Show Menu
トピック×

ID -Experience CloudIDの取得

Adobe Experience Platformは、 Web SDK Adobe・アイデンティティ・サービスを 利用します 。 これにより、各デバイスに固有の識別子が保持され、ページ間のアクティビティを相互に関連付けることができます。

ファーストパーティID

は、そのIDをファーストパーティドメインのcookieに Identity Service 保存します。 は、ドメインのHTTPヘッダーを使用してcookieを設定しようとします。 Identity Service その場合、はJavaScriptを使用したCookieの設定に戻 Identity Service ります。 Adobeでは、クライアント側のITP制限によってcookieが制限されないようにCNAMEを設定することをお勧めします。

サードパーティID

ID Identity Service をサードパーティドメイン(demdex.net)と同期して、サイト間の追跡を有効にする機能があります。 これが有効な場合、訪問者の最初のリクエスト(ECIDのないユーザーなど)は、demdex.netに対して行われます。 これは、Chromeなどを許可するブラウザーでのみ実行され、設定の thirdPartyCookiesEnabled パラメーターで制御されます。 この機能をすべて同時に無効にする場合は、false thirdPartyCookiesEnabled に設定します。

IDの移行

訪問者APIを使用して移行する場合は、既存のAMCV cookieを移行することもできます。 ECIDの移行を有効にするには、設定で idMigrationEnabled パラメーターを設定します。 IDの移行は、次のような使用事例を有効にするように設定されています。
  • ドメインの一部のページが訪問者APIを使用している場合と、他のページがこのSDKを使用している場合。 この場合、SDKは、既存のAMCV cookieを読み取り、既存のECIDを持つ新しいcookieを書き込みます。 また、SDKはAEP Web SDKが実装されたページでECIDが最初に取得された場合に、訪問者APIが実装された後続のページで同じECIDを持つように、AMCV cookieを書き込みます。
  • 訪問者APIも持つページでAEP Web SDKを設定する場合。 このケースをサポートするために、AMCV cookieが設定されていない場合、SDKはページ上で訪問者APIを探し、それを呼び出してECIDを取得します。
  • サイト全体でAEP Web SDKを使用し、訪問者APIを持たない場合は、返される訪問者情報を保持できるように、ECIDを移行すると便利です。 でのSDKのデプロイ後、訪問者ーのCookie idMigrationEnabled のほとんどが移行されるまでの時間が経過すると、設定を無効にできます。

訪問者IDの取得

この一意のIDを使用する場合は、 getIdentity コマンドを使用します。 getIdentity 現在の訪問者の既存のECIDを返します。 ECIDをまだ持っていない初回訪問者の場合は、新しいECIDが生成されます。
このメソッドは、通常、 Experience Cloud IDを読み取る必要があるカスタムソリューションで使用されます。 標準の実装では使用されません。
alloy("getIdentity")
  .then(function(result.identity.ECID) {
    // This function will get called with Adobe Experience Cloud Id when the command promise is resolved
  })
  .catch(function(error) {
    // The command failed.
    // "error" will be an error object with additional information
  })

IDの同期

この syncIdentity メソッドは、ハッシュ機能に加えて、バージョン2.1.0で削除されました。 バージョン2.1.0以降を使用し、IDを同期する場合は、フ xdm ィールドの sendEvent identityMap 下にあるコマンドのオプションでIDを直接送信できます。
また、コマンド Identity Service を使用して、独自のIDをECIDと同期でき syncIdentity ます。
使用可能なすべてのIDをすべての sendEvent コマンドで渡すことを強くお勧めします。 これにより、パーソナライゼーションを含む様々な使用例がロック解除されます。 これで、これらのIDを sendEvent コマンドに渡すことができるので、DataLayerに直接配置できます。
IDを同期すると、複数のIDを使用するデバイス/ユーザーを識別し、認証状態を設定して、どのIDを主要IDと見なすかを決定できます。 IDがに設定されていない場合 primary 、主なデフォルトはになり ECID ます。
alloy("sendEvent", {
  xdm: {
    "identityMap": {
      "ID_NAMESPACE": [ // Notice how each namespace can contain multiple identifiers.
        {
          "id": "1234",
          "authenticatedState": "ambiguous",
          "primary": true
        }
      ]
    }
  }
})

IDの同期オプション

識別名前空間記号

タイプ
必須
デフォルト値
文字列
なし
オブジェクトのキーは、 ID名前空間 (Identity Symbol)です。 これは、「 ID」のAdobe Experience Platformユーザーインターフェイスに表示されています。

id

タイプ
必須
デフォルト値
文字列
なし
これは、特定の名前空間に対して同期するIDです。

authenticationState

タイプ
必須
デフォルト値
可能な値
文字列
曖昧な
あいまい、認証済み、ログアウト
IDの認証状態。

primary

タイプ
必須
デフォルト値
Boolean
オプション
false
このIDを統合プロファイルのプライマリフラグメントとして使用するかどうかを指定します。 デフォルトでは、ECIDがユーザーの主識別子として設定されます。

hashEnabled

タイプ
必須
デフォルト値
Boolean
オプション
false
有効にすると、SHA256ハッシュを使用してIDがハッシュされます。