実装
概要
コンバージョン トラッキングの実装は、次の 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 の値は、販売者が変更されたかどうかを判断するために使用されます。 最初のリダイレクト販売者の広告ですモデルタイプに
販売者の変更値 | 要件 |
---|---|
1 | この値は、ユーザーが 元の販売者のウェブサイトで購入を完了 プラットフォームを介して |
2 | この値は、お客様が ユーザーが元のエンティティを通じてトランザクションを (販売者)。 |
サンドボックス環境と本番環境の両方で、クラウド環境と
コンバージョン イベントの送信時に有効な 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 では、コンバージョン イベントは 場所アクション リンクから確認できます。例:
- デスクトップまたはモバイルウェブ アプリケーション
- モバイルアプリ(アプリのディープリンクまたは登録済みアプリ インテント) ご利用のドメイン
トークンがユーザーレベルで保存されている場合(「トークンの永続化」を参照)は、 クロスデバイス アトリビューション モデルを提供することを前提としています。つまり、フォローしているユーザーが パソコンでアクション リンクをクリックし、モバイルで取引を完了する (同じユーザー アカウントを使用)コンバージョン イベントをトリガーします。
トークンがデバイスレベルでのみ保存されている場合(ブラウザなど) クロスデバイス アトリビューションは想定されていません。この 各デバイスには個別のトークンがあり、ユーザーが そのデバイスのアクション リンクが表示され、各デバイスはアトリビューションをたどります。 構成する必要があります。