Jenis Laporan: adGroup

Metrik performa dan atribut konfigurasi untuk grup iklan.

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

Meminta kutipan

Kirim isi permintaan Reports.request() reguler, tetapi tentukan "reportType": "adGroup".

{
...
 
"reportType": "adGroup",
 
"columns": [
   
{
     
"columnName": string,
     
"headerText": string,
     
"startDate": string,
     
"endDate": string
   
}
 
],
 
"filters": [
   
{
     
"column": {
       
"columnName": string,
     
},
     
...
   
},
   
...
 
],
...
}

Untuk setiap kolom yang ingin ditampilkan atau difilter 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" di tabel di bawah.

columnNameDeskripsiPerilakuJenisDapat difilter
status Alias untuk atribut adGroupStatus. atribut Status Ya
engineStatus Status tambahan grup iklan di akun mesin eksternal. Kemungkinan status (bergantung pada jenis akun eksternal) mencakup eligible, campaign ended, dll. atribut String Ya
creationTimestamp Stempel waktu pembuatan grup iklan, yang diformat dalam ISO 8601. atribut Timestamp Ya
lastModifiedTimestamp Stempel waktu perubahan terbaru grup 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
adRotation Rotasi penayangan iklan yang digunakan oleh grup iklan: Optimize atau Rotate indefinitely. atribut String Tidak
adGroup Nama grup iklan. atribut String Ya
adGroupId ID grup iklan DS. atribut ID Ya
adGroupStatus Status grup iklan: Active, Paused, atau Removed. Perhatikan bahwa kampanye, grup iklan, kata kunci, iklan, dan target masing-masing memiliki statusnya sendiri. Lihat status. atribut Status Ya
adGroupEngineId ID grup iklan di akun mesin eksternal. atribut ID Ya
adGroupStartDate Tanggal mulai grup iklan. atribut Date Ya
adGroupEndDate Tanggal akhir grup iklan. atribut Date Ya
adGroupSearchMaxCpc Bid default untuk kata kunci penelusuran di grup iklan ini. atribut Money Ya
adGroupBroadMaxCpc Bid default untuk kata kunci penelusuran pencocokan luas di grup iklan ini (khusus Bing Ads). atribut Money Ya
adGroupExactMaxCpc Bid default untuk kata kunci pencocokan persis di grup iklan ini (khusus Bing Ads). atribut Money Ya
adGroupPhraseMaxCpc Bid default untuk kata kunci penelusuran pencocokan frasa di grup iklan ini (khusus Bing Ads). atribut Money Ya
adGroupContentMaxCpc Bid default untuk kata kunci konten di grup iklan ini. atribut Money Ya
adGroupMobileBidAdjustment Persentase yang digunakan untuk menyesuaikan bid untuk perangkat seluler. Misalnya, 0,2 berarti peningkatan 20%, sehingga bid seluler adalah 1,2 kali bid default. Rentang nilai yang valid berbeda-beda berdasarkan mesin eksternal. atribut Number Ya
adGroupTabletBidAdjustment Persentase yang digunakan untuk menyesuaikan bid untuk tablet. Misalnya, 0,2 berarti peningkatan 20%, sehingga bid tablet adalah 1,2 kali bid default. Rentang nilai yang valid berbeda-beda berdasarkan mesin eksternal. atribut Number Ya
adGroupDesktopBidAdjustment Persentase yang digunakan untuk menyesuaikan bid untuk desktop. Misalnya, 0,2 berarti peningkatan 20%, sehingga bid desktop adalah 1,2 kali bid default. Rentang nilai yang valid berbeda-beda berdasarkan mesin eksternal. atribut Number Ya
adGroupType (Hanya berlaku untuk Google Ads) Menunjukkan jenis grup iklan: Standard, Dynamic, atau Showcase. atribut Ad group type Ya
bingAdsLanguage Bahasa iklan dan kata kunci dalam grup iklan Bing Ads. atribut Microsoft language code Ya
bingAdsAdDistributions Saluran distribusi iklan yang digunakan oleh grup iklan Bing Ads; kombinasi Search dan Content. atribut String Tidak
adGroupLabels Nama label yang langsung ditetapkan ke grup iklan ini; label yang diwarisi tidak disertakan. atribut String list 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 ke entitas ini, atau diwarisi oleh entitas ini. atribut String Ya
bidStrategyInherited Menunjukkan apakah strategi bidding entitas ini diwarisi. atribut Boolean Ya
deviceTargets Target perangkat di tingkat grup iklan; kombinasi dari Desktop, Mobile, Tablet, atau Other. atribut String Tidak
effectiveDeviceTargets Target perangkat di tingkat grup iklan, atau diwarisi dari kampanye; kombinasi dari Desktop, Mobile, Tablet, atau Other. atribut String Tidak
countryTargets Target negara yang disertakan dalam grup iklan. Download template upload dan kode geografis/bahasa. atribut String Tidak
provinceTargets Target provinsi yang disertakan dalam grup iklan. Download template upload dan kode geografis/bahasa. atribut String Tidak
metroTargets Target metro disertakan dalam grup iklan. Download template upload dan kode geografis/bahasa. atribut String Tidak
cityTargets Target kota yang disertakan dalam grup iklan. Download template upload dan kode geografis/bahasa. atribut String Tidak
effectiveCountryTargets Target negara yang disertakan dalam grup iklan, atau diwarisi dari kampanye. Download template upload dan kode geografis/bahasa. atribut String Tidak
effectiveProvinceTargets Target provinsi yang disertakan dalam grup iklan, atau diwarisi dari kampanye. Download template upload dan kode geografis/bahasa. atribut String Tidak
effectiveMetroTargets Target metro yang disertakan dalam grup iklan, atau diwarisi dari kampanye. Download template upload dan kode geografis/bahasa. atribut String Tidak
effectiveCityTargets Target kota yang disertakan dalam grup iklan, atau diwarisi dari kampanye. Download template upload dan kode geografis/bahasa. atribut String Tidak
effectiveLabels Nama semua label yang diwarisi atau langsung ditetapkan ke grup iklan ini. atribut String list Ya
engineRemarketingListTargetAll Menunjukkan apakah grup iklan hanya menggunakan target pemasaran ulang untuk menyesuaikan bid.

Kemungkinan nilai:

  • Ya: Grup iklan menggunakan target pemasaran ulang untuk menyesuaikan bid.
  • Tidak: Grup iklan hanya menampilkan iklan kepada anggota target pemasaran ulang, dan dapat menggunakan target pemasaran ulang untuk menyesuaikan bid.
atribut Boolean Ya
clicksWithFeedItemShowing Klik pada link apa pun di iklan saat item feed ditampilkan. Kolom ini hanya menampilkan nilai dalam laporan item feed atau dalam laporan yang tersegmentasi menurut kolom item feed. metrik Integer Ya
costWithFeedItemShowing Biaya semua iklan saat item feed ditampilkan. Kolom ini hanya menampilkan nilai dalam laporan item feed atau dalam laporan yang tersegmentasi menurut kolom item feed. metrik Money Ya
dfaActions Jumlah total tindakan Campaign Manager. metrik Integer Ya
dfaRevenue Pendapatan gabungan yang dihasilkan oleh transaksi Campaign Manager. metrik Money Ya
dfaTransactions Total jumlah transaksi Campaign Manager. metrik Integer Ya
dfaWeightedActions Jumlah berbobot dari 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 dari 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 Menggabungkan klik. metrik Integer Ya
cost Biaya gabungan yang 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 Jumlah total konversi lihat-tayang Google Ads. metrik Integer Ya
visits Jumlah total kunjungan DS. metrik Integer Ya
searchImpressionShare Khusus Google Ads dan Bing Ads. Tayangan iklan yang Anda terima di Jaringan Penelusuran dibagi dengan estimasi jumlah tayangan iklan yang valid untuk Anda terima. Ditampilkan sebagai angka antara 0,1 dan 1 atau, jika bagiannya kurang dari 0,1, string < 10%. metrik Impression share Ya
searchRankLostImpressionShare Khusus Google Ads dan Bing Ads. Persentase berapa kali iklan Anda tidak ditampilkan di Jaringan Penelusuran karena Peringkat Iklan yang buruk. Ditampilkan sebagai angka antara 0 dan 0,9 atau, jika pangsa lebih besar dari 0,9, sebagai string > 90%. metrik Impression share Ya
displayImpressionShare Khusus Google Ads. Tayangan iklan yang Anda terima di Jaringan Display dibagi dengan estimasi jumlah tayangan iklan yang valid untuk Anda terima. Ditampilkan sebagai angka antara 0,1 dan 1 atau, jika bagiannya kurang dari 0,1, string < 10%. metrik Impression share Ya
displayRankLostImpressionShare Khusus Google Ads. Persentase berapa kali iklan Anda tidak ditampilkan di Display Network karena Peringkat Iklan yang buruk. Ditampilkan sebagai angka antara 0 dan 0,9 atau, jika pangsa lebih besar dari 0,9, sebagai string > 90%. metrik Impression share Ya
qualityScoreAvg Khusus Google Ads dan Bing Ads. Rata-rata berbobot tayangan 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 diperlukan selama rentang waktu laporan agar iklan Anda muncul secara rutin di posisi teratas di atas hasil penelusuran. metrik Money Ya
absoluteTopImpressionPercentage Persentase tayangan iklan yang ditampilkan sebagai iklan pertama di atas hasil penelusuran organik. metrik Impression share Ya
searchAbsoluteTopImpressionShare Tayangan iklan yang Anda terima di lokasi teratas absolut (iklan pertama di atas hasil penelusuran organik) dibagi dengan estimasi jumlah tayangan iklan yang memenuhi syarat untuk Anda terima di lokasi teratas. metrik Impression share Ya
topImpressionPercentage Persentase tayangan iklan Anda yang ditampilkan di mana saja di atas hasil penelusuran organik. metrik Impression share Ya
searchTopImpressionShare Tayangan iklan yang Anda terima di lokasi teratas (di mana saja di atas hasil penelusuran organik) dibandingkan dengan estimasi jumlah tayangan iklan yang memenuhi syarat untuk Anda terima di lokasi teratas. metrik Impression share Ya
searchRankLostAbsoluteTopImpressionShare Memperkirakan seberapa sering iklan Anda tidak menjadi iklan pertama di atas hasil penelusuran organik karena Peringkat Iklan yang buruk. metrik Impression share Ya
searchRankLostTopImpressionShare Memperkirakan seberapa sering iklan tidak ditampilkan di mana saja di atas hasil penelusuran organik karena Peringkat Iklan yang buruk. metrik Impression share Ya
date Mesegmentasikan laporan berdasarkan hari; setiap baris dan metrik agregatnya dibagi menjadi beberapa baris, satu baris untuk setiap hari. Kolom ini menampilkan tanggal setiap baris. segmen Date Ya
monthStart Menyaring laporan menurut bulan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap bulan. Kolom ini menampilkan hari pertama bulan dari setiap baris. segmen Date Ya
monthEnd Menyaring laporan menurut bulan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap bulan. Kolom ini menampilkan hari terakhir bulan dari setiap baris. segmen Date Ya
quarterStart Menyaring laporan menurut kuartal; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap kuartal. Kolom ini menampilkan hari pertama kuartal dari setiap baris. segmen Date Ya
quarterEnd Menyaring laporan menurut kuartal; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap kuartal. Kolom ini menampilkan hari terakhir kuartal dari setiap baris. segmen Date Ya
weekStart Menyagregasi 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 Menyagregasi 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 Menyaring laporan menurut 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 Menyaring laporan menurut tahun; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap tahun. Kolom ini menampilkan hari terakhir tahun dari setiap baris. segmen Date Ya
deviceSegment Mesegmentasikan 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 Mesegmentasikan laporan menurut grup Floodlight; setiap baris dan metrik agregatnya dibagi menjadi beberapa baris, hingga satu baris untuk setiap grup Floodlight. Kolom ini menampilkan nama grup Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai tersegmentasi Floodlight, seperti klik dan kunjungan. segmen String Ya
floodlightGroupId Mesegmentasikan laporan menurut grup Floodlight; setiap baris dan metrik agregatnya dibagi menjadi beberapa baris, hingga satu baris untuk setiap grup Floodlight. Kolom ini menampilkan ID grup DS Floodlight dari setiap baris. Perhatikan bahwa beberapa metrik tidak memiliki nilai tersegmentasi Floodlight, seperti klik dan kunjungan. segmen ID Ya
floodlightGroupTag Mesegmentasikan laporan menurut grup Floodlight; setiap baris dan metrik agregatnya 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 tersegmentasi Floodlight, seperti klik dan kunjungan. segmen String Ya
floodlightActivity Menyagregasi 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 tersegmentasi Floodlight, seperti klik dan kunjungan. segmen String Ya
floodlightActivityId Menyagregasi 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 tersegmentasi Floodlight, seperti klik dan kunjungan. segmen ID Ya
floodlightActivityTag Menyagregasi 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 tersegmentasi Floodlight, seperti klik dan kunjungan. segmen String Ya
sitelinkDisplayText Menyaring laporan menurut sitelink; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap sitelink. Kolom ini menampilkan teks tampilan sitelink dari setiap baris. segmen String Ya
sitelinkDescription1 Menyaring laporan menurut sitelink; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap sitelink. Kolom ini menampilkan deskripsi sitelink 1 dari setiap baris. segmen String Ya
sitelinkDescription2 Menyaring laporan menurut sitelink; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap sitelink. Kolom ini menampilkan deskripsi sitelink 2 dari setiap baris. segmen String Ya
sitelinkLandingPageUrl Menyaring laporan menurut sitelink; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap sitelink. Kolom ini menampilkan URL halaman landing sitelink dari setiap baris. segmen String Ya
sitelinkClickserverUrl Menyaring laporan menurut sitelink; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap sitelink. Kolom ini menampilkan URL server klik sitelink dari setiap baris. segmen String Ya
locationBusinessName Menyaring laporan menurut ekstensi lokasi yang diupgrade dan ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik yang tersedia. Kolom ini menampilkan nama bisnis lokasi untuk setiap baris. segmen String Ya
locationCategory Menyaring laporan menurut ekstensi lokasi yang diupgrade dan ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik yang tersedia. Kolom ini menampilkan kategori lokasi untuk setiap baris. segmen String Ya
locationDetails Menyaring laporan menurut ekstensi lokasi yang diupgrade dan ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik yang tersedia. Kolom ini menampilkan detail tentang lokasi untuk setiap baris. segmen String Ya
locationFilter Menyaring laporan menurut ekstensi lokasi yang diupgrade dan ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik yang tersedia. Kolom ini menampilkan filter lokasi untuk setiap baris. segmen String Tidak
callPhoneNumber Menyaring laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan nomor telepon ekstensi panggilan. segmen String Ya
callCountryCode Menyaring laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan kode negara ekstensi panggilan dari setiap baris. segmen String Ya
callIsTracked Menyaring laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan nilai benar (true) jika panggilan ekstensi panggilan akan dilacak, dan menampilkan nilai salah (false) jika tidak. segmen Boolean Ya
callCallOnly Menyaring laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan true jika ekstensi panggilan hanya menampilkan nomor telepon, atau false jika ekstensi menampilkan nomor telepon dan link. segmen Boolean Ya
callConversionTracker Menyaring laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan nama pelacak konversi yang terkait dengan item feed, jika ada. segmen String Ya
callConversionTrackerId Menyaring laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan ID pelacak konversi yang terkait dengan ekstensi panggilan, jika ada. segmen ID Ya
appId Menyaring laporan menurut ekstensi aplikasi; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap ekstensi aplikasi. Kolom ini menampilkan ID aplikasi, jika ada. segmen String Ya
appStore Menyaring laporan menurut ekstensi aplikasi; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu baris untuk setiap ekstensi aplikasi. Kolom ini menampilkan jenis app store (Apple App Store, Google Play Store), jika ada. segmen App store Ya
feedItemId Menyaring laporan menurut item feed; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap item feed. Kolom ini menampilkan ID baris item feed DS untuk setiap baris. segmen ID Ya
feedId Menyaring laporan menurut item feed; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap item feed. Kolom ini menampilkan ID tabel feed DS untuk setiap baris. segmen ID Ya
feedType Menyaring laporan menurut item feed; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap item feed. Kolom ini menampilkan jenis item feed untuk setiap baris. segmen Feed type Ya