Pelaporan peningkatan

Untuk mengukur dampak kausal kampanye iklan Anda terhadap persepsi merek, konversi, nilai konversi, dan perilaku penelusuran organik, buat kueri resource pelaporan pengukuran peningkatan di Google Ads API:

  • Pelaporan Brand Lift: Mengevaluasi pengaruh eksposur iklan terhadap persepsi merek di berbagai jenis pengukuran yang disurvei di Google Ads API v25 dan yang lebih baru.
  • Pelaporan Conversion Lift: Mengukur konversi inkremental, nilai konversi, biaya per konversi inkremental (iCPA), dan laba atas belanja iklan inkremental (iROAS) terhadap grup kontrol yang tidak terekspos di Google Ads API v25 dan yang lebih baru, termasuk:
  • Pelaporan Search Lift: Mengukur peningkatan inkremental dalam volume kueri penelusuran organik di Google Penelusuran dan YouTube yang didorong oleh eksposur iklan di Google Ads API v26 dan yang lebih baru.

Untuk pelaporan eksperimen A/B standar pada resource experiment dan campaign, lihat Melaporkan eksperimen.

Pelaporan Brand Lift

Untuk mengevaluasi pengaruh kampanye iklan Anda terhadap persepsi brand di Google Ads API v25 dan yang lebih baru, buat kueri resource pengukuran Brand Lift khusus.

Referensi Brand Lift dan tampilan perincian

Konfigurasi, periode tayang, dan tampilan perincian Brand Lift bersifat hanya baca di Google Ads API (semua kolom bersifat OUTPUT_ONLY) dan dikonfigurasi di UI Google Ads atau dengan perwakilan Google atau kontak GPS Anda. Buat kueri resource ini menggunakan parameter customer_id akun (akun pengelola atau akun turunan) yang memiliki studi.

Buat kueri resource LiftMeasurementFlight untuk mengambil jadwal Brand Lift tingkat periode dan metadata pengumpulan survei, termasuk status periode (lift_measurement_flight.status, yang ditentukan oleh enum LiftMeasurementFlightStatus dengan nilai ENABLED untuk periode aktif dan STOPPED untuk periode yang dihentikan secara manual), rentang tanggal periode (lift_measurement_flight.start_date dan lift_measurement_flight.end_date) dalam zona waktu pelanggan, dan progres pengumpulan respons survei target (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, dengan 0 sama dengan 0% dan 1000000 sama dengan 100%). Untuk menentukan apakah flight ENABLED sedang berlangsung atau telah selesai, bandingkan tanggal saat ini di zona waktu pelanggan dengan lift_measurement_flight.start_date dan lift_measurement_flight.end_date, lalu periksa apakah response_collection_ratio_micros telah mencapai 1000000.

Buat kueri resource LiftMeasurementConfig untuk mengambil metrik Brand Lift tingkat studi secara keseluruhan, atau buat kueri resource pengelompokan berikut untuk menganalisis metrik Brand Lift di berbagai dimensi tertentu:

Sertakan segmen segments.brand_lift_measurement_type untuk mengelompokkan metrik Brand Lift menurut jenis pertanyaan yang disurvei, yang ditentukan oleh enum BrandLiftMeasurementType (seperti RECALL atau AWARENESS). Jika Anda menghilangkan segmen segments.brand_lift_measurement_type, API akan menampilkan metrik untuk satu jenis pengukuran yang dipilih secara otomatis per slice. Sertakan segmen segments.date untuk mengelompokkan metrik Brand Lift berdasarkan tanggal (YYYY-MM-DD). Metrik metrics.cost_per_lifted_cookie ditampilkan dalam mikro mata uang akun pemilik studi.

Di Google Ads API v27 dan yang lebih baru, Anda juga dapat memilih kolom lift_guidance (OUTPUT_ONLY) hanya baca (lift_guidance.outcome dan lift_guidance.guidance_message, dari jenis LiftGuidance) dalam klausa SELECT Google Ads Query Language (GAQL) di lift_measurement_config dan di lima resource pengelompokan Brand Lift (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender, dan lift_measurement_video) untuk menerima interpretasi statistik tingkat baris. Di lift_measurement_config, lift_guidance hanya diisi jika kueri juga memilih atau memfilter metrik atau segmen Peningkatan (metrik ini dihilangkan pada kueri konfigurasi khusus metadata), dan lift_guidance.guidance_message dapat berisi link Markdown inline (seperti [Learn more](https://support.google.com/...)). Anda tidak dapat memfilter atau mengurutkan subkolom lift_guidance dalam klausa WHERE atau ORDER BY. Untuk deskripsi nilai LiftOutcomeEnum.LiftOutcome yang ditampilkan di lift_guidance.outcome, lihat Menafsirkan hasil Brand Lift.

Nilai minimum pelaporan dan respons kosong

Pelaporan Brand Lift dibatasi latensi (memerlukan penundaan pipeline 24–48 jam setelah studi dimulai) dan dibatasi respons per jenis pengukuran yang disurvei (segments.brand_lift_measurement_type) untuk memenuhi nilai minimum pelaporan statistik dan privasi:

  • Rasio respons positif (metrics.brand_lift_baseline_positive_response_rate* dan metrics.brand_lift_exposed_positive_response_rate*): Minimal 50 respons survei di grup yang sesuai (terekspos atau tidak terekspos).
  • Nilai minimum peningkatan positif yang ketat (studi keseluruhan tentang LiftMeasurementConfig atau irisan independen): Peningkatan positif secara statistik (p_value <= 0.50) dengan total minimal 2.000 respons dan 860 respons per grup.
  • Nilai minimum peningkatan positif slice yang dilonggarkan (pada resource perincian saat keseluruhan studi memenuhi nilai minimum yang ketat dengan peningkatan positif): Peningkatan positif secara statistik (p_value <= 0.50) dengan total minimal 500 respons dan 200 respons per grup.
  • Nilai minimum peningkatan non-positif lengkap (NO_SIGNIFICANT_LIFT versus NOT_ENOUGH_DATA): Minimal 4.100 total respons per metrik jika tidak ada peningkatan positif yang terdeteksi secara statistik.

Kueri ke LiftMeasurementConfig dan lima resource pengelompokan Brand Lift (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign, dan LiftMeasurementVideo) menampilkan respons kosong (results: []), bukan error dalam kasus berikut:

  • Parameter customer_id yang dikueri tidak ada dalam daftar yang diizinkan atau tidak memiliki studi.
  • Filter tanggal WHERE berada di luar tanggal penerbangan yang dievaluasi (lift_measurement_flight.start_date dan lift_measurement_flight.end_date).
  • Studi atau segmen demografis, perangkat, kampanye, atau video tertentu belum memenuhi batas volume respons survei dan penundaan pelaporan 24–48 jam, meskipun LiftMeasurementConfig menampilkan hasil studi secara keseluruhan.

Untuk memecahkan masalah respons kosong, selesaikan langkah-langkah berikut:

  1. Buat kueri lift_measurement_flight untuk memverifikasi bahwa lift_measurement_flight.status = 'ENABLED', periksa apakah filter tanggal WHERE Anda berada dalam rentang lift_measurement_flight.start_date dan lift_measurement_flight.end_date, serta periksa progres survei di lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (dengan 1000000 sama dengan 100%).
  2. Buat kueri LiftMeasurementConfig untuk mengonfirmasi apakah keseluruhan studi telah menghasilkan metrik Brand Lift yang dapat dilaporkan sebelum membuat kueri resource perincian dimensi.

Menafsirkan hasil Brand Lift

Di Google Ads API v27 dan yang lebih baru, kolom lift_guidance.outcome menampilkan nilai LiftOutcomeEnum.LiftOutcome yang mengklasifikasikan status statistik setiap baris yang ditampilkan bersama saran perbaikan yang dapat dibaca manusia di lift_guidance.guidance_message:

  • Hasil studi yang sedang berlangsung (jika lift_measurement_flight.status adalah ENABLED dan tanggal saat ini di zona waktu pelanggan adalah pada atau sebelum lift_measurement_flight.end_date dengan lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros kurang dari 1000000):
    • STUDY_IN_PROGRESS_WITH_LIFT: Studi sedang berlangsung dan peningkatan positif awal mulai terlihat.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: Studi sedang berlangsung dengan volume awal yang memadai, dan belum ada peningkatan yang signifikan secara statistik yang terdeteksi.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: Studi sedang berlangsung dan aktif mengumpulkan respons survei awal untuk mencapai nilai minimum pelaporan statistik.
  • Hasil studi yang telah selesai (setelah lift_measurement_flight.end_date berlalu atau lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros telah mencapai 1000000):
    • POSITIVE_LIFT_DETECTED: Peningkatan positif yang signifikan secara statistik terdeteksi untuk studi atau irisan yang telah selesai.
    • NO_SIGNIFICANT_LIFT: Studi atau segmen yang telah selesai memenuhi nilai minimum presisi statistik (total minimal 4.100 respons per metrik), dan tidak ada peningkatan positif yang signifikan secara statistik yang terdeteksi.
    • NOT_ENOUGH_DATA: Studi atau irisan yang telah selesai tidak memenuhi nilai minimum respons survei yang diperlukan untuk pelaporan statistik (total minimal 2.000 respons dan 860 respons per grup untuk peningkatan positif pada keseluruhan studi, total 500 respons dan 200 respons per grup untuk peningkatan positif pada irisan saat keseluruhan studi memiliki peningkatan positif, atau total 4.100 respons per metrik jika tidak ada peningkatan positif yang terdeteksi).

Terapkan panduan berikut saat menafsirkan hasil Brand Lift:

  • Penayangan yang sedang berlangsung versus yang telah selesai (STUDY_IN_PROGRESS_*): Saat penayangan studi ENABLED masih berlangsung (sebelum lift_measurement_flight.end_date berlalu dan sebelum response_collection_ratio_micros mencapai 1000000), respons survei dan pemodelan yang dikoreksi bias masih distabilkan. Perlakukan metrik yang sedang diproses sebagai metrik awal dan hindari menjeda kampanye atau mengurangi anggaran hingga periode tayang selesai.
  • Peningkatan positif (POSITIVE_LIFT_DETECTED): Saat Brand Lift positif terdeteksi, buat kueri resource pengelompokan dimensi (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign, dan LiftMeasurementVideo) untuk mengidentifikasi kelompok audiens berperforma tinggi ("titik terang") dan mengevaluasi resonansi materi iklan di seluruh funnel merek.
  • Data tidak memadai atau tidak ada peningkatan yang signifikan (NOT_ENOUGH_DATA atau NO_SIGNIFICANT_LIFT): Jika volume respons survei tidak memadai (total respons kurang dari 4.100 per metrik tanpa peningkatan positif, atau kurang dari batas irisan ketat 2.000/860 atau batas irisan longgar 500/200 untuk peningkatan positif) atau tidak ada peningkatan yang signifikan secara statistik yang terdeteksi pada irisan, jangan anggap hal ini sebagai kegagalan kampanye atau mengecualikan audiens berdasarkan ketidakcukupan sampel irisan tunggal. Periksa metrik studi keseluruhan di LiftMeasurementConfig, buat kueri nilai segments.brand_lift_measurement_type lain yang disurvei (seperti RECALL atau AWARENESS funnel atas), dan periksa dimensi perincian yang tersisa.

Contoh kueri Brand Lift

Karena metadata penerbangan dan statistik peningkatan berada di resource yang terpisah, membuat kueri detail penerbangan dan statistik performa memerlukan kueri GAQL yang terpisah.

Kueri detail penerbangan

Untuk mengambil metadata untuk periode Brand Lift, seperti status, jenis pengukuran, tanggal yang dijadwalkan, dan progres pengumpulan survei, buat kueri resource LiftMeasurementFlight:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date,
  lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'SURVEY'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat dari konfigurasi pengukuran peningkatan (lift_measurement_config.lift_measurement_config_id).

Kueri statistik

Untuk mengambil metrik Brand Lift, buat kueri resource LiftMeasurementConfig atau resource pengelompokan yang sesuai. Misalnya, kueri berikut mengambil metrik Brand Lift yang disegmentasikan menurut kampanye dan jenis pengukuran Brand Lift dari resource LiftMeasurementCampaign:

SELECT
  lift_measurement_campaign.lift_measurement_config_id,
  lift_measurement_campaign.campaign,
  segments.brand_lift_measurement_type,
  metrics.absolute_brand_lift,
  metrics.relative_brand_lift
FROM lift_measurement_campaign
WHERE lift_measurement_campaign.lift_measurement_config_id = CONFIG_ID

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.

Pelaporan Conversion Lift

Di Google Ads API v25 dan yang lebih baru, pelaporan Conversion Lift mengukur dampak inkremental iklan Anda terhadap konversi dan nilai konversi. Studi Conversion Lift membandingkan perilaku konversi antara grup terekspos (pengguna yang memenuhi syarat untuk melihat iklan Anda) dan grup kontrol yang tidak terekspos (pengguna yang dicegah agar tidak melihat iklan Anda).

Konfigurasi, periode tayang, dan link eksperimen Conversion Lift bersifat hanya baca di Google Ads API (semua kolom adalah OUTPUT_ONLY) dan dikonfigurasi di UI Google Ads atau dengan perwakilan Google atau kontak GPS Anda. Buat kueri resource lift_measurement_config menggunakan parameter customer_id akun yang memiliki studi. Akun pengelola dapat langsung mengkueri studi Conversion Lift lintas-akun yang dimilikinya. Buat kueri studi yang dimiliki oleh akun turunan menggunakan parameter customer_id akun turunan (yang diautentikasi secara opsional dengan header login-customer-id).

Pelaporan Conversion Lift mendukung dua alur kerja studi, yang keduanya memiliki penemuan studi dan periode tayang iklan, rentang tanggal snapshot kumulatif, dan cakupan tindakan konversi yang sama:

  • Pelaporan Conversion Lift mandiri: Mengukur inkrementalitas keseluruhan, biaya per konversi inkremental (iCPA), dan laba atas belanja iklan inkremental (iROAS) di seluruh tindakan konversi yang dipilih atau semua tindakan konversi dari kampanye yang diukur dalam studi.
  • Pelaporan A/B + Conversion Lift: Mengukur inkrementalitas per grup dan skor pemenang Bayesian antara dua grup eksperimen yang bersaing (kontrol versus perlakuan) bersama dengan inkrementalitas studi secara keseluruhan.

Untuk mendapatkan bantuan dalam membuat kueri yang valid ke resource lift_measurement_config, gunakan alat Pembuat Kueri Google Ads.

Di Google Ads API v27 dan yang lebih baru, Anda dapat memilih kolom (OUTPUT_ONLY) lift_measurement_config.lift_guidance hanya baca (lift_guidance.outcome dan lift_guidance.guidance_message, dari jenis LiftGuidance) dalam klausa SELECT GAQL di lift_measurement_config untuk menerima interpretasi statistik tingkat baris untuk kueri Peningkatan Konversi mandiri dan A/B + Peningkatan Konversi. Di lift_measurement_config, lift_guidance hanya diisi jika kueri juga memilih atau memfilter metrik atau segmen Peningkatan (dihilangkan pada kueri konfigurasi khusus metadata), dan lift_guidance.guidance_message dapat berisi link Markdown inline (seperti [Learn more](https://support.google.com/...)). Anda tidak dapat memfilter atau mengurutkan subkolom lift_guidance dalam klausa WHERE atau ORDER BY. Kolom lift_guidance.outcome menampilkan salah satu nilai LiftOutcomeEnum.LiftOutcome berikut:

  • Hasil studi yang sedang berlangsung (jika lift_measurement_flight.status adalah ENABLED dan tanggal saat ini di zona waktu pelanggan adalah pada atau sebelum lift_measurement_flight.end_date):
    • STUDY_IN_PROGRESS_WITH_LIFT: Studi sedang berlangsung dan peningkatan positif awal mulai terlihat.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: Studi sedang berlangsung dengan volume awal yang memadai, dan belum ada peningkatan yang signifikan secara statistik yang terdeteksi.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: Studi sedang berlangsung dan aktif mengumpulkan data konversi awal untuk mencapai nilai minimum pelaporan statistik.
  • Hasil studi yang telah selesai (setelah lift_measurement_flight.end_date berlalu):
    • POSITIVE_LIFT_DETECTED: Peningkatan positif yang signifikan secara statistik terdeteksi untuk studi, grup eksperimen, atau segmen yang telah selesai.
    • AB_WINNER_WITH_LIFT: Studi A/B + Conversion Lift selesai dengan grup eksperimen pemenang secara head-to-head dan peningkatan positif yang signifikan secara statistik dibandingkan dengan grup kontrol yang tidak terekspos.
    • AB_WINNER_PARITY_VS_CONTROL: Studi A/B + Conversion Lift selesai dengan grup eksperimen pemenang secara head-to-head, tetapi setara dengan grup kontrol yang tidak terekspos.
    • NO_SIGNIFICANT_LIFT: Studi, grup eksperimen, atau segmen yang telah selesai memenuhi nilai minimum presisi statistik, dan tidak ada peningkatan positif yang signifikan secara statistik yang terdeteksi.
    • NOT_ENOUGH_DATA: Studi, grup eksperimen, atau segmen yang telah selesai tidak mengumpulkan konversi yang cukup untuk mencapai nilai minimum presisi statistik.

Menemukan konfigurasi studi dan penerbangan

Untuk melaporkan studi Conversion Lift, temukan terlebih dahulu konfigurasi studi dan jadwal tayangnya:

  1. Mengambil konfigurasi studi: Buat kueri resource LiftMeasurementConfig untuk mengambil nama studi, rasio holdback (lift_measurement_config.conversion_lift_holdback_ratio_micros), tindakan konversi yang dilacak (lift_measurement_config.conversion_actions), dan—di Google Ads API v26 dan yang lebih baru—kampanye yang ditautkan secara aktif (lift_measurement_config.campaigns). Kolom conversion_lift_holdback_ratio_micros dinyatakan dalam mikro, dengan 1,000,000 sama dengan 100% (misalnya, 300000 mewakili 30% grup holdback yang tidak terekspos). Jika Anda tidak mengetahui CONFIG_ID studi, hapus klausa WHERE untuk mencantumkan semua konfigurasi studi di akun.
  2. Mengambil periode pengamatan penerbangan: Buat kueri resource LiftMeasurementFlight untuk menemukan tanggal penerbangan terjadwal (lift_measurement_flight.start_date dan lift_measurement_flight.end_date) dalam zona waktu pelanggan. Karena satu resource LiftMeasurementConfig dapat mengelompokkan periode Brand Lift (SURVEY), Conversion Lift (CONVERSION), dan Search Lift (SEARCH), sertakan kolom lift_measurement_flight.lift_type dalam klausa SELECT dan filter menurut lift_measurement_flight.lift_type = 'CONVERSION' dalam klausa WHERE. Kolom lift_measurement_flight.start_date dan lift_measurement_flight.end_date dapat diurutkan dalam klausa ORDER BY, tetapi Anda tidak dapat memfilternya dalam klausa WHERE.

Kueri berikut mengambil konfigurasi studi (hilangkan kolom lift_measurement_config.campaigns di Google Ads API v25, karena kolom tersebut memerlukan Google Ads API v26 dan yang lebih baru):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  lift_measurement_config.name,
  lift_measurement_config.conversion_lift_holdback_ratio_micros,
  lift_measurement_config.conversion_actions,
  lift_measurement_config.campaigns
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat dari konfigurasi pengukuran peningkatan (lift_measurement_config.lift_measurement_config_id).

Kueri berikut mengambil jadwal penayangan Conversion Lift untuk studi:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'CONVERSION'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat dari konfigurasi pengukuran peningkatan (lift_measurement_config.lift_measurement_config_id).

Di Google Ads API v26 dan yang lebih baru, Anda juga dapat menemukan konfigurasi pengukuran peningkatan yang ditautkan ke kampanye langsung dari resource campaign dengan mengkueri kolom campaign.lift_measurement_config. Dengan mengkueri kolom ini, Anda tidak perlu melakukan referensi silang resource LiftMeasurementConfig secara terpisah:

SELECT
  campaign.id,
  campaign.lift_measurement_config
FROM campaign
WHERE campaign.id = CAMPAIGN_ID

Ganti kode berikut:

  • CAMPAIGN_ID: ID bilangan bulat kampanye (campaign.id).

Kolom campaign.lift_measurement_config menampilkan nama resource dalam format customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. Jika kampanye telah berpartisipasi dalam beberapa studi peningkatan, kolom ini mengidentifikasi konfigurasi yang paling baru ditautkan (aktif atau tidak aktif). Sebaliknya, kolom lift_measurement_config.campaigns hanya mencantumkan kampanye yang ditautkan secara aktif.

Membuat kueri rentang tanggal snapshot kumulatif

Hasil Conversion Lift disusun sebagai snapshot evaluasi kumulatif harian mulai dari tanggal mulai periode tayang iklan:

segments.conversion_lift_start_date dan segments.conversion_lift_end_date adalah kolom INT64 yang diformat sebagai bilangan bulat 8 digit tanpa tanda petik dan tanpa tanda hubung dalam format YYYYMMDD (misalnya, 20260501). Sebaliknya, kolom lift_measurement_flight.start_date dan lift_measurement_flight.end_date menampilkan string tanggal dalam format YYYY-MM-DD ISO 8601 (misalnya, 2026-05-01). Tidak seperti dalam kueri Brand Lift dan Search Lift, segmen segments.date tidak kompatibel dengan semua metrik dan segmen Conversion Lift. Memilih segmen segments.date bersama segmen Conversion Lift (seperti segments.conversion_lift_start_date) dalam klausa SELECT akan menampilkan error QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE, sedangkan menggabungkan segments.date dengan metrik Conversion Lift akan menampilkan error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.

Snapshot terbaru yang dihitung dapat tertinggal dari tanggal akhir penayangan aktif saat memproses data. Selalu buat kueri resource lift_measurement_config untuk pasangan (segments.conversion_lift_start_date, segments.conversion_lift_end_date) yang tersedia yang diurutkan berdasarkan segments.conversion_lift_end_date DESC terlebih dahulu untuk mengidentifikasi snapshot yang dievaluasi terbaru.

Kueri berikut mengambil rentang tanggal snapshot yang tersedia untuk studi:

SELECT
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'
ORDER BY segments.conversion_lift_end_date DESC

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.

Memfilter menurut cakupan tindakan konversi

Conversion Lift mengevaluasi inkrementalitas di dua cakupan yang ditentukan oleh segmen segments.conversion_lift_included_conversion_action_types:

  • SELECTED: Tindakan konversi yang dipilih selama penyiapan studi, atau semua tindakan konversi yang dapat di-bid (utama) jika tindakan konversi kustom tidak ditentukan.
  • ALL: Semua tindakan konversi dari kampanye yang diukur dalam studi.

Saat Anda membuat kueri resource lift_measurement_config untuk metrik Conversion Lift tanpa memfilter segmen segments.conversion_lift_included_conversion_action_types, API akan menampilkan dua baris per slice—satu untuk ALL dan satu untuk SELECTED. Di GAQL, setiap kolom segmen non-tanggal (dan setiap segmen tanggal snapshot Conversion Lift) yang difilter dalam klausa WHERE juga harus muncul dalam klausa SELECT. Jika tidak, API akan menampilkan error QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Saat Anda memfilter menurut segments.conversion_lift_included_conversion_action_types = 'SELECTED' dalam klausa WHERE, sertakan segmen tersebut dalam klausa SELECT.

Pelaporan Conversion Lift mandiri

Studi Conversion Lift mandiri mengukur dampak inkremental iklan Anda terhadap grup kontrol yang tidak terekspos tanpa membagi kampanye menjadi grup perlakuan yang bersaing.

Membuat kueri conversion lift dan iCPA

Conversion Lift melaporkan estimasi poin bersama dengan batas keyakinan satu sisi 90% (*_p90_lower_bound dan *_p90_upper_bound, yang bersama-sama membentuk interval kepercayaan dua sisi 80%) dan nilai p (p_value <= 0.10 sesuai dengan signifikansi statistik satu sisi 90%):

API akan menghilangkan metrik Conversion Lift pada baris yang ditampilkan dalam kasus berikut:

  • Periode snapshot inklusif kurang dari 4 hari.
  • Volume konversi yang diamati tanpa penskalaan kurang dari nilai minimum presisi minimum (kurang dari 65 konversi dasar yang diamati dalam grup holdback atau kurang dari 150 konversi yang terekspos yang diamati, dievaluasi sebelum penskalaan metrics.conversion_lift_baseline_conversions).
  • Peningkatan yang diukur tidak positif (metrics.incremental_conversions_p_value > 0.5 untuk metrik konversi, atau metrics.incremental_conversion_value_p_value > 0.5 untuk metrik nilai konversi).
  • Di Google Ads API v27 dan yang lebih baru, metrik iROAS (metrics.incremental_conversion_value_per_cost*) dan metrik skor pemenang nilai konversi (metrics.incremental_conversion_value_winner_score dan metrics.incremental_conversion_value_per_cost_winner_score) dikueri pada studi yang dikonfigurasi selama penyiapan dengan jumlah konversi, bukan nilai konversi sebagai metrik utamanya. Metrik nilai konversi non-biaya (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value*, dan metrics.relative_conversion_value_lift*) tetap diisi pada studi utama jumlah konversi setiap kali peningkatan nilai konversi dapat dilaporkan.
  • Beberapa baris atau studi digabungkan karena Anda menghapus kolom lift_measurement_config.lift_measurement_config_id, segments.conversion_lift_start_date, segments.conversion_lift_end_date, atau segments.conversion_lift_included_conversion_action_types dari klausa SELECT.

Terapkan panduan berikut saat menafsirkan hasil Conversion Lift mandiri:

  • Penayangan yang sedang berlangsung versus yang telah selesai (STUDY_IN_PROGRESS_*): Saat penayangan studi ENABLED masih berlangsung (saat tanggal saat ini di zona waktu pelanggan adalah pada atau sebelum lift_measurement_flight.end_date), pemodelan konversi dasar pengukuran dan perlakuan serta atribusi konversi yang tertunda masih distabilkan. Perlakukan metrik yang sedang diproses sebagai metrik awal dan hindari menjeda kampanye atau mengurangi anggaran hingga periode tayang iklan selesai.
  • Peningkatan positif (POSITIVE_LIFT_DETECTED): Pelaporan metrik Conversion Lift dan pemicu lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' setiap kali peningkatan yang diukur bersifat positif (p_value <= 0.50, sesuai dengan kepastian minimal 50% dengan estimasi titik positif, sedangkan p_value <= 0.10 menunjukkan signifikansi statistik satu sisi sebesar 90% dengan *_p90_lower_bound >= 0) dan nilai minimum presisi (minimal 4 hari snapshot, minimal 65 konversi dasar pengukuran yang tidak diskalakan, dan minimal 150 konversi terekspos yang tidak diskalakan) terpenuhi. Jika peningkatan positif terdeteksi, buat kueri perincian dimensi (demografi, perangkat, negara, atau kategori konversi dan tindakan konversi) untuk mengidentifikasi kelompok berperforma tinggi ("titik terang").
  • Data tidak memadai atau tidak ada peningkatan signifikan (NOT_ENOUGH_DATA atau NO_SIGNIFICANT_LIFT): Jika volume data tidak memadai (kurang dari 65 konversi dasar pengukuran yang tidak diskalakan atau kurang dari 150 konversi terekspos yang tidak diskalakan) atau tidak ada peningkatan signifikan secara statistik yang terdeteksi pada suatu segmen, jangan menganggap hal ini sebagai kegagalan kampanye atau mengecualikan audiens berdasarkan ketidakcukupan sampel segmen tunggal. Periksa metrik studi secara keseluruhan dan buat kueri segments.conversion_lift_included_conversion_action_types = 'ALL' (jika SELECTED tidak menunjukkan peningkatan) atau perincian dimensi yang tersisa untuk memverifikasi apakah peningkatan positif diisolasi di tempat lain.

Kueri berikut mengambil inkrementalitas konversi keseluruhan, batas keyakinan, dan iCPA:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.incremental_conversions_p90_lower_bound,
  metrics.incremental_conversions_p90_upper_bound,
  metrics.incremental_conversions_p_value,
  metrics.cost_per_incremental_conversion,
  metrics.cost_per_incremental_conversion_p90_lower_bound,
  metrics.cost_per_incremental_conversion_p90_upper_bound,
  metrics.relative_conversion_lift,
  metrics.relative_conversion_lift_p90_lower_bound,
  metrics.relative_conversion_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Membuat kueri peningkatan nilai konversi dan iROAS

Untuk mengevaluasi pendapatan inkremental yang dihasilkan oleh pembelanjaan iklan Anda, buat kueri metrik nilai konversi dan metrik metrics.incremental_conversion_value_per_cost. Metrik nilai konversi non-biaya (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value*, dan metrics.relative_conversion_value_lift*) diisi setiap kali studi memiliki peningkatan nilai konversi yang dapat dilaporkan, terlepas dari apakah metrik utama studi adalah jumlah konversi atau nilai konversi. Di Google Ads API v27 dan yang lebih baru, metrik iROAS (metrics.incremental_conversion_value_per_cost*)—bersama dengan metrics.incremental_conversion_value_winner_score dan metrics.incremental_conversion_value_per_cost_winner_score—hanya ditampilkan jika studi dikonfigurasi selama penyiapan dengan nilai konversi sebagai metrik utamanya (dan dihilangkan pada studi utama jumlah konversi):

Kueri berikut mengambil inkrementalitas nilai konversi, batas keyakinan, dan iROAS:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversion_value,
  metrics.conversion_lift_exposed_conversion_value,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_p90_lower_bound,
  metrics.incremental_conversion_value_p90_upper_bound,
  metrics.incremental_conversion_value_p_value,
  metrics.incremental_conversion_value_per_cost,
  metrics.incremental_conversion_value_per_cost_p90_lower_bound,
  metrics.incremental_conversion_value_per_cost_p90_upper_bound,
  metrics.relative_conversion_value_lift,
  metrics.relative_conversion_value_lift_p90_lower_bound,
  metrics.relative_conversion_value_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Menyegmentasikan hasil menurut dimensi

Segmentasikan metrik konversi inkremental menurut kategori konversi, tindakan konversi, demografi, perangkat, atau geografi. Saat membuat kueri resource lift_measurement_config, pilih hanya kombinasi segmen yang kompatibel:

Memilih segmen yang tidak kompatibel satu sama lain dalam klausa SELECT akan menggagalkan validasi kueri dan menampilkan error QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Gunakan Pembuat Kueri Google Ads untuk memvalidasi kombinasi segmen secara interaktif.

Evaluasi metrik efisiensi biaya (metrics.cost_per_incremental_conversion* dan metrics.incremental_conversion_value_per_cost*) hanya pada baris studi keseluruhan atau baris segments.experiment_arm. Di Google Ads API v25 dan v26, skema mengizinkan pemilihan enam metrik rasio biaya (metrics.cost_per_incremental_conversion, metrics.cost_per_incremental_conversion_p90_lower_bound, metrics.cost_per_incremental_conversion_p90_upper_bound, metrics.incremental_conversion_value_per_cost, metrics.incremental_conversion_value_per_cost_p90_lower_bound, dan metrics.incremental_conversion_value_per_cost_p90_upper_bound) dengan delapan segmen irisan non-grup (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country, dan segments.country_localized_name). Mulai Google Ads API v27, memilih salah satu dari enam metrik rasio biaya ini dengan salah satu dari delapan segmen irisan non-grup tersebut akan menggagalkan validasi kueri dan menampilkan error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. Metrik nilai konversi non-biaya (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value*, dan metrics.relative_conversion_value_lift*) tetap didukung pada segmen kategori konversi, tindakan konversi, demografi, perangkat, dan negara setiap kali peningkatan nilai konversi dapat dilaporkan (terlepas dari apakah metrik utama studi adalah jumlah konversi atau nilai konversi).

Untuk mengevaluasi peningkatan di seluruh kategori konversi yang ditentukan dalam enum ConversionActionCategory (seperti PURCHASE, SIGNUP, atau SUBMIT_LEAD_FORM), segmentasikan hasil menurut segmen segments.conversion_lift_conversion_category:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Segmen segments.conversion_action menampilkan nama resource tindakan konversi dalam format customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. Pilih segmen segments.conversion_action_name pada resource lift_measurement_config untuk mengambil nama tindakan konversi yang dapat dibaca manusia tanpa mengkueri resource conversion_action secara terpisah. Kueri berikut menyegmentasikan metrik Conversion Lift menurut tindakan konversi, nama tindakan konversi, dan kategori konversi:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_action,
  segments.conversion_action_name,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Kueri berikut mengelompokkan metrik Conversion Lift menurut segmen segments.device. Ganti segmen segments.age_range atau segments.gender dalam permintaan terpisah untuk mengambil pengelompokan demografis (opsional digabungkan dengan kategori konversi atau segmen tindakan konversi):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.device,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Untuk mengelompokkan hasil berdasarkan geografi, sertakan segmen segments.country dan segments.country_localized_name (opsional digabungkan dengan segmen kategori konversi atau tindakan konversi). Segmen segments.country menampilkan nama resource konstanta target geografis global dalam format geoTargetConstants/CRITERION_ID (misalnya, geoTargetConstants/2840 untuk Amerika Serikat).

Kueri berikut menyegmentasikan metrik Conversion Lift menurut nama resource kriteria negara dan nama negara yang dilokalkan:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.country,
  segments.country_localized_name,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Pelaporan A/B + Conversion Lift

Di Google Ads API v25 dan yang lebih baru, studi A/B + Conversion Lift menggabungkan eksperimen dua grup (membandingkan strategi kontrol versus perlakuan) dengan pengukuran holdback di Google Ads API untuk menilai inkrementalitas masing-masing grup dan menghitung skor pemenang Bayesian. Tidak seperti pelaporan eksperimen langsung pada resource experiment, yang membandingkan metrik traffic grup versus grup yang belum disesuaikan, mengkueri resource lift_measurement_config dengan segmen segments.experiment_arm akan mengukur peningkatan inkremental setiap grup terhadap dasar pengukuran holdback yang tidak terekspos.

Menemukan eksperimen dan grup

Studi A/B + Conversion Lift menautkan resource LiftMeasurementConfig ke resource experiment dua grup melalui kolom experiment.lift_measurement_config hanya baca (OUTPUT_ONLY).

Untuk menemukan eksperimen tertaut dan grupnya dalam satu permintaan, buat kueri resource ExperimentArm dengan kolom experiment yang diatribusikan dan filter di kolom experiment.lift_measurement_config. Responsnya mencakup status kontrol setiap grup (experiment_arm.control), pemisahan traffic (experiment_arm.traffic_split), kampanye yang ditautkan (experiment_arm.campaigns), dan nama resource. Gunakan nilai experiment_arm.resource_name yang ditampilkan (diformat sebagai customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID) untuk memfilter segmen segments.experiment_arm:

SELECT
  experiment.experiment_id,
  experiment.name,
  experiment.lift_measurement_config,
  experiment_arm.resource_name,
  experiment_arm.name,
  experiment_arm.control,
  experiment_arm.traffic_split,
  experiment_arm.campaigns
FROM experiment_arm
WHERE experiment.lift_measurement_config =
  'customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID'

Ganti kode berikut:

  • CUSTOMER_ID: ID pelanggan 10 digit dari akun yang memiliki studi (tanpa tanda hubung).
  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.

Jika Anda memulai dari EXPERIMENT_ID yang diketahui (atau ingin mencantumkan semua eksperimen yang mengaktifkan peningkatan di akun), jalankan kueri experiment_arm yang sama yang difilter menurut WHERE experiment.experiment_id = EXPERIMENT_ID (atau WHERE experiment.lift_measurement_config IS NOT NULL).

Membuat kueri inkrementalitas per grup dan skor pemenang

Untuk mengukur inkrementalitas setiap grup dan mengevaluasi probabilitas statistik bahwa suatu grup adalah pemenang, sertakan segmen segments.experiment_arm dalam kueri Anda ke resource lift_measurement_config.

Metrik skor pemenang Bayesian berikut mengevaluasi probabilitas (dari 0.0 hingga 1.0, yang berjumlah 1.0 di kedua grup jika kedua grup memiliki peningkatan positif yang dapat dilaporkan) bahwa grup tertentu lebih unggul:

  • metrics.incremental_conversions_winner_score: Probabilitas bahwa grup ini adalah pemenang untuk konversi inkremental, yang dinormalisasi berdasarkan pemisahan traffic grup (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score: Probabilitas bahwa grup ini adalah pemenang untuk nilai konversi inkremental, yang dinormalisasi berdasarkan pemisahan traffic grup (experiment_arm.traffic_split). Di Google Ads API v27 dan yang lebih baru, diisi hanya jika metrik utama studi adalah nilai konversi, dan dihilangkan (tidak ditetapkan) pada studi utama jumlah konversi.
  • metrics.cost_per_incremental_conversion_winner_score: Probabilitas bahwa grup ini adalah pemenang untuk biaya per konversi inkremental (iCPA terendah), yang dinormalisasi berdasarkan pembelanjaan.
  • metrics.incremental_conversion_value_per_cost_winner_score: Probabilitas bahwa grup ini adalah pemenang untuk nilai konversi inkremental per biaya (iROAS tertinggi), yang dinormalisasi berdasarkan pembelanjaan. Di Google Ads API v27 dan yang lebih baru, hanya diisi jika metrik utama studi adalah nilai konversi, dan dihilangkan (tidak ditetapkan) pada studi utama jumlah konversi.

Kueri berikut mengambil inkrementalitas per grup dan skor pemenang Bayesian untuk kedua grup:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.cost_per_incremental_conversion,
  metrics.incremental_conversions_winner_score,
  metrics.cost_per_incremental_conversion_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score,
  metrics.incremental_conversion_value_per_cost_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Untuk memfilter satu grup, tambahkan AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' ke klausa WHERE, dengan EXPERIMENT_ID adalah ID eksperimen dan ARM_ID adalah ID grup yang ditampilkan di kolom experiment_arm.resource_name. Segmen segments.experiment_arm mendukung pemfilteran dalam klausa WHERE (=, !=, IN, NOT IN), tetapi Anda tidak dapat mengurutkannya dalam klausa ORDER BY.

Menafsirkan hasil A/B + Conversion Lift

Studi A/B + Conversion Lift mengevaluasi dua hipotesis secara bersamaan: keunggulan grup head-to-head (metrics.*_winner_score) dan peningkatan kausal terhadap grup kontrol yang tidak terekspos (metrics.incremental_* dan *_p_value). Meskipun periode studi ENABLED masih berlangsung (STUDY_IN_PROGRESS_*, saat tanggal saat ini di zona waktu pelanggan adalah pada atau sebelum lift_measurement_flight.end_date), perbandingan grup head-to-head dan pemodelan konversi grup kontrol masih distabilkan. Perlakukan metrik yang sedang berlangsung sebagai metrik awal dan hindari mempromosikan grup eksperimen atau mengalokasikan ulang anggaran hingga periode tayang selesai.

Pada studi yang telah selesai, grup eksperimen diklasifikasikan sebagai pemenang head-to-head jika memenuhi nilai minimum presisi (minimal 4 hari snapshot, 65 konversi dasar pengukuran tanpa skala, dan 150 konversi terekspos tanpa skala), memiliki 0 <= p_value <= 0.50, dan mencapai skor pemenang Bayesian lebih besar dari 0.55 (> 0.55) pada metrik utama studi. Evaluasi hipotesis ganda ini menghasilkan dua status pemenang yang berbeda (juga tercermin dalam lift_guidance.outcome di Google Ads API v27 dan yang lebih baru):

  • Pemenang yang jelas dengan peningkatan kausal (AB_WINNER_WITH_LIFT): Grup pemenang mengungguli grup pesaing secara langsung (winner_score > 0.55) dan menghasilkan konversi atau nilai konversi inkremental yang signifikan secara statistik dibandingkan dengan grup kontrol yang tidak terekspos. Promosikan atau skalakan strategi grup pemenang, dan buat kueri perincian dimensi untuk meninjau kelompok berperforma tinggi.
  • Pemenang head-to-head setara dengan grup holdback (AB_WINNER_PARITY_VS_CONTROL): Grup pemenang mengungguli grup pesaing secara head-to-head (winner_score > 0.55), tetapi tidak ada grup yang menghasilkan peningkatan inkremental yang signifikan secara statistik dibandingkan grup holdback yang tidak terekspos pada tingkat yang dikueri. Sebelum meningkatkan pembelanjaan pada grup pemenang, buat kueri konversi ALL (segments.conversion_lift_included_conversion_action_types = 'ALL') dan perincian segments.conversion_lift_conversion_category untuk memverifikasi apakah peningkatan kausal positif diisolasi di tempat lain.

Hasil POSITIVE_LIFT_DETECTED berlaku di seluruh perincian kueri A/B + Conversion Lift sebagai berikut:

  • Baris studi gabungan (OVERALL) (kueri tanpa segments.experiment_arm): Studi menghasilkan peningkatan positif dibandingkan grup kontrol yang tidak terekspos (p_value <= 0.50), dan tidak ada grup yang mencapai skor pemenang head-to-head yang lebih besar dari 0.55.
  • Baris per grup (segments.experiment_arm): Jika satu grup menang (winner_score > 0.55) dan kedua grup mencapai peningkatan positif dibandingkan grup kontrol, baris grup yang menang akan menampilkan AB_WINNER_WITH_LIFT, sedangkan baris grup yang tidak menang akan menampilkan POSITIVE_LIFT_DETECTED.
  • Baris pengelompokan kategori konversi (segments.conversion_lift_conversion_category): Baris peningkatan positif selalu menampilkan POSITIVE_LIFT_DETECTED karena skor pemenang tidak dievaluasi per kategori konversi.

Jika slice menampilkan NOT_ENOUGH_DATA atau NO_SIGNIFICANT_LIFT, jangan jeda grup atau kecualikan audiens berdasarkan ketidakcukupan sampel satu slice. Periksa metrik studi keseluruhan dan konversi ALL (segments.conversion_lift_included_conversion_action_types = 'ALL').

Membuat kueri hasil gabungan grup dan multi-studi

Jika Anda menghilangkan segmen segments.experiment_arm dari kueri pada resource lift_measurement_config, API akan menampilkan inkrementalitas tingkat studi yang digabungkan di kedua grup gabungan. Pada kueri grup gabungan, hapus empat metrik metrics.*_winner_score, yang hanya berlaku di seluruh grup yang bersaing dan dihapus (tidak ditetapkan) pada baris grup gabungan tanpa segments.experiment_arm. Gunakan kueri tingkat studi di Kueri conversion lift dan iCPA serta Kueri conversion value lift dan iROAS.

Saat Anda menyegmentasikan hasil A/B + Conversion Lift menurut segmen segments.experiment_arm, API hanya mendukung segmen segments.conversion_lift_conversion_category sebagai dimensi pengelompokan tambahan. Karena pembelanjaan grup tidak diatribusikan ke kategori konversi individual, evaluasi metrik peningkatan konversi dan nilai konversi (abaikan metrik iCPA dan iROAS, yang gagal dalam validasi kueri dengan error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE di Google Ads API v27 dan yang lebih baru) saat Anda menyertakan segmen segments.conversion_lift_conversion_category. Segmen segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name, dan segments.date tidak kompatibel dengan segmen segments.experiment_arm dan metrik metrics.*_winner_score. Memilih salah satu segmen yang tidak kompatibel ini bersama dengan segments.experiment_arm akan menampilkan error QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE (dan error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE jika kueri juga memilih metrik metrics.*_winner_score).

Untuk mengambil hasil beberapa konfigurasi studi dalam satu permintaan, filter dengan operator IN:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  segments.conversion_lift_conversion_category,
  metrics.incremental_conversions,
  metrics.incremental_conversions_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id IN (
    CONFIG_ID_1, CONFIG_ID_2)
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Ganti kode berikut:

  • CONFIG_ID_1: ID bilangan bulat dari konfigurasi pengukuran peningkatan pertama.
  • CONFIG_ID_2: ID bilangan bulat dari konfigurasi pengukuran peningkatan kedua.
  • START_DATE: tanggal mulai snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260501).
  • END_DATE: tanggal akhir snapshot sebagai bilangan bulat YYYYMMDD 8 digit tanpa tanda petik (misalnya, 20260515).

Kesetaraan tanggal persis (= START_DATE dan = END_DATE) hanya menampilkan baris untuk studi yang memiliki periode snapshot yang sama persis. Saat mengkueri studi dengan tanggal mulai penayangan atau tanggal snapshot terbaru yang dievaluasi yang berbeda, filter dengan operator rentang (>= dan <=) atau hapus filter tanggal dari klausa WHERE sambil mempertahankan segmen segments.conversion_lift_start_date dan segments.conversion_lift_end_date dalam klausa SELECT.

Pelaporan Search Lift

Untuk mengukur peningkatan volume kueri penelusuran organik yang didorong oleh kampanye iklan Anda di Google Ads API v26 dan yang lebih baru, buat kueri resource pelaporan Search Lift. Search Lift mengukur perbedaan perilaku penelusuran untuk merek atau produk Anda antara pengguna yang melihat iklan Anda dan grup kontrol yang tidak melihat iklan.

Referensi dan segmentasi Search Lift

Buat kueri resource SearchLiftKeywordBundle untuk mengambil detail tentang paket kata kunci yang dikonfigurasi untuk studi Search Lift. Resource SearchLiftKeywordBundle bersifat hanya baca di Google Ads API (semua kolom adalah OUTPUT_ONLY), dan paket kata kunci dikonfigurasi di UI Google Ads atau oleh perwakilan Google atau kontak GPS Anda. Kolom yang dapat dikueri di GAQL adalah resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource), dan status (SearchLiftKeywordBundleStatus) (kolom keywords berulang tidak dapat dipilih dalam kueri GAQL).

Buat kueri resource LiftMeasurementConfig untuk mengambil metrik Search Lift dan konfigurasi studi secara keseluruhan.

Di Google Ads API v27 dan yang lebih baru, Anda juga dapat memilih kolom lift_measurement_config.lift_guidance hanya baca (OUTPUT_ONLY) (lift_guidance.outcome dan lift_guidance.guidance_message, dari jenis LiftGuidance) dalam klausa SELECT GAQL di lift_measurement_config saat mengkueri metrik atau segmen Search Lift (segments.search_lift_keyword_bundle atau segments.search_property). Di lift_measurement_config, lift_guidance dihilangkan pada kueri konfigurasi khusus metadata, dan lift_guidance.guidance_message dapat berisi link Markdown inline (seperti [Learn more](https://support.google.com/...)). Untuk Search Lift, lift_guidance.outcome menampilkan STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (kepastian minimal 70%, p_value <= 0.30), NO_SIGNIFICANT_LIFT, atau NOT_ENOUGH_DATA (dievaluasi berdasarkan nilai minimum minimal 1.000.000 tayangan iklan secara keseluruhan atau 100.000 tayangan iklan slice, minimal 75 penelusuran yang diamati, dan minimal 17 dari 20 bucket cookie, dengan satu paket kata kunci yang kurang efektif menyebabkan hasil studi secara keseluruhan melaporkan NOT_ENOUGH_DATA).

Segmentasikan performa Search Lift di seluruh dimensi berikut:

  • segments.search_lift_keyword_bundle: Segmentasikan menurut nama resource paket kata kunci. Kompatibel dengan segments.search_property, segments.date, dan segmen demografis (segments.device, segments.age_range, dan segments.gender). Setiap paket kata kunci melaporkan biaya dan tayangan iklan kampanye lengkap, dan kata kunci dapat termasuk dalam lebih dari satu paket. Jangan menjumlahkan metrik metrics.search_lift_cost_micros, metrics.search_lift_impressions, atau Search Lift di seluruh paket kata kunci.
  • segments.search_property: Melakukan segmentasi menurut properti penelusuran tempat penelusuran terjadi, yang ditentukan oleh enum SearchLiftSearchProperty (seperti GOOGLE_SEARCH atau YOUTUBE). Segmen segments.search_property hanya kompatibel dengan segmen segments.search_lift_keyword_bundle dan segments.date. Menggabungkan segments.search_property dengan segmen demografis (segments.device, segments.age_range, atau segments.gender) akan menggagalkan validasi kueri. Karena segments.search_property mempartisi tempat terjadinya penelusuran organik berikutnya, bukan tempat iklan ditayangkan, baris yang disegmentasikan menurut segments.search_property mengulangi biaya dan tayangan iklan tingkat kampanye yang tidak dipartisi di Google Ads API v26. Mulai Google Ads API v27, kedelapan metrik pembelanjaan dan tayangan iklan (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost*, dan metrics.normalized_incremental_searches_per_impression*) tidak kompatibel dengan segments.search_property dan gagal dalam validasi kueri dengan error QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.
  • Segmen demografis dan tanggal: segments.device, segments.age_range, segments.gender, dan segments.date.

Metrik Search Lift

Resource LiftMeasurementConfig menyediakan metrik Search Lift untuk mengevaluasi perubahan perilaku penelusuran:

Metrik inkremental yang dinormalisasi berikut—bersama dengan batas keyakinan satu sisi 90% yang sesuai (*_p90_lower_bound dan *_p90_upper_bound)—dilaporkan saat peningkatan positif secara statistik:

Contoh kueri Search Lift

Kueri GAQL berikut menunjukkan cara mengambil paket kata kunci dan metrik performa Search Lift.

Kueri paket kata kunci

Untuk mengambil paket kata kunci yang dikonfigurasi untuk pengukuran Search Lift, buat kueri resource search_lift_keyword_bundle:

SELECT
  search_lift_keyword_bundle.resource_name,
  search_lift_keyword_bundle.search_lift_keyword_bundle_id,
  search_lift_keyword_bundle.source,
  search_lift_keyword_bundle.status
FROM search_lift_keyword_bundle

Kueri metrik

Nilai search_lift_keyword_bundle.resource_name yang diambil dalam kueri paket kata kunci sesuai dengan nilai yang ditampilkan dalam segmen segments.search_lift_keyword_bundle dalam kueri berikut. Untuk menemukan CONFIG_ID, kampanye tertaut, dan jadwal penayangan untuk studi Anda, ikuti Menemukan konfigurasi studi dan penayangan di resource lift_measurement_config dan lift_measurement_flight (memfilter penayangan menurut lift_measurement_flight.lift_type = 'SEARCH').

Kueri berikut mengambil metrik Search Lift yang disegmentasikan menurut paket kata kunci dan properti penelusuran (hilangkan segments.search_property saat memilih metrics.search_lift_cost_micros atau metrics.search_lift_impressions):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.search_lift_keyword_bundle,
  segments.search_property,
  metrics.relative_search_lift,
  metrics.relative_search_lift_p90_lower_bound,
  metrics.relative_search_lift_p90_upper_bound,
  metrics.incremental_searches_p_value,
  metrics.normalized_incremental_searches,
  metrics.normalized_incremental_searches_p90_lower_bound,
  metrics.normalized_incremental_searches_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Ganti kode berikut:

  • CONFIG_ID: ID bilangan bulat konfigurasi pengukuran peningkatan.