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。

権限

• 任意のソース（例えばバルクシート、Search Ads 360 API、またはCampaign Manager 360 API）からコンバージョンをアップロードするには、コンバージョンをアップロードするサブマネージャーアカウントで編集アクセスが必要です。詳細については、Google: ユーザー権限についての役割の割り当てを参照してください。
• 共有Floodlight構成では、コンバージョンをアップロードする各子サブマネージャーアカウントで編集アクセスが必要です。親サブマネージャーやアップロードしていない子サブマネージャーへのアクセスは必要ありません。詳細については、Google: Floodlight指示を編集するを参照してください。
• クリックIDを使用してコンバージョンを追跡する場合、そのクリックIDを生成したサブマネージャーで編集アクセスが必要です。編集できないサブマネージャーからのクリックIDを使用する場合、アップロードは失敗します。詳細については、Google: ダウンロードしたバルクシートを編集するを参照してください。

API情報

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

• API名：Google Campaign Manager 360 API
• APIバージョン：v4
• APIエンドポイント：https://dfareporting.googleapis.com/dfareporting
• ドキュメント：Google: Campaign Manager 360 API - エンハンスドコンバージョン

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、バッチ処理アクションを参照してください。次のいずれかの閾値に達するか、プロファイルが公開されるまでリクエストはキューに入れられます：

• 最大リクエスト数：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が必要なイベントフィードまたはイベント仕様に条件を追加することをお勧めします。

構成

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

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

コネクタを追加した後、次の構成を構成してください：

• FloodlightプロファイルID：Campaign Manager 360アカウントにapi@tealium.comユーザーを追加した後に提供されるFloodlightプロファイルID。

コネクタの構成が完了したら、完了をクリックしてください。

アクション

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

コネクタアクションの構成を続けるには、続行をクリックしてください。アクションの名前を入力し、次にアクションタイプを選択してください。

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

コンバージョンを送信

変換データ

必要なパラメーター：

パラメーター	説明
Floodlight構成ID	(必須) この変換のFloodlight構成IDです。
FloodlightアクティビティID	(必須) この変換のFloodlightアクティビティIDです。
マッチID	(必須) Googleがクライアント側のFloodlightイベントとコネクターエンリッチメント変換コールをマッチさせるために使用する、広告主が作成した一意のイベント識別子です。このコネクターとFloodlightのgtag.jsタグの両方で同じ属性値を使用してください。
オーディナル	(必須) 変換の序数です。同じユーザーと日に対して同じ値（例：1）を各イベントに渡すことで、変換の重複を排除するために使用できます。重複排除を無効にするには、購入イベントの場合はorder_id、非購入イベントの場合はtealium_randomなどの一意の値を使用してください。このコネクターとFloodlightのgtag.jsタグの両方で同じ属性値を使用してください。タグでトランザクション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ハッシュを適用）	プレーンテキストの住所を提供し、コネクターがすべての特殊文字を削除し、空白トリム、小文字化し、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回まで再試行します。