拡張機能の検証
ID サービス拡張機能は、ルールアクションを使用せずにリクエストを行う、数少ないタグ拡張機能の 1 つです。 拡張機能は、Web サイトへの初回訪問の最初のページ読み込みで、ID サービスへの要求を自動的におこないます。要求された ID は、「AMCV_」で始まるファーストパーティ cookie に保存されます。
ID サービス拡張機能を検証するには、以下を実行します。
-
Luma サイトを開きます。
-
前のレッスンで説明したように、Debugger がタグプロパティを 自分の 開発環境」にマッピングしていることを確認します。
-
Debugger の「概要」タブで、「タグ」セクションに、Adobe Experience Platform ID サービス拡張機能が実装されていることを示す必要があります。
-
また、「概要」タブの「ID サービス」セクションには、データ収集インターフェイスの拡張機能設定画面と同じ組織 ID が入力されます。
-
訪問者 ID を取得するための最初の要求が、デバッガーの「ID サービス」タブに表示されることがあります。既に要求されている可能性がありますが、表示されなくても心配しないでください:
-
訪問者 Id を取得する最初のリクエストの後、ID は名前が
AMCV_
で始まる cookie に保存されます。次の手順を実行して、cookie が設定されていることを確認します。-
ブラウザーの開発者ツールを開きます。
-
「
Application
」タブに移動します。 -
左側の
Cookies
を展開します。 -
ドメイン(
https://luma.enablementadobe.com
)をクリックします。 -
右側の AMCV_ cookie を探します。ハードコードされたタグプロパティと独自のタグプロパティの両方を使用して Luma サイトを読み込んでから、いくつかのことがわかります。
-
これで作業は完了です。最初の拡張機能が追加されました。ID サービスの設定オプションについて詳しくは、ドキュメントを参照してください。
顧客 ID の送信
次に、顧客 ID を ID サービスに送信します。これにより、Experience Cloud と CRM を統合し、デバイスをまたいで訪問者を追跡できます。
前の「データ要素、ルールおよびライブラリの追加」レッスンでは、データ要素を作成してルールで使用しました。次に、訪問者が認証されたときに、同じ方法で顧客 ID を送信します。
顧客 ID データ要素の作成
まず、2 つのデータ要素を作成します。
Authentication State
:訪問者がログインしているかどうかをキャプチャします。Email (Hashed)
:データレイヤーから(顧客 ID として使用される)電子メールアドレスのハッシュバージョンを取り込みます。
認証状態のデータ要素を作成するには、以下を実行します。
-
左側のナビゲーションで データ要素 をクリックします
-
「データ要素を追加」ボタンをクリックします
-
データ要素に「
Authentication State
」と名前を付けます。 -
データ要素タイプ で「カスタムコード」を選択します
-
「エディターを開く」ボタンをクリックします
-
コードの編集ウィンドウで、次のコードを使用して、Luma サイトのデータレイヤーの属性に基づいて「logged in」または「logged out」の値を返します。
if (digitalData.user[0].profile[0].attributes.loggedIn) return "logged in" else return "logged out"
-
「保存」をクリックして、カスタムコードを保存します
-
その他の設定はすべてデフォルト値のまま残します。
-
ライブラリに保存 をクリックしてデータ要素を保存し、データ要素ページに戻ります。 すべての変更を加えて検証の準備が整わない限り、「ビルド」を行う必要はありません。
ユーザーの認証状態を把握することで、ID サービスに送信するには、ページ上にいつ顧客 ID があればよいかがわかります。次に、顧客 ID 自体のデータ要素を作成します。Luma デモサイトで、訪問者の電子メールアドレスのハッシュバージョンを使用します。
ハッシュ化された電子メールのデータ要素を追加するには、以下を実行します。
-
「データ要素を追加」ボタンをクリックします
-
データ要素に「
Email (Hashed)
」と名前を付けます。 -
「データ要素のタイプ」で、「JavaScript変数」を選択します
-
JavaScript変数名 として、Luma サイトのデータレイヤーの変数へのポインターを使用します:
digitalData.user.0.profile.0.attributes.username
-
その他の設定はすべてデフォルト値のまま残します。
-
ライブラリに保存 をクリックして、データ要素を保存します
顧客 ID を送信するルールの追加
Adobe Experience Platform ID サービスは、「Set Customer IDs」アクションを使用して、顧客 ID をルールで渡します。訪問者が認証されたときにこのアクションをトリガーするルールを作成します。
顧客 ID を送信するルールを追加するには、以下を実行します。
-
左側のナビゲーションで、「ルール」をクリックします
-
「ルールを追加」をクリックしてルールビルダーを開きます
-
ルール名を設定します。
All Pages - Library Loaded - Authenticated - 10
ヒント
この命名規則は、ユーザーが認証され、順序が「10」の場合に、すべてのページの先頭でこのルールを実行することを示しています。 アクションでトリガーされるソリューションに対して、このような命名規則を使用すると、実装で必要とされるルールの全体的な数を最小限に抑えることができます。 -
イベント で 追加 をクリックします
- イベントタイプ で「ライブラリの読み込み(ページのトップ)」を選択し す。
- 「Advanced Options」セクションを展開し、「Order」に「
10
」と入力します。 「順番」は、同じイベントによってトリガーされるルールのシーケンスを制御します。順番が早いルールは、順番が遅いルールの前に実行されます。この場合、要求を実行する前に顧客 ID を設定しますが、次のレッスンでは順序が50
のルールを使用します。 - 「変更を保持」ボタンをクリックして、ルールビルダーに戻ります
-
条件 で 追加 をクリックします
-
条件タイプ 「値比較」を選択します。
-
-
データ要素モーダルで、「認証状態」をクリックし、「選択」をクリックします
-
-
Equals
が演算子であることを確認します。 -
テキストフィールドに「logged in」と入力します。これにより、データ要素「Authentication State」の値が「logged in」になるとルールが実行されます。
-
「変更を保持」をクリックします
-
アクション で 追加 をクリックします
-
拡張機能 で、「Experience Cloud ID サービス」を選択します
-
アクションタイプ で「顧客 ID を設定」を選択します
-
統合コード に
crm_id
と入力します -
値 にデータ要素セレクターモーダルを開き、
Email (Hashed)
を選択します -
認証状態 で 認証済み を選択します
-
「変更を保持」ボタンをクリックしてアクションを保存し、ルールビルダーに戻ります
-
-
ライブラリおよびビルドに保存 ボタンをクリックして、ルールを保存します
これで、訪問者が認証されたときに顧客 ID を crm_id
変数として送信するルールが作成されました。順序を 10
として指定したため、このルールは、「データ要素、ルール、ライブラリを追加」レッスンで作成したデフォルトの順序値(50
)を使用する All Pages - Library Loaded
ルールより前に実行されます。