Halaman ini diterjemahkan oleh Cloud Translation API.

Integrasi DDM untuk Pelacakan Aplikasi Pihak Ketiga

Alur end-to-end berikut menjelaskan penyiapan pengiklan dan penerapan pihak ketiga yang diperlukan untuk menjalankan kampanye di produk sisi pembelian DoubleClick menggunakan solusi pelacakan aplikasi pihak ketiga.

Untuk mengetahui informasi selengkapnya tentang DoubleClick Digital Marketing secara umum serta ringkasan fitur atribusi dalam aplikasi, lihat halaman latar belakang DoubleClick Digital Marketing.

Pengiklan menyiapkan Peristiwa konversi di DDM untuk merepresentasikan penginstalan atau konversi (khusus Bid Manager - piksel konversi) (Campaign Manager - aktivitas Floodlight).
Pengiklan "menautkan" peristiwa konversi DDM di antarmuka pihak ketiga dan menyediakan variabel utama yang mengidentifikasi grup aktivitas konversi dan pengiklan.
- src adalah ID pengiklan yang merupakan sumber aktivitas Floodlight.
- cat adalah string tag aktivitas, yang digunakan server Floodlight untuk mengidentifikasi grup aktivitas yang menjadi tujuan aktivitas.
- type adalah string tag grup, yang mengidentifikasi grup aktivitas yang terkait dengan aktivitas Floodlight.
- u1, u2, ... (jika tersedia) adalah nilai kunci variabel Floodlight kustom.
Pengiklan menambahkan variabel untuk menandakan pengumpulan izin untuk kepatuhan DMA.
- eea digunakan untuk mengidentifikasi pengguna EEA.
  - eea=0 menunjukkan bahwa pengguna tidak berasal dari EEA.
  - eea=1 menunjukkan bahwa pengguna berasal dari EEA.
- ad_user_data adalah tanda izin untuk penggunaan data pengguna untuk tujuan iklan.
  - Hanya perlu disetel jika eea=1
  - ad_user_data=0 menunjukkan bahwa pengguna telah menolak izin untuk transmisi data tingkat pengguna ke Google untuk tujuan iklan.
  - ad_user_data=1 menunjukkan bahwa pengguna telah memberikan izin untuk transmisi data tingkat pengguna ke Google untuk tujuan iklan.
- npa digunakan untuk konten personalisasi iklan.
  - npa=0 menunjukkan bahwa pengguna menyetujui personalisasi.
  - npa=1 menunjukkan bahwa pengguna belum mengizinkan personalisasi.
- test_request_reason=dma dapat digunakan untuk menguji parameter DMA
  - Memvalidasi semua parameter DMA dan menampilkan peringatan.
  - Menampilkan multi-respons dengan klik palsu.
  - Mencatat konversi sebagai konversi pengujian.
Selain itu, pengiklan harus memberikan token otorisasi spesifiknya 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 di bursa bidding real-time atau ditayangkan oleh DCM di media yang dibeli langsung.
Pengguna akhir melihat dan mengklik iklan, yang dicatat oleh DDM.
Saat pengguna akhir menginstal aplikasi atau menyelesaikan peristiwa konversi, seperti "gameplay", server pihak ketiga akan "membuat ping" ke DDM di setiap aktivitas aplikasi:

Contoh URL untuk pengguna yang tidak berada di EEA
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
Contoh URL untuk pengguna di 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
```
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 menjadi tujuan aktivitas.
- type adalah string tag grup, yang mengidentifikasi grup aktivitas yang terkait dengan aktivitas Floodlight.
- ord adalah angka acak yang digunakan untuk membuat tag Floodlight menjadi unik.
- u1, u2, ... (jika tersedia) adalah nilai kunci variabel Floodlight kustom.
- eea mengidentifikasi apakah pengguna berada di EEA.
- ad_user_data mengidentifikasi apakah pengguna mengizinkan cookie dan Pengukuran.
- npa mengidentifikasi apakah pengguna memberikan izin untuk personalisasi.
dengan parameter tambahan yang dikirim melalui payload JSON dalam HTTP POST:
```
{
  "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
  }
}
```
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 merepresentasikan 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 dari 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 merepresentasikan string agen pengguna dari aplikasi tempat aktivitas direkam. Parameter ini wajib diisi.
- ip (jika tersedia) adalah alamat IPv4 perangkat yang ditetapkan ke perangkat. Parameter ini wajib diisi.
- didmd5 adalah string hash MD5 dari nilai IDFA atau ID Iklan Google Play yang hurufnya diubah menjadi huruf besar.
- lmt adalah bilangan bulat, dengan nilai 1 jika pengguna telah mengaktifkan opsi "Limit Ad Tracking" dengan IDFA atau AdID, atau 0, jika tidak disetel.
DDM akan merespons dengan respons JSON tentang apakah peristiwa konversi diatribusikan ke penayangan atau klik yang ditayangkan oleh DCM, dan jika "YA", informasi tambahan tentang peristiwa (penayangan atau klik terakhir):
- Nomor Iklan
- ID Situs
- ID Penempatan
- ID Materi Iklan
- Stempel waktu
Contoh respons JSON mungkin terlihat seperti:
```
{
  "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>],
}
```
dalam hal ini:
- attributed adalah nilai 1 (jika konversi dapat diatribusikan ke tayangan iklan 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 attributed = 1) adalah ID situs untuk tayangan terakhir.
- last_impression_placement_id (jika diatribusikan = 1) adalah ID penempatan untuk tayangan iklan terakhir.
- last_impression_creative_id (jika diatribusikan = 1) adalah ID materi iklan untuk tayangan iklan terakhir.
- last_click_ad_id (jika attributed = 1 dan klik diatribusikan) adalah ID iklan untuk klik terakhir.
- last_click_site_id (jika atribusi = 1 dan klik diatribusikan) adalah ID situs untuk klik terakhir.
- last_click_placement_id (jika attributed = 1 dan klik diatribusikan) adalah ID penempatan untuk klik terakhir.
- last_click_creative_id (jika attributed = 1 dan klik diatribusikan) adalah ID materi iklan untuk klik terakhir.
- last_click_exclid sesuai dengan ID klik unik yang diisi menggunakan makro %eiid!
Mulai penegakan DMA pada Maret 2024, kolom berikut juga akan tersedia:
- cps menunjukkan Layanan Platform Inti tempat peristiwa berada
  - a : Iklan
  - m : Maps
  - p : Play Store
  - s : Penelusuran
  - h : Shopping
  - y : YouTube
- ad_events adalah array objek ad_event yang berisi semua peristiwa konversi.
  - Objek ad_event memiliki kolom berikut:
  - product_type adalah string yang melaporkan produk yang bertanggung jawab atas konversi. Nilainya adalah DCM atau DBM.
  - interaction_type adalah jenis interaksi yang menghasilkan peristiwa. Berupa impression atau click.
  - conversion_metric adalah metrik konversi yang digunakan untuk atribusi. Berupa conversion atau view_through_conversion.
  - timestamp adalah stempel waktu UNIX saat peristiwa iklan terjadi dengan presisi mikrodetik. Nilai ini harus digunakan untuk atribusi klik terakhir.
  - campaign_type mengidentifikasi jenis kampanye yang menghasilkan peristiwa iklan.
  - line_item_id (khusus DBM) adalah ID item baris DBM yang menghasilkan peristiwa iklan.
  - line_item_name (khusus DBM) adalah nama item baris DBM yang menghasilkan peristiwa iklan.
  - placement_id (khusus DCM) adalah ID tag penempatan DCM yang menghasilkan peristiwa iklan.
  - placement_name (khusus DCM) adalah nama tag penempatan DCM yang menghasilkan peristiwa iklan.
  - external_customer_id adalah ID pengiklan yang memiliki kampanye yang menghasilkan peristiwa iklan.
    - Jika product adalah DBM, kolom ini mewakili ID Pengiklan DBM.
    - Jika product adalah DCM, kolom ini mewakili ID Pengiklan DCM.
  - creative_id adalah ID unit iklan materi iklan yang menghasilkan peristiwa iklan.
    - Jika product adalah DBM, kolom ini mewakili ID Materi Iklan DBM.
    - Jika product adalah DCM, kolom ini mewakili ID Materi Iklan DCM.
  - exchange_id (khusus DBM) adalah ID bursa yang menayangkan iklan DBM.
  - insertion_order_id (khusus DBM) adalah ID perjanjian pemasangan iklan DBM.
  - site_id (khusus DCM) adalah ID situs DCM untuk peristiwa iklan.
  - cps menunjukkan Layanan Platform Inti tempat peristiwa iklan berada. Lihat penjelasan lengkap kolom cps sebelumnya dalam dokumentasi untuk mengetahui detail selengkapnya.
- warnings adalah array peringatan yang dihasilkan oleh peristiwa konversi.
- errors adalah array error yang dihasilkan oleh peristiwa konversi dengan kode error HTTP, untuk skenario berikut:
  - HTTP 204 jika kuota permintaan telah terlampaui.
  - HTTP 400 jika permintaan dianggap tidak valid—misalnya, parameter wajib diisi tidak ada, dan server telah melakukan penggantian 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.

Contoh respons tambahan setelah DMA diberlakukan pada Maret 2024

Contoh respons pelacakan konversi yang diatribusikan dengan konversi diatribusikan ke interaksi iklan Penelusuran + YouTube, tetapi izin penggunaan lintas layanan 5(2)(b) + 5(2)(c) ditolak antara CPS Penelusuran + YouTube:
```
{
  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
      },
  ]}
```
Contoh respons tracking konversi afirmatif untuk Kampanye 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"
  }
]}
```

Integrasi DDM untuk Pelacakan Aplikasi Pihak Ketiga Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Integrasi DDM untuk Pelacakan Aplikasi Pihak Ketiga