Metrik performa dan atribut konfigurasi untuk kata kunci.
Laporan ini hanya dapat ditampilkan oleh permintaan asinkron (yaitu, melalui Reports.request()).
Minta nukilan
Kirim reguler
Reports.request()
isi permintaan, tetapi tentukan "reportType": "keyword".
{
...
"reportType": "keyword",
"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 kata kunci: 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 kata kunci di akun mesin eksternal. Status yang mungkin terjadi (bergantung pada jenis akun eksternal) mencakup criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused, dll. |
atribut | String |
Ya |
creationTimestamp |
Stempel waktu pembuatan kata kunci, yang diformat dalam ISO 8601. | atribut | Timestamp |
Ya |
lastModifiedTimestamp |
Stempel waktu modifikasi terbaru kata kunci, 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 |
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 |
keywordEngineId |
ID kata kunci di akun mesin eksternal. | atribut | ID |
Ya |
keywordMaxCpc |
Mengganti CPC maks grup iklan dan menetapkan jumlah maksimum yang bersedia Anda bayar jika seseorang mengklik iklan untuk kata kunci spesifik ini. Jika kolom ini kosong, kata kunci akan menggunakan CPC maks grup iklan. | atribut | Money |
Ya |
effectiveKeywordMaxCpc |
CPC maks (biaya per klik maksimum) yang berlaku untuk kata kunci ini. Nilai ini akan sama seperti CPC maks grup iklan atau, jika kata kunci menggantikan setelan grup iklan, CPC maks kata kunci itu sendiri. | atribut | Money |
Ya |
keywordLandingPage |
URL final yang akan dikunjungi pengguna setelah mengklik iklan Anda. Lihat URL halaman landing dan server klik. | atribut | String |
Ya |
keywordClickserverUrl |
URL yang digunakan DS untuk melacak aktivitas. Pengguna yang mengklik iklan akan mengunjungi URL server klik terlebih dahulu, lalu dialihkan ke halaman landing akhir. Lihat URL halaman landing dan server klik. | atribut | String |
Ya |
isDisplayKeyword |
Menunjukkan apakah ini adalah kata kunci placeholder yang digunakan untuk pelaporan display dan penempatan. | atribut | Boolean |
Ya |
keywordMaxBid |
Jika kata kunci ini dikelola oleh strategi bidding DS, strategi bidding tidak akan pernah menaikkan bid di atas batas ini. Lihat Menerapkan strategi bidding ke kata kunci. | atribut | Money |
Ya |
keywordMinBid |
Jika kata kunci ini dikelola dengan strategi bidding DS, strategi bidding tidak akan pernah menurunkan bid di bawah batas ini. Lihat Menerapkan strategi bidding ke kata kunci. | atribut | Money |
Ya |
keywordUrlParams |
Parameter URL ekstra yang ditambahkan ke halaman landing. Lihat bagian Menambahkan parameter URL. | atribut | String |
Ya |
bingKeywordParam2 |
Param2 kata kunci Bing Ads. | atribut | String |
Ya |
bingKeywordParam3 |
Param3 kata kunci Bing Ads. | atribut | String |
Ya |
keywordLabels |
Nama label yang ditetapkan langsung ke kata kunci ini; label yang diwariskan tidak disertakan. | atribut | String list |
Ya |
qualityScoreCurrent |
khusus Google Ads dan Bing Ads. Nilai terbaru Skor kualitas (QS) mesin untuk kata kunci. Perhatikan bahwa kolom ini selalu melaporkan QS terbaru untuk kata kunci, terlepas dari rentang waktu laporan. | atribut | Integer |
Ya |
topOfPageBidCurrent |
Khusus Google Ads. Memperkirakan bid CPC saat ini yang dibutuhkan agar iklan Anda tampil secara rutin di posisi teratas di atas hasil penelusuran. Perhatikan bahwa kolom ini selalu melaporkan CPC yang saat ini dibutuhkan, terlepas dari rentang waktu laporan. | atribut | Money |
Ya |
effectiveBidStrategyId |
ID DS strategi bidding yang ditetapkan ke entitas ini, atau diwarisi oleh entitas ini. | atribut | ID |
Ya |
effectiveBidStrategy |
Nama strategi bidding yang ditetapkan untuk entitas ini, atau diwarisi oleh entitas ini. | atribut | String |
Ya |
bidStrategyInherited |
Menunjukkan apakah strategi bidding entitas ini diwariskan. | atribut | Boolean |
Ya |
effectiveLabels |
Nama semua label yang diwariskan atau ditetapkan langsung ke kata kunci 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 |
qualityScoreAvg |
khusus Google Ads dan Bing Ads. Rata-rata berbobot tayangan iklan dari Skor kualitas (QS) mesin di semua hari dan kata kunci dalam cakupan laporan. | metrik | Number |
Ya |
topOfPageBidAvg |
Khusus Google Ads. Memperkirakan bid CPC rata-rata yang dibutuhkan selama rentang waktu laporan agar iklan Anda tampil secara rutin di posisi teratas di atas hasil penelusuran. | metrik | Money |
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 dari tahun 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 |
ad |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan nama iklan di setiap baris. | segmen | String |
Ya |
adId |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan ID DS iklan di setiap baris. | segmen | ID |
Ya |
isUnattributedAd |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menunjukkan apakah metrik dalam baris ini tidak dapat diatribusikan ke iklan tertentu. | segmen | Boolean |
Ya |
adHeadline |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan judul iklan di setiap baris. | segmen | String |
Ya |
adHeadline2 |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan judul 2 dari iklan di setiap baris. Tidak tersedia untuk beberapa mesin. | segmen | String |
Ya |
adHeadline3 |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan judul 3 dari iklan di setiap baris. Tidak tersedia untuk beberapa mesin. | segmen | String |
Ya |
adDescription1 |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan baris deskripsi 1 dari iklan di setiap baris. | segmen | String |
Ya |
adDescription2 |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan baris deskripsi 2 dari iklan di setiap baris. | segmen | String |
Ya |
adDisplayUrl |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan URL yang ditampilkan untuk iklan di setiap baris. | segmen | String |
Ya |
adLandingPage |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan halaman landing iklan di setiap baris. | segmen | String |
Ya |
adType |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan jenis iklan di setiap baris: Text atau Product. |
segmen | Ad type |
Ya |
adPromotionLine |
Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu baris untuk setiap iklan. Kolom ini menampilkan lini promosi dari iklan produk di setiap baris. | segmen | String |
Ya |