--- title: Google SA360 エンハンスドコンバージョンコネクタ構成ガイド description: この記事では、Google SA360 エンハンスドコンバージョンコネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/google-sa360-enhanced-conversions-connector/ --- Google SA360 エンハンスドコンバージョンコネクタは、コンバージョン測定の精度を向上させ、より強力な入札を可能にします。既存のクライアントサイドのコンバージョンタグを補完し、プライバシーを保護した方法でウェブサイトからGoogleへハッシュ化された第一者データを送信します。 コンバージョンはクライアントサイドの[Floodlight (`gtag.js`) タグ](https://docs.tealium.com/floodlight-gtagjs-tag/)を通じて記録され、Googleによってインデックスされます。Google SA360 エンハンスドコンバージョンコネクタは、サーバーからサーバーへのAPIコールを使用して、個人を特定できる情報（PII）を使用してこれらのコンバージョンをエンリッチメントするために使用できます。 ## 要件 このコネクタには以下が必要です： * コネクタ構成で使用するプロファイルIDを取得するために、`api@tealium.com` ユーザーをGoogleキャンペーンマネージャー360アカウントに追加してください。このユーザーはオフラインコンバージョンの更新権限を持っている必要があります。 * このコネクタがPIIデータをタグペイロードに更新するためには、[Floodlight `gtag.js` タグ](https://docs.tealium.com/floodlight-gtagjs-tag/)が必要です。 * Floodlight `gtag.js` タグを最新バージョンに更新してください。 * `tealium_random` のような一意の値を含む属性をタグの `match_id` 変数にマッピングしてください。Googleがコンバージョンをエンリッチメントするために同じ値をコネクタで使用してください。 * 非購入コンバージョンの場合、Floodlight `gtag.js` タグで `ordinal` に一意の値を含む属性をマッピングしてください。例えば、`tealium_random`。 ### 権限 * 任意のソース（バルクシート、Search Ads 360 API、またはCampaign Manager 360 APIなど）からコンバージョンをアップロードするには、コンバージョンをアップロードするサブマネージャーアカウントへの編集アクセスが必要です。詳細については、[Google: ユーザー権限についての役割の割り当て](https://support.google.com/searchads/answer/1409946)を参照してください。 * 共有Floodlight構成では、アップロードする各子サブマネージャーアカウントへの編集アクセスが必要です。親サブマネージャーやアップロードしていない子サブマネージャーへのアクセスは必要ありません。詳細については、[Google: Floodlight命令の編集](https://support.google.com/sa360/answer/13400844)を参照してください。 * コンバージョンを追跡するためにクリックIDを使用する場合、そのクリックIDを生成したサブマネージャーへの編集アクセスが必要です。編集できないサブマネージャーからのクリックIDを使用する場合、アップロードは失敗します。詳細については、[Google: ダウンロードしたバルクシートの編集](https://support.google.com/sa360/answer/13607450)を参照してください。 ## API情報 このコネクタは次のベンダーAPIを使用します： * API名：Google Campaign Manager 360 API * APIバージョン：v5 * APIエンドポイント：`https://dfareporting.googleapis.com/dfareporting` * ドキュメント：[Google: Campaign Manager 360 API - エンハンスドコンバージョン](https://developers.google.com/doubleclick-advertisers/guides/conversions_ec) ## バッチ制限 このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並行処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、[バッチ処理アクション](https://docs.tealium.com/batched-actions/)を参照してください。次のいずれかの閾値が満たされるか、プロファイルが公開されるまでリクエストはキューに入れられます： * 最大リクエスト数：1000 * 最古のリクエストからの最大時間：60分 * リクエストの最大サイズ：1 MB さらに、コネクタはクライアントサイドのコンバージョンがGoogleにインデックスされるのを待ってから2時間の遅延を持ってバッチコンバージョンを送信します。 ## トレース Tealiumの[Trace](https://docs.tealium.com/about-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が必要なイベントフィードやイベント仕様に条件を追加することをお勧めします。 ## 構成 コネクタマーケットプレースにアクセスして新しいコネクタを追加してください。コネクタを追加する一般的な手順については、[コネクタについて](https://docs.tealium.com/about-connectors/)の記事を参照してください。
このコネクタを追加する際には、ベンダーのデータプラットフォームポリシーを承諾する必要があります。
コネクタを追加した後、次の構成を構成してください： * **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ハッシュを適用） | プレーンテキストの住所を提供し、コネクターがすべての特殊文字を削除し、空白トリム、小文字化、ハッシュ化をこの値に適用します。 | | 住所情報：市区町村 | ユーザーの住所の市区町村です。 | | 住所情報：州 | ユーザーの住所の州コードです。 | | 住所情報：郵便番号 | ユーザーの住所の郵便番号です。 | | 住所情報：国コード | ユーザーの住所の2文字の国コードで、ISO 3166-1 alpha-2形式です。 | #### カスタム変数 | パラメーター | 説明 | |---| ---| |カスタム変数値| | |カスタム変数タイプ| | ## トラブルシューティング ### Google属性の特定 このコネクターとFloodlight（gtag.js）タグに必要な属性を特定するために、Google SA360の**アクティビティ**画面の以下の画像を参照してください： ![](https://docs.tealium.com/images/server-side-connectors/google-sa360-ui.png) 図は、このコネクターとFloodlight（gtag.js）タグに必要な以下の属性の位置を示しています： | | Google SA360 Enhanced Conversions Connector | Floodlight (gtag.js) tag | |---|:---:|:---:| |構成ID | ✓ | ✓ | |アクティビティID |✓ | | |アクティビティタグ文字列 | | ✓ | |グループタグ文字列 | | ✓ | |カウント方法| |✓ | ### エラーメッセージ このコネクターの潜在的なエラーメッセージは以下の通りです： |エラーメッセージ| 説明| |---| ---| | `NOT_FOUND` | "MatchId `{matchId}`が見つかりません。" Googleはクライアント側のタグピングから一致する変換を見つけることができませんでした。これはコネクターの問題ではなく、iQタグ管理のタグ構成の調査が必要かもしれません。これはまた、[Google Consent Mode tag](https://docs.tealium.com/google-consent-mode-tag/)の使用によるもので、タグに対する同意が拒否されたが、コネクターを通じて変換エンリッチメントが送信された結果でもあります。 | | `NOT_FOUND` | "指定された変換は存在しません。" 変換はクライアント側のタグから受信されましたが、Googleによってエンリッチメントのためにまだインデックスされていません。Tealiumはこれらの呼び出しを最大3回まで再試行します。|