Metrik performa dan atribut konfigurasi untuk iklan.
Laporan ini hanya dapat ditampilkan oleh permintaan asinkron (yaitu, melalui metode Reports.request()).
Nukilan permintaan
Mengirim isi permintaan
Reports.request()
reguler, tetapi menentukan "reportType": "ad"
.
{ ... "reportType": "ad", "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 iklan: Active , Paused , atau Removed . Perhatikan bahwa kampanye, grup iklan, kata kunci, dan iklan memiliki status masing-masing. Lihat status. |
atribut | Status |
Ya |
engineStatus |
Status tambahan iklan di akun mesin eksternal. Kemungkinan status (bergantung pada jenis akun eksternal) termasuk active , eligible , creative deleted , creative approved family safe , dll. |
atribut | String |
Ya |
creationTimestamp |
Stempel waktu pembuatan iklan, dalam format ISO 8601. | atribut | Timestamp |
Ya |
lastModifiedTimestamp |
Stempel waktu perubahan terbaru pada iklan, yang diformat dalam ISO 8601. | atribut | Timestamp |
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 |
ad |
Nama iklan. | atribut | String |
Ya |
adId |
ID iklan DS. Nilai 0 menunjukkan bahwa iklan tidak diberi atribut. | atribut | ID |
Ya |
adEngineId |
ID iklan di akun mesin eksternal. | 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 |
adHeadline |
Judul iklan. | atribut | String |
Ya |
adHeadline2 |
Judul iklan 2; tidak tersedia untuk beberapa mesin. | atribut | String |
Ya |
adHeadline3 |
Judul iklan 3; tidak tersedia untuk beberapa mesin. | atribut | String |
Ya |
adDescription1 |
Baris deskripsi 1 iklan. | atribut | String |
Ya |
adDescription2 |
Baris deskripsi iklan 2; tidak tersedia untuk beberapa mesin. | atribut | String |
Ya |
adDisplayUrl |
URL yang ditampilkan iklan. | atribut | String |
Ya |
adLandingPage |
Halaman landing iklan. Lihat URL halaman landing dan server klik. | atribut | String |
Ya |
adType |
Jenis iklan: Text , Product , Dynamic search , Mobile app install , Call-Only , Expanded text , atau Expanded dynamic search . |
atribut | Ad type |
Ya |
adPromotionLine |
Baris promosi iklan. Pesan promosi singkat untuk iklan produk. | atribut | String |
Ya |
adLabels |
Nama label yang langsung ditetapkan ke iklan ini; label yang diwariskan tidak disertakan. | atribut | String list |
Ya |
adPathField1 |
Kolom jalur iklan 1. Kolom jalur 1 dan 2 digabungkan dengan adDisplayUrl untuk membentuk URL yang ditampilkan di iklan. | atribut | String |
Ya |
adPathField2 |
Kolom jalur iklan 2. Kolom jalur 1 dan 2 digabungkan dengan adDisplayUrl untuk membentuk URL yang ditampilkan di iklan. | atribut | String |
Ya |
effectiveLabels |
Nama semua label yang diwarisi atau langsung ditetapkan ke iklan ini. | atribut | String list |
Ya |
dfaActions |
Jumlah total tindakan Campaign Manager. | metrik | Integer |
Ya |
dfaRevenue |
Pendapatan gabungan yang dihasilkan oleh transaksi Campaign Manager. | metrik | Money |
Ya |
dfaTransactions |
Jumlah total transaksi Campaign Manager. | metrik | Integer |
Ya |
dfaWeightedActions |
Jumlah tindakan Campaign Manager yang diukur. | metrik | Number |
Ya |
dfaActionsCrossEnv |
Jumlah total tindakan Campaign Manager lintas lingkungan. | metrik | Number |
Ya |
dfaRevenueCrossEnv |
Pendapatan gabungan yang dihasilkan oleh transaksi Campaign Manager lintas lingkungan. | metrik | Money |
Ya |
dfaTransactionsCrossEnv |
Jumlah total transaksi Campaign Manager lintas lingkungan. | metrik | Number |
Ya |
dfaWeightedActionsCrossEnv |
Jumlah tindakan Campaign Manager lintas lingkungan yang diukur. | metrik | Number |
Ya |
avgCpc |
Biaya per klik rata-rata. | metrik | Money |
Ya |
avgCpm |
Biaya per seribu tayangan rata-rata. | metrik | Money |
Ya |
avgPos |
Posisi rata-rata. | metrik | Number |
Ya |
clicks |
Klik gabungan. | metrik | Integer |
Ya |
cost |
Biaya gabungan dibayarkan ke akun mesin. | metrik | Money |
Ya |
ctr |
Rasio klik-tayang rata-rata. | metrik | Number |
Ya |
impr |
Jumlah total tayangan. | metrik | Integer |
Ya |
adWordsConversions |
Data yang telah disiapkan pengiklan untuk dilaporkan di kolom Konversi Google Ads. Saat tindakan konversi Google Ads dibuat, pengiklan dapat memilih apakah akan menghitung konversi tersebut di kolom Pelaporan konversi atau tidak. | metrik | Number |
Ya |
adWordsConversionValue |
Nilai gabungan konversi Google Ads. | metrik | Number |
Ya |
adWordsViewThroughConversions |
Total jumlah konversi lihat-tayang Google Ads. | metrik | Integer |
Ya |
visits |
Total jumlah kunjungan DS. | metrik | Integer |
Ya |
date |
Menyegmentasikan laporan menurut hari; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap hari. Kolom ini menampilkan tanggal setiap baris. | segmen | Date |
Ya |
monthStart |
Menyegmentasikan laporan menurut bulan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap bulan. Kolom ini menampilkan hari pertama dari setiap baris. | segmen | Date |
Ya |
monthEnd |
Menyegmentasikan laporan menurut bulan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap bulan. Kolom ini menampilkan hari terakhir dari setiap baris. | segmen | Date |
Ya |
quarterStart |
Menyegmentasikan laporan menurut kuartal; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap kuartal. Kolom ini menampilkan hari pertama kuartal di setiap baris. | segmen | Date |
Ya |
quarterEnd |
Menyegmentasikan laporan menurut kuartal; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap kuartal. Kolom ini menampilkan hari terakhir pada kuartal setiap baris. | segmen | Date |
Ya |
weekStart |
Menyegmentasikan laporan menurut minggu (Minggu sampai Sabtu); setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap minggu. Kolom ini menampilkan hari pertama (Minggu) dari setiap baris. | segmen | Date |
Ya |
weekEnd |
Menyegmentasikan laporan menurut minggu (Minggu sampai Sabtu); setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap minggu. Kolom ini menampilkan hari terakhir (Sabtu) dari setiap baris. | segmen | Date |
Ya |
yearStart |
Menyegmentasikan laporan menurut tahun; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap tahun. Kolom ini menampilkan hari pertama dari tahun setiap baris. | segmen | Date |
Ya |
yearEnd |
Menyegmentasikan laporan menurut tahun; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap tahun. Kolom ini menampilkan hari terakhir dari setiap tahun dalam baris. | segmen | Date |
Ya |
deviceSegment |
Menyegmentasikan laporan menurut perangkat; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap segmen perangkat. Kolom ini menampilkan segmen perangkat dari setiap baris. | segmen | Device segment |
Ya |
floodlightGroup |
Menyegmentasikan laporan menurut grup Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap grup Floodlight. Kolom ini menampilkan nama grup Floodlight setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang disegmentasikan Floodlight, seperti klik dan kunjungan. | segmen | String |
Ya |
floodlightGroupId |
Menyegmentasikan laporan menurut grup Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap grup Floodlight. Kolom ini menampilkan ID grup Floodlight DS dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang disegmentasikan Floodlight, seperti klik dan kunjungan. | segmen | ID |
Ya |
floodlightGroupTag |
Menyegmentasikan laporan menurut grup Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap grup Floodlight. Kolom ini menampilkan tag grup Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang disegmentasikan Floodlight, seperti klik dan kunjungan. | segmen | String |
Ya |
floodlightActivity |
Menyegmentasikan laporan menurut aktivitas Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap aktivitas Floodlight. Kolom ini menampilkan nama aktivitas Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang disegmentasikan Floodlight, seperti klik dan kunjungan. | segmen | String |
Ya |
floodlightActivityId |
Menyegmentasikan laporan menurut aktivitas Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap aktivitas Floodlight. Kolom ini menampilkan ID aktivitas Floodlight DS dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang disegmentasikan Floodlight, seperti klik dan kunjungan. | segmen | ID |
Ya |
floodlightActivityTag |
Menyegmentasikan laporan menurut aktivitas Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap aktivitas Floodlight. Kolom ini menampilkan tag aktivitas Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang disegmentasikan Floodlight, seperti klik dan kunjungan. | segmen | String |
Ya |