拡張機能の検証

ID サービス拡張機能は、ルールアクションを使用せずにリクエストを行う、数少ないタグ拡張機能の 1 つです。 拡張機能は、Web サイトへの初回訪問の最初のページ読み込みで、ID サービスへの要求を自動的におこないます。要求された ID は、「AMCV_」で始まるファーストパーティ cookie に保存されます。

ID サービス拡張機能を検証するには、以下を実行します。

  1. Luma サイトを開きます。

  2. 前のレッスンで説明したように、Debugger がタグプロパティを 自分の 開発環境」にマッピングしていることを確認します。

  3. Debugger の「概要」タブで、「タグ」セクションに、Adobe Experience Platform ID サービス拡張機能が実装されていることを示す必要があります。

  4. また、「概要」タブの「ID サービス」セクションには、データ収集インターフェイスの拡張機能設定画面と同じ組織 ID が入力されます。

    Adobe Experience Platform ID サービス拡張機能が実装されていることを確認する

  5. 訪問者 ID を取得するための最初の要求が、デバッガーの「ID サービス」タブに表示されることがあります。既に要求されている可能性がありますが、表示されなくても心配しないでください:
    自分の組織 ID を持つ ID サービスに対する要求があるかどうかを確認します

  6. 訪問者 Id を取得する最初のリクエストの後、ID は名前が AMCV_ で始まる cookie に保存されます。次の手順を実行して、cookie が設定されていることを確認します。

    1. ブラウザーの開発者ツールを開きます。

    2. Application」タブに移動します。

    3. 左側の Cookies を展開します。

    4. ドメイン(https://luma.enablementadobe.com)をクリックします。

    5. 右側の AMCV_ cookie を探します。ハードコードされたタグプロパティと独自のタグプロパティの両方を使用して Luma サイトを読み込んでから、いくつかのことがわかります。

      AMCV_ cookie の検証

これで作業は完了です。最初の拡張機能が追加されました。ID サービスの設定オプションについて詳しくは、ドキュメントを参照してください。

顧客 ID の送信

次に、顧客 ID を ID サービスに送信します。これにより、Experience Cloud と CRM を統合し、デバイスをまたいで訪問者を追跡できます。

前の「データ要素、ルールおよびライブラリの追加」レッスンでは、データ要素を作成してルールで使用しました。次に、訪問者が認証されたときに、同じ方法で顧客 ID を送信します。

顧客 ID データ要素の作成

まず、2 つのデータ要素を作成します。

  1. Authentication State:訪問者がログインしているかどうかをキャプチャします。
  2. Email (Hashed):データレイヤーから(顧客 ID として使用される)電子メールアドレスのハッシュバージョンを取り込みます。

認証状態のデータ要素を作成するには、以下を実行します。

  1. 左側のナビゲーションで データ要素 をクリックします

  2. データ要素を追加」ボタンをクリックします

    データ要素の追加

  3. データ要素に「Authentication State」と名前を付けます。

  4. データ要素タイプ で「カスタムコード」を選択します

  5. エディターを開く」ボタンをクリックします

    エディターを開き、データ要素のカスタムコードを追加する

  6. コードの編集ウィンドウで、次のコードを使用して、Luma サイトのデータレイヤーの属性に基づいて「logged in」または「logged out」の値を返します。

    if (digitalData.user[0].profile[0].attributes.loggedIn)
        return "logged in"
    else
        return "logged out"
    
  7. 保存」をクリックして、カスタムコードを保存します

    カスタムコードを保存する

  8. その他の設定はすべてデフォルト値のまま残します。

  9. ライブラリに保存 をクリックしてデータ要素を保存し、データ要素ページに戻ります。 すべての変更を加えて検証の準備が整わない限り、「ビルド」を行う必要はありません。

    データ要素の保存

ユーザーの認証状態を把握することで、ID サービスに送信するには、ページ上にいつ顧客 ID があればよいかがわかります。次に、顧客 ID 自体のデータ要素を作成します。Luma デモサイトで、訪問者の電子メールアドレスのハッシュバージョンを使用します。

ハッシュ化された電子メールのデータ要素を追加するには、以下を実行します。

  1. データ要素を追加」ボタンをクリックします

    データ要素を追加する

  2. データ要素に「Email (Hashed)」と名前を付けます。

  3. データ要素のタイプ」で、「JavaScript変数」を選択します

  4. JavaScript変数名 として、Luma サイトのデータレイヤーの変数へのポインターを使用します:digitalData.user.0.profile.0.attributes.username

  5. その他の設定はすべてデフォルト値のまま残します。

  6. ライブラリに保存 をクリックして、データ要素を保存します

    データ要素の保存

顧客 ID を送信するルールの追加

Adobe Experience Platform ID サービスは、「Set Customer IDs」アクションを使用して、顧客 ID をルールで渡します。訪問者が認証されたときにこのアクションをトリガーするルールを作成します。

顧客 ID を送信するルールを追加するには、以下を実行します。

  1. 左側のナビゲーションで、「ルール」をクリックします

  2. ルールを追加」をクリックしてルールビルダーを開きます

    ルールを追加

  3. ルール名を設定します。All Pages - Library Loaded - Authenticated - 10

    ヒント
    この命名規則は、ユーザーが認証され、順序が「10」の場合に、すべてのページの先頭でこのルールを実行することを示しています。 アクションでトリガーされるソリューションに対して、このような命名規則を使用すると、実装で必要とされるルールの全体的な数を最小限に抑えることができます。
  4. イベント追加 をクリックします

    イベントの追加

    1. イベントタイプ で「ライブラリの読み込み(ページのトップ)」を選択し す。
    2. Advanced Options」セクションを展開し、「Order」に「10」と入力します。 「順番」は、同じイベントによってトリガーされるルールのシーケンスを制御します。順番が早いルールは、順番が遅いルールの前に実行されます。この場合、要求を実行する前に顧客 ID を設定しますが、次のレッスンでは順序が 50 のルールを使用します。
    3. 変更を保持」ボタンをクリックして、ルールビルダーに戻ります

    イベントの保存

  5. 条件追加 をクリックします

    ルールへの条件の追加

    1. 条件タイプ値比較」を選択します。

    2. データ要素アイコン をクリックして、データ要素モーダルを開きます。

      データ要素モーダルを開く

    3. データ要素モーダルで、「認証状態」をクリックし、「選択」をクリックします

      認証状態の設定

  6. Equals が演算子であることを確認します。

  7. テキストフィールドに「logged in」と入力します。これにより、データ要素「Authentication State」の値が「logged in」になるとルールが実行されます。

  8. 変更を保持」をクリックします

    条件の保存

  9. アクション追加 をクリックします

    新しいアクションの追加

    1. 拡張機能 で、「Experience Cloud ID サービス」を選択します

    2. アクションタイプ で「顧客 ID を設定」を選択します

    3. 統合コードcrm_id と入力します

    4. にデータ要素セレクターモーダルを開き、Email (Hashed) を選択します

    5. 認証状態認証済み を選択します

    6. 変更を保持」ボタンをクリックしてアクションを保存し、ルールビルダーに戻ります

      アクションの設定と変更の保存

  10. ライブラリおよびビルドに保存 ボタンをクリックして、ルールを保存します

    ルールの保存

これで、訪問者が認証されたときに顧客 ID を crm_id 変数として送信するルールが作成されました。順序を 10 として指定したため、このルールは、「データ要素、ルール、ライブラリを追加」レッスンで作成したデフォルトの順序値(50)を使用する All Pages - Library Loaded ルールより前に実行されます。