ユニバーサルIDプロバイダーのオーディエンスファイルフォーマット・リファレンス

オーディエンストランザクションを行うユニバーサルID Universal IDs are IDs that Index can receive from data partners and pass to DSPs in the bid request.プロバイダーに対応している場合は、SFTPを使いIndex Exchange (Index)にオーディエンスファイルを送信でき、Audience Managerシステムにより15~20分で処理可能です。

注意:このオーディエンスフォーマットは、選ばれたユニバーサルIDプロバイダーのみが利用できます。ご不明な点は、Index担当者までお問い合わせください。

ファイルフォーマット

Indexでは、オーディエンスファイルのデュアルファイルフォーマットに対応しています。デュアルファイルフォーマットでは、Indexは1ペアのファイルに対して1つのオーディエンスの受信を想定しています(マルチオーディエンスのアップロードにはまだ対応していません)。各オーディエンスは、データファイルとメタファイルの2つのファイルで表されます。データファイルとメタファイルは、既存のオーディエンスに対する変更を含め、オーディエンスをアップロードするたびに必要となります。これらのファイルフォーマットの詳細については、以下の表を参照してください。

ファイルタイプ ファイル名 ファイルフォーマット 内容

データ

<audienceID>.gz

gzip

改行コードで区切られたユニバーサルIDのリスト

Meta v1.2

<audienceID>.json

json

メタファイルバージョン、バージョン、オーディエンス名、オーディエンスID、ソースオーディエンスID、広告主アカウントID、IndexアカウントID、エクスポートタイムスタンプ、アクション。

Meta v1.1

<audienceID>.json

json

メタファイルバージョン、オーディエンススコープ、オーディエンス名、オーディエンスID、ソースオーディエンスID、広告主アカウントID、ファイル名、エクスポートタイムスタンプ。

メタファイルv1.1にオーディエンススコープが追加されたことで、広告主は1回のファイルアップロードで対象となるすべてのIndexパブリッシャー 広告が表示される、ウェブサイトまたはアプリの所有者。に対してオーディエンスを実行できるようになりました。audience_scopePLATFORMに設定したメタファイルは、広告主のオーディエンススケールを大幅に拡大させます。audience_scopeDIRECTに設定されている場合、広告主は特定のパブリッシャーと直接オーディエンスの取引を行うことができます。

<audienceID>.json

Meta v1.0

json

オーディエンス名、オーディエンスID、ソースオーディエンスID、広告主アカウントID、IndexパブリッシャーID、ファイル名、エクスポートタイムスタンプ。

データファイルとメタファイルは、以下の例のようにオーディエンスIDとファイル名でリンクされています。

データファイル名:1a956a17-7f7d-48fd-92ad-ade76e154a6b.gz

メタファイル名:1a956a17-7f7d-48fd-92ad-ade76e154a6b.json

メタファイルフィールドのリスト

フィールド タイプ 対応済みメタファイルのバージョン 詳細

meta_version

文字列

1.1, 1.2

メタファイルのバージョン。

audienceName

1.0はバージョン1.0で、プラットフォームオーディエンススコープに対応していません。

1.1はバージョン1.1で、プラットフォームオーディエンススコープに対応しています。

1.2はバージョン1.2で、オーナーアカウントIDに対応しています。

audienceID

文字列

1.1

オーディエンスマッチングスコープ。

PLATFORMは、オーディエンスがプラットフォーム全体(すべての適格なIndexパブリッシャー)でマッチングできることを示します。

DIRECTは、オーディエンスが特定のパブリッシャーにのみマッチングすることを示します。

advertiserAccount_id

文字列

すべて

オーディエンス名またはセグメント名。Index UI App.indexexchange.comのIndex UI(管理画面)では、インベントリ、キャンペーン、取引設定などの接続設定を管理することができます。内に表示される名前。

文字列

exportTimestamp

同じaudienceIDがあるアップロードはそのオーディエンスに対するアップデートとして扱われます。

一意のaudienceIDがあるアップロードは別の新しいオーディエンスとして扱われます。

文字列

ownerAccount_id

すべて

ユニバーサルIDプロバイダーに割り当てられたオーディエンスの広告またはバイヤーのためのアドレッサビリティ識別子。どちらも適用しない場合、オーディエンスセグメントファイルを提供するデータパートナーの企業名が入力されます。例:LiveRampまたはLotame。

注意:この項目は、nullまたは空欄にはできません。

1.2

{
	"meta_version": "1.2",
	"audienceName": "New Customers Signups",
	"audienceID": "1a123a12-1a1b-12ab-12ad-ade76e154a6b",
	"advertiserAccount_id": "Agency1",
	"ownerAccount_id": 1234567,
	"exportTimestamp": "2023-06-01 13:20:35",	
}

List of supported ad request signals that can be included in the data file

タイムスタンプの形式:YYYY-MM-DD(年-月-日)

すべて

  • オーディエンスがエクスポートされた時間(UTC(協定世界時))。

  • 整数

1.0, 1.1 Indexパブリッシャー識別子。

publisher_idは、audience_scopeDIRECTに設定されている場合にのみ必要です。

整数

1.2

  • 1A2B3C4D5E!6F$7G

IndexアカウントID

メタファイルバージョン1.2の例

メタファイルバージョン1.1の例

  • 192.168.2.1

  • 2603:8000:6f00:562b:ac08:44bc:2cb7:5419

次のメタファイルにはダイレクトオーディエンススコープがあります:

次のメタファイルにはプラットフォームオーディエンススコープがあります:

メタファイルバージョン1.0の例

  • news-site.com/sports/lacrosse/finals

  • recipes123ABC.org/pies

App bundle ID

An open text value to support app ID formats for all app stores.

Example values:

  • com.myappname

  • 12345ABCDE

Postal/ZIP code

A combination of a postal/ZIP code and 3-letter country identifier, separated by a pipe character |, without spaces.

Example values:

  • A0B1C2|CAN

  • 12345|USA

Data file example

192.168.2.1
192.168.2.5
1234:abcd:5678:efab:9012:cdef:3456:abcd
192.168.2.9
1a2b:3c4d:5e6f:7a8b:9c0d:1e2f:3a4b:5c6d