Google Ads Enhanced Conversions - レガシーコネクタ構成ガイド | サーバーサイドコネクタ

コネクタのアクション

アクション名	AudienceStream	EventStream
コンバージョンの送信	✓	✓

このコネクタは現在非推奨となっており、アプリの増分性研究を実行している場合のみ使用してください。現在のコネクタについては、Google Ads Enhanced Conversions for Web connectorを参照してください。

API情報

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

API名：Google Enhanced Conversion API
APIバージョン：v1
APIエンドポイント：https://www.google.com/ads/event/api/

構成の構成

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

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

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

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

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

アクション - コンバージョンの送信

パラメータ

パラメータ	説明
コンバージョン追跡ID	必須 `AW-123456789`からの数値で、広告主アカウントを一意に識別します。マップされた値から`AW-`を省略します。
コンバージョンラベル	エンコードされたコンバージョン追跡IDとコンバージョンタイプ。
コンバージョンタイプ	コンバージョンのタイプ。広告主としてラベルにアクセスできない場合にのみ使用されます。
コンバージョン値	広告主にとってのコンバージョンの金額。デフォルト値は`$1 (USD)`
通貨コード	コンバージョン値に関連する通貨。これはISO 4217の3文字の通貨コードです。デフォルト値は`USD`。例：`USD`、`EUR`
コンバージョン時間	エポックからのUnix時間、マイクロ秒単位。デフォルト値は`now`。
トランザクションID	必須広告主として生成された、コンバージョンイベントを一意に識別するID。
Google Click ID	利用可能な場合、ユーザーコンバージョンにつながるGoogle Click ID（`gclid`）。
ユーザーエージェント	広告主がデータを保持している場合、コンバージョンしたユーザーのユーザーエージェント。
メール	コンバージョン時点のユーザーメール。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。以下のいずれかを提供する必要があります：ユーザーメールユーザーのフルネームと住所
電話番号	電話はメールまたはフルネームと住所と一緒に提供することができます。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。コンバージョン時点のユーザーの電話番号。 E.164 standard形式：`+prefix, country code, subscribe number` 例：`+14150000000`
住所：名前	ユーザーの名前。住所の場合、すべてのデータフィールド（名前、姓、通りの住所、市、地域、郵便番号、国）を提供する必要があります。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。
住所：姓	ユーザーの姓。住所の場合、すべてのデータフィールド（名前、姓、通りの住所、市、地域、郵便番号、国）を提供する必要があります。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。
住所：通り	ユーザーの通りの住所。住所の場合、すべてのデータフィールド（名前、姓、通りの住所、市、地域、郵便番号、国）を提供する必要があります。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。
住所：市	ユーザーの市名。住所の場合、すべてのデータフィールド（名前、姓、通りの住所、市、地域、郵便番号、国）を提供する必要があります。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。
住所：地域	ユーザーの県、州、または地域。住所の場合、すべてのデータフィールド（名前、姓、通りの住所、市、地域、郵便番号、国）を提供する必要があります。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。
住所：郵便番号	ユーザーの郵便番号。住所の場合、すべてのデータフィールド（名前、姓、通りの住所、市、地域、郵便番号、国）を提供する必要があります。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。
住所：国	ISO 3166-1 alpha-3形式のユーザーの3文字の国コード。住所の場合、すべてのデータフィールド（名前、姓、通りの住所、市、地域、郵便番号、国）を提供する必要があります。複数のメール、電話番号、住所を追加するために配列タイプの属性を使用します。
顧客データのハッシュ化	オプションマップされた顧客データ（メール、電話、名前、姓、通りの住所）がすでにwebsafe-base 64 eoncoded SHA-256ハッシュを使用してハッシュ化されているかどうかを確認します。注：これはSHA-256文字列をbase64エンコードするのとは異なります。既存のSHA-256文字列をバイナリに変換してからbase64エンコードします。
増分性研究のためのアプリコンバージョン	オプションこのアクションが増分性研究のためのコンバージョンイベントに関連しているかどうかを確認します。
増分性研究のためのコンバージョンデータ	オプションこのコンバージョンイベントの増分性研究に使用するための雑多なデータフィールドを1つ以上マップします。

一般的なエラーとトラブルシューティング

以下は一般的なエラーコードと解決策の一部です：

INVALID_CONVERSION_DATA：コンバージョンのデータが無効です。可能なアクションの失敗は以下の通りです：
- urlまたはjsonペイロードに有効なconversion_typeまたはlabelが提供されていません：labelが提供されていない場合、conversion_typeが必要です。これらのうちの1つがマップされた属性に値があることを確認してください。
- urlまたはjsonペイロードに提供されたconversion_timeが古すぎます。：マップされたタイムスタンプが正しい形式であることを確認してください。例：2022-08-01 00:06:06+00:01。または、マッピングを削除し、コネクタにデフォルトの現在のタイムスタンプを送信させます。
INVALID_USER_CUSTOMER_AUTHORIZATION：コネクタ構成の顧客IDにAW-が含まれていないことを確認します。認証されたユーザーは、コンバージョンアクションを所有するアカウントに対して少なくとも読み取り専用のアクセス権を持っている必要があります。
無効なパラメータ - アクションに無効なパラメータ値があるか、必要なパラメータが欠けています / メールまたはフルネーム＆アドレスのいずれかを提供する必要があります：Enhanced Conversionsに必要なPIIは以下のセットのいずれかです：
a) 顧客のメール
b) 顧客の名前、姓、通りの住所、市、州、国、郵便番号
イベントデータに必要なフィールド値が存在することを確認してください。