コンバージョン トラッキング

実装

概要

コンバージョン トラッキングの実装は、次の 3 つの要素で構成されています。

• ランディング ページ / アプリから rwg_token と merchant_id を収集する あります。
• 適切なアトリビューションが行われるように rwg_token と merchant_id を保持する クリックします。
• コンバージョン時に維持されているmerchant_idとmerchant_idを比較する （予約完了）。
• コンバージョンの日時にコンバージョン イベントを送信する（予約完了）。

このコンバージョン トラッキングの実装では、Google アナリティクスまたはその他のサードパーティ JavaScript。

コンバージョン トラッキングの実装を始める前に、以下の準備が必要です。 コンバージョンをデバイス単位とユーザー単位のどちらでトラッキングするかを決めます。

• デバイスレベルには、ブラウザ Cookie、ローカル ストレージ、アプリローカルの使用が含まれます トークンを 30 日間保持できるその他の方法で アトリビューション期間。トークンはユーザーのローカル バックエンドに保存されるため、 ユーザーが使用しているデバイスを変更すると、ローカル ブラウザや シークレット モードまたはシークレット モードを使用している場合、 適切にアトリビューションされない場合がありますデバイス単位の使用時 コンバージョン トラッキングを導入する場合は、サポートされているすべての 。
• ユーザーレベルでは、 サーバーサイドの解析システムやその他のサーバーサイドのシステムです。これは、 ユーザーがデバイスを変更すると、トークンがサーバーサイドに保存されます。 ローカル ストレージや Cookie を消去したり、プライベート シークレット モードでは、引き続きコンバージョン イベントは 1 回のみ関連付けられます。 ユーザーが再度ログインします。ユーザー単位のコンバージョン トラッキングを使用する場合 システムのアーキテクチャによっては 一度設定すれば サポートされているすべてのサーフェスで再利用できます。

rwg_token を収集する

フィードで指定した action_link が Google に表示されるたびに、 この URL は、一意のクエリ パラメータ rwg_token を含むように変更されています。「 rwg_token 値はエンコードされた文字列で、 ユーザーがクリックしたがユーザーデータがないリンク。このトークンを保存し、 コンバージョンイベントの一部として返すことができます

ランディング ページまたはアプリのエントリ ポイントごとに、 rwg_token クエリ パラメータを作成して保存します。これを保存するための要件 パラメータについては、rwg_token の永続化の手順をご覧ください。

デバイスレベルのトラッキングのためにこのトークンを解析する方法の例 ブラウザは以下に含まれています。または、このトークンを サーバー側でリクエストに応答します。

var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
  var pair = params[i].split('=');
  if (pair[0] == 'rwg_token') {
    rwgToken = decodeURIComponent(pair[1]);
    break;
  }
}

merchant_id を収集する

コンバージョン トラッキングのロジックをフロントエンド（ランディング）に実装する場合 そのページ内の URL を検索してキャプチャするカスタム スクリプトを merchant_id。通常、merchant_id はデータベースにすでに存在している可能性があります。 ランディング ページや URL に挿入して、そこから取得できるようにします。そうでない場合は、 それをどこかに暴露してキャプチャ可能とすれば 変更します。

バックエンドでコンバージョン トラッキングのロジックを実装すると、 merchant_id は、内部システムにクエリを実行して生成するデータと一緒に使用できます。 表示されます。

この merchant_id は、Google と共有しているものと同じである必要があります 追加できます

rwg_token と merchant_id の永続化

rwg_token URL パラメータを保持する必要があります。これは、 ユーザーが指定したすべてのアクション リンクに追加され、合計 30 日間継続されます。 rwg_token の値は、編集せずに保存し、返す必要があります。

rwg_token とともに、関連付けられた merchant_id を保存する必要があります。 アクション リンクを追加します。

前回のアクセスで保持されている既存のトークンがある場合は、 rwg_token と merchant_id を置き換える必要があり、有効期間は 30 日間です。 リセットする必要があります

上記のペアを永続化する場合は、デバイスに値を保存するか、 またはユーザーレベルで定義できます。

• デバイスレベルには、ブラウザ Cookie、ローカル ストレージ、アプリローカルの使用が含まれます トークンを 30 日間保持できるその他の方法で アトリビューション期間。
• ユーザーレベルでは、 サーバーサイドの解析システムやその他のサーバーサイドのシステムです。

以下はデバイスレベルのコンバージョン トラッキングの例です。これらの値は ファーストパーティ Cookie を使用するウェブブラウザ。この例では、事前トレーニング済みコンポーネントを 変数に代入することもできます。この例を使用するには、次の操作を行います。 rootdomain.com をドメインに更新する必要があります。

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

ユーザー単位のコンバージョン トラッキングを使用する場合は、rwg_token と merchant_id を使用します。 サーバーに保存され、ユーザーと関連付けられます。

コンバージョン データの送信

Google プレイスに起因する取引をユーザーが完了したとき アクション リンク。HTTP POST リクエストをコンバージョン エンドポイントに送信する必要があります。 エンドポイントは 2 つあります。1 つは本番環境用、もう 1 つは本番環境用です。 できます。

• 本番環境: https://www.google.com/maps/conversion/collect
• サンドボックス: https://www.google.com/maps/conversion/debug/collect

POST 本文は、次の形式の JSON エンコード オブジェクトである必要があります。

{
  "conversion_partner_id": <partnerId>,
  "rwg_token": <rwg_token_val>,
  "merchant_changed": 1|2
}

例（パートナー 20123456 のテストトークンを含む未変更の販売者）:

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
  "merchant_changed": 2
}

Merchant_changed の値は、販売者が変更されたかどうかを判断するために使用されます。 最初のリダイレクト販売者の広告ですモデルタイプに

サンドボックス環境と本番環境の両方で、クラウド環境と コンバージョン イベントの送信時に有効な rwg_token。テスト目的では、 次のテストトークンを両方の環境でテストする必要があります。

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

サンドボックスでテストするには、次の URL パラメータを手動で テストします。

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

デバイス単位のコンバージョン トラッキングの詳細な例（ユーザーの Cookie を使用） POST リクエストを行う方法の JavaScript で指定する例を以下に示します。

const partnerId = XXXXXXXXXX;

const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal,
      merchant_changed: merchantChanged
    })
  });
}

ユーザー単位のコンバージョン トラッキングを使用する場合は、 ユーザーが（どのサーフェスにあるかにかかわらず） 使用してトークンを送信します。 サンドボックスのエンドポイントです。

コンバージョン アトリビューションの要件

Google が義務付けているコンバージョン アトリビューションの基準は、30 日間のアトリビューションです。 どの店舗でも、場所のリンクの操作に関するウィンドウ。

このアトリビューション期間では、Google が予測しているコンバージョン イベントが 送信される可能性があります。

• ユーザーが位置情報アクション リンクをクリックし、同じ販売者の商品を注文した あります。（販売者の変更値 = 2）
• 位置情報アクション リンクをクリックしたユーザーが、別のチャネルから戻ってくる 注文するには、30 日以内に行う必要があります。（販売者 値の変更 = 2 ）
• ユーザーが位置情報アクション リンクをクリックし、別の店舗で注文を確定した または 30 日以内に発生した別のセッションで クリックします。（販売者の変更値 = 1）

さらに Google では、コンバージョン イベントは 場所アクション リンクから確認できます。例:

• デスクトップまたはモバイルウェブ アプリケーション
• モバイルアプリ（アプリのディープリンクまたは登録済みアプリ インテント） ご利用のドメイン

トークンがユーザーレベルで保存されている場合（「トークンの永続化」を参照）は、 クロスデバイス アトリビューション モデルを提供することを前提としています。つまり、フォローしているユーザーが パソコンでアクション リンクをクリックし、モバイルで取引を完了する （同じユーザー アカウントを使用）コンバージョン イベントをトリガーします。

トークンがデバイスレベルでのみ保存されている場合（ブラウザなど） クロスデバイス アトリビューションは想定されていません。この 各デバイスには個別のトークンがあり、ユーザーが そのデバイスのアクション リンクが表示され、各デバイスはアトリビューションをたどります。 構成する必要があります。