Google Campaign Manager 360 Floodlight コネクタ構成ガイド

Google Campaign Manager 360 Floodlightコネクタは、Campaign Manager APIを通じてFloodlight Conversion Tracking and Attributionシステムにオフライン変換を挿入します。

FloodlightはGoogle Marketingプラットフォームの変換追跡システムです。プラットフォーム内のすべてのプロパティ — Campaign Manager 360、Display & Video 360、およびSearch Ads 360 — はFloodlightを使用できます。

要件

Campaign Manager 360（CM360）アカウントを持っている必要があります。
CM360アカウントはAPIアクセスが有効になっている必要があります。
このアカウントにアクセスできるユーザープロファイルを持っている必要があります。
https://www.googleapis.com/auth/ddmconversions スコープをCM360アカウントに有効にして、変換データへのアクセスを許可します。
ユーザー api@tealium.com をアカウントに追加し、オフライン変換の挿入 権限でCM360アカウントへのアクセスを許可します。
ユーザー api@tealium.com をCM360アカウントに追加した後、コネクタの構成ページまたはアクションページで生成されたプロファイルIDを使用します。構成ページとアクションページの両方で定義されている場合、アクションページで定義されたプロファイルIDが優先されます。

API情報

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

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

バッチ制限

このコネクタは、ベンダーへの高容量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値が満たされるか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：1000
最古のリクエストからの最大時間：60分
リクエストの最大サイズ：1 MB

遅延アクション

Googleのベストプラクティスに従い、オフライン変換のアップロードを容易にするために、アクションは30分遅延されます。Google Campaign Manager 360 Floodlightコネクタを使用した遅延アクションについての詳細は、Google: オフライン変換のアップロードに関するベストプラクティスを参照してください。

traceをEventSreamまたはAudienceStreamで使用する場合、アクションは遅延されません。

構成

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

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

FloodlightプロファイルID
- Campaign Manager 360から提供されるFloodlightプロファイルIDです。api@tealium.comユーザーをCampaign Manager 360アカウントに追加した後に与えられます。

このコネクタを追加すると、ベンダーのデータプラットフォームポリシーを受け入れるように求められます。

アクション

アクション名	AudienceStream	EventStream
Track Floodlight Conversion	✓	✓

次へをクリックするか、アクション タブに進みます。ここでコネクタアクションを構成します。

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

アクション - Track Floodlight Conversion

構成IDパラメータ

パラメータ	説明
プロファイルID	CM360が提供するFloodlightプロファイルIDです。ここで構成された場合、構成で定義された値を上書きします。
Floodlight構成ID	必須です。この変換のFloodlight構成ID。
FloodlightアクティビティID	必須です。この変換のFloodlightアクティビティID。

ユーザー/デバイスID

複数の属性がマッピングされている場合、最初の空でない値が送信されます。
すべての変換は30分の遅延後に送信されます。

パラメータ	説明
暗号化されたユーザーID	1つ以上の暗号化されたユーザーIDが指定されている場合、暗号化エンティティタイプ、ID、およびソースセクションが必要です。
モバイルデバイスID	単一のデバイスID、単一のクリックID、単一のユーザーID、マッチID、または複数のユーザー候補IDを指定します。単一のユーザー候補IDパラメータに候補IDのリストを使用することが許可されています。
GoogleクリックID	単一のデバイスID、単一のクリックID、単一のユーザーID、マッチID、または複数のユーザー候補IDを指定します。単一のユーザー候補IDパラメータに候補IDのリストを使用することが許可されています。
ディスプレイクリックID	単一のデバイスID、単一のクリックID、単一のユーザーID、マッチID、または複数のユーザー候補IDを指定します。単一のユーザー候補IDパラメータに候補IDのリストを使用することが許可されています。
マッチID	単一のデバイスID、単一のクリックID、単一のユーザーID、マッチID、または複数のユーザー候補IDを指定します。単一のユーザー候補IDパラメータに候補IDのリストを使用することが許可されています。
インプレッションID	単一のデバイスID、単一のクリックID、単一のユーザーID、マッチID、または複数のユーザー候補IDを指定します。単一のユーザー候補IDパラメータに候補IDのリストを使用することが許可されています。

追加パラメータ

パラメータ	説明
序数	必須です。同じユーザーと日の変換を重複排除するために使用される序数。
タイムスタンプ（マイクロ秒単位）	変換のタイムスタンプ（Unixエポックマイクロ秒）。提供されていない場合、自動生成されます。
広告追跡の制限	`true`に構成すると、ターゲティングではなく報告のみに変換を使用します。
子供向けの処理	変換が子供向けである場合は`true`に構成します。
非パーソナライズ広告	変換が非パーソナライズ広告の場合は`true`に構成します。
未成年者向けの処理	リクエストが未成年者からの可能性がある場合は`true`に構成します（GDPR参照）。

ユーザー識別子

パラメータ	説明
メールアドレス（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化されたメールアドレスを提供してください。`gmail.com`および`googlemail.com`のドメイン名の前にあるピリオド（`.`）をハッシュ化する前にすべて削除してください。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタが`gmail.com`および`googlemail.com`のドメイン名の前にあるピリオド（`.`）を削除し、空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
電話番号（既にSHA256ハッシュ化済み）	すでに空白を削除し、SHA256でハッシュ化された電話番号を提供してください。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタがすべての非数字記号を削除し、プラス記号（`+`）を番号の前に付け、空白を削除し、この値をSHA256ハッシュでハッシュ化します。
住所情報：名（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された名前を提供してください。
住所情報：名（SHA256ハッシュを適用）	プレーンテキストの名前を提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
住所情報：姓（既にSHA256ハッシュ化済み）	すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された姓を提供してください。
住所情報：姓（SHA256ハッシュを適用）	プレーンテキストの姓を提供し、コネクタが空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
住所情報：番地（既にSHA256ハッシュ化済み）	特殊文字を含まず、すでに空白を削除し、小文字に変換し、SHA256でハッシュ化された番地を提供してください。
住所情報：番地（SHA256ハッシュを適用）	プレーンテキストの番地を提供し、コネクタがすべての特殊文字を削除し、空白を削除し、小文字に変換し、この値をSHA256ハッシュでハッシュ化します。
住所情報：市区町村	ユーザーの住所の市区町村。
住所情報：州	ユーザーの住所の州コード。
住所情報：郵便番号	ユーザーの住所の郵便番号。
住所情報：国コード	ユーザーの住所の2文字の国コード（ISO 3166-1 alpha-2形式）。

暗号化

パラメータ	説明
暗号化エンティティタイプ	暗号化されたユーザーIDが指定されている場合に必要です。広告配信またはデータ転送の暗号化構成と一致する必要があります。
暗号化エンティティID	暗号化されたユーザーIDが指定されている場合に必要です。広告配信またはデータ転送の暗号化構成と一致する必要があります。
暗号化ソース	暗号化されたユーザーIDが指定されている場合に必要です。暗号化されたクッキーが広告配信から受け取られたか、データ転送から受け取られたかを説明します。

数量と価値

パラメータ	説明
コンバージョン数量	コンバージョンの数量。
コンバージョン価値	コンバージョンの価値。

カスタムデータ

必要に応じてUカスタム変数に属性をマッピングします。値が入力されているもののみが送信されます。このセクションのマッピング先の使用は、カスタムデータ配列 - レガシーセクションのマッピングを上書きします。

パラメータ	説明
カスタム変数値	カスタム値のコレクション。各値は50文字を超えてはなりません。
カスタム変数タイプ	`Uxxx`の形式の文字列のコレクション。ここで`xxx`は`1`から`100`の数字です。

要件