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

動作原理

Google Ads のコンバージョンは、広告をクリックした後やディスプレイネットワーク広告を閲覧した後にユーザーが特定のアクションを実行したときに発生します。Google Ads コンバージョンコネクタは Google Ads API を使用しており、オフラインコンバージョンのアップロードや以前に取得したコンバージョン値の調整をサポートしています。このコネクタを使用して、電話や営業担当者を通じてオフラインで販売につながった広告を追跡するためにオフラインクリックコンバージョンを Google Ads にアップロードできます。広告が電話を引き起こし、それらの電話が価値ある顧客アクションにつながる場合の追跡のためにオフラインコールコンバージョンをアップロードできます。

要件

オフラインコンバージョンを送信するには、Google Ads インポートコンバージョンアクションを構成し、ソースとして電話またはクリックを指定します。詳細については、Google ヘルプドキュメントのオフラインコンバージョンに関するページを参照してください。
コンバージョンを調整するには、元のコンバージョンのトランザクション ID を持っているか、gclid とコンバージョンの日時を使用して調整したいコンバージョンを特定する必要があります。

コネクタアクション

アクション名	AudienceStream	EventStream
Upload Call Conversion - Legacy	✓	✓
Upload Click Conversion - Legacy	✓	✓
Conversion Restatement	✓	✓
Conversion Retraction	✓	✓
Upload Call Conversion	✓	✓
Upload Click Conversion	✓	✓

API 情報

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

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

バッチ制限

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

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

遅延アクション

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

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

同意

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

構成の構成

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

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

Customer ID: 管理する広告アカウントの顧客 ID を入力するか、アクション構成の動的オーバーライドフィールドを使用します。
Manager Customer ID: 管理されたアカウントにアクセスする場合は、Manager Customer ID と Customer ID を入力します。

コネクタの構成が完了したら、完了をクリックします。

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

コネクタアクションの構成を続けるには、続行をクリックします。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

アクション - Upload Call Conversion - Legacy

パラメータ

パラメータ	説明
Customer ID	必須。顧客アカウント ID を選択します。認証されたユーザーがアクセスできる顧客アカウントのオプションが表示されます。
Conversion Action	必須。既存のコンバージョンアクションを選択します。`UPLOAD_CALLS` タイプの Google Ads コンバージョンアクションのみが表示されます。詳細については、Google: Google Ads コンバージョントラッキングを参照してください。

コンバージョンデータパラメータ

パラメータ	説明
Caller ID	必須。この通話が発信された発信者 ID。発信者 ID は E.164 形式で、プラス (`+`) 文字が先行します。例：`+16502531234`。
Call Start Datetime	必須。通話が発生した日時。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss±hh:mm です。例：`2020-01-01 12:32:45-8:00`。
Conversion Datetime	必須。コンバージョンが発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss±hh:mm です。例：`2020-01-01 12:32:45-8:00`。
Conversion Value	広告主にとってのコンバージョンの価値。
Currency Code	コンバージョン値に関連する通貨。ISO 4217 の 3 文字の通貨コードです。例：`USD` または `EUR`。

オプションパラメータ

パラメータ	説明
Conversion Action Override	Conversion Action パラメータを上書きするためのコンバージョンアクション ID を提供します。このフィールドを使用すると、Conversion Action ID パラメータに EventStream 変数を入力できます。
Custom Variables	このコンバージョンに関連するカスタム変数。詳細については、Google: Custom Variableを参照してください。
Ad User Data Consent	広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。

アクション - Upload Click Conversion - Legacy

パラメータ

パラメータ	説明
Customer ID	顧客アカウント ID を選択します。認証されたユーザーがアクセスできる顧客アカウントのオプションが表示されます。
Conversion Action	既存のコンバージョンアクションを選択します。詳細については、Google: Google Ads コンバージョントラッキングを参照してください。

コンバージョンデータパラメータ

パラメータ	説明
Google Click ID	必須。このコンバージョンに関連する Google クリック ID (`gclid)`。Google Click ID、`gbraid`、または `wbraid` が必要です。
Conversion Datetime	必須。コンバージョンが発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss±hh:mm です。例：`2020-01-01 12:32:45-8:00`。
Conversion Value	広告主にとってのコンバージョンの価値。
Currency Code	コンバージョン値に関連する通貨。ISO 4217 の 3 文字の通貨コードです。例：`USD` または `EUR`。
Order ID	必須。コンバージョンに関連する注文 ID。注文 ID は、コンバージョンアクションごとに 1 つのコンバージョンにのみ使用できます。
External Attribution Credit	このパラメータは、Google Ads クリックに帰属するコンバージョンの割合を表します。
External Attribution Model	指定された帰属モデル名。詳細については、Google: Google Ads API Click Conversionを参照してください。
gbraid	必須。iOS14 以降の iOS デバイスからのアプリコンバージョンに関連するクリックの識別子。値は Google Click ID、`gbraid`、または `wbraid` のいずれかです。
wbraid	必須。iOS14 以降の iOS デバイスからのウェブコンバージョンに関連するクリックの識別子。値は Google Click ID、`gbraid`、または `wbraid` のいずれかです。

カートデータパラメータ

パラメータ	説明
Merchant ID	アイテムがアップロードされるマーチャントセンター ID。
フィード言語コード	アイテムがアップロードされるフィードに関連付けられた言語コード。
ローカルトランザクション	全カートに対する無料配送やクーポン割引など、すべてのトランザクションレベルの割引の合計。通貨コードは `ClickConversion` メッセージと同じです。
商品ID	商品のショッピングID。この値はマーチャントセンターの商品識別子と等しくなければなりません。複数のアイテムを追加するには配列を使用します。配列タイプの属性は長さが等しくなければなりません。
数量	販売されたアイテムの数。複数のアイテムを追加するには配列を使用します。配列タイプの属性は長さが等しくなければなりません。
単価	税金、送料、およびトランザクションレベルの割引を除いた単価。通貨コードは `ClickConversion` メッセージと同じです。複数のアイテムを追加するには配列を使用します。配列タイプの属性は長さが等しくなければなりません。

オプションのパラメータ

パラメータ	説明
コンバージョンアクションの上書き	コンバージョンアクションパラメータを上書きするためのコンバージョンアクションIDを提供します。コンバージョンアクションIDパラメータを入力するためにEventStream変数を使用できます。
カスタム変数	このコンバージョンに関連付けられたカスタム変数。詳細については、Google: Custom Variableを参照してください。
広告ユーザーデータの同意	広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。

アクション — コンバージョン再声明

パラメータ

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

オプションのパラメータ

パラメータ	説明
コンバージョンアクションの上書き	コンバージョンアクションパラメータを上書きするためのコンバージョンアクションIDを提供します。このフィールドを使用して、EventStream変数でコンバージョンアクションIDパラメータを入力できます。
顧客IDの上書き	オプション。コネクタ構成の顧客IDを上書きするための顧客IDを提供します。このオプションを使用する場合、コンバージョンアクションの上書きも使用する必要があります。
マネージャー顧客IDの上書き	オプション。顧客IDの上書きを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供します。

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

パラメータ

パラメータ	説明
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google: Google Ads Conversion Adjustmentsを参照してください。
撤回日時	必須。撤回が行われた日時。形式は yyyy-mm-dd hh:mm:ss+\|-hh:mm です。日付属性はGoogleが期待する形式に変換されます。
オーダーID	オーダーIDまたはGoogle Click IDとコンバージョン日時のいずれかが提供されなければなりません。コンバージョンがオーダーIDで報告された場合、そのオーダーIDを使用する必要があります。
Google Click ID	オーダーIDまたはGoogle Click IDとコンバージョン日時のいずれかが提供されなければなりません。コンバージョンがオーダーIDで報告された場合、そのオーダーIDを使用する必要があります。
コンバージョン日時	このパラメータは形式 yyyy-mm-dd hh:mm:ss+\|-hh:mm でなければなりません。日付属性はGoogleが期待する形式に変換されます。
コンバージョンアクションの上書き	コンバージョンアクションパラメータを上書きするためのコンバージョンアクションIDを提供します。EventStream変数を使用してコンバージョンアクションIDパラメータを入力できます。
顧客IDの上書き	オプション。コネクタ構成の顧客IDを上書きするための顧客IDを提供します。このオプションを使用する場合、コンバージョンアクションの上書きも使用する必要があります。
マネージャー顧客IDの上書き	オプション。顧客IDの上書きを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供します。

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

パラメータ

パラメータ	説明
コンバージョンアクション	必須。既存のコンバージョンアクションを選択します。`UPLOAD_CALLS`タイプのGoogle広告コンバージョンアクションのみが表示されます。詳細については、Google: Google Ads Conversion Trackingを参照してください。

コンバージョンデータパラメータ

パラメータ	説明
発信者ID	必須。この通話が行われた発信者ID。発信者IDはE.164形式で、プラス (`+`) が先行します。例: `+16502531234`。
通話開始日時	必須。通話が行われた日時。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss±hh:mm です。例: `2020-01-01 12:32:45-8:00±hh:mm`。
コンバージョン日時	必須。コンバージョンが発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss±hh:mm です。例: `2020-01-01 12:32:45-8:00±hh:mm`。
コンバージョン値	広告主にとってのコンバージョンの値。
通貨コード	コンバージョン値に関連付けられたISO 4217 3文字の通貨コード。例: `USD` または `EUR`。

オプションのパラメータ

パラメータ	説明
カスタム変数	このコンバージョンに関連付けられたカスタム変数。詳細については、Google: Custom Variableを参照してください。
コンバージョンアクションの上書き	コンバージョンアクションパラメータを上書きするためのコンバージョンアクションIDを提供します。このフィールドを使用して、EventStream変数でコンバージョンアクションIDパラメータを入力できます。
広告ユーザーデータの同意	広告ユーザーデータの同意。デフォルト値は `GRANTED` です。有効な値は `GRANTED` と `DENIED` です。
顧客IDの上書き	必須。顧客アカウントIDを選択します。認証されたユーザーにアクセス可能な顧客アカウントのオプションが表示されます。
マネージャー顧客IDの上書き	オプション。顧客IDの上書きを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供します。

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

パラメータ

パラメータ	説明
コンバージョンアクション	既存のコンバージョンアクションを選択します。詳細については、Google: Google Ads Conversion Trackingを参照してください。

コンバージョンデータパラメータ

パラメータ	説明
Google Click ID	必須。このコンバージョンに関連付けられたGoogleクリックID (`gclid)`。Google Click ID、`gbraid`、または`wbraid`が必要です。
コンバージョン日時	必須。コンバージョンが発生した日時。この日時は通話時間の後でなければなりません。タイムゾーンを指定する必要があります。形式は yyyy-mm-dd hh:mm:ss±hh:mm です。例: `2020-01-01 12:32:45-8:00`。
コンバージョン値	広告主にとってのコンバージョンの値。
通貨コード	コンバージョン値に関連付けられたISO 4217 3文字の通貨コード。例: `USD` または `EUR`。
External Attribution Credit	Google Adsクリックに帰属する変換の割合。
External Attribution Model	指定された帰属モデル名。詳細については、Google: Google Ads API Click Conversionを参照してください。
gbraid	必須。iOS14以降のiOSデバイスからのアプリ変換に関連するクリックの識別子。値はGoogle Click ID、`gbraid`、または`wbraid`のいずれかです。
wbraid	必須。iOS14以降のiOSデバイスからのウェブ変換に関連するクリックの識別子。値はGoogle Click ID、`gbraid`、または`wbraid`のいずれかです。

カートデータパラメータ

パラメータ	説明
Merchant ID	アイテムがアップロードされるマーチャントセンターID。
Feed Country Code	アイテムがアップロードされるフィードの国コード。
Feed Language Code	アイテムがアップロードされるフィードの言語コード。
Local Transaction	カート全体に対する送料無料やクーポン割引など、すべてのトランザクションレベルの割引の合計。通貨コードは`ClickConversion`メッセージと同じです。
Product ID	アイテムのショッピングID。この値はマーチャントセンターの商品識別子と同じでなければなりません。複数のアイテムを追加するには配列を使用します。配列型属性は長さが等しくなければなりません。
Quantity	販売されたアイテムの数。複数のアイテムを追加するには配列を使用します。配列型属性は長さが等しくなければなりません。
Unit Price	税金、送料、およびトランザクションレベルの割引を除いた単価。通貨コードは`ClickConversion`メッセージと同じです。複数のアイテムを追加するには配列を使用します。配列型属性は長さが等しくなければなりません。

オプションのパラメータ

パラメータ	説明
Custom Variables	この変換に関連するカスタム変数。詳細については、Google: Custom Variableを参照してください。
Ad User Data Consent	広告ユーザーデータの同意。デフォルト値は`GRANTED`です。有効な値は`GRANTED`と`DENIED`です。
Conversion Action Override	Conversion Actionパラメータをオーバーライドするための変換アクションIDを提供します。このフィールドを使用して、EventStream変数でConversion Action IDパラメータを構成できます。
Customer ID Override	必須。顧客アカウントIDを選択します。利用可能なオプションは認証されたユーザーのアクセス可能な顧客アカウントを反映します。
Manager Customer ID Override	オプション。Customer ID Overrideを使用してクライアント顧客にアクセスする場合、マネージャー顧客IDを提供してください。