Web SDK の ID データ

Adobe Experience Platform Web SDK は、Adobe Experience Cloud ID （ECID）を使用して訪問者の行動を追跡します。 ECID を使用すると、各デバイスに、複数のセッションにわたって保持できる一意の ID を設定し、web セッション中およびセッション間で発生するすべてのヒットを特定のデバイスに結び付けることができます。

このドキュメントでは、Platform Web SDK を使用して ECID を管理する方法の概要を説明します。

SDK を使用した ECID のトラッキング

Platform Web SDK は、これらの cookie の生成方法を設定できる複数の方法を使用して、cookie を使用して ECID の割り当てと追跡を行います。

新しいユーザーが web サイトにアクセスすると、Adobe Experience Cloud ID サービスは、そのユーザーのデバイス ID cookie の設定を試みます。 初回の訪問者の場合、ECID が生成され、Adobe Experience Platform Edge Networkからの最初の応答で返されます。 リピート訪問者の場合、ECID は kndctr_{YOUR-ORG-ID}_AdobeOrg_identity Cookie から取得され、Edge Networkによってペイロードに追加されます。

ECID を含む Cookie を設定すると、Web SDK で生成される後続の各リクエストでは、kndctr_{YOUR-ORG-ID}_AdobeOrg_identity Cookie にエンコードされた ECID が含まれます。

デバイスの識別に Cookie を使用する場合、Edge Networkを操作するには 2 つの選択肢があります。

以下の節で説明するように、使用するデータ収集方法は、ブラウザー間の Cookie の有効期間に直接影響します。

サードパーティのデータ収集 third-party

サードパーティのデータ収集では、データをEdge Networkドメイン adobedc.net に直接送信します。

近年、Web ブラウザーでは、サードパーティによって設定された Cookie の処理に対する制限がますます厳しくなっています。 一部のブラウザーでは、デフォルトでサードパーティ cookie がブロックされます。 サードパーティ cookie を使用してサイト訪問者を識別する場合、それらの cookie の有効期間は、ほとんどの場合、代わりにファーストパーティ cookie を使用して使用可能な場合よりも短くなります。 場合によっては、サードパーティ cookie の有効期限が 7 日以内に切れます。

また、サードパーティのデータ収集が使用される場合、一部の広告ブロッカーは、Adobeのデータ収集エンドポイントへのトラフィックを完全に制限します。

ファーストパーティデータ収集 first-party

ファーストパーティデータ収集では、adobedc.net を指す独自のドメインで CNAME を使用して Cookie を設定します。

ブラウザーは長い間、サイトが所有するエンドポイントと同様に、CNAME エンドポイントで設定された Cookie を処理してきましたが、ブラウザーで実装された最近の変更により、CNAME Cookie の処理方法に区別が生まれました。 現在、デフォルトでファーストパーティ CNAME Cookie をブロックするブラウザーはありませんが、一部のブラウザーでは、CNAME を使用して設定された Cookie の有効期間がわずか 7 日に制限されています。

Adobe Experience Cloud アプリケーションへの cookie の有効期間の影響 lifespans

ファーストパーティとサードパーティのどちらのデータ収集を選択した場合でも、cookie が保持される期間は、Adobe AnalyticsとCustomer Journey Analyticsの訪問者数に直接影響します。 また、サイトでAdobe TargetまたはOffer decisioningを使用した際に、一貫性のないパーソナライゼーションエクスペリエンスがエンドユーザーに提供される可能性があります。

例えば、過去 7 日間にユーザーが 3 回表示した項目を、ホームページに昇格させるパーソナライゼーションエクスペリエンスを作成した場合を考えてみましょう。

エンドユーザーが週に 3 回訪問し、その後 7 日間サイトに戻らない場合、そのユーザーの Cookie はブラウザーポリシーによって削除された可能性があるので、サイトに戻ったときに新しいユーザーと見なされる場合があります（サイトを訪問したときに使用していたブラウザーによって異なります）。 この問題が発生した場合、Analytics ツールは、7 日前にサイトに訪問したばかりの訪問者でも、新しいユーザーとして扱います。 また、ユーザーのエクスペリエンスをパーソナライズする作業も再び開始されます。

ファーストパーティデバイス ID

上記のように cookie の有効期間の影響を考慮して、代わりに、独自のデバイス識別子を設定および管理することを選択できます。 詳しくは、ファーストパーティデバイス ID に関するガイドを参照してください。

現在のユーザーの ECID と地域の取得 retrieve-ecid

ユースケースに応じて、ECID にアクセスする方法は 2 つあります。

データ収集のためのデータ準備を使用した ECID ータの取得 retrieve-ecid-data-prep

データ収集のためのデータ準備を使用して、ECID を XDM フィールドにマッピングします。 ECID にアクセスする場合は、この方法をお勧めします。

それには、ソースフィールドを次のパスに設定します。

xdm.identityMap.ECID[0].id

次に、ターゲットフィールドを XDM パスに設定します。フィールドのタイプは string です。

getIdentity() コマンドを使用して ECID を取得します retrieve-ecid-getidentity

現在の訪問者の一意の ECID を取得するには、getIdentity コマンドを使用します。 ECID ールをまだもっていない初めての訪問者の場合、このコマンドは新しい ECID を生成します。 getIdentity た、訪問者の地域 ID も返します。

alloy("getIdentity")
  .then(function(result) {
    // The command succeeded.
    console.log("ECID:", result.identity.ECID);
    console.log("RegionId:", result.edge.regionId);
  })
  .catch(function(error) {
    // The command failed.
    // "error" will be an error object with additional information.
  });

使用 identityMap using-identitymap

XDM identityMap フィールドを使用すると複数の ID を使用してデバイスやユーザーを識別し、認証状態を設定し、どの識別子をプライマリと見なすかを決定できます。 識別子を primary に設定していない場合、プライマリのデフォルト値は ECID になります。

identityMap フィールドは、sentEvent コマンドを使用して更新されます。

alloy("sendEvent", {
  xdm: {
    "identityMap": {
      "ID_NAMESPACE": [ // Notice how each namespace can contain multiple identifiers.
        {
          "id": "1234",
          "authenticatedState": "authenticated",
          "primary": true
        }
      ]
    }
  }
});

identityMap 内の各プロパティは、特定 ID 名前空間に属する ID を表します。 プロパティ名は、ID 名前空間の記号である必要があります。この記号は、Adobe Experience Platform ユーザーインターフェイスの「ID」の下に表示されます。 プロパティ値は、その ID 名前空間に関連する ID の配列である必要があります。

ID 配列内の各 ID オブジェクトには、次のプロパティが含まれます。

identityMap フィールドを使用してデバイスまたはユーザーを識別すると、ID Service API から setCustomerIDs メソッドを使用した場合と同じ結果が得られます。 詳しくは、ID サービス API ドキュメントを参照してください。

訪問者 API から ECID への移行

から Visitor API を使用して移行する場合、既存の AMCV Cookie も移行できます。 ECID 移行を有効にするには、設定で idMigrationEnabled パラメーターを設定します。 ID 移行により、次のユースケースが可能になります。

移行する特性の更新

XDM 形式のデータをAudience Managerに送信する場合、このデータはマイグレーション時にシグナルに変換される必要があります。 XDM が提供する新しいキーを反映するように特性を更新する必要があります。 このプロセスは、Audience Managerが作成した BAAAM ツールを使用すると容易になります。

イベント転送での使用

現在 イベント転送を有効にしており、appmeasurement.js と visitor.js を使用している場合は、イベント転送機能を有効にしておくことができ、問題は発生しません。 バックエンドでは、AdobeはAAM セグメントを取得し、それらを Analytics への呼び出しに追加します。 Analytics への呼び出しにこれらのセグメントが含まれている場合、Analytics はAudience Managerを呼び出してデータを転送しないため、重複したデータ収集はありません。 また、同じセグメント化エンドポイントがバックエンドで呼び出されるので、Web SDK を使用する際に場所のヒントは必要ありません。