Data peristiwa mentah tentang konversi.
Laporan ini hanya dapat ditampilkan oleh permintaan asinkron (yaitu, melalui metode Reports.request()).
Karena peristiwa terjadi pada tanggal tertentu, permintaan untuk laporan ini harus menentukan timeRange. Anda dapat menentukan salah satu hal berikut:
- startDate dan endDate.
- changedMetricsSinceTimestamp (changedAttributesSinceTimestamp tidak valid untuk peristiwa).
Meminta kutipan
Kirim isi permintaan
Reports.request()
reguler, tetapi tentukan "reportType": "conversion"
.
{
...
"reportType": "conversion",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
Untuk setiap kolom yang ingin ditampilkan atau difilter dalam laporan,
tentukan columnName
yang tercantum dalam tabel di bawah.
Anda juga dapat secara opsional menentukan
headerText,
startDate,
dan endDate.
Perhatikan bahwa beberapa kolom tidak dapat difilter; lihat "Dapat difilter" di tabel di bawah.
columnName | Deskripsi | Perilaku | Jenis | Dapat difilter |
---|---|---|---|---|
status |
Status konversi: Active atau Removed . |
atribut | Status |
Ya |
deviceSegment |
Segmen perangkat yang diatribusikan konversi: Desktop , Mobile , Tablet , atau Other . |
atribut | Device segment |
Ya |
floodlightGroup |
Nama grup Floodlight. | atribut | String |
Ya |
floodlightGroupConversionType |
Jenis konversi yang dihasilkan oleh aktivitas Floodlight dalam grup ini: Action atau Transaction . |
atribut | Conversion type |
Ya |
floodlightGroupId |
ID grup Floodlight DS. | atribut | ID |
Ya |
floodlightGroupTag |
Tag grup Floodlight. | atribut | String |
Ya |
floodlightActivity |
Nama aktivitas Floodlight. | atribut | String |
Ya |
floodlightActivityId |
ID aktivitas Floodlight DS. | atribut | ID |
Ya |
floodlightActivityTag |
Tag aktivitas Floodlight. | atribut | String |
Ya |
agency |
Nama agensi. | atribut | String |
Ya |
agencyId |
ID agensi DS. | atribut | ID |
Ya |
advertiser |
Nama pengiklan. | atribut | String |
Ya |
advertiserId |
ID pengiklan DS. | atribut | ID |
Ya |
account |
Nama akun mesin. | atribut | String |
Ya |
accountId |
ID akun mesin DS. | atribut | ID |
Ya |
accountEngineId |
ID akun di akun mesin eksternal. | atribut | String |
Ya |
accountType |
Jenis akun mesin: Google AdWords , Bing Ads , Yahoo Japan Listing Ads , Yahoo Search Marketing , Yahoo Gemini , Baidu , atau Comparison Shopping . |
atribut | Engine type |
Ya |
campaign |
Nama kampanye. | atribut | String |
Ya |
campaignId |
ID kampanye DS. | atribut | ID |
Ya |
campaignStatus |
Status kampanye yang berisi item ini. | atribut | Status |
Ya |
adGroup |
Nama grup iklan. | atribut | String |
Ya |
adGroupId |
ID grup iklan DS. | atribut | ID |
Ya |
adGroupStatus |
Status grup iklan yang berisi item ini. | atribut | Status |
Ya |
keywordId |
ID kata kunci DS. Nilai 0 menunjukkan bahwa kata kunci tidak diatribusikan. | atribut | ID |
Ya |
keywordMatchType |
Jenis pencocokan kata kunci: Broad , Exact , Phrase , atau Content . |
atribut | Match type |
Ya |
keywordText |
Teks kata kunci. | atribut | String |
Ya |
productTargetId |
ID target produk DS. | atribut | ID |
Ya |
productGroupId |
ID grup produk yang terkait dengan konversi ini. Hanya konversi dari kampanye Shopping yang memiliki ID grup produk. ID grup produk tidak boleh digunakan untuk bergabung. | atribut | ID |
Ya |
ad |
Nama iklan. | atribut | String |
Ya |
adId |
ID iklan DS. Nilai 0 menunjukkan bahwa iklan tidak diatribusikan. | atribut | ID |
Ya |
isUnattributedAd |
Menunjukkan apakah metrik di baris ini tidak dapat diatribusikan ke iklan tertentu. Misalnya, iklan dengan format yang tidak didukung atau URL server klik yang salah dapat mencegah DS mengatribusikan metrik ke iklan. | atribut | Boolean |
Ya |
inventoryAccountId |
ID akun inventaris DS yang berisi produk yang terkait dengan konversi. DS membuat ID ini saat Anda menautkan akun inventaris di DS. | atribut | ID |
Ya |
productId |
ID produk yang terkait dengan konversi ini. | atribut | String |
Ya |
productCountry |
Negara (format ISO 3166) yang terdaftar untuk feed inventaris yang berisi produk yang terkait dengan konversi ini. | atribut | String |
Ya |
productLanguage |
Bahasa (ISO 639-1) produk yang terkait dengan konversi ini. | atribut | String |
Ya |
productStoreId |
Toko di Iklan Inventaris Lokal yang terkait dengan konversi. ID ini harus cocok dengan ID toko yang digunakan di feed produk lokal Anda. | atribut | String |
Ya |
productChannel |
Saluran penjualan produk yang terkait dengan konversi: Online atau Local . |
atribut | Product channel |
Ya |
conversionId |
ID yang dibuat Search Ads 360 untuk setiap konversi. | atribut | ID |
Ya |
advertiserConversionId |
Untuk konversi offline, ini adalah ID yang diberikan oleh pengiklan. Jika pengiklan tidak menentukan ID tersebut, Search Ads 360 akan membuatnya. Untuk konversi online, kolom ini sama dengan kolom conversionId atau kolom floodlightOrderId, bergantung pada petunjuk Floodlight pengiklan. | atribut | String |
Ya |
conversionType |
Jenis konversi: Action atau Transaction . |
atribut | Conversion type |
Ya |
conversionRevenue |
Total jumlah dolar dari konversi. | atribut | Money |
Ya |
conversionQuantity |
Jumlah item yang dicatat oleh konversi, seperti yang ditentukan oleh parameter qty. Pengiklan bertanggung jawab untuk mengisi parameter secara dinamis (seperti jumlah item yang terjual dalam konversi), jika tidak, nilai defaultnya adalah 1. | atribut | Number |
Ya |
conversionDate |
Tanggal, dalam zona waktu jaringan Campaign Manager, saat konversi terjadi. Tanggal ini digunakan untuk agregasi metrik konversi. Misalnya, saat menggabungkan tindakan untuk 1 Mei, DS akan menghitung semua konversi tindakan yang conversionDate -nya adalah 1 Mei. |
atribut | Date |
Ya |
conversionTimestamp |
Stempel waktu UTC saat konversi terjadi. | atribut | Timestamp |
Ya |
conversionLastModifiedTimestamp |
Stempel waktu UTC dari perubahan terbaru konversi. | atribut | Timestamp |
Ya |
conversionAttributionType |
Hal yang diatribusikan ke konversi: Visit atau Keyword+Ad . |
atribut | Conversion attribution type |
Ya |
conversionVisitId |
ID kunjungan DS yang diatribusikan ke konversi. | atribut | ID |
Ya |
conversionVisitTimestamp |
Stempel waktu UTC kunjungan yang diatribusikan ke konversi. | atribut | Timestamp |
Ya |
conversionVisitExternalClickId |
String unik, untuk kunjungan yang diatribusikan ke konversi, yang diteruskan ke halaman landing sebagai parameter URL gclid. Hanya diaktifkan untuk pengiklan dengan integrasi Conversion API atau integrasi Google Analytics. | atribut | String |
Ya |
conversionSearchTerm |
Istilah penelusuran yang menghasilkan konversi. | atribut | String |
Ya |
floodlightOriginalRevenue |
Pendapatan asli yang tidak berubah yang terkait dengan peristiwa Floodlight (dalam mata uang laporan saat ini), sebelum modifikasi petunjuk mata uang Floodlight. | atribut | Money |
Ya |
floodlightEventRequestString |
String permintaan Floodlight untuk konversi. | atribut | String |
Ya |
floodlightReferrer |
Situs perujuk Floodlight konversi. | atribut | String |
Ya |
floodlightOrderId |
ID pesanan Floodlight yang diberikan oleh pengiklan untuk konversi. | atribut | String |
Ya |
feedItemId |
ID baris item feed yang terkait dengan konversi ini. | atribut | ID |
Ya |
feedId |
ID tabel feed yang terkait dengan konversi ini. | atribut | ID |
Ya |
feedType |
Jenis feed yang terkait dengan konversi ini. | atribut | Feed type |
Ya |