Declared IDs declared-ids

declared IDs の機能、セットアップ手順、コード例、変数について説明します。

Declared ID ターゲット設定 declared-id-targeting

サードパーティ cookies などの永続的ストレージメカニズムを使用しない、または使用できないデバイスやブラウザーで、Audience Manager とのユーザー ID の交換および同期をおこないます。

Declared ID ターゲティングの目的 declared-id-targeting-purpose

一部のブラウザーやほとんどのモバイルデバイスでは、サードパーティの cookies を許可していません。そのため、サイト訪問者に関する情報の保持や永続的 ID の割り当てが難しくなります。この問題を解決するため、Audience Manager では、declared IDs をイベント呼び出しで渡せるよう、DIL を使用しています。また、declared IDは、Experience Cloud のすべてのソリューションで同じユーザーに適用される汎用 ID としても機能できます。ID のターゲティング／マッチング処理を次の表で説明します。

まず最初に、データ収集に使用するサイトのすべてのページに Experience Cloud ID サービスと DIL を設定する必要があります。DIL create および宣言された ID 変数を参照してください。

オプトアウト呼び出し opt-out-calls

declared ID の処理では、サイト訪問者の環境設定に従って、 によるターゲティングを Web サイトでオプトアウトすることができます。Audience ManagerAudience Manager がオプトアウトリクエストを受信すると、DCS から返される JSON には、Audience Manager ユーザー ID ではなく、エラーコード 171 と「Encountered opt out tag」というメッセージが含まれています。

データ収集のオプトアウトについて詳しくは、データのプライバシーを参照してください。

Declared ID オプトアウトの例 opt-out-examples

d_cid および d_cid_ic のキー値ペアを使用して、declared ID のオプトアウトリクエストをおこなうことができます。d_dpid や d_dpuuid などの従来のパラメーターはまだ機能しますが、既に非推奨（廃止予定）となっています。詳しくは、DPID と DPUUID に代わる CID を参照してください。以下の例で、斜体 ​の部分には実際の情報が入ります。

CID および CID_IC でのオプトアウト

説明と構文については、宣言された ID の URL 変数および構文を参照してください。

DPID、DPUUID、および UUIDでのオプトアウト（廃止予定）

これらの方法はまだ機能しますが、既に非推奨（廃止予定）となっています。この情報は、従来手法の参考などのために提供するものです。従来のオプトアウト方法は次のとおりです。

Declared IDs の変数と構文 variables-and-syntax

以下の表に、Audience Manager でデータプロバイダー ID およびユーザー ID または統合コード（使用する場合）を渡すキー値ペアを示します。なお、斜体 ​の部分には実際の情報が入ります。読みやすくするために、スペースが追加されています。

それぞれのキー値ペアでは、以下がおこなわれます。

サンプルイベント呼び出し sample-event-calls

これらのキー値ペアとその必須構文を仮定すると、イベント呼び出しは以下のようにおこないます。

Declared ID 変数 declared-id-variables

declared IDs を DIL を通じて Audience Manager. に渡すための設定変数について説明します。

DIL は Adobe Experience Platform Identity Service を使用して Declared IDs を渡す dil-id-service-pass-declared-ids

Adobe Experience Platform ID サービスを使用する場合、非推奨（廃止予定）の dpid 変数と dpuuid 変数を使用して declared IDs を渡す必要はありません。代わりに、visitorService 関数に依存する現在のバージョンの DIL を使用して、Adobe Experience Platform Identity Service の setCustomerIDs 関数から declared IDs を取得します。詳しくは、顧客 ID と認証状態を参照してください。次のように、DIL.create で visitorService を呼び出します。

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

キー値ペア namespace で、MCORG は Experience Cloud の組織 ID です。この ID がわからない場合、Experience Cloud ダッシュボードの「Administration」セクションで確認できます。このダッシュボードを表示するには、管理者権限が必要です。管理：コアサービスも参照してください。

非推奨（廃止予定）の関数 deprecated-functions

DIL の最新バージョン（6.2 以降）では、これらのキー値ペアを使用して declared IDs を渡す必要はありません。これは、DIL が上記のコードサンプルのように visitorService 関数を使用しているためです。この関数は Adobe Experience Platform Identity Service から declared IDs を取得します。ここでは、これらの変数を、履歴やレガシーを示す目的で参照しています。以下のコードは、DIL.create を設定して Visitor ID Service から declared ID を取得する方法の例を示しています。次の表は、declaredId オブジェクトで使用されるレガシー変数の一覧です。

DPID および DPUUID

Audience Manager は結合された DPID と DPUUID を、システム内の対応するユーザー ID と比較して照合します。存在しない ID がある場合、Audience Manager は新しいユーザー ID を作成し、DPID/DPUUID の組み合わせと同期します。Audience Manager がユーザー ID（UUID）を照合または作成すると、その ID が JSON レスポンスでクライアントのドメイン （ファーストパーティの cookie）またはその他のローカルストレージの cookie に返されます。

DIL v6.1 以前を使用している場合には、この関数を呼び出します。新しいバージョンでは Adobe Experience Platform Identity Service から declared IDs を取得するので、この関数は非推奨（廃止予定）となっています。

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

DIL のインスタンス化の後に ID を渡す

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

リクエストとレスポンスの例 request-response-examples

次のリクエストはデータプロバイダー ID とユーザー ID を Audience Manager に送信します。:

https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678

次のレスポンスでは、Audience Manager ID（UUID など）が返され、ページドメインのファーストパーティ Cookie に書き込まれます。

myCallback({
...
   "uuid":"abc123"
})

ターゲティングからの除外 do-not-target

declared ID の処理では、サイト訪問者の環境設定に従って、 によるターゲティングを Web サイトでオプトアウトすることができます。Audience ManagerAudience Manager がオプトアウトリクエストを受け取ると、DCS は Audience Manager ユーザー ID ではなく空の JSON オブジェクトを返します。