このページは Cloud Translation API によって翻訳されました。

サードパーティアプリトラッキング向けの DDM 統合

次のエンドツーエンドのフローでは、サードパーティアプリのトラッキングソリューションを使って DoubleClick のバイサイド向けサービスでキャンペーンを実行するために必要な広告主様の設定とサードパーティによる実装の両方を示しています。

DoubleClick Digital Marketing の全般的な情報や、アプリ内アトリビューション機能の概要については、DoubleClick Digital Marketing の背景ページをご覧ください。

広告主様は、インストールまたはコンバージョン（Bid Manager のみ - コンバージョンピクセル）（キャンペーンマネージャー - Floodlight アクティビティ）を表すコンバージョンイベントを DDM で設定します。
広告主様は、サードパーティインターフェースで DDM コンバージョンイベントを「リンク」し、広告主様とコンバージョンのアクティビティグループを識別するキー変数を入力します。
- src: Floodlight アクティビティの発生元である広告主 ID。
- cat: アクティビティタグ文字列。アクティビティの所属先アクティビティグループを識別するために Floodlight サーバーで使用されます。
- type: グループタグ文字列。Floodlight アクティビティが関連付けられているアクティビティグループを表します。
- u1, u2, ...（利用可能な場合）: カスタム Floodlight 変数の Key-Value。
広告主様が、DMA コンプライアンスのための同意収集を示す変数を追加します。
- eea は EEA ユーザーの識別に使用されます。
  - eea=0 は、ユーザーが EEA のユーザーではないことを示します。
  - eea=1 は、ユーザーが EEA のユーザーであることを示します。
- ad_user_data は、広告目的でのユーザーデータの使用に関する同意フラグです。
  - eea=1 の場合にのみ設定する必要があります
  - ad_user_data=0 は、ユーザーが広告目的でユーザーレベルのデータを Google に送信することへの同意を拒否したことを示します。
  - ad_user_data=1 は、広告目的でユーザーレベルのデータを Google に送信することについてユーザーが同意していることを示します。
- npa は、広告のパーソナライズコンテンツに使用されます。
  - npa=0 は、ユーザーがパーソナライズに同意していることを示します。
  - npa=1 は、ユーザーがパーソナライズに同意していないことを示します。
- test_request_reason=dma を使用して DMA パラメータをテストできます。
  - すべての DMA パラメータを検証し、警告を返します。
  - 偽のクリックを含むマルチレスポンスを返します。
  - コンバージョンをテストコンバージョンとして記録します。
さらに、広告主様は特定の認証トークンをサードパーティに提供する必要があります。

token は広告主様固有の英数字の文字列で、サーバーリクエストごとに DDM に渡さなければならないものです。
広告主様は、リアルタイムビッディングの取引で DBM によって配信される広告タグか、直接購入メディアで DCM によって配信される広告タグを使って、アプリ内広告キャンペーンを実施します。
エンドユーザーは DDM によって記録された広告を見たり、クリックしたりします。
エンドユーザーがアプリをインストールしたり、「ゲームプレイ」などのコンバージョンイベントを完了すると、サードパーティサーバーはアプリのすべてのアクティビティに DDM を「ping」します。

EEA 以外のユーザー向けの URL の例
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
EEA のユーザー向けの URL の例
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
```
ここで
- src: Floodlight アクティビティの発生元である広告主 ID。
- cat: アクティビティタグ文字列。アクティビティの所属先アクティビティグループを識別するために Floodlight サーバーで使用されます。
- type: グループタグ文字列。Floodlight アクティビティが関連付けられているアクティビティグループを表します。
- ord: Floodlight タグを一意にするために使用される乱数。
- u1, u2, ...（利用可能な場合）: カスタム Floodlight 変数の Key-Value。
- eea は、ユーザーが EEA に居住しているかどうかを識別します。
- ad_user_data は、ユーザーが Cookie と測定に同意したかどうかを識別します。
- npa は、ユーザーがパーソナライズに同意しているかどうかを識別します。
HTTP POST で JSON ペイロードを経由して追加のパラメータが送信されます。
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (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: ユーザーが IDFA または AdID で「広告トラッキング制限」オプションを有効にしている場合は 1、設定されていない場合は 0。
DDM では、コンバージョンイベントが DCM によって配信されるビューまたはクリックに起因しているかどうかが JSON レスポンスで示され、起因している場合はそのイベント（最後のビューまたは最後のクリック）に関する追加情報が示されます。
- 広告 ID
- サイト ID
- プレースメント ID
- クリエイティブ ID
- タイムスタンプ
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",
  "cps": <cps>,
  "ad_events": [
    <ad event objects>
  ],
  "warnings": [<warning strings>],
  "errors": [<error strings>],
}
```
ここで
- attributed: 1（コンバージョンがインプレッションまたはクリックに起因する場合）または 0（アトリビューション不可の場合）の値。
- last_impression_ad_id（attributed = 1 の場合）: 最後のインプレッションの広告 ID。
- last_impression_site_id（attributed = 1 の場合）: 最後のインプレッションのサイト ID。
- last_impression_placement_id（attributed = 1 の場合）: 最後のインプレッションのプレースメント ID。
- last_impression_creative_id（attributed = 1 の場合）: 最後のインプレッションのクリエイティブ ID。
- last_click_ad_id（attributed = 1、クリックが起因していた場合）: 最後のクリックの広告 ID。
- last_click_site_id（attributed = 1、クリックが起因していた場合）: 最後のクリックのサイト ID。
- last_click_placement_id（attributed = 1、クリックが起因していた場合）: 最後のクリックのプレースメント ID。
- last_click_creative_id（attributed = 1、クリックが起因していた場合）: 最後のクリックのクリエイティブ ID。
- last_click_exclid: %eiid! マクロを使って入力された一意のクリック ID。
2024 年 3 月の DMA 施行に伴い、以下のフィールドも利用可能になります。
- cps は、イベントが属する Core Platform Service を示します。
  - a : 広告
  - m : マップ
  - p : Play ストア
  - s : 検索
  - h : ショッピング
  - y : YouTube
- ad_events は、すべてのコンバージョンイベントを含む ad_event オブジェクトの配列です。
  - ad_event オブジェクトには次のフィールドがあります。
  - product_type は、コンバージョンを担当したプロダクトをレポートする文字列です。DCM または DBM のいずれかになります。
  - interaction_type は、イベントにつながったインタラクションのタイプです。impression または click のいずれか。
  - conversion_metric は、アトリビューションに使用されるコンバージョン指標です。conversion または view_through_conversion のいずれか。
  - timestamp は、広告イベントが発生した UNIX タイムスタンプ（マイクロ秒単位）です。この値はラストクリックアトリビューションで使用されます。
  - campaign_type は、広告イベントが発生したキャンペーンのタイプを示します。
  - line_item_id （DBM のみ）は、広告イベントを生成した DBM 広告申込情報 ID です。
  - line_item_name （DBM のみ）は、広告イベントを生成した DBM 広告申込情報の名前です。
  - placement_id （DCM のみ）は、広告イベントを生成した DCM プレースメントタグ ID です。
  - placement_name （DCM のみ）は、広告イベントを生成した DCM プレースメントタグの名前です。
  - external_customer_id は、広告イベントが発生したキャンペーンを所有する広告主の ID です。
    - product が DBM の場合、このフィールドは DBM 広告主 ID を表します。
    - product が DCM の場合、このフィールドは DCM 広告主 ID を表します。
  - creative_id は、広告イベントが発生したクリエイティブ広告ユニットの ID です。
    - product が DBM の場合、このフィールドは DBM クリエイティブ ID を表します。
    - product が DCM の場合、このフィールドは DCM クリエイティブ ID を表します。
  - exchange_id （DBM のみ） は、DBM 広告を配信したエクスチェンジの ID です。
  - insertion_order_id （DBM のみ）は DBM 広告掲載オーダー ID です。
  - site_id （DCM のみ）は、広告イベントの DCM サイト ID です。
  - cps は、広告イベントが属する Core Platform Service を示します。詳細については、ドキュメントの冒頭にある cps フィールドの説明をご覧ください。
- warnings は、コンバージョンイベントによって生成された警告の配列です。
- errors は、次のシナリオで HTTP エラーコードとともに変換イベントによって生成されたエラーの配列です。
  - HTTP 204: リクエスト割り当て数を超過している場合。
  - リクエストが無効と見なされた場合（必要なパラメータが欠落しているなど）、サーバーがピクセルトラッキングにフォールバックした場合は HTTP 400。
  - HTTP 401: 認証トークンが無効な場合。
  - HTTP 404: リクエストエラーがあった場合。
広告主様は、システムでキャンペーンレポートを見ることができます。また、同じパラメータを使って、DCM でコンバージョンレポートを確認することも可能です。

2024 年 3 月に DMA が施行された後のレスポンス例の追加

コンバージョンが検索広告と YouTube 広告の両方のインタラクションに帰属し、検索 CPS と YouTube CPS の間で 5(2)(b) + 5(2)(c) のクロスユースの同意が拒否された場合の、帰属コンバージョントラッキングレスポンスの例:
```
{
  attributed: 1,
  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: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
  cps: "s",
  ad_events: [{
      cps : "s",
      product_type: "DCM",
      interaction_type: "click",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647655.123456,
      site_id: 1408067,
      }, {
      cps : "s",
      product_type:"DCM",
      interaction_type: "impression",
      ad_event_type: "impression",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647607.123456,
      site_id: 1408067
      },{
      cps : "y",
      product_type: "DCM",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616370,
      placement_name: "Placement on Youtube",
      external_customer_id: 7480542,
      creative_id: 6016444,
      timestamp: 14344344.123456,
      site_id: 140806
      },
  ]}
```
DBM キャンペーンの場合、肯定的なコンバージョントラッキングレスポンスのサンプルは以下のようになります。
```
{
  attributed: 1,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id :60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
  cps: "y",
  ad_events: [{
    product_type: "DBM",
    interaction_type: "click",
    ad_event_type: "click",
    campaign_type: "Display",
    line_item_id: 123456789,
    line_item_name: "TEST LINE ITEM NAME",
    external_customer_id: 2550,
    creative_id: 512333,
    exchange_id: 132,
    insertion_order_id: 523423,
    timestamp: 1432681913.123456
    cps: "y"
  },
  {
    product_type: "DCM",
    interaction_type: "click",
    campaign_type: "Display",
    placement_id: 9342323,
    placement_name: "TEST PLACEMENT NAME",
    external_customer_id: 7480542,
    creative_id: 8234234,
    timestamp: 1432681913.123456,
    cps: "y"
  }
]}
```

サードパーティ アプリ トラッキング向けの DDM 統合 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

サードパーティアプリトラッキング向けの DDM 統合