Jenis Laporan: kata kunci

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.

columnNameDeskripsiPerilakuJenisDapat 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