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

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

コンバージョンはクライアントサイドのFloodlight (gtag.js) タグを通じて記録され、Googleによってインデックスされます。Google SA360 エンハンスドコンバージョンコネクタは、サーバーからサーバーへの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分
• リクエストの最大サイズ：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が必要なイベントフィードやイベント仕様に条件を追加することで、PIIのないコンバージョンを制限することをお勧めします。

コネクタアクション

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

構成の構成

コネクタマーケットプレースに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、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などの一意の値を使用します。トランザクションIDがタグで使用されている場合は、その値を含む属性をマッピングします。
タイムスタンプマイクロ秒	変換のタイムスタンプ（Unixエポックマイクロ秒）。提供されていない場合、コネクターが自動的に生成します。Tealiumの日付属性（ミリ秒で保存）をマッピングする場合、コネクターは値をマイクロ秒に変換してからGoogleに送信します。値はクライアント側の変換の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ハッシュを使用してこの値をハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村。
住所情報：州	ユーザーの住所の州コード。
住所情報：郵便番号	ユーザーの住所の郵便番号。
住所情報：国コード	ユーザーの住所の2文字国コード（ISO 3166-1 alpha-2形式）。

カスタム変数

パラメーター	説明
カスタム変数値	カスタム値の配列。 各値は50文字を超えてはなりません。
カスタム変数タイプ	“U1”から“U100”までのパターンに一致する文字列の配列。このパターンに一致しない文字列は除外されます。

トラブルシューティング

Google属性の特定

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

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

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

エラーメッセージ

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

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