Google Ads コンバージョンコネクタ構成ガイド | サーバーサイドコネクタ

コネクタのアクション

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

API情報

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

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

バッチ制限

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

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

遅延アクション

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

EventStreamまたはAudienceStreamでtraceを使用するとき、アクションは遅延しません。

構成の構成

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

コネクタを追加した後、以下の構成を構成します：

アクション構成 - パラメータとオプション

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

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

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

パラメータ

パラメータ	説明
顧客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`

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

パラメータ

パラメータ	説明
顧客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`メッセージ内のものと同じです。複数のアイテムを追加するために配列を使用します。配列型の属性は等しい長さでなければなりません。

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

コンバージョンが報告されてから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が期待する形式に変換されます。
通貨コード	再記述値の通貨。提供されない場合、コンバージョンアクションからのデフォルトの通貨が使用されます。

アクション — コンバージョンの撤回

コンバージョンが報告されてから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が期待する形式に変換されます。

リアルタイムWebトラフィックに対する考慮事項

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

このコネクタをこのように使用するための以下の戦略のいずれかを考慮してください：

ファイルインポートまたはCollect APIを使用して歴史的なコンバージョンデータをアップロードします。

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