FAQ tentang Pelaporan

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.

Apa yang seharusnya menjadi cakupan laporan saya?

Untuk sebagian besar laporan, sebaiknya tetapkan Reports.reportScope ke akun mesin atau pengiklan tertentu. Untuk laporan yang sangat besar, seperti laporan kata kunci, laporan konversi, atau laporan yang tersegmentasi dengan baik, sebaiknya batasi cakupannya ke akun mesin tertentu. API mungkin menampilkan error untuk laporan yang lebih besar dari 10 juta baris.

Mengapa saya menerima error Terlarang (403)?

Kemungkinan besar, Anda perlu mendapatkan token OAuth refresh.

Bagaimana cara menemukan ID untuk agensi iklan dan pengiklan?

Jika belum memiliki ID untuk agensi dan pengiklan yang dapat Anda lihat, minta laporan advertiser dengan kolom agencyId dan advertiserId, tetapi jangan tentukan reportScope. Search Ads 360 akan menampilkan daftar semua ID agensi dan pengiklan yang dapat dilihat oleh Akun Google Anda.

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 pelaporannya?

Beberapa metrik lebih baru dari 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 metrik kemarin; 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 filter spam mesin atau konversi offline diupload melalui API. Untuk mendownload perubahan ini secara bertahap, minta laporan tentang data yang telah berubah sejak download terakhir Anda. Jika Anda mendownload perubahan inkremental, sebaiknya minta laporan lengkap sesekali. Misalnya, Anda dapat mendownload perubahan inkremental setiap beberapa hari, lalu meminta laporan lengkap sekali sebulan.

Kapan perubahan atribut akan muncul dalam laporan?

Perlu waktu sekitar satu menit agar perubahan atribut yang dibuat seseorang di Search Ads 360 muncul dalam laporan yang Anda download melalui API. Perubahan yang dilakukan langsung di mesin eksternal (tidak melalui Search Ads 360) harus diimpor ke Search Ads 360 terlebih dahulu menggunakan sinkronisasi masuk.

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

Apa itu 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 ke iklan. Untuk setiap grup iklan, Search Ads 360 melaporkan setiap metrik tanpa atribut sebagai milik "iklan tanpa atribut". Untuk meminta metrik ini dalam laporan, tetapkan includeRemovedEntities ke true. Untuk memudahkan Anda melihat iklan yang tidak memiliki atribut, sertakan kolom isUnattributedAd dalam permintaan.

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

Apakah laporan menyertakan konversi yang diskalakan?

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

Floodlight selalu menerapkan penskalaan ke kolom pelaporan berikut:

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

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

Mengapa konversi mentah tidak dijumlahkan ke metrik gabungan X?

Jika metrik gabungan tidak sesuai dengan peristiwa mentah di Search Ads 360, percayalah pada metrik gabungan. Saat menghitung gabungan metrik, Search Ads 360 berupaya membersihkan sumber data dengan menghapus konversi yang diduga merupakan 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 siapkan informasi berikut:

  • 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.
    Akun ini telah diberi izin untuk mengakses Search Ads 360, yaitu akun yang sama dengan yang Anda gunakan untuk menyiapkan otorisasi.

  • Cuplikan kode permintaan Anda

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