适用于第三方应用跟踪的 DDM 集成

以下端到端流程将介绍在使用第三方应用跟踪解决方案的情况下，为了在 DoubleClick 买方产品上投放广告系列而需要执行的广告客户设置和第三方实现。

如需详细了解 DoubleClick 数字营销概览以及应用内归因功能概览，请参阅 DoubleClick 数字营销背景信息页。

  1. 广告客户在 DDM 中设置转化事件以表示安装或转化（仅限 Bid Manager - 转化像素）（Campaign Manager - Floodlight 活动）。

  2. 广告客户“关联”第三方界面中的 DDM 转化事件，并提供标识广告客户和转化活动组的主要变量。

    • src 是广告客户 ID，即 Floodlight 活动的来源。
    • cat 是活动代码字符串，Floodlight 服务器用它来标识活动所属的活动组。
    • type 是组代码字符串，用于标识与 Floodlight 活动相关联的活动组。
    • u1, u2, ...（如果有）是自定义 Floodlight 变量键值对。

  3. 广告客户添加变量，表明已根据《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 参数并返回警告。
      • 返回包含虚假点击的多重响应。
      • 将转化记录为测试转化。

  4. 此外，广告客户需要向第三方提供其特定的授权令牌：

    token 是广告客户专有的字母数字字符串，必须随各个服务器请求一起传递到 DDM。

  5. 广告客户使用 DBM 在实时出价广告交易平台投放的广告代码或 DCM 在直接购买的媒体上投放的广告代码来投放应用内广告系列。

  6. 最终用户看到并点击广告。DDM 记录最终用户的活动数据。

  7. 如果最终用户安装应用或完成转化事件（例如“玩游戏”），则第三方服务器会基于每项应用活动对 DDM 执行“ping”操作：

    不属于 EEA 用户的网址示例

    https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0

    面向 EEA 用户的网址示例

    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 是广告客户 ID，即 Floodlight 活动的来源。
    • cat 是活动代码字符串，Floodlight 服务器用它来标识活动所属的活动组。
    • type 是组代码字符串，用于标识与 Floodlight 活动相关联的活动组。
    • ord 是用于使 Floodlight 代码具有唯一性的随机数字。
    • u1, u2, ...（如果有）是自定义 Floodlight 变量键值对。
    • 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 会使用 JSON 响应进行回应，以指示转化事件是否归因于 DCM 投放的展示或点击；如果“是”，则会提供相关事件（最终展示或最终点击）的更多信息：

    • 广告 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 表示相应事件所属的核心平台服务
      • 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 是拥有产生广告事件的广告系列的广告客户标识符。
        • 如果 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 表示广告事件所属的核心平台服务。 如需了解详情，请参阅本文档前面部分中对 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"
  }
]}