Google Adsコンバージョンコネクタのセットアップガイド
この記事では、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 。 |
オプションのパラメータ
パラメータ | 説明 |
---|---|
コンバージョンアクションのオーバーライド | Conversion ActionパラメータをオーバーライドするためのコンバージョンアクションIDを指定します。このフィールドを使用して、EventStream変数を使用してConversion Action IDパラメータを設定できます。 |
カスタム変数 | このコンバージョンに関連するカスタム変数。詳細については、カスタム変数を参照してください。 |
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クリックコンバージョンを参照してください。 |
オプションのパラメータ
パラメータ | 説明 |
---|---|
コンバージョンアクションのオーバーライド | Conversion ActionパラメータをオーバーライドするためのコンバージョンアクションIDを指定します。このフィールドを使用して、EventStream変数を使用してConversion Action IDパラメータを設定できます。 |
カスタム変数 | このコンバージョンに関連するカスタム変数。詳細については、カスタム変数を参照してください。 |
Ad User Data Consent | 広告ユーザーデータの同意。デフォルト値はGRANTED です。有効な値はGRANTED およびDENIED です。 |
カートデータのパラメータ
パラメータ | 説明 |
---|---|
Merchant ID | アイテムがアップロードされるMerchant Center IDです。 |
Feed Country Code | アイテムがアップロードされるフィードに関連する国コードです。 |
Feed Language Code | アイテムがアップロードされるフィードに関連する言語コードです。 |
ローカルトランザクション | カート全体のすべてのトランザクションレベルの割引(送料無料、クーポン割引など)の合計です。通貨コードはClickConversion メッセージと同じです。 |
商品ID | アイテムのショッピングIDです。この値はMerchant Centerの商品識別子と等しくする必要があります。複数のアイテムを追加するには、配列を使用します。配列タイプの属性は同じ長さである必要があります。 |
数量 | 販売されたアイテムの数です。複数のアイテムを追加するには、配列を使用します。配列タイプの属性は同じ長さである必要があります。 |
単価 | 税金、送料、およびトランザクションレベルの割引を除いた単価です。通貨コードはClickConversion メッセージと同じです。複数のアイテムを追加するには、配列を使用します。配列タイプの属性は同じ長さである必要があります。 |
アクション — コンバージョン再評価
コンバージョンを調整する前に、報告されたコンバージョンから24時間待機してください。これにより、CONVERSION_NOT_FOUNDまたはTOO_RECENT_CONVERSIONエラーが発生するのを防ぐことができます。
パラメータ
パラメータ | 説明 |
---|---|
コンバージョンアクション | 既存のコンバージョンアクションを選択します。詳細については、Google Adsコンバージョン調整を参照してください。 |
再評価値 | (必須)再評価後のコンバージョンの値です。 |
再評価日時 | (必須)調整が行われた日時です。形式はyyyy-mm-dd hh:mm:ss+|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。 |
注文ID | Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。 |
Google Click ID | Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。 |
Conversion Date Time | コンバージョンの日時です。形式はyyyy-mm-dd hh:mm:ss+|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。 |
通貨コード | 再評価値の通貨です。指定しない場合は、コンバージョンアクションのデフォルト通貨が使用されます。 |
オプションのパラメータ
パラメータ | 説明 |
---|---|
コンバージョンアクションのオーバーライド | Conversion ActionパラメータをオーバーライドするためのコンバージョンアクションIDを指定します。このフィールドを使用して、EventStream変数を使用してConversion Action IDパラメータを設定できます。 |
アクション — コンバージョン取り消し
コンバージョンを調整する前に、報告されたコンバージョンから24時間待機してください。これにより、CONVERSION_NOT_FOUNDまたはTOO_RECENT_CONVERSIONエラーが発生するのを防ぐことができます。
パラメータ
パラメータ | 説明 |
---|---|
コンバージョンアクション | 既存のコンバージョンアクションを選択します。詳細については、Google Adsコンバージョン調整を参照してください。 |
取り消し日時 | (必須)取り消しが行われた日時です。形式はyyyy-mm-dd hh:mm:ss+|-hh:mmです。日付属性はGoogleが期待する形式に変換されます。 |
注文ID | Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。 |
Google Click ID | Order IDまたはGoogle Click IDとConversion Date Timeのいずれかを指定する必要があります。コンバージョンが注文IDを指定して報告された場合、その注文IDを使用する必要があります。 |
Conversion Date Time | このパラメータはyyyy-mm-dd hh:mm:ss+|-hh:mmの形式である必要があります。日付属性はGoogleが期待する形式に変換されます。 |
コンバージョンアクションのオーバーライド | Conversion ActionパラメータをオーバーライドするためのコンバージョンアクションIDを指定します。このフィールドを使用して、EventStream変数を使用してConversion Action IDパラメータを設定できます。 |
リアルタイムWebトラフィックの考慮事項
GoogleクリックIDに関連付けられたクリックスルーは、コネクタをアクティブ化する前に少なくとも6時間前に発生している必要があります。これは、多くのGoogleクリックIDがコンバージョンイベントよりも6時間以内に発生したクリックに関連付けられているため、リアルタイムWebトラフィックのアクティベーションにこのコネクタを使用する場合には追加の考慮が必要です。
次のいずれかの戦略を使用して、このようにコネクタを使用することを検討してください:
- ファイルインポートまたはCollect APIを使用して、過去のコンバージョンデータをアップロードします。
- データをGoogleシートに送信し、データを手動でGoogle Adsにアップロードします。
最終更新日 :: 2024年May月16日