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)を使用してください。

Report Builderで有料検索レポートを実行し、暗号化されたユーザー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パラメータ

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

ユーザー/デバイスID

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

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

暗号化ソース

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

数量と価値

パラメータ	説明
Ordinal	必須。コンバージョンの序数です。同じユーザーと日のコンバージョンを重複排除するために使用されます。
Limit Ad Tracking	レポートのみに使用する場合は `true` に構成します。ターゲティングには使用しません。
Timestamp in micros	コンバージョンのタイムスタンプで、Unixエポックマイクロ秒です。提供されていない場合、自動生成されます。
Child Directed Treatment	子供向けのコンバージョンである場合は `true` に構成します。
Non-Personalized Ad	非パーソナライズ広告のコンバージョンである場合は `true` に構成します。
Treatment For Underage	リクエストが未成年者からのものである可能性がある場合（GDPRを参照）は `true` に構成します。

カスタムデータ

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

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

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