Halaman ini diterjemahkan oleh Cloud Translation API.

Integrasi DDM untuk Pelacakan Aplikasi Pihak Ketiga

Alur menyeluruh berikut menjelaskan penyiapan pengiklan dan implementasi pihak ketiga yang diperlukan untuk menjalankan kampanye di produk sisi beli DoubleClick menggunakan solusi pelacakan aplikasi pihak ketiga. Untuk informasi selengkapnya tentang DoubleClick Digital Marketing secara umum serta ringkasan fungsi atribusi dalam aplikasi, lihat halaman latar belakang DoubleClick Digital Marketing.

Pengiklan menyiapkan peristiwa Konversi di DDM untuk mewakili penginstalan/konversi (khusus Bid Manager - piksel konversi) (Campaign Manager - aktivitas Floodlight).
Pengiklan "links" Peristiwa konversi DDM di antarmuka pihak ketiga dan memberikan variabel utama yang mengidentifikasi pengiklan dan grup aktivitas konversi.
- src adalah ID pengiklan yang merupakan sumber aktivitas Floodlight.
- cat adalah string tag aktivitas, yang digunakan server Floodlight untuk mengidentifikasi grup aktivitas yang mencakup aktivitas tersebut.
- type adalah string tag grup, yang mengidentifikasi grup aktivitas yang dikaitkan dengan aktivitas Floodlight.
- u1, u2, ... (jika tersedia) adalah nilai kunci variabel Floodlight kustom.
Selain itu, pengiklan harus memberikan token otorisasi spesifik kepada pihak ketiga: token adalah string alfanumerik khusus pengiklan yang harus diteruskan bersama dengan setiap permintaan server ke DDM.
Pengiklan menjalankan kampanye iklan dalam aplikasi dengan tag iklan yang ditayangkan oleh DBM pada bursa bidding real-time atau ditayangkan oleh DCM pada media yang dibeli secara langsung.
Pengguna akhir melihat dan/atau mengklik iklan, yang dicatat dalam log oleh DDM.
Saat pengguna akhir menginstal aplikasi dan/atau menyelesaikan peristiwa konversi ("game play", dll.), server pihak ketiga "ping" DDM pada setiap aktivitas aplikasi
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
```
dalam hal ini:
- src adalah ID pengiklan yang merupakan sumber aktivitas Floodlight.
- cat adalah string tag aktivitas, yang digunakan server Floodlight untuk mengidentifikasi grup aktivitas yang mencakup aktivitas tersebut.
- type adalah string tag grup, yang mengidentifikasi grup aktivitas yang terkait dengan aktivitas Floodlight.
- ord adalah nomor acak yang digunakan untuk membuat tag Floodlight menjadi unik.
- u1, u2, ... (jika tersedia) adalah nilai kunci variabel Floodlight kustom.
dengan parameter tambahan yang dikirim melalui payload JSON dalam POST HTTP:
```
{
  "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
  }
}
```
dan token otorisasi pengiklan diteruskan di Header Otorisasi HTTP:
```
Authorization: Token token="[advertiser authorization token string]"
```
dalam hal ini:
- app (wajib) adalah objek JSON yang mewakili aplikasi tempat aktivitas konversi terjadi. Gunakan app: {} jika aplikasi tempat aktivitas konversi terjadi tidak tersedia.
- bundle (jika tersedia) adalah kolom objek aplikasi yang berisi nilai string nama paket Play Store atau ID App Store.
- device adalah objek JSON yang mewakili perangkat tempat aktivitas konversi terjadi.
- ua adalah kolom objek perangkat yang mewakili string agen pengguna aplikasi tempat aktivitas direkam. Parameter ini diperlukan.
- ip (jika tersedia) adalah alamat IPv4 perangkat yang ditetapkan untuk perangkat. Parameter ini diperlukan.
- didmd5 adalah string hash MD5 dari nilai IDFA atau ID Iklan Google Play dalam huruf besar.
- lmt adalah bilangan bulat, dengan nilai 1 jika pengguna telah mengaktifkan opsi "Batasi Pelacakan Iklan" dengan IDFA/AdID, atau 0, jika tidak ditetapkan.
DDM akan merespons dengan respons JSON apakah peristiwa konversi diatribusikan ke tampilan atau klik yang ditayangkan oleh DCM, dan jika "YES", informasi tambahan tentang peristiwa (tampilan atau klik terakhir):
```
- Ad ID
- Site ID
- Placement ID
- Creative ID
- Timestamp
```
Contoh respons JSON mungkin terlihat seperti ini:
```
{"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"}
```
dalam hal ini:
- attributed adalah nilai 1 (jika konversi dapat diatribusikan ke tayangan atau klik) atau 0 (jika tidak dapat diatribusikan).
- last_impression_ad_id (jika diatribusikan = 1) adalah ID iklan untuk tayangan terakhir.
- last_impression_site_id (jika diatribusikan = 1) adalah ID situs untuk tayangan terakhir.
- last_impression_placement_id (jika diatribusikan = 1) adalah ID penempatan untuk tayangan terakhir.
- last_impression_creative_id (jika diatribusikan = 1) adalah ID materi iklan untuk tayangan terakhir.
- last_click_ad_id (jika diatribusikan = 1 dan klik diatribusikan) adalah ID iklan untuk klik terakhir.
- last_click_site_id (jika diatribusikan = 1 dan klik diatribusikan) adalah ID situs untuk klik terakhir.
- last_click_placement_id (jika diatribusikan = 1 dan klik diatribusikan) adalah ID penempatan untuk klik terakhir.
- last_click_creative_id (jika diatribusikan = 1 dan klik diatribusikan) adalah ID materi iklan untuk klik terakhir.
- last_click_exclid sesuai dengan ID klik unik yang diisi melalui makro %eiid!
dengan kode error HTTP, untuk skenario berikut:
- HTTP 204 jika kuota permintaan telah terlampaui.
- HTTP 400 jika permintaan tersebut dianggap tidak valid (misalnya, parameter wajib tidak ada) dan server telah beralih kembali ke pelacakan piksel.
- HTTP 401 jika token otorisasi tidak valid.
- HTTP 404 untuk permintaan yang buruk.
Pengiklan akan dapat melihat laporan kampanye di sistem Anda; pengiklan juga akan dapat melihat laporan konversi di DCM dengan parameter yang sama seperti di atas.