ユニバーサル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つのファイルで表されます。データファイルとメタファイルは、既存のオーディエンスに対する変更を含め、オーディエンスをアップロードするたびに必要となります。これらのファイルフォーマットの詳細については、以下の表を参照してください。
ファイルタイプ | ファイル名 | ファイルフォーマット | 内容 |
---|---|---|---|
データ |
|
gzip |
改行コードで区切られたユニバーサルIDのリスト |
Meta v1.2 |
|
json |
メタファイルバージョン、バージョン、オーディエンス名、オーディエンスID、ソースオーディエンスID、広告主アカウントID、IndexアカウントID、エクスポートタイムスタンプ、アクション。 |
Meta v1.1 |
|
json |
メタファイルバージョン、オーディエンススコープ、オーディエンス名、オーディエンスID、ソースオーディエンスID、広告主アカウントID、ファイル名、エクスポートタイムスタンプ。 |
メタファイルv1.1にオーディエンススコープが追加されたことで、広告主は1回のファイルアップロードで対象となるすべてのIndexパブリッシャー 広告が表示される、ウェブサイトまたはアプリの所有者。に対してオーディエンスを実行できるようになりました。 |
|
Meta v1.0 |
json |
オーディエンス名、オーディエンスID、ソースオーディエンスID、広告主アカウントID、IndexパブリッシャーID、ファイル名、エクスポートタイムスタンプ。
データファイルとメタファイルは、以下の例のようにオーディエンスIDとファイル名でリンクされています。
データファイル名:1a956a17-7f7d-48fd-92ad-ade76e154a6b.gz
メタファイル名:1a956a17-7f7d-48fd-92ad-ade76e154a6b.json
メタファイルフィールドのリスト
フィールド | タイプ | 対応済みメタファイルのバージョン | 詳細 |
---|---|---|---|
|
文字列 |
1.1, 1.2 |
メタファイルのバージョン。 |
|
|
|
|
|
文字列 |
1.1 |
オーディエンスマッチングスコープ。
|
|
文字列 |
すべて |
オーディエンス名またはセグメント名。Index UI App.indexexchange.comのIndex UI(管理画面)では、インベントリ、キャンペーン、取引設定などの接続設定を管理することができます。内に表示される名前。 文字列 |
|
同じ |
一意の |
文字列 |
|
すべて |
ユニバーサル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パブリッシャー識別子。 |
---|---|
|
整数 1.2
|
IndexアカウントID |
メタファイルバージョン1.2の例 メタファイルバージョン1.1の例
|
次のメタファイルにはダイレクトオーディエンススコープがあります: |
次のメタファイルにはプラットフォームオーディエンススコープがあります: メタファイルバージョン1.0の例
|
App bundle ID |
An open text value to support app ID formats for all app stores. Example values:
|
Postal/ZIP code |
A combination of a postal/ZIP code and 3-letter country identifier, separated by a pipe character |, without spaces. Example values:
|
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