実装
概要
コンバージョン トラッキングの実装は、次の 3 つの要素で構成されています。
-
rwg_token
の収集 (ランディング ページやアプリのエントリ ポイントから) -
rwg_token
の永続化 適切なアトリビューション期間を選択 - 購入手続き時にコンバージョン イベントを送信する
このコンバージョン トラッキングの実装では、 Google アナリティクスまたはその他のサードパーティ JavaScript。
<ph type="x-smartling-placeholder">コンバージョン トラッキングの実装を始める前に、 デバイス単位またはユーザー単位でコンバージョンをトラッキングする場合:
- デバイス単位には、ブラウザ 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">
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 を使用するため、クロスデバイス コンバージョンを あります。この場合、各デバイスは個別のトークンを持ちます。 ユーザーがそのデバイスでアクション リンクをクリックした場合は持続する 各デバイスは個別にアトリビューション ルールに従います。