受信データファイルコンテンツ:構文、無効な文字、変数および例 inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
受信特性データファイルをフォーマットするときに従う必要のある必須フィールド、構文およびルール。
ファイルコンテンツの構文 file-content-syntax
受信データファイルのフィールドは、以下の順序でなければなりません。この例では、各要素を視覚的に区切るために<
>
記号が追加されています。実際のデータファイルでこれを使用する必要はありません。
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
使用可能なその他のファイルコンテンツ形式については、カスタムパートナー統合を参照してください。
code language-none |
---|
|
定義済みのファイル変数 file-variables-defined
次の表は、形式が適切に設定された受信データファイルで使用される変数の一覧と定義です。斜体 の部分には実際の情報が入ります。
User ID
ユーザー ID は次のいずれかに該当します。
- Audience Manager により割り当てられた一意のユーザー ID( Audience Manager UUID)。
- CRM システムで割り当てられた一意のユーザー ID(Audience Manager の DPUUID)。
- モバイル Android または iOS デバイス ID(モバイルオペレーティングシステムで表示される、元のままの形式)。
モバイル ID については、以下の点にも注意してください。
- IDFA 形式:ID は大文字でなければなりません。また、ハッシュしてはいけません。例:
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android 形式:ID は小文字でなければなりません。また、ハッシュしてはいけません。例:
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
Audience Manager 特性 ID。受信データファイルには 転送された特性のみ を入れるようにしてください。受信データ転送では、他の特性タイプは処理されません。
注意:特性 ID を確認するには、すべての特性の詳細を返す GET メソッドを使用します。詳しくは、特性 API メソッドを参照してください。
フォーマット Trait IDs formatting-trait-ids
次の表は、受信データファイルでtraitの名前または ID を識別するためのプレフィックスの一覧です。例についてはサンプルファイルを参照してください。
d_sid=
d_sid
というプレフィックスは、ID が Audience Manager の特性 ID であることを表します。これはユーザーインターフェイスに表示される ID と同じです。特性 ID は API GET
メソッドを使用して返すこともできます。詳しくは、特性 API メソッドを参照してください。d_unsid=
データに d_unsid
というプレフィックスを付けると、ユーザーがその特性から削除されます。 d_unsid
というプレフィックスは、 overwrite
ファイルでは無視されます。
d_unsid=
というプレフィックスは、ID が Audience Manager の特性 ID であることを表します。これはユーザーインターフェイスに表示される ID と同じです。特性 ID は API GET
メソッドを使用して返すこともできます。詳しくは、特性 API メソッドを参照してください。
ic=
特性ルールを使用すると、特性認定の条件を設定できます。特性ルールを ic == trait ID
と書式設定した場合、特性を簡単なコンマ区切りのリストで送信できます。
例えば、次の 3 つの特性ルールを作成したとします。
ic == "123"
ic == "456"
ic == "789"
これらの特性は ic
キーに関連付けられます。これにより、データファイルでより簡単な特性リストを作成できます。また、 ic
というプレフィックスを使用する必要はありません。その結果、データファイルの内容は次のようになります。
user ID <TAB> 123,456,789
特性データは英数字の文字列を使用するキーと値のペアとして書式設定できます。キーと値のペアの書式設定には次のように複数の方法があります。
key = value
"key" = value
key = "value"
"key" = "value"
"age"="32"
、 "gender"=m
、 model = "pickup truck"
、 product = tablet
はすべて、正しい形式のキーと値のペアの例です。
Trait IDs、User IDs およびキーと値のペアの無効な文字 invalid-chars
Trait IDs
Trait IDs は数字のみで構成されます。受信データファイルには、onboarded traits のみを入れるようにしてください。受信データ転送では、他のtraitタイプは処理されません。
User IDs
%3A
)やエンコードされていないコロン( : )を使用 しないでください。モバイルデバイス ID は次の形式を厳密に遵守していなければなりません。
- IDFA 形式:ID は大文字でなければなりません。また、ハッシュしてはいけません。例:
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android 形式:ID は小文字でなければなりません。また、ハッシュしてはいけません。例:
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
キー値ペア
キーと値のペアで、値の名前が正しく書式設定されていない場合も、問題が発生します。キーと値のペアの値を作成する場合、または値の名前を設定する場合は、以下のルールに従ってください。
引用符は、キーと値のペアのキーと値の部分に使用できます。例えば、次のようにできます。
-
d_city = "New York", d_city = "San Francisco"
-
"d_city" = "New York", "d_city" = "San Francisco"
-product = camera
」は「 product = camera
」と解釈されます。TAB
TAB
を使用 しないでください 。 TAB
は受信データファイルで変数を区切る場合にのみ使用します。\n, \t
\n, \t
)は使用しないでください。データファイルの例 data-file-examples
d_sid
または d_unsid
を使用このデータファイルは、特性 24、26、27 について認定され、特性 28、29 から削除されたユーザーを示しています。
59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
注意:
d_unsid を使用する代わりに、次の構文を使用してユーザープロファイルから特性を削除することもできます。
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
を使用これらの特性は、 ic
というプレフィックスで特性ルールに追加されています。そのため、次のように、コンマ区切りのデータファイルに追加することができます。タブは UUID と特性 ID を区切ります。 ic
というプレフィックスはファイルでは必要ありません。
数値 ID
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
文字列 ID
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
このファイルデータは、キーと値のペアを使用して、データを Audience Manager に渡します。
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
他の例が必要な場合は、サンプルデータファイルをダウンロードします。ダウンロードファイルの拡張子は .overwrite
です。これは普通のテキストエディターで開くことができます。
事例マトリックス examples-matrix
以下の表は、受信ファイルの書式設定を正しくおこなう方法を示す例の一覧です。ID のタイプと、traitsをプロファイルに追加する方法によって分類されています。
例 1 example-1
trait IDs を使用して、Audience Manager UUIDs の trait 認定情報を送信します。
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
例 2 example-2
trait IDsを使用して、Audience Manager UUIDs のtrait不適格情報を送信します。
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27
または
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0
または
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1
例 3 example-3
キーと値のペアを送信し、Audience Manager UUIDs 用の trait 認定情報を追加します。
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
または
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
例 4 example-4
ic
プレフィックスを使用して、Audience Manager UUIDs のtrait認定情報を送信します。
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
または
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
例 5 example-5
trait IDs を使用して、Android デバイスの trait 認定情報を送信します。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
例 6 example-6
trait IDsを使用して、Android デバイスのtrait不適格情報を送信します。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
または
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0
または
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1
例 7 example-7
キーと値のペアを送信し、trait デバイスの Android 認定情報を追加します。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
または
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
例 8 example-8
ic
プレフィックスを使用して、Android デバイスのtrait認定情報を送信します。
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
または
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
例 9 example-9
trait IDs を使用して、iOS デバイスの trait 認定情報を送信します。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
例 10 example-10
trait IDsを使用して、iOS デバイスのtrait不適格情報を送信します。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26
または
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0
または
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1
例 11 example-11
キーと値のペアを送信し、trait デバイスの iOS 認定情報を追加します。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
または
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
例 12 example-12
ic
プレフィックスを使用して、iOS デバイスのtrait認定情報を送信します。
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
または
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
例 13 example-13
trait IDs を使用して、DPUUIDs の trait 認定情報を送信します。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
例 14 example-14
trait IDsを使用して、DPUUIDs のtrait不適格情報を送信します。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
または
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0
または
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1
例 15 example-15
キーと値のペアを送信し、DPUUIDs 用のtrait認定情報を追加します。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
または
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
例 16 example-16
ic
プレフィックスを使用して、DPUUIDs のtrait認定情報を送信します。
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
または
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55