Search Ads 360 Reporting API versi sebelumnya akan dihentikan dan dinonaktifkan pada 30 Juni 2024. Perhatikan bahwa Search Ads 360 Conversion API tidak terpengaruh dan akan terus didukung. Semua pengembangan pelaporan baru harus menggunakan Search Ads 360 Reporting API versi baru.

Mulai April 2024, error supportedApiVersion akan ditampilkan saat meminta laporan. Lihat detailnya di sini.

Sebaiknya migrasikan juga penerapan Search Ads 360 yang ada ke API baru. Lihat Memulai dan Panduan Migrasi Search Ads 360 Reporting API versi baru untuk mendapatkan informasi selengkapnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Conversion

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

Untuk 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
    }
  ]
}

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`	Mewakili izin untuk preferensi layanan platform inti (CPS) di setelan. Tidak ada nilai default. Nilai yang dapat diterima: GRANTED: Status izin yang diinginkan adalah memberikan. Baca preferensi CPS dari setelan GTE. DITOLAK: Status izin yang diinginkan adalah menolak; Daftar CPS kosong.
`conversion[].advertiserId`	`long`	ID pengiklan DS.
`conversion[].agencyId`	`long`	ID agensi DS.
`conversion[].attributionModel`	`string`	Hanya tersedia bagi pengiklan setelah menghubungi dukungan pelanggan DoubleClick Search.
`conversion[].campaignId`	`long`	ID kampanye DS.
`conversion[].channel`	`string`	Saluran penjualan produk. Nilai yang dapat diterima: "`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 yang berarti bagi mereka. Setiap konversi dalam permintaan harus menentukan ID unik, dan kombinasi ID serta 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 epoch milidetik UTC.
`conversion[].conversionTimestamp`	`unsigned long`	Waktu saat konversi terjadi, dalam epoch milidetik UTC.
`conversion[].countMillis`	`long`	Hanya tersedia bagi pengiklan setelah menghubungi dukungan pelanggan DoubleClick Search.
`conversion[].criterionId`	`long`	ID (kata kunci) kriteria 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 tempat konversi terjadi. Nilai yang dapat diterima: "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`conversion[].dsConversionId`	`long`	ID yang dihasilkan 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 dibuat 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 1000000, 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 sesuai (misalnya, nama aktivitas Floodlight DoubleClick Search).
`conversion[].segmentationType`	`string`	Jenis segmentasi konversi ini (misalnya, `FLOODLIGHT`). Nilai yang dapat diterima: "`FLOODLIGHT`"
`conversion[].state`	`string`	Status konversi, yaitu `ACTIVE` atau `REMOVED`. Catatan: status DELETED tidak digunakan lagi. Nilai yang dapat diterima: "`ACTIVE`" "`DELETED`": (Tidak digunakan lagi) "`REMOVED`"	dapat ditulis
`conversion[].storeId`	`string`	ID toko lokal tempat produk yang diiklankan. Hanya berlaku saat saluran adalah "`local`".
`conversion[].type`	`string`	Jenis konversi, yaitu `ACTION` atau `TRANSACTION`. Konversi `ACTION` adalah tindakan dari pengguna yang tidak memiliki nilai yang dapat dihitung secara moneter, sedangkan konversi `TRANSACTION` adalah tindakan yang memiliki nilai yang dapat dihitung secara monetisasi. Contohnya adalah pendaftaran milis (`ACTION`) versus pembelian e-commerce (`TRANSACTION`). Nilai yang dapat diterima: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	Mengidentifikasi ini sebagai resource ConversionList. Nilai: string tetap `doubleclicksearch#conversionList`.

Metode

dapatkan: Mengambil daftar konversi dari akun DoubleClick Search Engine.
getByCustomerId: Mengambil daftar konversi dari akun DoubleClick Search Engine menggunakan ID pelanggan Search Ads 360 versi baru.
sisipkan: Menyisipkan sekumpulan konversi baru ke DoubleClick Search.
info terbaru: Memperbarui batch konversi di DoubleClick Search.
updateAvailability: Memperbarui ketersediaan sekumpulan aktivitas Floodlight di DoubleClick Search.