Google Adsストアセールスコネクタ構成ガイド
この記事では、Google Adsストアセールスコネクタの構成方法について説明します。
API情報
このコネクタは、以下のベンダーAPIを使用します：
- API名：Google Ads API
- APIバージョン：v14
- APIエンドポイント：
https://googleads.googleapis.com/ - ドキュメンテーション：Google Ads API
コネクタアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トランザクションのアップロード | ✗ | ✓ |
| トランザクションのアップロード（複数の識別子） | ✗ | ✓ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。
このコネクタを追加すると、ベンダーのデータプラットフォームポリシーを受け入れるように求められます。
コネクタを追加した後、以下の構成を構成します：
- 顧客ID
必須：Google Adsアカウントの顧客ID。 - マネージャー顧客ID
クライアント顧客にアクセスする場合、マネージャー顧客IDを構成する必要があります。
アクション構成 - パラメータとオプション
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - トランザクションのアップロード
バッチ制限
このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：
- リクエストの最大数：100000
- 最も古いリクエストからの最大時間：60分
- リクエストの最大サイズ：40MB
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンアクション | コンバージョンアクションは、STORE_SALESまたはSTORE_SALES_DIRECT_UPLOADのタイプでなければなりません。 |
| 住所情報：国コード | ユーザーの住所の国コードをISO-3166-1 alpha-2形式の2文字で使用します。 |
| 住所情報：名（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたユーザーの名前を提供します。 |
| 住所情報：名（SHA256ハッシュを適用） | ユーザーのプレーンテキストの名前を提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 |
| 住所情報：姓（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたユーザーの姓を提供します。 |
| 住所情報：姓（SHA256ハッシュを適用） | ユーザーのプレーンテキストの姓を提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 |
| 住所情報：郵便番号 | ユーザーの住所の郵便番号。 |
| メールアドレス（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたユーザーのメールアドレスを提供します。 |
| メールアドレス（SHA256ハッシュを適用） | ユーザーのプレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 |
| 電話番号（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、SHA256でハッシュ化されたユーザーの電話番号を提供します。 |
| 電話番号（SHA256ハッシュを適用） | ユーザーのプレーンテキストの電話番号を提供し、コネクタはこの値を空白トリム、SHA256ハッシュ化します。 |
| 第三者ユーザーID | 第三者が割り当てたユーザーID。 |
| トランザクション日時 | （必須）トランザクションが発生したタイムスタンプ。形式：YYYY-MM-DD HH:MM:SS[+/-HH:MM]、ここで[+/-HH:MM]はUTCからのオプションのタイムゾーンオフセットです。 |
| トランザクション金額 | （必須）トランザクション金額をマイクロ単位で、ここで100万は1通貨単位に相当します。 |
| 通貨コード | （必須）ISO-4217の3文字形式のトランザクション通貨コード。 |
| トランザクションアップロード比率 | （必須）アップロードされたセールスと顧客との全体のセールスとの比率。この値は0と1の間（0を除く）でなければなりません。例えば、顧客と関連付けることができるセールスの半分をアップロードする場合、この値は0.5になります。 |
| トランザクション注文ID | トランザクションの注文ID。 |
| カスタムキー | ストアセールスカスタム変数キーの名前。トランザクションに適用できる事前定義されたキーで、後でレポートのカスタムセグメンテーションに使用できます。 |
| カスタム値 | 各トランザクションのカスタム変数の値。 |
| ストアコード | Googleに以前にアップロードされたユニークなストアID。 |
| アイテムID | 製品のユニークな識別子。これは、Merchant CenterのアイテムIDまたはGTIN（Global Trade Item Number）のいずれかになります。 |
| 数量 | 売れたアイテムの数。構成されていない場合、デフォルトは1です。 |
| 国コード | アイテムがアップロードされているフィードに関連付けられた国のCommon Locale Data Repository（CLDR）の地域コード。 |
| 言語コード | アイテムがアップロードされているフィードに関連付けられた言語のISO 639-1コード |
| マーチャントID | Merchant CenterアカウントのID。 |
アクション - トランザクションのアップロード（複数の識別子）
バッチ制限
このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：
- リクエストの最大数：33000
- 最も古いリクエストからの最大時間：60分
- リクエストの最大サイズ：40MB
パラメータ
| パラメータ | 説明 |
|---|---|
| コンバージョンアクション | コンバージョンアクションは、STORE_SALESまたはSTORE_SALES_DIRECT_UPLOADのタイプでなければなりません。 |
| 住所情報：国コード | ユーザーの住所の国コードをISO-3166-1 alpha-2形式の2文字で使用します。 |
| 住所情報：名（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたユーザーの名前を提供します。 |
| 住所情報：名（SHA256ハッシュを適用） | ユーザーのプレーンテキストの名前を提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 |
| 住所情報：姓（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたユーザーの姓を提供します。 |
| 住所情報：姓（SHA256ハッシュを適用） | ユーザーのプレーンテキストの姓を提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 |
| 住所情報：郵便番号 | ユーザーの住所の郵便番号。 |
| メールアドレス（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、小文字にし、SHA256でハッシュ化されたユーザーのメールアドレスを提供します。 |
| メールアドレス（SHA256ハッシュを適用） | ユーザーのプレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。 |
| 電話番号（すでにSHA256でハッシュ化されている） | すでに空白をトリムし、SHA256でハッシュ化されたユーザーの電話番号を提供します。 |
| 電話番号（SHA256ハッシュを適用） | ユーザーのプレーンテキストの電話番号を提供し、コネクタはこの値を空白トリム、SHA256ハッシュ化します。 |
| 第三者ユーザーID | 第三者が割り当てたユーザーID。 |
| トランザクション日時 | （必須）トランザクションが発生したタイムスタンプ。形式：YYYY-MM-DD HH:MM:SS[+/-HH:MM]、ここで[+/-HH:MM]はUTCからのオプションのタイムゾーンオフセットです。 |
| トランザクション金額 | （必須）トランザクション金額をマイクロ単位で、ここで100万は1通貨単位に相当します。 |
| 通貨コード | （必須）ISO-4217の3文字形式のトランザクション通貨コード。 |
| トランザクションアップロード比率 | （必須）アップロードされたセールスと顧客との全体のセールスとの比率。この値は0と1の間（0を除く）でなければなりません。例えば、顧客と関連付けることができるセールスの半分をアップロードする場合、この値は0.5になります。 |
| トランザクション注文ID | トランザクションの注文ID。 |
| カスタムキー | ストアセールスカスタム変数キーの名前。トランザクションに適用できる事前定義されたキーで、後でレポートのカスタムセグメンテーションに使用できます。 |
| カスタム値 | 各トランザクションのカスタム変数の値。 |
| ストアコード | Googleに以前にアップロードされたユニークなストアID。 |
| アイテムID | 製品のユニークな識別子。これは、Merchant CenterのアイテムIDまたはGTIN（Global Trade Item Number）のいずれかになります。 |
| 数量 | 売れたアイテムの数。構成されていない場合、デフォルトは1です。 |
| 国コード | アイテムがアップロードされているフィードに関連付けられた国のCommon Locale Data Repository（CLDR）の地域コード。 |
| 言語コード | アイテムがアップロードされているフィードに関連付けられた言語のISO 639-1コード |
| マーチャントID | Merchant CenterアカウントのID。 |
最終更新日 :: 2024年March月29日