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

<ph type="x-smartling-placeholder">

</ph> 目標: コンバージョン トラッキングを実装する: 予約とビジネスリンクの統合。

で確認できます。 <ph type="x-smartling-placeholder">

</ph> 警告: コンバージョン データの一部として、 個人識別情報（PII）が Google に送信されることはありません。

実装

概要

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

1. rwg_token の収集 （ランディング ページやアプリのエントリ ポイントから）
2. rwg_token の永続化 適切なアトリビューション期間を選択
3. 購入手続き時にコンバージョン イベントを送信する

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

<ph type="x-smartling-placeholder">

</ph> 重要なポイント: コンバージョンの実装には 2 つのレベルがあります。 トラッキング、デバイスレベル、ユーザーレベルです。この期間中は、どちらもサポートされます。 プロダクトのアーキテクチャに基づいて選択できます。

コンバージョン トラッキングの実装を始める前に、 デバイス単位またはユーザー単位でコンバージョンをトラッキングする場合:

• デバイス単位には、ブラウザ Cookie、ローカル ストレージ、アプリのローカル ストレージ、または永続化できる 30 日間のアトリビューション期間のトークンです。トークンは、 ユーザーが変更した場合、そのユーザーのデバイスのローカルに保存されます。 使用しているデバイスの確認、ローカル ストレージや Cookie の消去、 シークレット ブラウジングまたはシークレット モードを使用している場合、コンバージョン イベントが 適切にアトリビューションされない場合がありますデバイス単位の使用時 すべてのコンバージョンで再実装する必要があります。 対応サーフェス（モバイルを含む）
• ユーザーレベルには、アプリケーションでの永続化が含まれます。 サーバーサイドの解析システムや サーバー側システムです。トークンはローカルのデータベースに保存され、 サーバーサイドで、ユーザーが使用しているデバイスを変更すると、 ローカル ストレージ/Cookie を使用してアクセスしたり、シークレット ブラウジングや シークレット モードでは、コンバージョン イベントへの貢献度は ユーザーが再度ログインします。ユーザー単位のコンバージョントラッキングでは システムのアーキテクチャによっては、 サーバーサイドに実装すれば、すべての環境で再利用できます。 サポートしています。

rwg_token を収集する

ニュース メディアから提供された action_link を Google が表示するたびに 一意のクエリが含まれるように URL が パラメータ: rwg_token。rwg_token value はエンコードされた文字列で、 ユーザーがクリックしたリンクですこのトークンを保存し、 コンバージョンイベントの一部になります

ランディング ページまたはアプリのエントリ ポイントごとに、設定された値を解析する必要がある rwg_token クエリ パラメータを指定して保存します。要件 このパラメータの格納については、ステップ「 rwg_token。

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

<script>
  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;
    }
  }
</script>

rwg_token の永続化

<ph type="x-smartling-placeholder">

</ph> 注: rwg_token を永続化することは、 必要なアトリビューション期間を実装しますこのモジュールの詳細については、 帰属表示の要件については、をご覧ください。 コンバージョン アトリビューションの要件をご覧ください。

rwg_token URL パラメータを保持する必要があります。これにより、 は、指定したすべてのアクション リンクに追加され、 適用できます。rwg_token の値は、次のようになります。 編集されずに保管されて返されます。 前回のアクセスで保持されている既存のトークンがある場合は、 古いトークンは置き換えられ、30 日間の保存期間が適用されます。 リセットされます

トークンを永続化する場合は、トークンを デバイスレベルまたはユーザーレベルで定義できます。

• デバイスレベルには、ブラウザ Cookie、ローカル ストレージ、 アプリのローカル ストレージ、またはトークンを永続化できる 過去 30 日間のアトリビューション期間が 30 日間に計算されます
• ユーザーレベルには、アプリケーション データベースでの永続化が含まれます。 サーバーサイドの解析システムや その他のサーバーサイドのシステムを通じて

以下は、デバイス単位のコンバージョン トラッキングの例です。 このトークンをウェブブラウザに保存すると、最初の できます。この例では、ユーザーがトークン値を解析済みであることを前提としています。 変数に変換します。この例を使用するには 「rootdomain」をご自身のドメインに更新する必要があります。

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

ユーザー単位のコンバージョン トラッキングを使用する場合は、rwg_tokenで次のように設定する必要があります。 サーバーに保存され、ユーザーと関連付けられます。

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

コンバージョンを達成したユーザーが 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>
}

サンドボックスと本番環境の両方で、次のことを行う必要があります。 コンバージョン イベントの送信時に有効な rwg_token を指定してください。 サンドボックス環境でのテストを目的として、以下を使用できます。 あります。

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

<ph type="x-smartling-placeholder">

</ph> 注: 本番環境では、そうでないコンバージョン イベントを送信しないでください。 関連付けられます必ず、有効で、かつ イベント送信前に期限切れでない rwg_token 値を使用すること。

デバイス単位のコンバージョン トラッキングの詳細な例（Google の 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
    })
  });
}

ユーザー単位のコンバージョン トラッキングを使用する場合は、 （サーフェスにかかわらず、ユーザーに関連付けられている） サーバーサイド ストレージ メカニズムから呼び出し、 同じ本番環境またはサンドボックスのエンドポイントを使用して、トークンを配布できます。

<ph type="x-smartling-placeholder">

</ph> 注: コンバージョン イベントは、ウェブ クライアントまたはアプリ クライアントから送信できます。 取得します。この決定は、 トークンの保存場所に応じて異なりますが、 コンバージョンごとに 1 回だけ送信され、有効な rwg_token の値。

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

Google が義務付けているコンバージョン アトリビューションの基準は 30 日間です。 場所のリンクがクリックされた場合のアトリビューション期間です。 あります

<ph type="x-smartling-placeholder">

</ph> 注: このアトリビューションのフレームワークは、 コンバージョンへの貢献度が決定されますこのシステムは 使用するコンバージョン トラッキングとは独立して動作するように設計されており、 その値がシステム内のデータに影響を与えず 分析できます

このアトリビューション期間では コンバージョンの発生が予想されます イベントが送信されます。

• ユーザーが位置情報アクション リンクをクリックし、 同じセッション
• ユーザーが位置情報アクション リンクをたどってから、 注文するには、30 日以内に別のチャネルに注文する必要があります。
• ユーザーが位置情報アクション リンクをクリックし、 同じセッション内または異なるセッション内での 過去 30 日間に 1 回の課金となります

さらにコンバージョンイベントは 場所アクション リンクからアクセスできるサーフェス。例:

• デスクトップまたはモバイルウェブ アプリケーション
• モバイルアプリ（アプリのディープリンクまたは登録済みの URL を使用） 自分のドメインの app-intent

トークンがユーザーレベルで保存されている場合 （トークンの永続化を参照）は、 クロスデバイスアトリビューションがありますつまり デスクトップからアクション リンクをたどり、 トランザクションを発生させ、 追加できます

トークンがデバイスレベルでのみ保存されている場合（ ブラウザ Cookie を使用するため、クロスデバイス コンバージョンを あります。この場合、各デバイスは個別のトークンを持ちます。 ユーザーがそのデバイスでアクション リンクをクリックした場合は持続する 各デバイスは個別にアトリビューション ルールに従います。