DCS からのデータ受信 receive-data-from-the-dcs

DCS 呼び出しで /event 応答を要求する方法については、こちらを参照してください。この節では、応答の例と、応答でよく使用されるデータ要素の定義を示します。

このコンテンツを確認する前に、DCS へのデータ送信を参照してください。

DCS 応答パラメーター:復習 dcs-response-parameters

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

レスポンスのサンプル sample-response

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="
}

応答パラメーター response-parameters

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)。
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695