概要
コンバージョン トラッキングの実装は、rwg_token の保存と返すという 2 つの部分で構成されます。これらの値は変わりませんが、コンバージョン トラッキング v2 に準拠するには、新しい値 merchant_change を返す必要があります。
トークンの永続化に対する変更
トークンを保持する場合は、アクション リンクに関連付けられた販売者を保存する必要があります。これは通常、販売者を対応する merchant_id と照合することで行われます。
次は、デバイスレベルのコンバージョン トラッキングの例で、ファーストパーティ Cookie を使ってウェブブラウザにこれらの値を保存します。この例では、トークン値を解析して変数にし、merchant_id を格納するロジックが実装されていることを前提としています。この例を使用するには、rootdomain をドメインで更新する必要があります。この推奨のアプローチがすべての人に適しているとは限らないため、パートナーは必要に応じて独自のロジックを自由に調整または実装できます。
<script>
if (typeof rwg_token !== 'undefined') {
merchant_id = // Write your own logic here assigning the merchant id value
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}
</script>
コンバージョン データの送信に関する変更
ユーザーがコンバージョン イベントを完了すると、投稿の本文は、新しいブール値 merchant_change を持つ JSON エンコード オブジェクトになります。
{
"conversion_partner_id": <partnerId>,
"rwg_token": <rwg_token_val>
"merchant_changed": 1|2
}
以前に保存された merchant_id を使用して、コンバージョン イベントをトリガーした販売者が元の販売者と異なるかどうかを判断します。販売者が変更されたかどうかを判断したら、次の表を使用して適切な merchant_change 値を返します。
| 販売者による値の変更 | 要件 |
|---|---|
| 1 | この値は、ユーザーが元の販売者のウェブサイトを離れ、貴社のプラットフォームで別の販売者から購入を完了したときに使用されます |
| 2 | この値は、顧客が元のエンティティ（販売者）を通じて取引を完了したときに使用されます。 |
コンバージョン イベントを送信する際は、有効な rwg_token を指定する必要があります。
テスト目的で、リリースの準備ができるまで、両方の環境で次のテストトークンを使用します。
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
リクエストを行う際は、環境に対応する次のエンドポイントを使用します。
- 本番環境: https://www.google.com/maps/conversion/collect
- サンドボックス: https://www.google.com/maps/conversion/debug/collect
コンバージョン アトリビューションの要件
Google が義務付けているコンバージョン アトリビューションの基準は、どの店舗においても、プレイスリンクのインタラクションに対して 30 日間のアトリビューション期間です。
このアトリビューション期間は、次のいずれかのシナリオでコンバージョン イベントが送信されることを Google が想定することを意味します。
- ユーザーが位置情報アクション リンクをクリックし、同じセッションで同じ販売者の注文を行います（販売者の変更値 = 2）
- ユーザーが位置情報アクション リンクをクリックし、その後 30 日以内に別のチャネルから戻ってきて、同じ販売者の注文を行いました。（販売者の変更値 = 2）
- ユーザーが位置情報アクション リンクをクリックし、同じセッション内で、または 30 日間の期間内の別のセッションで、別の店舗で注文を行います。（販売者の変更値 = 1）
また、ユーザーがプレイス アクション リンクからアクセスできるすべてのサーフェスからコンバージョン イベントを送信することも想定しています。例:
- デスクトップ ウェブ アプリケーションまたはモバイルウェブ アプリケーション
- モバイルアプリ（アプリのディープリンクまたはドメインの登録済みアプリ インテント経由）
トークンがユーザーレベルで格納されている場合（トークンの永続性を参照）、クロスデバイス アトリビューションを提供することが想定されます。つまり、ユーザーがパソコンでアクション リンクをクリックし、同じユーザー アカウントを使用してモバイルで取引を完了した場合、コンバージョン イベントをトリガーする必要があります。
トークンがデバイスレベル（ブラウザの Cookie など）でのみ保存されている場合、クロスデバイス アトリビューションを提供することは想定されていません。この場合、ユーザーがそのデバイス上でアクション リンクをクリックした場合、各デバイスには個別のトークンが保持され、各デバイスは個別にアトリビューション ルールに従います。