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 Reports.request()).
Karena acara 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).
Minta nukilan
Kirim reguler
Reports.request()
isi permintaan, tetapi tentukan "reportType": "visit"
.
{ ... "reportType": "visit", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Untuk setiap kolom yang ingin Anda tampilkan atau filter 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" pada tabel di bawah.
columnName | Deskripsi | Perilaku | Jenis | Dapat difilter |
---|---|---|---|---|
status |
Status kunjungan. Kunjungan tidak dapat diubah, sehingga selalu Active . |
atribut | Status |
Ya |
deviceSegment |
Segmen perangkat yang diatribusikan ke kunjungan: Desktop , Mobile , Tablet , atau Other . |
atribut | Device segment |
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 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 diatribusikan. | atribut | ID |
Ya |
isUnattributedAd |
Menunjukkan apakah metrik dalam 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 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 di 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 pada 1 Mei, DS akan menghitung semua kunjungan yang visitDate -nya merupakan 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 yang memiliki integrasi API konversi atau integrasi Google Analytics. | atribut | String |
Ya |
feedItemId |
ID baris item feed yang dikaitkan dengan kunjungan ini. | atribut | ID |
Ya |
feedId |
ID tabel feed yang dikaitkan dengan kunjungan ini. | atribut | ID |
Ya |
feedType |
Jenis feed yang terkait dengan kunjungan ini. | atribut | Feed type |
Ya |