Google Analytics 4 Audiences

​

前提条件

• JSON形式のサービスアカウントの認証情報。圧縮ツールを使用してこのファイルをパスワード保護し、ファイルとパスワードは別々に送付してください。
• プロジェクトのプロパティID。
• Kameleoonプロジェクトのサイトコード。

​

ステップ1：サービスレベルアカウントによる認証をセットアップする

• プロジェクトとサービスアカウントを生成するために使用する、Google Analyticsへの管理者アクセス権を持つメールアカウント。
• このアカウントに対する、すべての必要なオーディエンス（GA4内）へのアクセス権。

​

Google Cloud Consoleでプロジェクトを作成する

​

適切なAPIを有効化する

• Google Analytics Reporting API
• Google Analytics Data API
• Google Analytics API

​

サービスレベルアカウントを作成する

​

プロパティに対するサービスアカウントのViewer権限を付与する

1. GA4アカウントにサインインします。
2. 管理する特定のGA4プロパティを選択します。
3. 管理設定にアクセスします。
4. Property User Management または Property Access Management オプションを探します。
5. + > Add user をクリックします。

6. Email addresses フィールドに、アクセスが必要なサービスアカウントに関連付けられたメールアドレスを入力します。
7. Standard roles セクションで Viewer を選択します。
8. Add をクリックします。

​

ステップ2：GA4カスタムディメンションへKameleoon visitorcodeをプッシュする

​

gtag.jsを使用する

​

1. visitorCodeをGA4にプッシュする

      if (Kameleoon.API.CurrentVisit.pageViews === 1) {
    Kameleoon.API.Core.runWhenConditionTrue(
      function () {
        return typeof window.google_tag_data !== "undefined";
      },
      function () {
        gtag.push({ 'event': 'Kameleoon Visitor Code', 'kameleoon_visitor_code': Kameleoon.API.Visitor.code });
      },
      500
    );
  }

​

2. GA4でカスタムディメンションを作成する

​

Google Tag Managerを使用する

​

1. visitorCodeをdataLayerにプッシュする

 if (Kameleoon.API.CurrentVisit.pageViews === 1) {
   Kameleoon.API.Core.runWhenConditionTrue(
     function () {
       return typeof window.google_tag_manager !== "undefined";
     },
     function () {
       dataLayer.push({ 'event': 'Kameleoon Visitor Code', 'kameleoon_visitor_code': Kameleoon.API.Visitor.code });
     },
     500
   );
 }

​

2. GTM変数を追加する

• Name： kameleoon_visitor_code
• Variable configuration：
  • Type： Data Layer Variable
  • Data Layer Variable Name： Kameleoon Visitor Code

​

3. GTMでタグを作成する

1. 変数を作成する

1. GTMへ移動： Google Tag Managerを開き、コンテナへ移動します。
2. Variablesへ移動： 左側のメニューで Variables をクリックします。
3. 新しい変数を作成： User-Defined Variables の下で New をクリックします。
4. 変数の種類を選択： Variable Configuration をクリックし、Data Layer Variable を選択します。
5. 変数を構成：
   • Name： kameleoon_visitor_code
   • Variable type： Data Layer Variable
   • Data Layer Variable Name： Kameleoon Visitor Code
6. 変数を Save します。

2. トリガーを作成する

1. Triggersへ移動： 左側のメニューで Triggers をクリックします。
2. 新しいトリガーを作成： New をクリックします。
3. トリガーの種類を選択： Trigger Configuration をクリックし、Custom Event を選択します。
4. トリガーを構成：
   • Trigger name： トリガーにわかりやすい名前を付けます（例：「Page Type is Product」）。
   • Event name： トリガーの基にしたいイベント名を入力します。任意のイベントで起動させたい場合は空のままにしておきます。
   • This trigger fires on： Some Custom Events を選択します。
   • Conditions： dataLayer 変数の条件を設定します。

5. トリガーを保存： Save をクリックします。

3. トリガーをタグに添付する

1. Tagsへ移動： 左側のメニューで Tags をクリックします。
2. タグを作成または編集： タグを作成するか、既存のタグを編集します。
3. トリガーを添付：
   • タグの構成で Triggering セクションまでスクロールします。
   • Triggering をクリックし、作成したトリガーを選択します。
4. タグを保存： Save をクリックします。

​

ステップ3：KameleoonでGA4オーディエンスを使用するためのカスタムデータを作成する

 Kameleoon.API.Data.retrieveDataFromRemoteSource(Kameleoon.API.Visitor.code, function(data) {
     for (const [key, value] of Object.entries(data)) {
         Kameleoon.API.Data.setCustomData('GA4 Audiences',key)
     }
 });
 return { "value": null} 

var xhr = new XMLHttpRequest();

xhr.open(
  "GET",
    "https://integrations.kameleoon.com/ga4-audience?sitecode=[SITECODE]&web_property=[WEB_PROPERTY]",
  false
);

var GA4Audiences = [];

xhr.onreadystatechange = function () {
  if (this.readyState === XMLHttpRequest.DONE && this.status === 200) {
    var audiences = JSON.parse(xhr.response);

    audiences.map(function (audience) {
      if (audience) {
        GA4Audiences.push({ value: audience, label: audience });
      }
    });
  }
};

xhr.send();

return GA4Audiences;

​

サーバーサイド用の外部セグメント同期