Kolom Tersimpan

Search Ads 360 Reporting API versi baru kini tersedia. API baru ini memberikan fleksibilitas yang lebih baik dalam membuat laporan kustom dan mengintegrasikan data ke dalam proses dan aplikasi pelaporan Anda. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Search Ads 360 Reporting API baru.

Untuk melaporkan aktivitas Floodlight, sasaran Google Analytics, atau KPI kustom, pengiklan dapat login ke UI Search Ads 360 dan membuat satu atau beberapa kolom tersimpan, seperti kolom aktivitas Floodlight, kolom aktivitas Google Analytics, atau kolom formula. Anda dapat menyertakan kolom tersimpan dalam permintaan laporan untuk mendownload datanya atau untuk memfilter laporan.

Mendapatkan daftar kolom yang disimpan

Untuk melihat semua kolom tersimpan yang telah dibuat oleh pengiklan, kirim permintaan SavedColumns.list() . Responsnya menyertakan savedColumnName untuk setiap kolom pengiklan.

Meminta laporan untuk kolom tersimpan

Untuk menyertakan kolom tersimpan dalam permintaan laporan, tambahkan kolom dengan atribut savedColumnName yang ditetapkan ke nama kolom:

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

Saat menggunakan kolom tersimpan, perhatikan bahwa:

  • Kolom tersimpan ditentukan di tingkat pengiklan. Jika Anda menyertakan kolom tersimpan dalam permintaan, request.reportScope harus menentukan pengiklan atau cakupan yang lebih rendah. Akibatnya, setiap laporan dapat menyertakan kolom tersimpan hanya untuk satu pengiklan.

  • Nama kolom tersimpan peka huruf besar/kecil, peka spasi kosong, dan peka tanda baca. Atribut savedColumnName harus sama persis dengan nama kolom yang disimpan. Jika nama kolom tersimpan sama dengan nama kolom lain dalam permintaan yang sama, Search Ads 360 mengharuskan Anda menentukan headerText alternatif yang unik untuk salah satu atau kedua kolom.

  • Kolom tersimpan dapat diubah atau dihapus di UI pengelolaan kampanye Search Ads 360 kapan saja; jika permintaan yang menentukan kolom tersimpan gagal, coba hapus kolom tersimpan dari permintaan, lalu kirim lagi.

  • Laporan inkremental tidak boleh berisi metrik yang tidak secara eksplisit didukung oleh API (misalnya, kolom aktivitas Google Analytics). Selain itu, karena pengguna Search Ads 360 dapat menentukan ulang kolom tersimpan, laporan inkremental yang berisi kolom tersimpan mungkin tidak akurat.