Web SDK の ID データ

Adobe Experience Platform Web SDK は、 Adobe Experience Cloud ID(ECID) 訪問者の行動を追跡するには、をクリックします。 ECID を使用すると、各デバイスに複数のセッション間で保持できる一意の ID が割り当てられていることを確認でき、Web セッション中および複数の Web セッション間で発生したすべてのヒットを特定のデバイスに結び付けることができます。

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

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

Platform Web SDK は、Cookie を使用して ECID を割り当て、追跡します。これらの Cookie の生成方法を設定するには、複数の利用可能なメソッドが使用されます。

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

ECID を含む Cookie を設定したら、Web SDK によって生成される後続の各リクエストでは、 kndctr_{YOUR-ORG-ID}_AdobeOrg_identity cookie.

デバイスを識別するために Cookie を使用する場合、Edge ネットワークとやり取りする方法は 2 つあります。

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

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

サードパーティのデータ収集には、Edge ネットワークドメインへの直接のデータ送信が含まれます。 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 日に制限されます。

cookie の寿命がAdobe Experience Cloudアプリケーションに及ぼす影響 lifespans

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

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

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

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

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

現在のユーザーの ECID および地域の取得

現在の訪問者の一意の 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

XDM の使用 identityMap フィールドを使用すると、複数の ID を使用してデバイスやユーザーを識別し、認証状態を設定して、プライマリ 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 への移行

訪問者 API を使用して移行する際に、既存の AMCV Cookie を移行することもできます。 ECID の移行を有効にするには、 idMigrationEnabled パラメーターを設定に含める必要があります。 ID 移行により、次のような使用例が可能になります。

移行用の特性の更新

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

イベント転送で使用

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