Google Campaign Manager 360 Floodlight コネクタ構成ガイド | サーバーサイドコネクター

FloodlightはDoubleClick Digital Marketing (DDM) プラットフォームのコンバージョントラッキングシステムです。DDMプラットフォーム内のすべてのプロパティ—Campaign Manager (DCM)、Bid Manager、DoubleClick Search (DS)—はFloodlightを使用できます。詳細については、Google: Floodlightコンバージョントラッキングについてを参照してください。

DS vs DCM

Report Builderで有料検索レポートを実行しない場合や、DDMプラットフォームのCampaign Manager (DCM) レポートで検索によるオフラインコンバージョンを表示する必要がない場合は、DoubleClick Search (DS)を使用してください。

暗号化されたユーザーID、モバイルデバイスID、またはGoogleクリックIDによってコンバージョンを特定できる場合はDCMを使用してください。

DSまたはDCMのいずれかを使用することが重要ですが、両方を使用しないでください：両方の製品からアップロードされたコンバージョンは重複排除されず、データの不整合を引き起こす可能性があります。

FloodlightコンバージョントラッキングシステムとFloodlightタグを混同しないでください。FloodlightタグはDoubleClickプラットフォームのトラッキングタグです。

要件

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

API情報

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

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

バッチ制限

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

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

遅延アクション

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

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

コネクタアクション

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

構成の構成

コネクタマーケットプレースにアクセスして新しいコネクタを追加します。コネクタを追加する方法については、Connector Overview記事を参照してください。

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

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

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

アクション構成 - パラメータとオプション

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

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

アクション - Track Floodlight Conversion

構成IDパラメータ

パラメータ	説明
プロファイルID	DCMから提供されるFloodlightプロファイルIDです。`api@tealium.com`ユーザーをDCMアカウントに追加した後に与えられます。ここで構成された場合、構成で定義された値を上書きします。
Floodlight構成ID	(必須) このコンバージョンのFloodlight構成IDです。
FloodlightアクティビティID	(必須) このコンバージョンのFloodlightアクティビティIDです。

ユーザー/デバイスID

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

パラメータ	説明
暗号化ユーザーID	1つ以上の暗号化ユーザーIDが指定されている場合、暗号化エンティティタイプ、ID、およびソースセクションが必要です。
モバイルデバイスID	単一のデバイスID、単一のクリックID、単一のユーザーID、または複数のユーザー候補IDのいずれかを指定します。単一のユーザー候補IDパラメータの候補IDリストを使用することが許可されています。
GoogleクリックID	単一のデバイスID、単一のクリックID、単一のユーザーID、または複数のユーザー候補IDのいずれかを指定します。単一のユーザー候補IDパラメータの候補IDリストを使用することが許可されています。
Display Click ID	広告クリックの一意の識別子です。
Match ID	各コンバージョンイベントに広告主が割り当てた一意の識別子です。
Impression ID	各インプレッションに割り当てられた一意の識別子です。

追加パラメータ

パラメータ	説明
Ordinal	(必須) コンバージョンの序数です。同じユーザーと日のコンバージョンを重複排除するために使用されます。
Timestamp	コンバージョンのタイムスタンプで、Unixエポックマイクロ秒です。提供されていない場合、自動生成されます。
Limit Ad Tracking	レポートのみに使用する場合は`true`に構成します。ターゲティングには使用されません。
Child Directed Treatment	子供向けのコンバージョンである場合は`true`に構成します。
Non-Personalized Ad	非パーソナライズ広告のコンバージョンである場合は`true`に構成します。
Treatment For Underage	リクエストが未成年者からの可能性がある場合は`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が指定されている場合に必要です。暗号化されたクッキーが広告配信またはデータ転送から受け取られたかを説明します。

数量と価値

パラメータ	説明
数量	変換の数量。マッピングされていない場合、デフォルト値は `1` です。
価値	変換の価値。

カスタムデータ

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

カスタムデータ配列 - レガシー

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