Jenis Laporan: adGroup

Metrik performa dan atribut konfigurasi untuk grup iklan.

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

Minta nukilan

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

{
...
  "reportType": "adGroup",
  "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 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 status 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 Iklan Bing). atribut Money Ya
adGroupExactMaxCpc Bid default untuk kata kunci pencocokan persis di grup iklan ini (khusus Iklan Bing). atribut Money Ya
adGroupPhraseMaxCpc Bid default untuk kata kunci penelusuran pencocokan frasa di grup iklan ini (khusus Iklan Bing). atribut Money Ya
adGroupContentMaxCpc Bid default untuk kata kunci konten dalam grup iklan ini. atribut Money Ya
adGroupMobileBidAdjustment Persentase penyesuaian bid untuk seluler. Misalnya, 0,2 berarti peningkatan sebesar 20%, sehingga bid seluler adalah 1,2 kali lipat dari 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 sebesar 20%, jadi bid tablet 1,2 kali lipat dari bid default. Rentang nilai yang valid berbeda-beda berdasarkan mesin eksternal. atribut Number Ya
adGroupDesktopBidAdjustment Persentase penyesuaian bid untuk desktop. Misalnya, 0,2 berarti peningkatan sebesar 20%, sehingga bid desktop adalah 1,2 kali lipat dari 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 di 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 ditetapkan secara langsung ke grup iklan ini; label yang diwariskan 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 untuk entitas ini, atau diwarisi oleh entitas ini. atribut String Ya
bidStrategyInherited Menunjukkan apakah strategi bidding entitas ini diwariskan. atribut Boolean Ya
deviceTargets Target perangkat di tingkat grup iklan; kombinasi Desktop, Mobile, Tablet, atau Other. atribut String Tidak
effectiveDeviceTargets Target perangkat di tingkat grup iklan, atau diwarisi dari kampanye; kombinasi 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 disertakan dalam grup iklan, atau diwarisi dari kampanye. Download template upload dan kode geografis/bahasa. atribut String Tidak
effectiveMetroTargets Target metro 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 diwariskan atau ditetapkan langsung 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 Mengklik link di iklan saat elemen feed ditampilkan. Kolom ini hanya menampilkan nilai dalam laporan elemen feed atau dalam laporan yang disegmentasikan menurut kolom item feed. metrik Integer Ya
costWithFeedItemShowing Biaya semua iklan saat elemen feed ditampilkan. Kolom ini hanya menampilkan nilai dalam laporan elemen feed atau dalam laporan yang disegmentasikan 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 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
searchImpressionShare khusus Google Ads dan Bing Ads. Tayangan iklan yang Anda terima di Jaringan Penelusuran dibagi dengan estimasi jumlah tayangan yang valid untuk Anda terima. Ditampilkan sebagai angka antara 0.1 dan 1 atau, jika pangsanya 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 pangsanya lebih besar dari 0,9, sebagai string > 90%. metrik Impression share Ya
displayImpressionShare Khusus Google Ads. Tayangan yang Anda terima di Jaringan Display dibagi dengan estimasi jumlah tayangan yang valid untuk Anda terima. Ditampilkan sebagai angka antara 0.1 dan 1 atau, jika pangsanya kurang dari 0,1, string < 10%. metrik Impression share Ya
displayRankLostImpressionShare Khusus Google Ads. Persentase berapa kali iklan Anda tidak ditampilkan di Jaringan Display karena Peringkat Iklan yang buruk. Ditampilkan sebagai angka antara 0 dan 0,9 atau, jika pangsanya lebih besar dari 0,9, sebagai string > 90%. metrik Impression share 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 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 yang Anda terima di lokasi teratas absolut (iklan pertama di atas hasil penelusuran organik) dibagi dengan estimasi jumlah tayangan yang valid untuk Anda terima di lokasi teratas. metrik Impression share Ya
topImpressionPercentage Persentase tayangan iklan yang ditampilkan di mana saja di atas hasil penelusuran organik. metrik Impression share Ya
searchTopImpressionShare Tayangan yang diterima di lokasi teratas (di mana saja di atas hasil penelusuran organik) dibandingkan dengan estimasi jumlah tayangan yang berhak Anda terima di lokasi teratas. metrik Impression share Ya
searchRankLostAbsoluteTopImpressionShare Mengestimasi 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 Anda tidak ditampilkan di mana saja di atas hasil penelusuran organik karena Peringkat Iklan yang buruk. metrik Impression share 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
sitelinkDisplayText Menyegmentasikan 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 Menyegmentasikan 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 Menyegmentasikan 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 Menyegmentasikan 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 Menyegmentasikan 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 Menyegmentasikan laporan menurut ekstensi lokasi yang diupgrade yang ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik. Kolom ini menampilkan nama bisnis lokasi untuk setiap baris. segmen String Ya
locationCategory Menyegmentasikan laporan menurut ekstensi lokasi yang diupgrade yang ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik. Kolom ini menampilkan kategori lokasi untuk setiap baris. segmen String Ya
locationDetails Menyegmentasikan laporan menurut ekstensi lokasi yang diupgrade yang ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik. Kolom ini menampilkan detail tentang lokasi untuk setiap baris. segmen String Ya
locationFilter Menyegmentasikan laporan menurut ekstensi lokasi yang diupgrade yang ditautkan ke akun Profil Bisnis; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap lokasi yang memiliki metrik. Kolom ini menampilkan filter lokasi untuk setiap baris. segmen String Tidak
callPhoneNumber Mengelompokkan 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 Mengelompokkan 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 Mengelompokkan laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan nilai true (benar) jika panggilan ekstensi panggilan akan dilacak, dan false (salah) jika tidak. segmen Boolean Ya
callCallOnly Mengelompokkan laporan menurut ekstensi panggilan; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi panggilan. Kolom ini menampilkan nilai benar jika ekstensi panggilan hanya menampilkan nomor telepon, atau menampilkan salah jika ekstensi menampilkan nomor telepon dan link. segmen Boolean Ya
callConversionTracker Mengelompokkan 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 dikaitkan dengan elemen feed, jika ada. segmen String Ya
callConversionTrackerId Mengelompokkan 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 Menyegmentasikan laporan menurut ekstensi aplikasi; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi aplikasi. Kolom ini menampilkan ID aplikasi, jika ada. segmen String Ya
appStore Menyegmentasikan laporan menurut ekstensi aplikasi; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap ekstensi aplikasi. Kolom ini menampilkan jenis app store (Apple App Store, Google Play Store), jika ada. segmen App store Ya
feedItemId Menyegmentasikan laporan menurut elemen feed; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap elemen feed. Kolom ini menampilkan ID baris item feed DS untuk setiap baris. segmen ID Ya
feedId Menyegmentasikan laporan menurut elemen feed; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap elemen feed. Kolom ini menampilkan ID tabel feed DS untuk setiap baris. segmen ID Ya
feedType Menyegmentasikan laporan menurut elemen feed; setiap baris dan metrik gabungannya dibagi menjadi beberapa baris, satu untuk setiap elemen feed. Kolom ini menampilkan jenis elemen feed untuk setiap baris. segmen Feed type Ya