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を最新バージョンに更新します。
ユニークな値を含む属性をタグのmatch_idにマップします。例えば、tealium_random。Googleが強化するコンバージョンを識別できるように、コネクタでも同じ値を使用します。

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時間の遅延後にバッチ化されたコンバージョンを送信します。

トレース

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）を各イベントに渡すことで使用できます。重複排除を無効にするためには、例えば`tealium_random`のようなユニークな値を使用します。このコネクタとFloodlight `gtag.js`タグの両方で同じ属性値を使用します。
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画面の以下の画像を参照してください：

Google SA360 UI screenshot with callouts

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

	Google SA360 Enhanced Conversionsコネクタ	Floodlight (gtag.js)タグ
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回まで再試行します。

エラーメッセージ	説明
`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回まで再試行します。