Conversion

Resource konversi memiliki metode yang memungkinkan pengguna membuat, mengubah, dan mengambil konversi Floodlight secara massal. 

Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.

Representasi resource

Daftar konversi.

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string,
      "sessionAttributesEncoded": bytes
    }
  ]
}
Nama properti Nilai Deskripsi Catatan
conversion[] list Konversi yang diminta.
conversion[].adGroupId long ID grup iklan DS.
conversion[].adId long ID iklan DS.
conversion[].adUserDataConsent string Merepresentasikan izin untuk preferensi layanan platform inti (CPS) di setelan. Tidak ada nilai default. Nilai yang dapat diterima adalah: GRANTED: Status izin yang diinginkan adalah izin diberikan. Baca preferensi CPS dari setelan GTE. DENIED: Status izin yang diinginkan adalah izin ditolak; daftar CPS kosong.

Nilai yang dapat diterima adalah:
  • "DENIED"
  • "GRANTED"
  • "UNKNOWN"
conversion[].advertiserId long ID pengiklan DS.
conversion[].agencyId long ID agensi DS.
conversion[].attributionModel string Hanya tersedia untuk pengiklan setelah menghubungi dukungan pelanggan DoubleClick Search.
conversion[].campaignId long ID kampanye DS.
conversion[].channel string Saluran penjualan untuk produk. Nilai yang dapat diterima adalah:
  • "local": toko fisik
  • "online": toko online
conversion[].clickId string ID klik DS untuk konversi.
conversion[].conversionId string Untuk konversi offline, pengiklan memberikan ID ini. Pengiklan dapat menentukan ID apa pun yang berarti bagi mereka. Setiap konversi dalam permintaan harus menentukan ID unik, dan kombinasi ID dan stempel waktu harus unik di antara semua konversi dalam pengiklan.
Untuk konversi online, DS menyalin dsConversionId atau floodlightOrderId ke properti ini, bergantung pada petunjuk Floodlight pengiklan.
conversion[].conversionModifiedTimestamp unsigned long Waktu saat konversi terakhir diubah, dalam milidetik epoch UTC.
conversion[].conversionTimestamp unsigned long Waktu konversi terjadi, dalam epoch millis UTC.
conversion[].countMillis long Hanya tersedia untuk pengiklan setelah menghubungi dukungan pelanggan DoubleClick Search.
conversion[].criterionId long ID kriteria (kata kunci) DS.
conversion[].currencyCode string Kode mata uang untuk pendapatan konversi. Harus dalam format alfabet ISO 4217 (3 karakter). dapat ditulis
conversion[].customDimension[] list Dimensi kustom untuk konversi, yang dapat digunakan untuk memfilter data dalam laporan.
conversion[].customDimension[].name string Nama dimensi kustom.
conversion[].customDimension[].value string Nilai dimensi kustom.
conversion[].customMetric[] list Metrik kustom untuk konversi.
conversion[].customMetric[].name string Nama metrik kustom.
conversion[].customMetric[].value double Nilai numerik metrik kustom.
conversion[].customerId string ID pelanggan Search Ads 360 versi baru. Harus berupa akun klien. Jika kolom ini ditetapkan, semua kolom ID lainnya harus ditetapkan ke ID Search Ads 360 versi baru.
conversion[].deviceType string Jenis perangkat yang digunakan untuk melakukan konversi.

Nilai yang dapat diterima adalah:
  • "DESKTOP"
  • "HIGH_END_MOBILE"
  • "OTHER_DEVICE"
  • "TABLET"
conversion[].dsConversionId long ID yang dibuat DoubleClick Search untuk setiap konversi.
conversion[].engineAccountId long ID akun mesin DS.
conversion[].floodlightOrderId string ID pesanan Floodlight yang diberikan oleh pengiklan untuk konversi.
conversion[].inventoryAccountId long ID yang dihasilkan dan digunakan DS untuk mengidentifikasi akun inventaris yang berisi produk secara unik.
conversion[].productCountry string Negara yang terdaftar untuk feed Merchant Center yang berisi produk. Gunakan kode ISO 3166 untuk menentukan negara.
conversion[].productGroupId long ID grup produk DS.
conversion[].productId string ID produk (SKU).
conversion[].productLanguage string Bahasa yang terdaftar untuk feed Merchant Center yang berisi produk. Gunakan kode ISO 639 untuk menentukan bahasa.
conversion[].quantityMillis long Jumlah konversi ini, dalam milidetik. dapat ditulis
conversion[].revenueMicros long Jumlah pendapatan dari konversi TRANSACTION ini, dalam mikro (nilai dikalikan dengan 1.000.000, tanpa desimal). Misalnya, untuk menentukan nilai pendapatan "10", masukkan "10000000" (10 juta) dalam permintaan Anda. dapat ditulis
conversion[].segmentationId long ID segmentasi numerik (misalnya, ID aktivitas Floodlight DoubleClick Search).
conversion[].segmentationName string ID segmentasi yang mudah dipahami (misalnya, nama aktivitas Floodlight DoubleClick Search).
conversion[].segmentationType string Jenis segmentasi konversi ini (misalnya, FLOODLIGHT).

Nilai yang dapat diterima adalah:
  • "FLOODLIGHT"
conversion[].sessionAttributesEncoded bytes Atribut sesi untuk peristiwa, yang direpresentasikan sebagai string JSON yang dienkode base64. Konten harus dibuat oleh library yang disediakan Google.
conversion[].state string Status konversi, yaitu ACTIVE atau REMOVED. Catatan: status DELETED tidak digunakan lagi.

Nilai yang dapat diterima adalah:
  • "ACTIVE"
  • "DELETED":  (Tidak digunakan lagi)
  • "REMOVED"
 dapat ditulis
conversion[].storeId string ID toko lokal tempat produk diiklankan. Hanya berlaku jika salurannya "local".
conversion[].type string Jenis konversi, yaitu ACTION atau TRANSACTION. Konversi ACTION adalah tindakan pengguna yang tidak memiliki nilai yang dapat diukur secara moneter, sedangkan konversi TRANSACTION adalah tindakan yang memiliki nilai yang dapat diukur secara moneter. Contohnya adalah pendaftaran daftar email (ACTION) versus pembelian e-commerce (TRANSACTION).

Nilai yang dapat diterima adalah:
  • "ACTION"
  • "TRANSACTION"
kind string Mengidentifikasinya sebagai resource ConversionList. Nilai: string tetap doubleclicksearch#conversionList.

Metode

get
Mengambil daftar konversi dari akun mesin DoubleClick Search.
getByCustomerId
Mengambil daftar konversi dari akun mesin DoubleClick Search menggunakan ID pelanggan Search Ads 360 versi baru.
insert
Menyisipkan batch konversi baru ke DoubleClick Search.
update
Memperbarui batch konversi di DoubleClick Search.
updateAvailability
Memperbarui ketersediaan batch aktivitas floodlight di DoubleClick Search.