Experience Cloud ID サービスの Analytics への実装 implement-the-experience-cloud-id-service-for-analytics

次の説明は、Experience Cloud ID サービスを使用し、データ収集タグを使用しない Analytics のお客様を対象としています。ただし、タグを使用して ID サービスを実装することを強くお勧めします。タグは、実装ワークフローを効率化し、適切なコードの配置とシーケンスを自動的に保証します。

IMPORTANT

次の手順に従い、Adobe Analytics 用 ID サービスを実装します。

手順 1:ID サービスコードのダウンロード section-ead9403a6b7e45b887f9ac959ef89f7f

ID サービスでは、VisitorAPI.js コードライブラリが必要です。このコードライブラリをダウンロードするには:

  1. 管理Code Manager に移動します。

  2. Code Manager で、「JavaScript (新規)」または「JavaScript (レガシー)」をクリックします。

    圧縮されたコードライブラリがダウンロードされます。

  3. コードファイルを解凍し、VisitorAPI.js ファイルを開きます。

手順 2:ID サービスコードへの Visitor.getInstance 関数の追加 section-6053a6b7c16c466a9f9fdbf9cb9db3df

IMPORTANT
  • 以前のバージョンの ID サービス API では、この関数を別の場所に別の構文で配置する必要がありました。バージョン 1.4 より前のバージョンから移行する場合は、ここで説明する新しい場所と構文について注意してください。
  • すべて大文字で書かれたコードは、実際の値用のプレースホルダーです。このテキストを組織 ID、トラッキングサーバー URL、またはその他の指定された値に置き換えます。

パート 1:以下の Visitor.getInstance 関数をコピーします

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

パート 2:VisitorAPI.js ファイルに関数コードを追加します

Visitor.getInstance 関数をファイル末尾のコードブロックの後に配置します。編集後のファイルは以下のようになります。

/*
========== DO NOT ALTER ANYTHING BELOW THIS LINE ==========
Version and copyright section
*/

// Visitor API code library section

// Put Visitor.getInstance at the end of the file, after the code library

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

手順 3:Visitor.getInstance への Experience Cloud 組織 ID の追加 section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e

Visitor.getInstance 関数の INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE を Experience Cloud 組織 ID に置き換えます。組織 ID がわからない場合、Experience Cloud 管理ページで確認できます。管理 - コアサービスも参照してください。編集後の関数は、以下のサンプルのようになります。

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

IMPORTANT
組織 ID の大文字小文字を変更​ しない ​でください。この ID は大文字小文字が区別され、割り当てられたとおりに使用する必要があります。

手順 4:Visitor.getInstance へのトラッキングサーバーの追加 section-70ec9ebff47940d8ab520be5ec4728c5

トラッキングサーバーは、Analytics データ収集に使用されます。

パート 1:トラッキングサーバー URL の確認

s_code.js ファイルまたは AppMeasurement.js ファイルでトラッキングサーバー URL を確認します。この URL に以下の変数を指定します。

  • s.trackingServer
  • s.trackingServerSecure

パート 2:トラッキングサーバー変数の設定

使用するトラッキングサーバー変数を判断するには:

  1. 以下の判断マトリックスの質問に答えます。自分の答えに合う変数を使用します。
  2. トラッキングサーバーのプレースホルダーをトラッキングサーバー URL に置き換えます。
  3. 未使用のトラッキングサーバーおよび Experience Cloud サーバーの変数をコードから削除します。

NOTE
使用されている場合は、以下のように Experience Cloud サーバーの URL をトラッキングサーバーの URL に対応させます。
  • Experience Cloud サーバー URL = トラッキングサーバー URL
  • Experience Cloud サーバーセキュア URL = トラッキングサーバーセキュア URL

トラッキングサーバーの見つけ方がわからない場合は、FAQtrackingServer および trackingServerSecure 変数の適切な設定を参照してください。

手順 5:AppMeasurement.js または s_code.js ファイルの更新 section-b53113aea1bd4de896e0e4e9a7edee19

AppMeasurement.js または s_code.js ファイルにこの関数を追加します。

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

linkInternalFilterscharSettrackDownloads などの設定を含むセクションにこのコードを配置します。

(オプション、推奨)  カスタム prop の作成。

有効範囲を測定するために AppMeasurement.js または s_code.js にカスタム prop を設定します。このカスタム prop を doPlugins ファイルまたは AppMeasurement.js ファイルの s_code.js 関数に追加します。

// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

手順 6:ページへの Visitor API コードの追加 section-d46d6aa324c842f2931d901e38d6db1d

VisitorAPI.js ファイルを各ページの <head> タグ内に配置します。VisitorAPI.js ファイルをページに配置する際には、以下のようにします。

  • タグは <head> セクションの先頭に配置して、他のソリューションタグより先に表示させます。
  • AppMeasurement およびその他の Experience Cloud ソリューションのコードより前に実行する必要があります。

テストと検証の後にこのコードを本番に移行します。

手順 7:(オプション)猶予期間の設定 section-7bbb2f72c26e4abeb8881e18366797a3

これらの使用例のいずれかがお客様の状況に当てはまる場合は、カスタマーケアまでお問い合わせいただき、一時的な猶予期間を設定するよう依頼してください。猶予期間は最大 180 日です。必要に応じて、猶予期間を更新できます。

部分的実装

ID サービスを使用するページと使用しないページが混在し、そのすべてのページが同じ Analytics レポートスイートで管理される場合は、猶予期間が必要です。この状況は、複数のドメインで管理されるグローバルなレポートスイートがある場合に一般的です。

同じレポートスイートで管理されるすべての Web ページに ID サービスをデプロイした後に、猶予期間を停止します。

s_vi Cookie の要件

新しい訪問者が ID サービスへの移行後に s_vi Cookie を使用する必要がある場合、猶予期間が必要です。この状況は、実装で s_vi Cookie を読み取って変数に保存している場合に一般的です。

実装で s_vi Cookie を読み取る代わりに MID を取得できるようになった後に、猶予期間を停止します。

Cookie と Experience Cloud ID サービスを参照してください。

クリックストリームデータフィードから内部システムにデータを送信していて、そのプロセスで visid_high 列と visid_low 列を使用している場合、猶予期間が必要です。

データ収集プロセスで post_visid_high 列と post_visid_low 列を使用できるようになった後で、猶予期間を停止します。

クリックストリームデータ列リファレンスを参照してください。

クリックストリームデータの取り込み

手順 8:ID サービスコードのテストとデプロイ section-e9c1764ac21a4ec5be1ff338c0e2e01b

次のようにテストおよびデプロイできます。

テストと検証

ID サービスの実装状況をテストするには、以下の項目を確認します。

詳しくは、Experience Cloud ID サービスのテストと検証を参照してください。

コードのデプロイ

テストの合格後に、コードをデプロイします。

手順 7 で猶予期間を有効にした場合:

  • Analytics ID(AID)と MID がイメージリクエストに含まれていることを確認します。
  • 停止条件が満たされたら、必ず猶予期間を無効にします。
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a