Google SA360 エンハンスドコンバージョンコネクタ構成ガイド

Google SA360 エンハンスドコンバージョンコネクタは、コンバージョン測定の精度を向上させ、より強力な入札を可能にします。既存のクライアントサイドのコンバージョンタグを補完し、プライバシーを保護した方法でウェブサイトからGoogleへハッシュ化された第一者データを送信します。

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

要件

このコネクタには以下が必要です：

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

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分
• リクエストの最大サイズ：1 MB

さらに、コネクタはクライアントサイドのコンバージョンがGoogleにインデックスされるのを待ってから2時間の遅延を持ってバッチコンバージョンを送信します。

トレース

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

PIIマッピングの制限

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

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

コネクタアクション

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

構成の構成

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

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

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

• FloodlightプロファイルID - Campaign Manager 360にapi@tealium.comユーザーを追加した後に提供されるFloodlightプロファイルIDです。

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

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

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

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

アクション — コンバージョンを送信

変換データ

必要なパラメーター：

パラメーター	説明
Floodlight構成ID	必須。この変換のFloodlight構成IDです。
FloodlightアクティビティID	必須。この変換のFloodlightアクティビティIDです。
マッチID	必須。Googleがクライアント側のFloodlightイベントとコネクターエンリッチメント変換コールをマッチさせるために使用する、広告主が作成した一意のイベント識別子です。このコネクターとFloodlightのgtag.jsタグの両方で同じ属性値を使用してください。
オーディナル	必須。変換の序数です。同じユーザーと日に対して同じ値（例：1）を各イベントに渡すことで、変換の重複を排除するために使用できます。重複排除を無効にするには、購入イベントの場合はorder_id、非購入イベントの場合はtealium_randomなどの一意の値を使用してください。このコネクターとFloodlightのgtag.jsタグの両方で同じ属性値を使用してください。タグでトランザクションIDが使用されている場合は、その値を含む属性をマッピングしてください。
タイムスタンプマイクロ秒	変換のタイムスタンプで、Unixエポックマイクロ秒です。提供されていない場合は自動生成されます。値はクライアント側の変換のGoogle記録タイムスタンプから1分以内である必要があります。
数量	必須。変換の数量です。配列をマッピングする場合、コネクターは配列内の値を合計します。このコネクターとFloodlightのgtag.jsタグの両方で同じ属性値を使用してください。値を更新する場合を除きます。
値	必須。変換の値です。このコネクターとFloodlightのgtag.jsタグの両方で同じ属性値を使用してください。値を更新する場合を除きます。
プロファイルID	コネクターの構成タブで定義された値を上書きします。

パラメーター	説明
メールアドレス（既にSHA256ハッシュ化済み）	すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供してください。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクターが空白トリム、小文字化、SHA256ハッシュを使用してこの値をハッシュ化します。
電話番号（既にSHA256ハッシュ化済み）	すでに空白トリム、SHA256ハッシュ化された電話番号を提供してください。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクターが空白トリムしてこの値をSHA256ハッシュでハッシュ化します。
住所情報：名（既にSHA256ハッシュ化済み）	すでに空白トリム、小文字化、SHA256ハッシュ化された名を提供してください。
住所情報：名（SHA256ハッシュを適用）	プレーンテキストの名を提供し、コネクターが空白トリム、小文字化、SHA256ハッシュを使用してこの値をハッシュ化します。
住所情報：姓（既にSHA256ハッシュ化済み）	すでに空白トリム、小文字化、SHA256ハッシュ化された姓を提供してください。
住所情報：姓（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクターが空白トリム、小文字化、SHA256ハッシュを使用してこの値をハッシュ化します。
住所情報：住所（既にSHA256ハッシュ化済み）	特殊文字を含まない住所を提供し、すでに空白トリム、小文字化、SHA256ハッシュ化されているものです。
住所情報：住所（SHA256ハッシュを適用）	プレーンテキストの住所を提供し、コネクターがすべての特殊文字を削除し、空白トリム、小文字化、SHA256ハッシュを使用してこの値をハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村です。
住所情報：州	ユーザーの住所の州コードです。
住所情報：郵便番号	ユーザーの住所の郵便番号です。
住所情報：国コード	ユーザーの住所の2文字国コードで、ISO 3166-1 alpha-2形式です。

トラブルシューティング

Google属性の特定

このコネクターとFloodlight（gtag.js）タグに必要な属性がどこにあるかを特定するために、Google SA360のアクティビティ画面の以下の画像を参照してください：

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

	Google SA360 Enhanced Conversions Connector	Floodlight (gtag.js) タグ
構成ID	✓	✓
アクティビティID	✓
アクティビティタグ文字列		✓
グループタグ文字列		✓
カウント方法		✓

エラーメッセージ

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

エラーメッセージ	説明
NOT_FOUND	“MatchId {matchId} が見つかりません。” Googleはクライアント側のタグピングから一致する変換を見つけることができませんでした。これはコネクターの問題ではなく、iQタグ管理タグの構成に関する調査の原因となる可能性があります。これは、Google Consent Mode tagの使用によるもので、タグに対する同意が拒否されたが、コネクターを通じて変換エンリッチメントが送信された結果でもあります。
NOT_FOUND	“指定された変換は存在しません。” 変換はクライアント側のタグから受信されましたが、Googleによってエンリッチメントのためにまだインデックスされていません。Tealiumはこれらの呼び出しを最大3回まで再試行します。