Data peristiwa mentah tentang kunjungan. Kunjungan terjadi setiap kali konsumen mengklik iklan dan dialihkan ke halaman landing.
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 dari hal berikut:
- startDate dan endDate.
- changedMetrics SejakTimestamp (changedAttributesSejakTimestamp tidak valid untuk peristiwa).
Nukilan permintaan
Mengirim isi permintaan
Reports.request()
reguler, tetapi menentukan "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Untuk setiap kolom yang ingin dikembalikan atau difilter dalam laporan,
tentukan columnName
yang tercantum dalam tabel di bawah.
Anda juga dapat menetapkan headerText, startDate, dan endDate.
Perhatikan bahwa beberapa kolom tidak dapat difilter; lihat "Dapat difilter" pada tabel di bawah.
columnName | Deskripsi | Perilaku | Jenis | Dapat difilter |
---|---|---|---|---|
status |
Status kunjungan. Kunjungan tidak dapat diubah, jadi ini selalu Active . |
atribut | Status |
Ya |
deviceSegment |
Segmen perangkat yang diatribusikan ke kunjungan: Desktop , Mobile , Tablet , atau Other . |
atribut | Device segment |
Ya |
agency |
Nama agensi iklan. | 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 diberi atribut. | 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 kunjungan ini. Hanya kunjungan 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 diberi atribut. | 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 diklik. DS menghasilkan ID ini saat Anda menautkan akun inventaris di DS. | atribut | ID |
Ya |
productId |
ID produk yang diklik. | atribut | String |
Ya |
productCountry |
Negara (format ISO 3166) yang terdaftar untuk feed inventaris yang berisi produk yang diklik. | atribut | String |
Ya |
productLanguage |
Bahasa (ISO 639-1) yang telah ditetapkan untuk feed Merchant Center yang berisi data tentang produk. | atribut | String |
Ya |
productStoreId |
Toko dalam Iklan Inventaris Lokal yang diklik. Ini harus cocok dengan ID toko yang digunakan di feed produk lokal Anda. | atribut | String |
Ya |
productChannel |
Saluran penjualan produk yang diklik: Online atau Local . |
atribut | Product channel |
Ya |
visitId |
ID kunjungan DS. | atribut | ID |
Ya |
visitSearchQuery |
Kueri penelusuran yang menghasilkan kunjungan ini. | atribut | String |
Ya |
visitDate |
Tanggal, dalam zona waktu akun mesin, saat kunjungan terjadi. Tanggal ini digunakan untuk agregasi kunjungan. Misalnya, saat DS menggabungkan kunjungan untuk tanggal 1 Mei, DS akan menghitung semua kunjungan yang visitDate -nya adalah 1 Mei. |
atribut | Date |
Ya |
visitTimestamp |
Stempel waktu UTC saat kunjungan terjadi. | atribut | Timestamp |
Ya |
visitNetworkType |
Jaringan iklan yang menghasilkan kunjungan ini: Content , Search , atau Other . |
atribut | Network type |
Ya |
visitReferrer |
URL perujuk kunjungan. | atribut | String |
Ya |
visitExternalClickId |
String unik untuk setiap kunjungan yang diteruskan ke halaman landing sebagai parameter URL gclid. Hanya diaktifkan untuk pengiklan dengan integrasi API konversi atau integrasi Google Analytics. | atribut | String |
Ya |
feedItemId |
ID baris elemen feed yang terkait dengan kunjungan ini. | atribut | ID |
Ya |
feedId |
ID tabel feed yang terkait dengan kunjungan ini. | atribut | ID |
Ya |
feedType |
Jenis feed yang terkait dengan kunjungan ini. | atribut | Feed type |
Ya |