Metrik performa dan atribut konfigurasi untuk iklan.
Laporan ini hanya dapat ditampilkan oleh permintaan asinkron (yaitu, melalui Reports.request()).
Minta nukilan
Kirim reguler
Reports.request()
isi permintaan, tetapi tentukan "reportType": "ad".
{
...
"reportType": "ad",
"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 iklan: Active, Paused, atau Removed. Perhatikan bahwa kampanye, grup iklan, kata kunci, dan iklan masing-masing memiliki status sendiri. Lihat status. |
atribut | Status |
Ya |
engineStatus |
Status tambahan iklan di akun mesin eksternal. Status yang mungkin terjadi (bergantung pada jenis akun eksternal) mencakup active, eligible, creative deleted, creative approved family safe, dll. |
atribut | String |
Ya |
creationTimestamp |
Stempel waktu pembuatan iklan, yang diformat dalam ISO 8601. | atribut | Timestamp |
Ya |
lastModifiedTimestamp |
Stempel waktu modifikasi terbaru iklan, yang diformat dalam ISO 8601. | atribut | Timestamp |
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 |
ad |
Nama iklan. | atribut | String |
Ya |
adId |
ID iklan DS. Nilai 0 menunjukkan bahwa iklan tidak diatribusikan. | atribut | ID |
Ya |
adEngineId |
ID iklan di akun mesin eksternal. | 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 |
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 |
Deskripsi baris 1 iklan. | atribut | String |
Ya |
adDescription2 |
Deskripsi iklan baris 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 ditetapkan langsung 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 ditetapkan langsung 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 berbobot tindakan Campaign Manager. | 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 berbobot tindakan Campaign Manager lintas lingkungan. | metrik | Number |
Ya |
avgCpc |
Biaya per klik rata-rata. | metrik | Money |
Ya |
avgCpm |
Biaya per seribu tayangan iklan rata-rata | metrik | Money |
Ya |
avgPos |
Posisi rata-rata. | metrik | Number |
Ya |
clicks |
Klik agregat. | metrik | Integer |
Ya |
cost |
Biaya agregat yang dibayarkan ke akun mesin. | metrik | Money |
Ya |
ctr |
Rata-rata rasio klik-tayang. | metrik | Number |
Ya |
impr |
Jumlah total tayangan. | metrik | Integer |
Ya |
adWordsConversions |
Data yang telah disiapkan pengiklan untuk dilaporkan dalam 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 |
Jumlah total kunjungan DS. | metrik | Integer |
Ya |
date |
Menyegmentasikan laporan menurut hari; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap hari. Kolom ini menampilkan tanggal dari setiap baris. | segmen | Date |
Ya |
monthStart |
Menyegmentasikan laporan menurut bulan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap bulan. Kolom ini menampilkan hari pertama setiap bulan dari setiap baris. | segmen | Date |
Ya |
monthEnd |
Menyegmentasikan laporan menurut bulan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap bulan. Kolom ini menampilkan hari terakhir dalam sebulan dari setiap baris. | segmen | Date |
Ya |
quarterStart |
Menyegmentasikan laporan menurut kuartal; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap kuartal. Kolom ini menampilkan hari pertama kuartal tersebut di setiap baris. | segmen | Date |
Ya |
quarterEnd |
Menyegmentasikan laporan menurut kuartal; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap kuartal. Kolom ini menampilkan hari terakhir per kuartal dari setiap baris. | segmen | Date |
Ya |
weekStart |
Mengelompokkan laporan menurut minggu (Minggu hingga 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 |
Mengelompokkan laporan menurut minggu (Minggu hingga 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 berdasarkan tahun; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap tahun. Kolom ini menampilkan hari pertama tahun dari setiap baris. | segmen | Date |
Ya |
yearEnd |
Menyegmentasikan laporan berdasarkan tahun; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap tahun. Kolom ini menampilkan hari terakhir dalam setahun dari setiap baris. | segmen | Date |
Ya |
deviceSegment |
Menyegmentasikan laporan menurut perangkat; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris 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 baris untuk setiap grup Floodlight. Kolom ini menampilkan nama grup Floodlight untuk setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang tersegmentasi 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 baris untuk setiap grup Floodlight. Kolom ini menampilkan ID grup Floodlight DS dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang tersegmentasi 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 baris untuk setiap grup Floodlight. Kolom ini menampilkan tag grup Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang tersegmentasi Floodlight, seperti klik dan kunjungan. | segmen | String |
Ya |
floodlightActivity |
Mengelompokkan laporan menurut aktivitas Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap aktivitas Floodlight. Kolom ini menampilkan nama aktivitas Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang tersegmentasi Floodlight, seperti klik dan kunjungan. | segmen | String |
Ya |
floodlightActivityId |
Mengelompokkan laporan menurut aktivitas Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap aktivitas Floodlight. Kolom ini menampilkan ID aktivitas Floodlight DS dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang tersegmentasi Floodlight, seperti klik dan kunjungan. | segmen | ID |
Ya |
floodlightActivityTag |
Mengelompokkan laporan menurut aktivitas Floodlight; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap aktivitas Floodlight. Kolom ini menampilkan tag aktivitas Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai yang tersegmentasi Floodlight, seperti klik dan kunjungan. | segmen | String |
Ya |