ステップ 3: コンバージョン トラッキング

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

実装

概要

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

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

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

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

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

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

rwg_token を収集する

ニュース メディアから提供された action_link を Google が表示するたびに 一意のクエリが含まれるように URL が パラメータ: rwg_tokenrwg_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">

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">

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

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

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

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

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

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

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

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

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

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