整合 DDM，追蹤第三方應用程式

以下端對端流程說明廣告主設定和第三方實作程序，這些程序是使用第三方應用程式追蹤解決方案，在 DoubleClick 買方產品上放送廣告活動時的必要步驟。

如要進一步瞭解 DoubleClick 數位行銷，以及應用程式內歸因功能總覽，請參閱 DoubleClick 數位行銷背景資訊頁面。

  1. 廣告主在 DDM 中設定轉換事件，代表安裝次數或轉換次數 (僅限 Bid Manager - 轉換像素) (Campaign Manager - Floodlight 活動)。

  2. 廣告主在第三方介面「連結」DDM 轉換事件，並提供可識別廣告主和轉換活動群組的重要變數。

    • src 是廣告主 ID，用來識別 Floodlight 活動來源。
    • cat 是活動代碼字串，Floodlight 伺服器會使用這項資訊來識別活動所屬的活動群組。
    • type 是群組代碼字串，用來識別 Floodlight 活動所連結的活動群組。
    • u1, u2, ... (如果有的話) 是 Floodlight 自訂變數鍵/值。

  3. 廣告主新增變數，表示同意聲明收集作業符合《數位市場法》規定。

    • eea，用於識別歐洲經濟區使用者。
      • eea=0 表示使用者不在歐洲經濟區。
      • eea=1 表示使用者來自歐洲經濟區。
    • 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 參數並傳回警告。
      • 傳回含有虛假點擊的多重回應。
      • 將轉換記錄為測試轉換。

  4. 此外，廣告主還需要向第三方提供專屬授權權杖：

    token 是廣告主專屬的英數字元字串，必須連同每個伺服器要求一併傳送至 DDM。

  5. 廣告主在即時出價廣告交易平台，透過 DBM 放送應用程式內廣告活動的廣告代碼，或在直接購買的媒體上，透過 DCM 放送廣告代碼。

  6. 使用者看到並點按廣告，DDM 會記錄這些動作。

  7. 當使用者安裝應用程式或完成轉換事件 (例如「玩遊戲」) 時，第三方伺服器會針對每個應用程式活動「ping」DDM：

    非歐洲經濟區使用者的網址範例

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

    歐洲經濟區使用者的網址範例

    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 可判斷使用者是否位於歐洲經濟區。
    • 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 是整數，如果使用者已啟用廣告識別碼或廣告 ID 的「限制廣告追蹤」選項，這個值為 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 (如果歸因 = 1) 是最後一次曝光的廣告 ID。
    • last_impression_site_id (如果已歸因 = 1) 是最後一次曝光的網站 ID。
    • last_impression_placement_id (如果 attributed = 1) 是最後一次曝光的刊登位置 ID。
    • last_impression_creative_id (如果 attributed = 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

    自 2024 年 3 月《數位市場法》生效起，您也可以使用下列欄位：

    • 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 是廣告主 ID，擁有產生廣告事件的廣告活動。
        • 如果 product 是 DBM，這個欄位代表 DBM 廣告主 ID。
        • 如果 product 是 DCM，這個欄位代表 DCM 廣告主 ID。
      • creative_id 是產生廣告事件的廣告素材廣告單元 ID。
        • 如果 product 是 DBM，這個欄位代表 DBM 廣告素材 ID。
        • 如果是 DCM product，這個欄位代表 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 月《數位市場法》生效後的其他範例回覆

    以下是已歸因轉換追蹤回應的範例，其中轉換歸因於搜尋和 YouTube 廣告互動，但搜尋和 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"
  }
]}