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 で生成される後続の各リクエストには、にエンコードされた ECID が含まれます kndctr_{YOUR-ORG-ID}_AdobeOrg_identity cookie。

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

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

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

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

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

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

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

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

ブラウザーは長い間、サイトが所有するエンドポイントと同様に、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

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

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

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

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

xdm.identityMap.ECID[0].id

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

を取得します ECID 経由 getIdentity() コマンド 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 デバイスまたはユーザーを識別するためのフィールドは、 setCustomerIDs メソッドを次から ID Service API. を参照してください。 ID サービス API ドキュメント を参照してください。

訪問者 API から ECID への移行

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

移行する特性の更新

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

イベント転送での使用

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