名前空間
検索できるようにしたい各IDには、名前空間が割り当てられます。名前空間は、すべてのレポートスイートで使用されている任意の変数内のIDを識別するカスタム文字列です。
名前空間の文字列は、データプライバシー要求の一部として ID を提供する際に検索対象にしたいフィールドを識別するために使用されます。 データプライバシーリクエストが送信されると、そのリクエストには、リクエストで使用するデータ主体の ID を指定する JSON セクションが含まれます。 あるデータ主体に対する 1 回のリクエストの一部として、複数の ID を含めることができます。 JSONには以下が含まれます。
- 名前空間文字列を含む「名前空間」フィールド。
- ほとんどのAdobe Analytics リクエストの「type」フィールドには、「analytics」の値が含まれています。
- Analyticsが各レポートスイートの関連する名前空間変数で検索するIDを含む「値」フィールド。
詳しくは、CX Enterprise Data Privacy API ドキュメント および標準ID名前空間の リスト を参照してください。 サンプルリクエストについて詳しくは、アクセス/削除ジョブの作成を参照してください。
Cookie ID
従来の Analytics トラッキング Cookie(Adobe Analytics ID(AAID)とも呼ばれる):
{
"namespace": "AAID",
"type": "standard",
"value": "2CCEEAE88503384F-1188000089CA"
}
値は、ダッシュで区切られた2つの16進数として指定する必要があります。 アルファベット文字である16進数はすべて、大文字を使用して指定する必要があります。 16進数の値には、先頭のゼロを指定しないでください(先頭のゼロが必要な場合は、非推奨のフォームで指定した値と同じ値との違いに注意してください)。
また、"namespace": "AAID" の代わりに(または追加として)"namespaceId": 10 を使用することもできます。その場合、その形式を使用できるその他のアドビ製品が表示されます。
従来の Analytics トラッキング Cookie:廃止された形式
{
"namespace": "visitorId",
"type": "analytics",
"value": "2cceeae88503384f-00001188000089ca"
}
値は、2つの16桁の16進数または2つの19桁の10進数として指定する必要があります。 数字は、ダッシュ、アンダースコア、コロンで区切る必要があります。 いずれかの数値が十分な桁数を持たない場合、先頭にゼロを追加する必要があります。
ID サービスの Cookie
{
"namespace": "ECID",
"type": "standard",
"value": "00497781304058976192356650736267671594"
}
値は、38 桁の 10 進数で指定される必要があります。 この数値をデータフィードまたは Data Warehouse レポートからの 2 つの mcvisid_high/low 列または post_msvisid_high/low 列からプルしている場合、2 つの数値がそれぞれ 19 桁になるようにゼロを追加して、大きい値を先にして連結する必要があります。
また、"namespace": "ECID" の代わりに(または追加として)"namespaceId": 4 を使用することもできます。その場合、その形式を使用できるその他のアドビ製品が表示されます。
これらの Cookie ID の任意の値の部分の形式が、その ID について説明した形式に従っていない場合、「値が正しくフォーマットされていません」というエラーと共に、データプライバシー要求は失敗します。
新しいプライバシー JavaScript を使用して、これらの Cookie ID を収集するのが最も一般的です。これにより、これらの JSON ID の関連するすべてのキーと値のペアが自動的に提供されます。
この JavaScript コードによって、前述のフィールド(名前空間、タイプ、値)以外のキーと値のペアが JSON に入力されますが、Analytics でのデータプライバシーの処理で最も重要なのは、前述のフィールドです。他の方法で ID を収集している場合に提供する必要があるのも前述のフィールドのみです。
カスタム訪問者 ID
{
"namespace": "customVisitorID",
"type": "analytics",
"value": "<ID>"
}
名前空間も、カスタム訪問者ID用に事前定義されています。
カスタム変数の ID
{
"namespace":"Email Address",
"type": "analytics",
"value": "john@xyz.com"
},
{
"namespace": "CRM ID",
"type": "analytics",
"value": "123456-ABCD"
}
カスタムのトラフィック変数またはコンバージョン変数(prop または eVar)の ID の場合は、変数に ID-DEVICE または ID-PERSON ラベルを設定してから、独自の名前空間の名前をその ID タイプに割り当てます。 変数を ID-DEVICE または ID-PERSON としてラベル設定する際の名前空間の提供を参照してください。
また、他の変数またはレポートスイートに対して以前に定義した名前空間を表示して、そのいずれかを再利用できるので、同じ名前空間を、そのタイプのIDを保存するすべてのレポートスイートに簡単に使用できます。 レポートスイート内の複数の変数に同じ名前空間を割り当てることもできます。 例えば、一部の顧客は、トラフィック変数とコンバージョン変数にCRM IDを保存し(ページによっては、どちらか一方または両方に格納されることがあります)、両方の変数に名前空間「CRM ID」を割り当てることができます。
visitorId と customVisitorId は、Analytics のレガシートラッキング cookie と Analytics の顧客訪問者 ID を識別するために予約されています。 これらの名前空間を、カスタムトラフィックやコンバージョン変数に使用しないでください。詳しくは、変数を ID-DEVICE または ID-PERSON としてラベル設定する際の名前空間の提供を参照してください。