Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan Pelaporan

Dengan penyatuan pelaporan dan kueri, Anda tidak perlu lagi menentukan laporan. Anda dapat langsung membuat kueri resource untuk data menggunakan SearchGoogleAdsStreamRequest atau SearchGoogleAdsRequest.

Mulai perencanaan migrasi laporan Anda dengan melihat tabel pemetaan kolom yang sesuai. Tabel ini menunjukkan nama kolom AdWords API dan yang setara di Google Ads API.

Contoh

Laporan Performa Grup Iklan dan Laporan Performa Kampanye adalah dua laporan AdWords API yang paling sering digunakan. Sebagai perbandingan, kami menyediakan kueri yang setara dalam Bahasa Kueri AdWords (AWQL) dan Bahasa Kueri Google Ads (GAQL):

Laporan Performa Grup Iklan
# AWQL SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost FROM ADGROUP_PERFORMANCE_REPORT DURING LAST_7_DAYS # Google Ads Query Language SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks, metrics.cost_micros FROM ad_group WHERE segments.date DURING LAST_7_DAYS
Laporan Kinerja Kampanye
# AWQL SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks, Ctr, AverageCpc, Cost FROM CAMPAIGN_PERFORMANCE_REPORT DURING LAST_30_DAYS # Google Ads Query Language SELECT campaign.name, campaign.status, segments.device, metrics.impressions, metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_30_DAYS

Laporan Performa Grup Iklan

# AWQL
SELECT CampaignId, AdGroupId, Impressions, Clicks, Cost
FROM ADGROUP_PERFORMANCE_REPORT
DURING LAST_7_DAYS

# Google Ads Query Language
SELECT campaign.id, ad_group.id, metrics.impressions, metrics.clicks,
       metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS

Laporan Kinerja Kampanye

# AWQL
SELECT CampaignName, CampaignStatus, Device, Impressions, Clicks,
       Ctr, AverageCpc, Cost
FROM CAMPAIGN_PERFORMANCE_REPORT
DURING LAST_30_DAYS

# Google Ads Query Language
SELECT campaign.name, campaign.status, segments.device, metrics.impressions,
       metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Laporan atribusi tunggal versus beberapa

Selama migrasi, laporan tertentu yang terkait dengan kriteria tertentu di AdWords API mungkin memerlukan pertimbangan khusus seperti Laporan Performa Kata Kunci atau Laporan Performa Rentang Usia. Ada dua jenis laporan seperti itu:

Laporan atribusi tunggal, seperti Laporan Performa Kriteria atau Laporan Performa Kata Kunci, saat hanya salah satu dari kriteria pemicu (seperti penempatan, usia, kata kunci, dll.) yang dicatat untuk tayangan tertentu: Tayangan dapat dipicu oleh beberapa kriteria, tetapi pada satu atribusi melaporkan tayangan dan semua statistiknya hanya diatribusikan ke satu kriteria.
Beberapa laporan atribusi, seperti Laporan Performa Gender atau Laporan Performa Penempatan, dengan hingga satu kriteria di setiap dimensi yang memicu tayangan memiliki tayangan yang dicatat untuknya: Beberapa laporan atribusi dapat dianggap sebagai laporan khusus jenis kriteria. Tidak seperti atribusi tunggal yang barisnya dapat berisi berbagai jenis kriteria, setiap laporan atribusi hanya berisi kriteria untuk satu jenis kriteria.

Di Google Ads API, tidak ada satu pun laporan atribusi. Semua laporan tingkat kriteria Google Ads API memiliki atribusi multi-atribut yang berarti bahwa setiap laporan khusus untuk satu grup jenis kriteria, dan meringkas statistik sesuai dengan kriteria jenis tersebut. Jangan tambahkan statistik bersama dari resource criteria_view yang berbeda, karena akan mengakibatkan penghitungan ganda dan total yang salah.

Header HTTP includeZeroImpressions

AdWords API

Di AdWords API, Anda dapat menggunakan header includeZeroImpressions untuk mengontrol apakah baris laporan tempat semua kolom metrik yang ditentukan dalam kueri memiliki nilai nol akan ditampilkan.

Tetapkan header ke true, output laporan mencakup baris seperti itu; untuk false, output tidak disertakan.

Meskipun nama header menyebutkan "Tayangan", baris laporan harus memiliki nol di semua kolom metrik yang ditentukan dalam permintaan (bukan hanya tayangan) agar dikecualikan jika header ditetapkan ke false.

Google Ads API

Tidak ada header seperti itu di Google Ads API, sehingga Anda tidak dapat memetakan kueri AdWords API secara langsung ke kueri di Google Ads API.

Sebagai perkiraan, Anda dapat menentukan predikat metrics.impressions > 0 dalam kueri untuk mengecualikan baris laporan yang tayangannya nol. Untuk sebagian besar kasus, hal ini memberikan hasil yang setara seperti menetapkan header includeZeroImpressions AdWords API ke false karena saat tayangan bukan nol, nilai metrik lainnya sering kali bukan nol.

Namun, perhatikan kasus saat metrics.impressions bernilai nol, tetapi nilai metrik lainnya (seperti metrics.search_impression_share berbasis prediksi) mungkin tidak, sehingga baris laporan tetap dapat ditampilkan.