FAQ tentang Pelaporan

Search Ads 360 Reporting API versi baru kini tersedia. API baru menyediakan meningkatkan fleksibilitas dalam membuat laporan kustom dan mengintegrasikan data ke dalam aplikasi pelaporan dan proses. Pelajari lebih lanjut cara bermigrasi ke dan menggunakan Pelaporan Search Ads 360 versi baru Google Cloud Platform.

Berapa cakupan laporan saya?

Untuk sebagian besar laporan, sebaiknya tetapkan Reports.reportScope ke akun mesin atau pengiklan tertentu. Untuk model sangat besar seperti laporan kata kunci, laporan konversi, atau laporan yang tersegmentasi secara detail—sebaiknya batasi cakupan pada akun mesin tertentu. API dapat menampilkan error untuk laporan yang lebih besar dari 10 juta baris.

Mengapa saya menerima error Dilarang (403)?

Kemungkinan besar, Anda perlu mendapatkan token OAuth refresh.

Bagaimana cara menemukan ID untuk agensi dan pengiklan?

Jika Anda belum memiliki ID untuk agensi dan pengiklan yang Anda miliki izin untuk melihat, meminta izin advertiser laporan dengan kolom agencyId dan advertiserId, tetapi tidak menentukan reportScope. Search Ads 360 akan menampilkan daftar semua ID agensi dan pengiklan yang Akun Google memiliki izin untuk melihat.

Berikut adalah contoh permintaan:

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

Seberapa aktual data pelaporan?

Beberapa metrik lebih baru daripada yang lain. Untuk mengetahui detailnya, lihat seberapa baru data pelaporan di Search Ads 360?

Untuk memastikan laporan Anda berisi semua metrik yang tersedia, sebaiknya tunggu sekitar 4 jam setelah tengah malam (zona waktu akun mesin) sebelum meminta laporan metrics; untuk laporan conversion, sebaiknya tunggu 12 jam setelah tengah malam (zona waktu pengiklan Campaign Manager). Jika Anda menggunakan API untuk mengupload data konversi, lihat insert.operation untuk mengetahui detail tentang ketersediaan data yang diupload.

Bahkan setelah beberapa hari, metrik masih dapat berubah karena adanya filter spam mesin atau jika offline konversi yang diupload melalui API. Untuk mendownloadnya secara bertahap perubahan, minta laporan pada data yang telah berubah sejak download terakhir Anda. Jika Anda mendownload update perubahan, sebaiknya sesekali meminta laporan lengkap. Misalnya, Anda mungkin mendownload perubahan tambahan setiap beberapa hari dan kemudian meminta laporan lengkap sekali sebulan.

Kapan perubahan atribut akan muncul dalam laporan?

Perlu waktu sekitar satu menit agar perubahan atribut yang dilakukan seseorang di Search Ads 360 muncul di laporan yang didownload melalui API. Perubahan dilakukan secara langsung pada mesin eksternal (bukan melalui Search Ads 360) harus diimpor ke Search Ads 360 terlebih dahulu menggunakan sinkronisasi masuk.

Sebaiknya kembali hanya data yang telah berubah untuk menentukan entitas mana yang memiliki perubahan atribut.

Apa yang dimaksud dengan iklan dan kata kunci tanpa atribut?

Terkadang Search Ads 360 tidak dapat mengatribusikan metrik ke iklan tertentu. Misalnya, iklan dengan format yang tidak didukung atau URL server klik dengan error dapat mencegah Search Ads 360 mengatribusikan metrik dengan iklan. Untuk setiap grup iklan, Search Ads 360 melaporkan setiap metrik yang tidak diatribusikan sebagai milik "iklan tanpa atribut". Untuk meminta metrik ini dalam laporan, tetapkan includeRemovedEntities ke true. Untuk mempermudah melihat iklan mana yang tidak diatribusikan, sertakan isUnattributedAd dalam permintaan.

Demikian pula, terkadang Search Ads 360 tidak dapat mengatribusikan metrik ke kata kunci tertentu. Hal ini terjadi jika muncul perbedaan dalam pelaporan. Dalam kasus tersebut, Kolom keywordId untuk kata kunci tanpa atribut ditetapkan ke 0.

Apakah laporan menyertakan konversi yang diskalakan?

Dalam beberapa kasus, konversi sulit diukur, seperti saat cookie situs yang menyimpan informasi tentang klik iklan tidak tersedia karena berbagai faktor, termasuk setelan browser. Dalam kasus ini, Floodlight menggunakan penskalaan untuk memperhitungkan data konversi yang tidak dapat diukur secara langsung. Artinya, Floodlight menerapkan machine learning ke data historis untuk membuat model jumlah konversi dan jumlah pendapatan konversi yang tidak dapat diukur. Floodlight dapat lalu tambahkan estimasi yang dihasilkan ke metrik konversinya untuk memberikan gambaran yang lebih lengkap tentang bagaimana iklan mendorong konversi.

Floodlight selalu menerapkan penskalaan ke kolom pelaporan berikut:

  • dfaActions
  • dfaRevenue
  • dfaTransactions
  • dfaWeightedActions
  • Kolom tersimpan yang melaporkan aktivitas Floodlight

conversion tidak mencakup konversi yang diskalakan. Laporan ini hanya menunjukkan konversi yang diukur secara langsung. Jumlah konversi dan jumlah pendapatan dalam laporan conversion tidak diharapkan sama dengan konversi dan pendapatan yang dilaporkan pada kolom yang tercantum di atas.

Mengapa konversi mentah tidak dijumlahkan dengan metrik gabungan X?

Jika metrik gabungan tidak cocok dengan peristiwa mentah di Search Ads 360, percayalah pada metrik gabungan. Saat menghitung agregat metrik, Search Ads 360 mencoba membersihkan data sumber dengan menghapus konversi yang dicurigai sebagai duplikat.

Bagaimana jika pertanyaan saya tidak terjawab di sini?

Jika ada masalah yang tidak dapat Anda selesaikan setelah membaca referensi di situs ini, hubungi dukungan dan minta informasi berikut ini siap:

  • ID Agensi dan ID Pengiklan Search Ads 360 yang Anda coba akses

  • Nomor Project dari Konsol API Google

  • Nama pengguna Akun Google yang Anda gunakan untuk mengakses API.
    Ini adalah akun yang telah diberikan izin untuk mengakses Search Ads 360, yang merupakan akun yang sama dengan yang Anda gunakan siapkan otorisasi.

  • Cuplikan kode permintaan Anda

  • Respons JSON
    Jika responsnya adalah error, pastikan untuk menyertakan pesan error, bukan hanya kode kesalahan numerik.