Data pelaporan untuk pengiklan, termasuk:
- Metrik performa di semua akun mesin dan kampanye pengiklan.
- Atribut konfigurasi untuk pengiklan.
Minta nukilan
Kirim reguler
Reports.request() atau
Reports.generate()
isi permintaan, tetapi tentukan "reportType": "advertiser".
{
...
"reportType": "advertiser",
"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 pengiklan: Active, Paused, atau Removed. |
atribut | Status |
Ya |
creationTimestamp |
Stempel waktu pembuatan pengiklan, yang diformat dalam ISO 8601. | atribut | Timestamp |
Ya |
lastModifiedTimestamp |
Stempel waktu perubahan terbaru pengiklan, 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 |
dfaAdvertiserId |
ID pengiklan Campaign Manager yang terkait dengan pengiklan DS ini. | atribut | ID |
Ya |
dfaNetworkId |
ID jaringan Campaign Manager yang terkait dengan pengiklan DS ini. | atribut | ID |
Ya |
dfaNetworkTimeZone |
Zona waktu jaringan Campaign Manager yang terkait dengan pengiklan DS ini dalam format Database Zona Waktu IANA, seperti America/New_York. |
atribut | String |
Ya |
advertiserCurrencyCode |
Kode mata uang pengiklan dalam format ISO 4217. | atribut | String |
Ya |
googleAnalyticsTimeZone |
Zona waktu tampilan Google Analytics yang ditautkan ke pengiklan DS ini. Menggunakan format Database Zona Waktu IANA, seperti America/New_York. |
atribut | String |
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 |
searchBudgetLostImpressionShare |
khusus Google Ads dan Bing Ads. Persentase berapa kali iklan Anda tidak ditampilkan pada Jaringan Penelusuran karena anggaran tidak mencukupi. Ditampilkan sebagai angka antara 0 dan 0,9 atau, jika pangsanya lebih besar dari 0,9, sebagai string > 90%. |
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 |
displayBudgetLostImpressionShare |
Khusus Google Ads. Persentase berapa kali iklan Anda tidak ditampilkan pada Jaringan Display karena anggaran tidak mencukupi. Ditampilkan sebagai angka antara 0 dan 0,9 atau, jika pangsanya lebih besar dari 0,9, sebagai string > 90%. |
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 tampil 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 |
searchBudgetLostAbsoluteTopImpressionShare |
Memperkirakan seberapa sering iklan Anda tidak menjadi iklan pertama di atas hasil penelusuran organik karena anggaran yang rendah. | metrik | Impression share |
Ya |
searchBudgetLostTopImpressionShare |
Membantu Anda memahami frekuensi iklan tidak ditampilkan di mana saja di atas hasil penelusuran organik karena anggaran yang rendah. | 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 |