Search Ads 360 Reporting API versi sebelumnya akan dihentikan dan dinonaktifkan pada 30 Juni 2024. Perhatikan bahwa Search Ads 360 Conversion API tidak terpengaruh dan akan terus didukung. Semua pengembangan pelaporan baru harus menggunakan Search Ads 360 Reporting API versi baru.

Mulai April 2024, error supportedApiVersion akan ditampilkan saat meminta laporan. Lihat detailnya di sini.

Sebaiknya migrasikan juga penerapan Search Ads 360 yang ada ke API baru. Lihat Memulai dan Panduan Migrasi Search Ads 360 Reporting API versi baru untuk mendapatkan informasi selengkapnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Jenis Laporan: kata kunci

Metrik performa dan atribut konfigurasi untuk kata kunci.

Laporan ini hanya dapat ditampilkan oleh permintaan asinkron (yaitu, melalui metode Reports.request()).

Nukilan permintaan

Mengirim isi permintaan Reports.request() reguler, tetapi menentukan "reportType": "keyword".

{
...
  "reportType": "keyword",
  "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 kata kunci: `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 kata kunci di akun mesin eksternal. Kemungkinan status (bergantung pada jenis akun eksternal) termasuk `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, dalam format ISO 8601.	atribut	`Timestamp`	Ya
`lastModifiedTimestamp`	Stempel waktu perubahan terbaru kata kunci, 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
`keywordId`	ID kata kunci DS. Nilai 0 menunjukkan bahwa kata kunci tidak diberi atribut.	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 bidang ini kosong, kata kunci akan menggunakan BPK maks. grup iklan.	atribut	`Money`	Ya
`effectiveKeywordMaxCpc`	CPC maks (biaya per klik maksimum) yang berlaku untuk kata kunci ini. Nilainya akan sama dengan nilai 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, kemudian dialihkan ke halaman landing terakhir. 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 dengan strategi bidding DS, strategi bidding ini 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 oleh 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 tambahan ditambahkan ke halaman landing. Lihat Menambahkan parameter URL.	atribut	`String`	Ya
`bingKeywordParam2`	Param2 dari kata kunci Iklan Bing.	atribut	`String`	Ya
`bingKeywordParam3`	Param3 dari 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`	Google Ads dan Bing Ads saja. Nilai skor Kualitas mesin (QS) terbaru untuk kata kunci. Perhatikan bahwa kolom ini selalu melaporkan QS terbaru untuk kata kunci, terlepas dari rentang waktu laporannya.	atribut	`Integer`	Ya
`topOfPageBidCurrent`	Google Ads saja. Perkiraan bid CPC saat ini yang diperlukan agar iklan Anda muncul secara rutin di posisi teratas di atas hasil penelusuran. Perhatikan bahwa kolom ini selalu melaporkan CPC yang saat ini diperlukan terlepas dari rentang waktu laporannya.	atribut	`Money`	Ya
`effectiveBidStrategyId`	ID DS dari strategi bidding yang ditetapkan ke entitas ini, atau diwarisi oleh entitas ini.	atribut	`ID`	Ya
`effectiveBidStrategy`	Nama strategi bidding yang ditetapkan ke entitas ini, atau diwariskan oleh entitas ini.	atribut	`String`	Ya
`bidStrategyInherited`	Menunjukkan apakah strategi bidding entitas ini diwariskan.	atribut	`Boolean`	Ya
`effectiveLabels`	Nama semua label yang diwarisi atau langsung ditetapkan 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 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
`qualityScoreAvg`	Google Ads dan Bing Ads saja. Rata-rata berbobot skor Skor Kualitas (QS) mesin di seluruh hari dan kata kunci dalam cakupan laporan.	metrik	`Number`	Ya
`topOfPageBidAvg`	Google Ads saja. Memperkirakan bid CPC rata-rata yang diperlukan selama rentang waktu laporan agar iklan Anda muncul 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 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
`ad`	Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu 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 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 untuk setiap iklan. Kolom ini menunjukkan apakah metrik di 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 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 untuk setiap iklan. Kolom ini menampilkan judul 2 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 untuk setiap iklan. Kolom ini menampilkan judul 3 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 untuk setiap iklan. Kolom ini menampilkan baris deskripsi 1 iklan di setiap baris.	segmen	`String`	Ya
`adDescription2`	Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap iklan. Kolom ini menampilkan baris deskripsi 2 iklan di setiap baris.	segmen	`String`	Ya
`adDisplayUrl`	Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu untuk setiap iklan. Kolom ini menampilkan URL yang ditampilkan dari iklan di setiap baris.	segmen	`String`	Ya
`adLandingPage`	Menyegmentasikan laporan menurut iklan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, hingga satu 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 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 untuk setiap iklan. Kolom ini menampilkan baris promosi iklan produk di setiap baris.	segmen	`String`	Ya