- 広告主は、インストールやコンバージョン(Bid Manager のみ - コンバージョン ピクセル)(キャンペーン マネージャー - Floodlight アクティビティ)を表すコンバージョン イベントを DDM で設定します。
第三者インターフェースの DDM コンバージョン イベント(広告主とリンク)では、広告主とコンバージョン アクティビティ グループを識別する主要な変数を提供します。
src
は、Floodlight アクティビティのソースである広告主 ID です。cat
: アクティビティ タグ文字列。アクティビティの所属先アクティビティ グループを識別するために Floodlight サーバーで使用されます。type
は、Floodlight アクティビティが関連付けられているアクティビティ グループを識別するグループタグ文字列です。u1, u2, ...
(利用可能な場合): カスタム Floodlight 変数の Key-Value。
また、広告主は特定の認証トークンをサードパーティに提供する必要があります。
token
は広告主固有の英数字の文字列で、各サーバー リクエストと一緒に DDM に渡す必要があります。広告主は、リアルタイム ビッダーで DBM で配信される広告タグか、直接購入したメディアで DCM から配信される広告タグを使って、アプリ内キャンペーンを実施します。
エンドユーザーが DDM によって記録した広告を表示またはクリックした場合。
エンドユーザーがアプリをインストールするか、コンバージョン イベント(「ゲームプレイ」など)を完了すると、すべてのアプリ アクティビティでサードパーティ サーバーによる DDM がトリガーされます
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
ここで
src
は、Floodlight アクティビティのソースである広告主 ID です。cat
: アクティビティ タグ文字列。アクティビティの所属先アクティビティ グループを識別するために Floodlight サーバーで使用されます。type
は、Floodlight アクティビティが関連付けられているアクティビティ グループを識別するグループタグ文字列です。ord
は、Floodlight タグを一意にするために使用される乱数です。u1, u2, ...
(利用可能な場合): カスタム Floodlight 変数の Key-Value。
追加のパラメータを HTTP POST で JSON ペイロードを介して送信します。
{ "app": { "bundle": "com.rovio.angrybirds" }, "device": { "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25", "ip": "108.176.57.230", "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F", "lmt": 1 } }
広告主の認証トークンが HTTP 認証ヘッダーで渡されます。
Authorization: Token token="[advertiser authorization token string]"
ここで
app
(必須)は、コンバージョン アクティビティが発生したアプリを表す JSON オブジェクトです。コンバージョン アクティビティが発生したアプリを利用できない場合は、app: {}
を使用します。bundle
(利用可能な場合)は、Play ストア バンドル名または App Store ID の文字列値を含むアプリ オブジェクト フィールドです。device
は、コンバージョン アクティビティが発生したデバイスを表す JSON オブジェクトです。ua
は、アクティビティが記録されたアプリのユーザー エージェント文字列を表すデバイス オブジェクト フィールドです。このパラメータは必須です。ip
(該当する場合)は、デバイスに割り当てられたデバイスの IPv4 アドレスです。 このパラメータは必須です。didmd5
は、大文字の IDFA または Google Play 広告 ID 値の MD5 ハッシュ文字列です。lmt
は整数です。ユーザーが「広告のトラッキングを制限する」オプションを有効にしている場合は 1、設定されていない場合は 0 に設定されます。
DDM は、コンバージョン イベントが DCM によって配信されたビューまたはクリックに結び付けられているかどうかと、イベントに関する追加情報(最後のビューまたはクリック)に関する JSON レスポンスを返します。
- Ad ID - Site ID - Placement ID - Creative ID - Timestamp
JSON レスポンスの例を次に示します。
{"attributed": 1, // Whether the conversion can be attributed to a DCM event. "last_impression_ad_id":283641088, "last_impression_site_id":1408067, "last_impression_placement_id":107616368, "last_impression_creative_id":60162352, "last_impression_timestamp":1415647607, "last_click_ad_id":283641088, "last_click_site_id":1408067, "last_click_placement_id":107616368, "last_click_creative_id":60162352, "last_click_timestamp":1415647657, "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A"}
ここで
attributed
は、1(コンバージョンがインプレッションまたはクリックに起因する場合)または 0(アトリビューションできない場合)です。last_impression_ad_id
(アトリビューション = 1 の場合)は、最後のインプレッションの広告 ID です。last_impression_site_id
(アトリビューション = 1 の場合)は、最後のインプレッションのサイト ID です。last_impression_placement_id
(アトリビューション = 1 の場合)は、最後のインプレッションのプレースメント ID です。last_impression_creative_id
(アトリビューション = 1 の場合)は、最後のインプレッションのクリエイティブ ID です。last_click_ad_id
(アトリビューション = 1、クリックがアトリビューションされた場合)は、ラストクリックの広告 ID です。last_click_site_id
(アトリビューション = 1、クリックがアトリビューションされた場合)は、ラストクリックのサイト ID です。last_click_placement_id
(アトリビューション = 1、クリックがアトリビューションされた場合)は、ラストクリックのプレースメント ID です。last_click_creative_id
(アトリビューション = 1、クリックがアトリビューションされた場合)は、ラストクリックのクリエイティブ ID です。last_click_exclid
は、%eiid!
マクロを介して入力された一意のクリック ID に対応します。
次のシナリオでは、HTTP エラーコードが返されます。
HTTP 204
(リクエストの割り当てを超えた場合)。HTTP 400
は、リクエストが無効と見なされ(必須パラメータがないなど)、サーバーがピクセル トラッキングにフォールバックしたときです。- 認証トークンが無効である場合は、
HTTP 401
。 - 不正なリクエストの場合は、
HTTP 404
。
広告主は、ご自身のシステムでキャンペーン レポートを表示できるようになります。また、上記と同じパラメータを使って、DCM でもコンバージョン レポートを確認できるようになります。
第三者のアプリ トラッキング向けの DDM の統合
次のエンドツーエンドのフローでは、サードパーティ製アプリの設定を使用して DoubleClick の購入者向けキャンペーンでキャンペーンを実施するために必要となる広告主の設定と第三者による実装の両方を示しています。
DoubleClick Digital Marketing の全般的な情報とアプリ内アトリビューション機能の概要については、DoubleClick Digital Marketing の背景ページをご覧ください。