Jenis Laporan: iklan

Metrik performa dan atribut konfigurasi untuk 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": "ad". 

{
...
  "reportType": "ad",
  "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 Status iklan: Active, Paused, atau Removed. Perhatikan bahwa kampanye, grup iklan, kata kunci, dan iklan masing-masing memiliki statusnya sendiri. Lihat status. atribut Status Ya
engineStatus Status tambahan iklan di akun mesin eksternal. Kemungkinan status (bergantung pada jenis akun eksternal) mencakup active, eligible, creative deleted, creative approved family safe, dll. atribut String Ya
creationTimestamp Stempel waktu pembuatan iklan, yang diformat dalam ISO 8601. atribut Timestamp Ya
lastModifiedTimestamp Stempel waktu perubahan terbaru 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
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
ad Nama iklan. atribut String Ya
adId ID iklan DS. Nilai 0 menunjukkan bahwa iklan tidak diatribusikan. atribut ID Ya
adEngineId ID iklan di akun mesin eksternal. atribut ID Ya
isUnattributedAd Menunjukkan apakah metrik di baris ini tidak dapat diatribusikan ke iklan tertentu. Misalnya, iklan dengan format yang tidak didukung atau URL server klik yang salah dapat mencegah DS mengatribusikan metrik ke iklan. atribut Boolean Ya
adHeadline Judul iklan. atribut String Ya
adHeadline2 Judul iklan 2; tidak tersedia untuk beberapa mesin telusur. atribut String Ya
adHeadline3 Judul iklan 3; tidak tersedia untuk beberapa mesin telusur. atribut String Ya
adDescription1 Baris deskripsi 1 iklan. atribut String Ya
adDescription2 Baris deskripsi 2 iklan; tidak tersedia untuk beberapa mesin telusur. atribut String Ya
adDisplayUrl URL yang ditampilkan iklan. atribut String Ya
adLandingPage Halaman landing iklan. Lihat URL halaman landing dan server klik. atribut String Ya
adType Jenis iklan: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text, atau Expanded dynamic search. atribut Ad type Ya
adPromotionLine Baris promosi iklan. Pesan promosi singkat untuk iklan produk. atribut String Ya
adLabels Nama label yang ditetapkan langsung ke iklan ini; label yang diwarisi tidak disertakan. atribut String list Ya
adPathField1 Kolom jalur iklan 1. Kolom jalur 1 dan 2 digabungkan dengan adDisplayUrl untuk membentuk URL yang ditampilkan di iklan. atribut String Ya
adPathField2 Kolom jalur iklan 2. Kolom jalur 1 dan 2 digabungkan dengan adDisplayUrl untuk membentuk URL yang ditampilkan di iklan. atribut String Ya
effectiveLabels Nama semua label yang diwarisi atau ditetapkan langsung ke iklan 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 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
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