本頁面由 Cloud Translation API 翻譯而成。

第三方應用程式整合的 DoubleClick 數位行銷整合服務

以下的端對端流程同時說明廣告客戶設定和第三方導入方式，以便透過第三方應用程式追蹤解決方案在 DoubleClick 買方產品上放送廣告活動。如需 DoubleClick 數位行銷的一般資訊及應用程式內歸因功能總覽，請參閱 DoubleClick 數位行銷背景網頁。

廣告客戶在 DoubleClick 中設定轉換事件，代表安裝/轉換 (僅限 Bid Manager - 轉換像素) (Campaign Manager - Floodlight 活動)。
廣告客戶「連結」在第三方介面中的 DoubleClick 數位行銷事件，並提供可識別廣告客戶和轉換活動群組的變數。
- src 是 Floodlight 活動的來源廣告客戶 ID。
- cat 是活動代碼字串，Floodlight 伺服器會使用這項資訊來識別活動所屬的活動群組。
- type 是群組標記字串，用來識別與 Floodlight 活動相關聯的活動群組。
- u1, u2, ... (如果有的話) 是 Floodlight 自訂變數鍵/值。
此外，廣告客戶必須向第三方提供其專屬的授權憑證：token 是廣告客戶專屬的英數字元字串，必須隨著伺服器要求與 DoubleClick 一起傳遞。
廣告客戶在應用程式內放送廣告活動時，使用 DBM 透過即時出價廣告交易平台提供的廣告代碼，或是 DCM 直接在直接購買媒體上放送的廣告代碼。
使用者看到並/或點擊廣告，而這項資料是由 DoubleClick 紀錄所記錄。
使用者安裝應用程式並/或完成轉換事件 (「遊戲過程」等) 時，第三方伺服器會「針對」應用程式活動進行 DoubleClick 活動
```
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 自訂變數鍵/值。
在 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 是大寫的廣告識別碼或 Google Play 廣告 ID 值的 MD5 雜湊字串。
- lmt 是整數，如果使用者已啟用 [限制廣告追蹤] 選項且值為 IDFA/AdID，則值為 1；如果未設定，則值為 0。
DoubleClick 將透過 JSON 回應，回應轉換事件是否歸因於 DCM 所產生檢視或點擊；如果是「YES」時，也會提供該事件的其他相關資訊 (「上次檢視」或「點擊」)。
```
- 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) 是最終曝光的廣告編號。
- last_impression_site_id (如果歸屬 = 1) 是最終曝光的網站 ID。
- last_impression_placement_id (如果歸屬 = 1) 是最終曝光的刊登位置編號。
- last_impression_creative_id (如果歸屬 = 1) 是最終曝光的廣告素材 ID。
- last_click_ad_id (如果歸屬 = 1 且點擊功勞歸屬) 是最終點擊的廣告 ID。
- last_click_site_id (如果歸屬 = 1 且點擊歸屬) 是最終點擊的網站編號。
- last_click_placement_id (如果歸屬 = 1 且點擊功勞歸屬) 是最終點擊的刊登位置編號。
- last_click_creative_id (如果歸屬 = 1 且點擊功勞歸屬) 是最終點擊的廣告素材 ID。
- last_click_exclid 會對應至透過 %eiid! 巨集填入的專屬點擊 ID
並傳回 HTTP 錯誤代碼：
- 如果超過要求配額，則 HTTP 204。
- 如果要求被視為無效 (例如缺少必要參數)，且伺服器已恢復為像素追蹤，則傳回 HTTP 400。
- 如果授權憑證無效，則為 HTTP 401。
- HTTP 404 錯誤。
廣告客戶將能在您的系統中查看廣告活動報表；此外，廣告客戶也能在 DCM 中查看使用上述參數的參數報表。