Google SA360 Enhanced Conversions コネクタ構成ガイド

Google SA360 Enhanced Conversionsコネクタは、コンバージョン測定の精度を向上させ、より強力な入札を可能にします。これは、ハッシュ化された第一者のコンバージョンデータをプライバシー保護の観点から安全にGoogleに送信することで、既存のクライアントサイドのコンバージョンタグを補完します。

コンバージョンは、クライアントサイドのFloodlight (gtag.js)タグを通じて記録され、Googleによってインデックス化されます。Google SA360 Enhanced Conversionsコネクタは、サーバー間API呼び出しを使用して、これらのコンバージョンを個人識別情報（PII）でエンリッチメントするために使用できます。

要件

このコネクタには以下の要件があります：

• コネクタ構成で使用するプロファイルIDを取得するために、api@tealium.comユーザーをGoogle Campaign Manager 360アカウントに追加します。このユーザーは、オフラインコンバージョンの更新権限を持つ必要があります。
• このコネクタがPIIデータを含むタグペイロードを更新するためには、Floodlight gtag.jsタグが必要です。
• Floodlight gtag.jsタグを最新バージョンに更新します。
• tealium_randomなどの一意の値を含む属性をタグmatch_id変数にマップします。Googleがエンリッチメントするコンバージョンを識別できるように、コネクタでも同じ値を使用します。
• 非購入コンバージョンの場合、Floodlight gtag.jsタグで、一意の値を含む属性をordinalにマップします。例えば、tealium_random。

API情報

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

• API名：Google Campaign Manager 360 API
• APIバージョン：v4
• APIエンドポイント：https://dfareporting.googleapis.com/dfareporting
• ドキュメンテーション：Google Campaign Manager 360 API > Enhanced Conversions

バッチ制限

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

• リクエストの最大数：1000
• 最も古いリクエストからの最大時間：60分
• リクエストの最大サイズ：1MB

さらに、コネクタは、Googleがクライアントサイドのコンバージョンをインデックスできるように、2時間の遅延後にバッチ化されたコンバージョンを送信します。

Trace

TealiumのTrace機能は、リアルタイムのデバッグを可能にするために構成されたバッチ処理と遅延をバイパスします。Googleによるクライアントサイドのコンバージョンのインデックス化は即時ではなく、このコネクタをTraceで使用すると404 Not Foundエラーが発生します。

PIIマッピングの制限

Floodlight (gtag.js)タグとこのコネクタを使用する際には、以下のPIIデータの制限を守るようにしてください：

• コネクタが機能するためにはPIIデータを送信する必要があります。コネクタがGoogleと接続する際にデータにPIIが含まれていない場合、コネクタはPIIが欠落しているというエラーを生成し、Googleには何もデータを送信しません。PIIデータには、以下のいずれかが含まれている必要があります：
  • メールアドレス
  • 電話番号
  • すべての住所情報（名前、姓、通りの住所、市区町村、州、郵便番号、国コード）
• PIIデータは、Floodlight (gtag.js)タグまたはGoogle SA360 Enhanced Conversionsコネクタを通じて送信しますが、両方では送信しません。両方でPIIをマッピングすると、コネクタでconversion already enhancedエラーが発生します。
• コネクタエラーを避けるために、PIIが必要なイベントフィードまたはイベント仕様に条件を追加して、PIIがないコンバージョンを制限することをお勧めします。

コネクタアクション

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

構成の構成

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

このコネクタを追加するときは、ベンダーのデータプラットフォームポリシーを受け入れる必要があります。

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

• Floodlight Profile ID - api@tealium.comユーザーをCampaign Manager 360アカウントに追加した後に、Campaign Manager 360から提供されるFloodlight Profile ID。

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

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

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

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

アクション - Send Conversion

パラメータ

パラメータ	説明
Floodlight Configuration ID	(必須) このコンバージョンのFloodlight構成ID。
Floodlight Activity ID	(必須) このコンバージョンのFloodlightアクティビティID。
Match ID	(必須) Googleがコネクタエンリッチメントコンバージョン呼び出しをクライアントサイドのFloodlightイベントとマッチさせるために使用する、広告主が作成した一意のイベント識別子。このコネクタとFloodlightの gtag.js タグの両方で同じ属性値を使用します。
Ordinal	(必須) コンバージョンの序数。同じユーザーと日付のコンバージョンを重複排除するために、このパラメータを使用して同じ値（例えば、1）を各イベントに渡すことができます。重複排除を無効にするためには、購入イベントの場合は order_id、非購入イベントの場合は tealium_random などの一意の値を使用します。タグにトランザクションIDが使用されている場合は、その値を含む属性をマップします。
Timestamp Micros	コンバージョンのタイムスタンプ、Unixエポックマイクロ秒で表されます。提供されていない場合は自動生成されます。値は、クライアントサイドのコンバージョンのGoogle記録タイムスタンプから1分以内である必要があります。
Quantity	(必須) コンバージョンの数量。配列をマップすると、コネクタは配列内の値を合計します。値を更新したい場合を除き、このコネクタとFloodlightの gtag.js タグの両方で同じ属性値を使用します。
Value	(必須) コンバージョンの値。値を更新したい場合を除き、このコネクタとFloodlightの gtag.js タグの両方で同じ属性値を使用します。
Profile ID	コネクタの構成タブで定義された値を上書きします。
Email Address (already SHA256 hashed)	すでに空白をトリムし、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供します。
Email Address (apply SHA256 hash)	プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化、SHA256ハッシュ化します。
Phone Number (already SHA256 hashed)	すでに空白をトリムし、SHA256でハッシュ化された電話番号を提供します。
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	ユーザーの住所の2文字の国コード（ISO-3166-1 alpha-2形式）。

トラブルシューティング

Google属性の特定

このコネクタに必要な属性を特定するための参考として、Google SA360のActivities画面の以下の画像を参照してください：

この図は、このコネクタとFloodlight (gtag.js)タグに必要な以下の属性の位置を示しています：

	Google SA360 Enhanced Conversions Connector	Floodlight (gtag.js) tag
Configuration ID	✓	✓
Activity ID	✓
Activity Tag String		✓
Group Tag String		✓
Counting Method		✓

エラーメッセージ

このコネクタの潜在的なエラーメッセージは以下の通りです：

エラーメッセージ	説明
NOT_FOUND	“MatchId {matchId} cannot be found." Googleはクライアントサイドのタグピングから一致するコンバージョンを見つけることができませんでした。これはコネクタの問題ではなく、iQ Tag Managementタグの構成について調査する原因かもしれません。これはまた、タグに対して同意が拒否されたが、コンバージョンエンリッチメントがコネクタを通じて送信されたGoogle Consent Mode tagの使用の結果である可能性もあります。
NOT_FOUND	“Specified conversion doesn’t exist." コンバージョンはクライアントサイドのタグから受信されましたが、まだGoogleによってエンリッチメントのためにインデックス化されていません。Tealiumはこれらの呼び出しを最大3回まで再試行します。