DCS 呼び出しで /event
応答を要求する方法については、こちらを参照してください。この節では、応答の例と、応答でよく使用されるデータ要素の定義を示します。
このコンテンツを確認する前に、DCS へのデータ送信を参照してください。
DCS からの応答を受信する場合は、d_rtbd=json
要求に DCS を含める必要があります。このパラメーターを省略した場合、DCS はデータを返しません。データを要求する場合の DCS への基本的な呼び出しでは、次の構文を使用します。
https://domain_alias.demdex.net/event?key1=val1&key2=val2&d_dst=1&d_rtbd=json&d_cb=callback
DCS へのデータ送信ドキュメントで、架空の会社 Acme, Inc. がこの呼び出しをおこなったことを思い出してください。
https://acme_aam_domain.demdex.net/event?videoTypeID=2&data=moarData&d_dst=1&d_rtbd=json&d_cb=acme_callback
この呼び出しには必要な応答パラメーターが含まれているので、DCS は以下のような JSON オブジェクトを送り返します。実際の応答は、これと同様の場合もあれば、もっと複雑な場合もあります。
{
"stuff": [],
"uuid": "22920112968019678612904394744954398990",
"dcs_region": 7,
"tid": "31ZpxW5bQGc="
}
DCS からの応答でよく見かけるパラメーターを、それぞれ次の表で定義します。これは、イベント呼び出しや、データを返すその他の DCSAPI クエリに当てはまります。
パラメーター | 説明 |
---|---|
c |
URL の宛先として設定された URL です。 |
cn |
Cookie の宛先の Cookie 名フィールドに設定された名前または ID です。 |
cv |
"cn":"destinaton name" パラメーターで定義された宛先に送信された値です。 |
dcs_region |
サーバー間 DCS 呼び出し。 |
dests |
このオブジェクトには、UI で設定されるすべての URL 宛先の情報が含まれています。このオブジェクトの値(リスト)は、ユーザーのアクションに応じて動的に変わります。 |
dmn |
Cookie の宛先の「Cookie Domain」フィールドに指定されたドメインです。Cookie の宛先のオプション設定を参照してください。サーバー間統合の場合は、aam-api.com などのドメインを使用することをお勧めします。 |
e |
URL の宛先に設定されたセキュア URL です。 |
stuff |
このオブジェクトには、すべての Cookie の宛先の情報が含まれています。このオブジェクトの値(リスト)は、ユーザーのアクションに応じて動的に変わります。 |
tid |
トランザクション ID(デバッグ目的で使用される 12 文字の一意の ID)です。DCS への各 /event 呼び出しでは、応答の改善および高速化に関するサポートへの問い合わせで参照できる tid を受け取ります。 |
ttl |
Cookie の有効期間(日単位)です。 |
u および uuid |
Audience Manager によって割り当てられ一意のユーザー ID。これが必要になるのは、サーバー間 DCS 呼び出しをおこなう場合です。 |
y |
宛先のタイプ。iFrame(iframe )または画像(img )。 |