Google Adsコンバージョンコネクタのセットアップガイド | サーバーサイドコネクタ

コネクタのアクション

アクション名	AudienceStream	EventStream
通話コンバージョンのアップロード	✓	✓
クリックコンバージョンのアップロード	✓	✓
コンバージョンの再記述	✓	✓
コンバージョンの取り消し	✓	✓

API情報

このコネクタは次のベンダーAPIを使用します：

API名：Google Ads API
APIバージョン：v15
APIエンドポイント：https://googleads.googleapis.com/
ドキュメント：Google Ads API

バッチ制限

このコネクタは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：2000
最も古いリクエストからの経過時間の最大値：10分
リクエストの最大サイズ：2MB

遅延アクション

Googleのベストプラクティスに従い、オフラインコンバージョンのアップロードを受け入れるために、アクションは30分遅延されます。Googleキャンペーンマネージャー360 Floodlightコネクタを使用した遅延アクションの詳細については、Googleのオフラインコンバージョンのアップロードのベストプラクティスドキュメントを参照してください。

EventStreamまたはAudienceStreamでトレースを使用する場合、アクションは遅延されません。

同意

コネクタは、デフォルトでadUserDataとadPersonalizationの同意の値をGRANTEDとして送信します。デフォルトを上書きするには、関連するEventStream属性をAd User Data Consentおよび/またはAd Personalization Consentにマッピングし、値をDENIEDに設定します。

設定の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な手順については、コネクタについての記事を参照してください。

コネクタを追加した後、次の設定を構成します：

アクション設定 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでは、コネクタのアクションを構成します。

このセクションでは、各アクションのパラメータとオプションの設定方法について説明します。

アクション - 通話コンバージョンのアップロード

パラメータ

パラメータ	説明
顧客ID	顧客アカウントIDを選択します。利用可能なオプションは、認証されたユーザーのアクセス可能な顧客アカウントを反映します。
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google Adsコンバージョントラッキングを参照してください。
発信者ID	必須この通話が行われた発信者IDです。発信者IDはE.164形式で指定し、プラス（`+`）文字で先行する必要があります。例：`+16502531234`
通話開始日時	必須通話が発生した日時です。タイムゾーンを指定する必要があります。形式はyyyy-mm-dd hh:mm:ssです。例：`2020-01-01 12:32:45-8:00`。
コンバージョン日時	必須コンバージョンが発生した日時です。通話時間より後である必要があります。タイムゾーンを指定する必要があります。形式はyyyy-mm-dd hh:mm:ssです。例：`2020-01-01 12:32:45-8:00`。
コンバージョン値	広告主のコンバージョンの値です。
通貨コード	コンバージョン値に関連する通貨です。これはISO 4217の3文字の通貨コードです。例：`USD`、`EUR`
Ad User Data Consent	広告ユーザーデータの同意。デフォルト値は`GRANTED`です。有効な値は`GRANTED`および`DENIED`です。

アクション - クリックコンバージョンのアップロード

パラメータ

パラメータ	説明
顧客ID	顧客アカウントIDを選択します。利用可能なオプションは、認証されたユーザーのアクセス可能な顧客アカウントを反映します。
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google Adsコンバージョントラッキングを参照してください。
GoogleクリックID	必須このコンバージョンに関連するGoogleクリックID（`gclid`）です。
コンバージョン日時	必須コンバージョンが発生した日時です。クリック時間より後である必要があります。タイムゾーンを指定する必要があります。形式はyyyy-mm-dd hh:mm:ssです。例：`2020-01-01 12:32:45-8:00`。
コンバージョン値	広告主のコンバージョンの値です。
通貨コード	コンバージョン値に関連する通貨です。これはISO 4217の3文字の通貨コードです。例：`USD`、`EUR`
注文ID	必須コンバージョンに関連する注文IDです。注文IDは1つのコンバージョンアクションに対してのみ使用できます。
外部帰属クレジット	Google Adsクリックに帰属されるコンバージョンの割合を表します。
外部帰属モデル	帰属モデルの名前を指定します。詳細については、Google Ads APIクリックコンバージョンを参照してください。
マーチャントID	アイテムがアップロードされるマーチャントセンターIDです。
フィード国コード	アイテムがアップロードされるフィードに関連する国コードです。
フィード言語コード	アイテムがアップロードされるフィードに関連する言語コードです。
ローカルトランザクション	カート全体の無料配送やクーポン割引などのすべてのトランザクションレベルの割引の合計です。通貨コードは`ClickConversion`メッセージと同じです。
商品ID	アイテムのショッピングIDです。マーチャントセンターの商品識別子と等しくする必要があります。複数のアイテムを追加するには、配列を使用します。配列タイプの属性は同じ長さである必要があります。
数量	販売されたアイテムの数です。複数のアイテムを追加するには、配列を使用します。配列タイプの属性は同じ長さである必要があります。
単価	税金、配送料、およびトランザクションレベルの割引を除いた単価です。通貨コードは`ClickConversion`メッセージと同じです。複数のアイテムを追加するには、配列を使用します。配列タイプの属性は同じ長さである必要があります。
Ad User Data Consent	広告ユーザーデータの同意。デフォルト値は`GRANTED`です。有効な値は`GRANTED`および`DENIED`です。

アクション — コンバージョンの再記述

コンバージョンを調整する前に、報告されたコンバージョンから24時間待機してください。これにより、CONVERSION_NOT_FOUNDまたはTOO_RECENT_CONVERSIONエラーが発生するのを防ぐことができます。

パラメータ

パラメータ	説明
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google Adsコンバージョン調整を参照してください。
再記述値	(必須) 再記述後のコンバージョンの値です。
再記述日時	(必須) 調整が行われた日時です。形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。
注文ID	注文IDまたはGoogleクリックIDとコンバージョン日時のいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。
GoogleクリックID	注文IDまたはGoogleクリックIDとコンバージョン日時のいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。
コンバージョン日時	使用する場合、形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmである必要があります。日付属性はGoogleが期待する形式に変換されます。
通貨コード	再記述値の通貨です。指定しない場合は、コンバージョンアクションのデフォルト通貨が使用されます。

アクション — コンバージョンの取り消し

パラメータ

パラメータ	説明
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google Adsコンバージョン調整を参照してください。
取り消し日時	(必須) 取り消しが行われた日時です。形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。
注文ID	注文IDまたはGoogleクリックIDとコンバージョン日時のいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。
GoogleクリックID	注文IDまたはGoogleクリックIDとコンバージョン日時のいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。
コンバージョン日時	使用する場合、形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmである必要があります。日付属性はGoogleが期待する形式に変換されます。

リアルタイムWebトラフィックの考慮事項

GoogleクリックIDに関連付けられたクリックスルーは、コネクタをアクティブ化する前に少なくとも6時間前に発生している必要があります。これにより、Googleがリクエストを拒否しないようにすることができます。リアルタイムWebトラフィックのアクティベーションにこのコネクタを使用する場合、追加の考慮が必要です。なぜなら、多くのGoogleクリックIDがコンバージョンイベントよりも6時間以内に発生したクリックに関連付けられているためです。

次のいずれかの戦略を使用して、このようにコネクタを使用することを検討してください：

ファイルインポートまたはCollect APIを使用して、過去のコンバージョンデータをアップロードします。

データをGoogleシートに送信し、データを手動でGoogle Adsにアップロードします。