Google Ads Enhanced Conversions for Web コネクタ構成ガイド | サーバーサイドコネクタ

必要条件

Enhanced Conversionsが有効なGoogle Adsアカウント。
Enhanced Conversionsが有効なコンバージョンアカウントの読み取りと書き込みの権限。
Google AdsアカウントのカスタマーID。詳細については、Google: Find your Google Ads customer IDを参照してください。
- クライアントの代わりにアカウントにアクセスしている場合、マネージャーカスタマーID（MCC ID）を構成する必要があります。Google AdsにログインしてPreferences > Access & Security > Managerに移動することで、カスタマーIDを確認できます。

コネクタのアクション

アクション名	AudienceStream	EventStream
Send Conversion	✓	✓

API情報

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

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

バッチ制限

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

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

構成の構成

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

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

Customer ID
必須。管理するためのAdsアカウントのカスタマーIDを提供します。
Manager Customer ID
オプション。クライアントの代わりにアカウントにアクセスしている場合、マネージャーカスタマーIDを構成する必要があります。Google AdsにログインしてPreferences > Access & Security > Managerに移動することで、カスタマーIDを確認できます。

コンバージョンが構成されているアカウントに対して少なくとも読み取りと書き込みの権限を持つGoogleアカウントとの接続を確立する必要があります。

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

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

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

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

アクション - Send Conversion

パラメータ

パラメータ	説明
Conversion Action	既存のコンバージョンアクションを選択します。コンバージョンアクションは、Google Ads UIでWEBPAGEタイプ、エンリッチメントコンバージョンが有効、およびエンリッチメントコンバージョン実装方法がAPIに構成されている必要があります。エンリッチメントコンバージョンについての詳細は、Google Ads: Enhanced Conversion Trackingを参照してください。
Transaction ID	広告主が生成した、コンバージョンイベントを一意に識別するID。このIDの値は、クライアントサイドのイベントと一致するべきです。購入には`order_ID`、その他のイベントには`tealium_random`を使用することを推奨します。自動トランザクションIDが提供されていない場合は必須です。
Conversion Value	コンバージョンの金額。
Conversion Currency	コンバージョンの通貨コード。
Conversion Time	元のコンバージョンが発生した日時。タイムゾーンを指定する必要があります。形式はyyyy-mm-dd hh:mm:ss+\|-hh:mmです。例えば、`022-01-01 12:32:45-08:00`。デフォルト値はnowです。
Gclid	利用可能な場合、ユーザーコンバージョンにつながるAdクリックのGoogleクリック識別子。
User Agent	広告主がそのデータを保持している場合、コンバートしたユーザーのユーザーエージェント。
Email Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供します。`gmail.com`および`googlemail.com`のメールアドレスで、ドメイン名の前にあるすべてのピリオド（.）をハッシュ化する前に削除します。
Email Address (apply SHA256 hash)	平文のメールアドレスが提供された場合、コネクタは`gmail.com`および`googlemail.com`のメールアドレスで、ドメイン名の前にあるすべてのピリオド（.）を削除し、空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Phone Number (already SHA256 hashed)	すでに空白をトリムし、SHA256でハッシュ化された、E164 standardに従った電話番号を提供します。
Phone Number (apply SHA256 hash)	平文の電話番号が提供された場合、コネクタはすべての非数字文字を削除し、番号の前にプラス記号（`+`）を付け、空白をトリムし、この値をSHA256ハッシュでハッシュ化します。
Address Info: First Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された名前を提供します。
Address Info: First Name (apply SHA256 hash)	平文の名前が提供された場合、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Address Info: Last Name (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された姓を提供します。
Address Info: Last Name (apply SHA256 hash)	平文の姓が提供された場合、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Address Info: Street Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化された通りの住所を提供します。
Address Info: Street Address (apply SHA256 hash)	平文の通りの住所が提供された場合、コネクタは空白をトリムし、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
Address Info: City	ユーザーの住所の市区町村。
Address Info: State	ユーザーの住所の州コード。
Address Info: Postal Code	ユーザーの住所の郵便番号。
Address Info: Country Code	ユーザーの住所のISO 3166-1 alpha-2の2文字の国コード。
Automatic Transaction ID	(オプション) Tealium iQタグIDに構成すると、Tealiumは自動的にTealium iQから送信されるトランザクションIDの値を探します。この機能を使用するには、タグテンプレートが2023年4月以降のバージョンである必要があります。トランザクションIDまたは自動トランザクションIDのいずれかを提供する必要があります。
Conversion Action Override	(オプション) Requiredセクションのコンバージョンアクションを上書きするためのConversion Action IDを提供します。このパラメータを使用すると、EventStream変数を使用してConversion Action IDを入力することができます。Conversion Action IDを見つけるには、Google Adsダッシュボードに移動してコンバージョンをクリックします。Conversion Action IDは、ウェブサイトURLの`ctId`クエリパラメータの値です。例えば、URLが`https://ads.google.com/aw/conversions/detail?ctId=987654321`の場合、Conversion Action IDは`987654321`です。

エラートラブルシューティング

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

EC_MODE_MISMATCH: コンバージョンアクションがGoogle Ads Platformで不正なコンバージョンタイプを持っています。Google Ads PlatformのTools > Conversions > Conversion EventでコンバージョンタイプをAPIに変更します。
INVALID_USER_CUSTOMER_AUTHORIZATION: コネクタ構成中にGoogle Adsプラットフォームに認証するために使用されるログインは、オーディエンスリストを所有するアカウントに対して少なくとも読み取り専用のアクセス権を持つ必要があります。
Invalid Parameter - Action has invalid parameter value or missing required parameter: これは、必要なフィールドが欠けている場合にコネクタから発生する内部検証エラーです。以下のアクションエラーのいずれかが返されます：
- Transaction ID cannot be empty: コンバージョンに注文IDがない場合、クライアントサイドのタグとコネクタアクション構成でtealium_randomをマッピングできます。
メールアドレス、電話番号、またはすべての住所情報を提供する必要があります：エンリッチメントされたコンバージョンに必要なPIIは、以下のいずれかのセットです：
a) 顧客のメール
b) 顧客の名前、姓、通りの住所、市、州、国、郵便番号
イベントデータに必要なフィールド値が存在することを確認してください。

詳細については、Google Ads: APIエラーを参照してください。