Artış raporlaması

Reklam kampanyalarınızın marka algısı, dönüşümler, dönüşüm değeri ve organik arama davranışı üzerindeki nedensel etkisini ölçmek için Google Ads API'deki artış ölçümü raporlama kaynaklarını sorgulayın:

  • Brand Lift raporları: Google Ads API 25 ve sonraki sürümlerde, reklam gösterim süresinin, ankete dayalı ölçüm türlerinde marka algısını nasıl etkilediğini değerlendirir.
  • Dönüşüm Artışı raporları: Google Ads API 25 ve sonraki sürümlerde, reklam gösterilmeyen bir kontrol grubuna göre artımlı dönüşümleri, dönüşüm değerini, artımlı dönüşüm başına maliyeti (artımlı EBM) ve reklam harcamalarından elde edilen artımlı geliri (artımlı ROAS) ölçer. Bu ölçümlere şunlar dahildir:
  • Arama Artışı raporlaması: Google Ads API 26 ve sonraki sürümlerde reklam gösterim süresine maruz kalmanın etkisiyle Google Arama ve YouTube'da organik arama sorgusu hacmindeki artışı ölçer.

experiment ve campaign kaynaklarıyla ilgili standart A/B denemesi raporları için Denemelerle ilgili rapor oluşturma başlıklı makaleyi inceleyin.

Brand Lift raporlaması

Reklam kampanyalarınızın Google Ads API 25 ve sonraki sürümlerde marka algısını nasıl etkilediğini değerlendirmek için özel Brand Lift ölçümü kaynaklarını sorgulayın.

Brand Lift kaynakları ve döküm görünümleri

Brand Lift yapılandırmaları, yayın aralıkları ve döküm görünümleri Google Ads API'de salt okunurdur (tüm alanlar OUTPUT_ONLY) ve Google Ads kullanıcı arayüzünde veya Google temsilciniz ya da GPS iletişim kişinizle yapılandırılır. Bu kaynakları, araştırmanın sahibi olan hesabın (yönetici veya alt hesap) customer_id parametresini kullanarak sorgulayın.

Yayın düzeyinde Brand Lift planlaması ve anket toplama meta verilerini almak için LiftMeasurementFlight kaynağını sorgulayın. Bu meta veriler arasında yayın durumu (lift_measurement_flight.status, etkin yayınlar için ENABLED ve manuel olarak durdurulan yayınlar için STOPPED değerlerini içeren LiftMeasurementFlightStatus enum ile tanımlanır), müşterinin saat dilimindeki yayın tarih aralıkları (lift_measurement_flight.start_date ve lift_measurement_flight.end_date) ve hedef anket yanıtı toplama ilerleme durumu (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, burada 0 %0'a ve 1000000 %100'e eşittir) yer alır. Bir ENABLED yayın süresinin devam edip etmediğini veya tamamlanıp tamamlanmadığını belirlemek için müşterinin saat dilimindeki geçerli tarihi lift_measurement_flight.start_date ve lift_measurement_flight.end_date ile karşılaştırın ve response_collection_ratio_micros değerinin 1000000 değerine ulaşıp ulaşmadığını kontrol edin.

Genel çalışma düzeyindeki Brand Lift metriklerini almak için LiftMeasurementConfig kaynağını sorgulayın veya Brand Lift metriklerini belirli boyutlara göre analiz etmek için aşağıdaki döküm kaynaklarını sorgulayın:

Brand Lift metriklerini, BrandLiftMeasurementType enum (ör. RECALL veya AWARENESS) tarafından tanımlanan anket soru türüne göre ayırmak için segments.brand_lift_measurement_type segmentini ekleyin. segments.brand_lift_measurement_type segmentini atlarsanız API, her dilim için otomatik olarak seçilen tek bir ölçüm türüne ait metrikleri döndürür. Brand Lift metriklerini tarihe göre (YYYY-MM-DD) dökümünü almak için segments.date segmentini ekleyin. metrics.cost_per_lifted_cookie metriği, çalışmanın sahibi olan hesabın para biriminin mikro birimi cinsinden döndürülür.

Google Ads API v27 ve sonraki sürümlerde, satır düzeyinde istatistiksel yorum almak için Google Ads Sorgu Dili (GAQL) SELECT yan tümcesinde salt okunur (OUTPUT_ONLY) lift_guidance alanını (lift_guidance.outcome ve lift_guidance.guidance_message, LiftGuidance türünde) lift_measurement_config ve beş Brand Lift döküm kaynağında (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender ve lift_measurement_video) seçebilirsiniz. lift_measurement_config tarihinde, lift_guidance yalnızca sorgu aynı zamanda Artış metriklerini veya segmentlerini seçtiğinde ya da filtrelediğinde doldurulur (yalnızca meta veri yapılandırma sorgularında atlanır) ve lift_guidance.guidance_message satır içi Markdown bağlantıları (ör. [Learn more](https://support.google.com/...)) içerebilir. WHERE veya ORDER BY yan tümcelerinde lift_guidance alt alanlarını filtreleyemez ya da sıralayamazsınız. lift_guidance.outcome içinde döndürülen LiftOutcomeEnum.LiftOutcome değerlerinin açıklamaları için Brand Lift sonuçlarını yorumlama başlıklı makaleyi inceleyin.

Raporlanabilirlik eşikleri ve boş yanıtlar

Brand Lift raporlaması, istatistiksel raporlanabilirlik ve gizlilik eşiklerini karşılamak için hem gecikme kontrollüdür (bir çalışma başladıktan sonra 24-48 saatlik bir ardışık düzen gecikmesi gerektirir) hem de ankete katılan ölçüm türü başına yanıt kontrollüdür (segments.brand_lift_measurement_type):

  • Olumlu yanıt oranları (metrics.brand_lift_baseline_positive_response_rate* ve metrics.brand_lift_exposed_positive_response_rate*): İlgili kolda (deney veya kontrol) en az 50 anket yanıtı.
  • Katı pozitif artış eşiği (LiftMeasurementConfig ile ilgili genel çalışma veya bağımsız dilim): En az 2.000 toplam yanıt ve kol başına 860 yanıt ile istatistiksel olarak pozitif artış (p_value <= 0.50).
  • Esnek dilim pozitif artış eşiği (genel çalışma pozitif artışla katı eşiği karşıladığında bir döküm kaynağında): En az 500 toplam yanıt ve kol başına 200 yanıtla istatistiksel olarak pozitif artış (p_value <= 0.50).
  • Pozitif olmayan artış eşiğini tamamlama (NO_SIGNIFICANT_LIFT ve NOT_ENOUGH_DATA): İstatistiksel olarak pozitif artış tespit edilmediğinde metrik başına en az 4.100 toplam yanıt.

LiftMeasurementConfig ve beş Brand Lift dökümü kaynağına (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign ve LiftMeasurementVideo) yönelik sorgular, aşağıdaki durumlarda hata yerine boş bir yanıt (results: []) döndürür:

  • Sorgulanan customer_id parametresi, izin verilenler listesinde değil veya çalışmanın sahibi değil.
  • WHERE tarih filtreleri, değerlendirilen yayın tarihlerinin (lift_measurement_flight.start_date ve lift_measurement_flight.end_date) dışında.
  • LiftMeasurementConfig genel araştırma sonuçlarını döndürse bile araştırma veya belirli demografi, cihaz, kampanya ya da video dilimi, 24-48 saatlik raporlama gecikmesi ve anket yanıtı hacmi eşiklerini karşılamamıştır.

Boş yanıtlarla ilgili sorunları gidermek için aşağıdaki adımları uygulayın:

  1. lift_measurement_flight sorgusunu çalıştırarak lift_measurement_flight.status = 'ENABLED' olduğunu doğrulayın, WHERE tarih filtrelerinizin lift_measurement_flight.start_date ve lift_measurement_flight.end_date arasında olduğundan emin olun ve lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros tablosunda anket ilerleme durumunu inceleyin (1000000 %100'e eşittir).
  2. Boyutsal döküm kaynaklarını sorgulamadan önce, çalışmanın tamamının raporlanabilir Brand Lift metrikleri oluşturup oluşturmadığını doğrulamak için LiftMeasurementConfig sorgusunu çalıştırın.

Brand Lift sonuçlarını yorumlama

Google Ads API v27 ve sonraki sürümlerde lift_guidance.outcome alanı, döndürülen her satırın istatistiksel durumunu sınıflandıran bir LiftOutcomeEnum.LiftOutcome değeri ve lift_guidance.guidance_message içinde okunabilir düzeltme önerileri döndürür:

  • Devam eden çalışma sonuçları (lift_measurement_flight.status, ENABLED olduğunda ve müşterinin saat dilimindeki geçerli tarih, lift_measurement_flight.end_date tarihinde veya öncesinde olduğunda ve lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, 1000000 değerinden az olduğunda):
    • STUDY_IN_PROGRESS_WITH_LIFT: Çalışma devam ediyor ve ilk olumlu artış ortaya çıkıyor.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: Çalışma, yeterli başlangıç hacmiyle devam ediyor ve henüz istatistiksel olarak önemli bir artış tespit edilmedi.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: Çalışma devam ediyor ve istatistiksel raporlama eşiklerine yönelik ilk anket yanıtlarını aktif olarak topluyor.
  • Tamamlanan çalışma sonuçları (lift_measurement_flight.end_date geçtiğinde veya lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, 1000000 değerine ulaştığında):
    • POSITIVE_LIFT_DETECTED: Tamamlanan çalışma veya dilim için istatistiksel olarak önemli bir pozitif artış tespit edildi.
    • NO_SIGNIFICANT_LIFT: Tamamlanan çalışma veya dilim, istatistiksel kesinlik eşiklerini (metrik başına en az 4.100 toplam yanıt) karşıladı ve istatistiksel olarak önemli bir pozitif artış tespit edilmedi.
    • NOT_ENOUGH_DATA: Tamamlanan çalışma veya dilim, istatistiksel raporlanabilirlik için gereken anket yanıtı eşiklerini karşılamadı (çalışmanın tamamında pozitif artış için toplamda en az 2.000 ve kol başına 860 yanıt, çalışmanın tamamında pozitif artış olduğunda bir dilimde pozitif artış için toplamda 500 ve kol başına 200 yanıt veya pozitif artış tespit edilmediğinde metrik başına toplamda 4.100 yanıt).

Brand Lift sonuçlarını yorumlarken aşağıdaki yönergeleri uygulayın:

  • Devam eden ve tamamlanan aralıklar (STUDY_IN_PROGRESS_*): Bir ENABLED çalışmasının aralığı devam ederken (lift_measurement_flight.end_date geçmeden ve response_collection_ratio_micros, 1000000 değerine ulaşmadan önce) anket yanıtları ve sapma düzeltmeli modelleme hâlâ kararlı hâle gelmeye devam eder. Devam eden metrikleri ön metrikler olarak değerlendirin ve yayın tamamlanana kadar kampanyaları duraklatmaktan veya bütçeleri azaltmaktan kaçının.
  • Pozitif artış (POSITIVE_LIFT_DETECTED): Pozitif Brand Lift algılandığında, yüksek performans gösteren kitle gruplarını ("parlak noktalar") belirlemek ve marka dönüşüm hunisi genelinde reklam öğesi yankısını değerlendirmek için boyut dökümü kaynaklarını (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign ve LiftMeasurementVideo) sorgulayın.
  • Yetersiz veri veya önemli bir artış yok (NOT_ENOUGH_DATA ya da NO_SIGNIFICANT_LIFT): Anket yanıtı hacmi yetersiz olduğunda (olumlu artış olmadan metrik başına toplam 4.100'den az yanıt veya olumlu artış için 2.000/860 katı ya da 500/200 esnek dilim eşiklerinden daha az yanıt) veya bir dilimde istatistiksel olarak önemli bir artış algılanmadığında, bunu kampanya başarısızlığı olarak değerlendirmeyin veya tek dilimli örnek yetersizliğine dayalı olarak kitleleri hariç tutmayın. LiftMeasurementConfig ile ilgili genel çalışma metriklerini kontrol edin, ankete dahil edilen diğer segments.brand_lift_measurement_type değerlerini (ör. dönüşüm hunisinin üst kısmı RECALL veya AWARENESS) sorgulayın ve kalan döküm boyutlarını kontrol edin.

Örnek Brand Lift sorguları

Uçuş meta verileri ve artış istatistikleri ayrı kaynaklarda bulunduğundan uçuş ayrıntılarını ve performans istatistiklerini sorgulamak için ayrı GAQL sorguları gerekir.

Uçuş ayrıntıları sorgusu

Durumu, ölçüm türü, planlanan tarihler ve anket toplama ilerleme durumu gibi bir Brand Lift uçuşunun meta verilerini almak için LiftMeasurementFlight kaynağını sorgulayın:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği (lift_measurement_config.lift_measurement_config_id).

İstatistik sorgusu

Brand Lift metriklerini almak için LiftMeasurementConfig kaynağını veya uygun döküm kaynağını sorgulayın. Örneğin, aşağıdaki sorgu, LiftMeasurementCampaign kaynağından kampanya ve Brand Lift ölçüm türüne göre segmentlere ayrılmış Brand Lift metriklerini alır:

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

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.

Dönüşüm Artışı raporları

Google Ads API v25 ve sonraki sürümlerde Dönüşüm Artışı raporlaması, reklamlarınızın dönüşümler ve dönüşüm değeri üzerindeki artımlı etkisini ölçer. Dönüşüm Artışı çalışmaları, reklam gösterilen grup (reklamlarınızı görmeye uygun olan kullanıcılar) ile reklam gösterilmeyen kontrol grubunun (reklamlarınızı görmesi engellenen kullanıcılar) dönüşüm davranışlarını karşılaştırır.

Dönüşüm Artışı yapılandırmaları, yayın aralıkları ve deneme bağlantıları Google Ads API'de salt okunurdur (tüm alanlar OUTPUT_ONLY) ve Google Ads kullanıcı arayüzünde veya Google temsilciniz ya da GPS iletişim kişinizle yapılandırılır. Çalışmanın sahibi olan hesabın customer_id parametresini kullanarak lift_measurement_config kaynağını sorgulayın. Yönetici hesabı, sahip olduğu hesaplar arası Dönüşüm Artışı çalışmalarını doğrudan sorgulayabilir. Çocuk hesabının customer_id parametresini kullanarak çocuk hesabına ait sorgu çalışmalarını yapın (isteğe bağlı olarak login-customer-id başlığıyla kimlik doğrulaması yapılır).

Dönüşüm Artışı raporlaması, aynı çalışma ve yayın aralığı keşfi, kümülatif anlık görüntü tarih aralıkları ve dönüşüm işlemi kapsamlarını paylaşan iki çalışma iş akışını destekler:

  • Bağımsız Dönüşüm Artışı raporlaması: Çalışmada ölçülen kampanyalardaki seçili dönüşüm işlemleri veya tüm dönüşüm işlemleri genelinde toplam artışı, artımlı dönüşüm başına maliyeti (artımlı EBM) ve reklam harcamalarından elde edilen artımlı geliri (artımlı ROAS) ölçer.
  • A/B + Dönüşüm Artışı raporlaması: İki rakip deneme kolu (kontrol ve deneme) arasındaki kol başına artımlılığı ve Bayesçi kazanan puanlarını, genel çalışma artımlılığıyla birlikte ölçer.

lift_measurement_config kaynağı için geçerli sorgular oluşturma konusunda yardım almak üzere Google Ads Sorgu Oluşturucu aracını kullanın.

Google Ads API 27 ve sonraki sürümlerde, bağımsız Dönüşüm Artışı ve A/B + Dönüşüm Artışı sorguları için satır düzeyinde istatistiksel yorum almak üzere lift_measurement_config üzerinde GAQL SELECT ifadesinde salt okunur (OUTPUT_ONLY) lift_measurement_config.lift_guidance alanını (lift_guidance.outcome ve lift_guidance.guidance_message, LiftGuidance türünde) seçebilirsiniz. lift_measurement_config üzerinde lift_guidance, yalnızca sorgu aynı zamanda Artış metriklerini veya segmentlerini seçtiğinde ya da filtrelediğinde doldurulur (yalnızca meta veri yapılandırma sorgularında atlanır) ve lift_guidance.guidance_message, satır içi Markdown bağlantıları (ör. [Learn more](https://support.google.com/...)) içerebilir. WHERE veya ORDER BY yan tümcelerinde lift_guidance alt alanlarını filtreleyemez ya da sıralayamazsınız. lift_guidance.outcome alanı, aşağıdaki LiftOutcomeEnum.LiftOutcome değerlerinden birini döndürür:

  • Devam eden çalışma sonuçları (lift_measurement_flight.status, ENABLED olduğunda ve müşterinin saat dilimindeki geçerli tarih lift_measurement_flight.end_date veya daha öncesi olduğunda):
    • STUDY_IN_PROGRESS_WITH_LIFT: Çalışma devam ediyor ve ilk olumlu artış ortaya çıkıyor.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: Çalışma, yeterli başlangıç hacmiyle devam ediyor ve henüz istatistiksel olarak önemli bir artış tespit edilmedi.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: Çalışma devam ediyor ve istatistiksel raporlama eşiklerine yönelik ilk dönüşüm verilerini aktif olarak topluyor.
  • Tamamlanan çalışma sonuçları (lift_measurement_flight.end_date geçtikten sonra):
    • POSITIVE_LIFT_DETECTED: Tamamlanan çalışma, deneme kolu veya dilim için istatistiksel olarak önemli bir pozitif artış tespit edildi.
    • AB_WINNER_WITH_LIFT: Kazanan deneme kolunun başa baş olduğu ve reklam gösterilmeyen kontrol grubuna kıyasla istatistiksel olarak önemli bir pozitif artışın elde edildiği bir A/B + Dönüşüm Artışı araştırması tamamlandı.
    • AB_WINNER_PARITY_VS_CONTROL: Bir A/B + Dönüşüm Artışı araştırması, kazanan bir deneme koluyla başa baş tamamlandı ancak reklam gösterilmeyen kontrol grubuyla eşit düzeyde.
    • NO_SIGNIFICANT_LIFT: Tamamlanan çalışma, deneme kolu veya dilim, istatistiksel kesinlik eşiklerini karşıladı ve istatistiksel olarak anlamlı bir pozitif artış tespit edilmedi.
    • NOT_ENOUGH_DATA: Tamamlanan çalışma, deneme kolu veya dilim, istatistiksel kesinlik eşiklerine ulaşmak için yeterli dönüşüm elde etmedi.

Çalışma yapılandırmalarını ve uçuşları keşfetme

Dönüşüm Artışı çalışması hakkında rapor oluşturmak için önce çalışma yapılandırmasını ve yayın planını öğrenin:

  1. Çalışma yapılandırmasını alma: Çalışmanın adını, ayırma oranını (lift_measurement_config.conversion_lift_holdback_ratio_micros), izlenen dönüşüm işlemlerini (lift_measurement_config.conversion_actions) ve Google Ads API v26 ve sonraki sürümlerde etkin şekilde bağlı kampanyaları (lift_measurement_config.campaigns) almak için LiftMeasurementConfig kaynağını sorgulayın. conversion_lift_holdback_ratio_micros alanı, 1,000,000 değerinin %100'e eşit olduğu mikro cinsinden ifade edilir (örneğin, 300000 %30'luk bir reklam gösterilmeyen ayırma grubunu temsil eder). Çalışmanın CONFIG_ID değerini bilmiyorsanız hesaptaki tüm çalışma yapılandırmalarını listelemek için WHERE ifadesini çıkarın.
  2. Uçuş gözlem aralıklarını alma: Müşterinin saat diliminde planlanan uçuş tarihlerini (lift_measurement_flight.start_date ve lift_measurement_flight.end_date) bulmak için LiftMeasurementFlight kaynağını sorgulayın. Tek bir LiftMeasurementConfig kaynağı Brand Lift (SURVEY), Dönüşüm Artışı (CONVERSION) ve Arama Artışı (SEARCH) aralıklarını gruplandırabildiğinden SELECT ifadesine lift_measurement_flight.lift_type alanını ekleyin ve WHERE ifadesinde lift_measurement_flight.lift_type = 'CONVERSION' değerine göre filtreleyin. lift_measurement_flight.start_date ve lift_measurement_flight.end_date alanları ORDER BY yan tümcelerinde sıralanabilir ancak bunları WHERE yan tümcesinde filtreleyemezsiniz.

Aşağıdaki sorgu, çalışma yapılandırmasını alır (Google Ads API 25 sürümünde lift_measurement_config.campaigns alanını atlayın. Bu alan için Google Ads API 26 ve sonraki sürümler gerekir):

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

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği (lift_measurement_config.lift_measurement_config_id).

Aşağıdaki sorgu, çalışma için Dönüşüm Artışı yayın planını alır:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği (lift_measurement_config.lift_measurement_config_id).

Google Ads API 26 ve sonraki sürümlerde, campaign.lift_measurement_config alanını sorgulayarak bir kampanyaya bağlı artış ölçümü yapılandırmasını doğrudan campaign kaynağından da keşfedebilirsiniz. Bu alanı sorgulamak, LiftMeasurementConfig kaynağına ayrı olarak çapraz referans verme ihtiyacını ortadan kaldırır:

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

Aşağıdakini değiştirin:

  • CAMPAIGN_ID: Kampanyanın tam sayı kimliği (campaign.id).

campaign.lift_measurement_config alanı, customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID biçiminde bir kaynak adı döndürür. Bir kampanya birden fazla artış çalışmasına katıldıysa bu alan, en son bağlanan yapılandırmayı (etkin veya etkin değil) tanımlar. Buna karşılık, lift_measurement_config.campaigns alanı yalnızca etkin olarak bağlı kampanyaları listeler.

Kümülatif anlık görüntü tarih aralıklarını sorgulama

Dönüşüm Artışı sonuçları, yayının başlangıç tarihinden itibaren günlük kümülatif değerlendirme anlık görüntüleri olarak yapılandırılır:

Hem segments.conversion_lift_start_date hem de segments.conversion_lift_end_date, YYYYMMDD biçiminde (ör. 20260501) tırnak işareti ve kısa çizgi içermeyen 8 haneli tam sayılar olarak biçimlendirilmiş INT64 alanlarıdır. Buna karşılık lift_measurement_flight.start_date ve lift_measurement_flight.end_date alanları, ISO 8601 YYYY-MM-DD biçiminde (ör. 2026-05-01) tarih dizeleri döndürür. Brand Lift ve Arama Artışı sorgularından farklı olarak segments.date segmenti, tüm Dönüşüm Artışı metrikleri ve segmentleriyle uyumsuzdur. SELECT ifadesinde Dönüşüm Artışı segmentleriyle (ör. segments.conversion_lift_start_date) birlikte segments.date segmentinin seçilmesi QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatasına, segments.date ile Dönüşüm Artışı metriklerinin birleştirilmesi ise QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE hatasına neden olur.

Hesaplanan en yeni anlık görüntü, veri işlenirken etkin bir yayının bitiş tarihinin gerisinde kalabilir. En son değerlendirilen anlık görüntüyü belirlemek için her zaman segments.conversion_lift_end_date DESC ölçütüne göre sıralanmış kullanılabilir (segments.conversion_lift_start_date, segments.conversion_lift_end_date) çiftleri için lift_measurement_config kaynağını sorgulayın.

Aşağıdaki sorgu, bir çalışmanın kullanılabilir anlık görüntü tarih aralıklarını alır:

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

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.

Dönüşüm işlemi kapsamına göre filtreleme

Dönüşüm Artışı, segments.conversion_lift_included_conversion_action_types segmenti tarafından tanımlanan iki kapsamda artımlılığı değerlendirir:

  • SELECTED: Çalışma oluşturulurken seçilen dönüşüm işlemleri veya özel dönüşüm işlemleri belirtilmemişse teklif verilebilir tüm (birincil) dönüşüm işlemleri.
  • ALL: Çalışmada ölçülen kampanyalardaki tüm dönüşüm işlemleri.

segments.conversion_lift_included_conversion_action_types segmentine göre filtreleme yapmadan dönüşüm artışı metrikleri için lift_measurement_config kaynağını sorguladığınızda API, her dilim için biri ALL, diğeri SELECTED olmak üzere iki satır döndürür. GAQL'de, WHERE ifadesinde filtrelenen tarih dışındaki tüm segment alanları (ve tüm Dönüşüm Artışı anlık görüntü tarih segmentleri) SELECT ifadesinde de görünmelidir. Aksi takdirde API, QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE hatası döndürür. WHERE yan tümcesinde segments.conversion_lift_included_conversion_action_types = 'SELECTED' ölçütüne göre filtreleme yaparken bu segmenti SELECT yan tümcesine ekleyin.

Bağımsız Dönüşüm Artışı raporlaması

Bağımsız Dönüşüm Artışı çalışmaları, kampanyaları rakip deney kollarına ayırmadan, reklamlarınızın reklam gösterilmeyen bir kontrol grubuna kıyasla artımlı etkisini ölçer.

Sorgu dönüşüm artışı ve iEBM

Dönüşüm Artışı, %90 tek taraflı güven sınırları (birlikte %80 iki taraflı güven aralığı oluşturan *_p90_lower_bound ve *_p90_upper_bound) ve p değerleri (p_value <= 0.10, %90 tek taraflı istatistiksel olarak önemli olmaya karşılık gelir) ile birlikte nokta tahminlerini raporlar:

API, aşağıdaki durumlarda döndürülen satırlardaki Dönüşüm Artışı metriklerini atlar:

  • Dahil edilen anlık görüntü aralığı 4 günden azsa
  • Ölçeklendirilmemiş gözlemlenen dönüşüm hacmi, minimum kesinlik eşiklerinin altında (ölçeklendirmeden önce değerlendirilen, reklam gösterilmeyen grupta 65'ten az gözlemlenen referans dönüşüm veya 150'den az gözlemlenen reklam gösterilen dönüşüm metrics.conversion_lift_baseline_conversions).
  • Ölçülen artış pozitif değil (dönüşüm metrikleri için metrics.incremental_conversions_p_value > 0.5 veya dönüşüm değeri metrikleri için metrics.incremental_conversion_value_p_value > 0.5).
  • Google Ads API 27 ve sonraki sürümlerde, iROAS metrikleri (metrics.incremental_conversion_value_per_cost*) ve dönüşüm değeri kazanan puanı metrikleri (metrics.incremental_conversion_value_winner_score ve metrics.incremental_conversion_value_per_cost_winner_score), kurulum sırasında birincil metrik olarak dönüşüm değeri yerine dönüşüm sayısı ile yapılandırılmış bir çalışmada sorgulanır. Maliyet dışı dönüşüm değeri metrikleri (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* ve metrics.relative_conversion_value_lift*), dönüşüm değeri artışı raporlanabilir olduğunda dönüşüm sayısı birincil araştırmalarında doldurulmuş olarak kalır.
  • SELECT ifadesinden lift_measurement_config.lift_measurement_config_id, segments.conversion_lift_start_date, segments.conversion_lift_end_date veya segments.conversion_lift_included_conversion_action_types alanlarını çıkardığınız için birden fazla satır ya da çalışma birleştirildi.

Bağımsız Dönüşüm Artışı sonuçlarını yorumlarken aşağıdaki yönergeleri uygulayın:

  • Devam eden ve tamamlanan yayınlar (STUDY_IN_PROGRESS_*): Bir ENABLED çalışmasının yayını devam ederken (müşterinin saat dilimindeki geçerli tarih lift_measurement_flight.end_date veya daha öncesiyken) kontrol ve deney dönüşüm modelleme ve gecikmeli dönüşüm ilişkilendirme hâlâ kararlı hale gelmeye devam eder. Devam eden metrikleri ön metrikler olarak değerlendirin ve yayın tamamlanana kadar kampanyaları duraklatmaktan veya bütçeleri azaltmaktan kaçının.
  • Pozitif artış (POSITIVE_LIFT_DETECTED): Ölçülen artış pozitif olduğunda (p_value <= 0.50, pozitif nokta tahminiyle en az %50 kesinliğe karşılık gelir, p_value <= 0.10 ise *_p90_lower_bound >= 0 olduğunda %90 tek taraflı istatistiksel olarak önemli olduğunu gösterir) ve minimum kesinlik eşikleri (en az 4 anlık görüntü günü, en az 65 ölçeklendirilmemiş referans dönüşüm ve en az 150 ölçeklendirilmemiş reklam gösterilen dönüşüm) karşılandığında Dönüşüm Artışı metriği raporlanabilirliği ve lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED' tetiklenir. Pozitif artış tespit edildiğinde, yüksek performans gösteren grupları ("parlak noktalar") belirlemek için boyutsal dökümleri (demografi, cihaz, ülke veya dönüşüm kategorisi ve dönüşüm işlemi) sorgulayın.
  • Yetersiz veri veya önemli bir artış yok (NOT_ENOUGH_DATA ya da NO_SIGNIFICANT_LIFT): Veri hacmi yetersiz olduğunda (ölçeklendirilmemiş referans dönüşüm sayısı 65'ten az veya ölçeklendirilmemiş reklam gösterilen dönüşüm sayısı 150'den az) ya da bir dilimde istatistiksel olarak önemli bir artış algılanmadığında bunu kampanyanın başarısız olduğu şeklinde yorumlamayın veya tek dilimli örnek yetersizliğine dayanarak kitleleri hariç tutmayın. Pozitif artışın başka bir yerde izole edilip edilmediğini doğrulamak için genel çalışma metriklerini ve sorguyu segments.conversion_lift_included_conversion_action_types = 'ALL' (SELECTED artış göstermiyorsa) veya kalan boyutsal dökümleri kontrol edin.

Aşağıdaki sorgu, genel dönüşüm artımlılığını, güven sınırlarını ve artımlı EBM'yi alır:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

Sorgu dönüşüm değeri artışı ve artımlı ROAS

Reklam harcamanızın sağladığı artımlı geliri değerlendirmek için dönüşüm değeri metriklerini ve metrics.incremental_conversion_value_per_cost metriğini sorgulayın. Maliyet dışı dönüşüm değeri metrikleri (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* ve metrics.relative_conversion_value_lift*), çalışmanın birincil metriğinin dönüşüm sayısı veya dönüşüm değeri olup olmadığına bakılmaksızın, çalışmada raporlanabilir dönüşüm değeri artışı olduğunda doldurulur. Google Ads API v27 ve sonraki sürümlerde, iROAS metrikleri (metrics.incremental_conversion_value_per_cost*) ile birlikte metrics.incremental_conversion_value_winner_score ve metrics.incremental_conversion_value_per_cost_winner_score, yalnızca çalışma kurulum sırasında birincil metrik olarak dönüşüm değeri ile yapılandırıldığında döndürülür (ve dönüşüm sayısı birincil çalışmalarda atlanır):

Aşağıdaki sorgu, dönüşüm değeri artımlılığını, güven sınırlarını ve artımlı ROAS'ı alır:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

Sonuçları boyuta göre segmentlere ayırma

Artımlı dönüşüm metriklerini dönüşüm kategorisi, dönüşüm işlemi, demografi, cihaz veya coğrafi konuma göre segmentlere ayırın. lift_measurement_config kaynağını sorgularken yalnızca uyumlu segment kombinasyonlarını seçin:

SELECT yan tümcesinde birbiriyle uyumlu olmayan segmentlerin seçilmesi, sorgu doğrulamasının başarısız olmasına ve QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatasının döndürülmesine neden olur. Segment kombinasyonlarını etkileşimli olarak doğrulamak için Google Ads Sorgu Oluşturucu'yu kullanın.

Maliyet verimliliği metriklerini (metrics.cost_per_incremental_conversion* ve metrics.incremental_conversion_value_per_cost*) yalnızca genel çalışma satırlarında veya segments.experiment_arm satırlarında değerlendirin. Google Ads API v25 ve v26'da şema, sekiz adet ARM olmayan dilim segmentiyle (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country ve segments.country_localized_name) altı maliyet oranı metriğinin (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 ve metrics.incremental_conversion_value_per_cost_p90_upper_bound) seçilmesine izin verir. Google Ads API v27'den itibaren, bu altı maliyet oranı metriğinden herhangi birinin bu sekiz ARM olmayan dilim segmentinden herhangi biriyle seçilmesi, sorgu doğrulamasının başarısız olmasına ve QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE hatası döndürülmesine neden olur. Maliyet dışı dönüşüm değeri metrikleri (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* ve metrics.relative_conversion_value_lift*), dönüşüm değeri artışının raporlanabilir olduğu her durumda (araştırmanın birincil metriğinin dönüşüm sayısı veya dönüşüm değeri olup olmadığına bakılmaksızın) dönüşüm kategorisi, dönüşüm işlemi, demografi, cihaz ve ülke segmentlerinde desteklenmeye devam eder.

ConversionActionCategory enum'da tanımlanan dönüşüm kategorilerindeki (ör. PURCHASE, SIGNUP veya SUBMIT_LEAD_FORM) artışı değerlendirmek için sonuçları segments.conversion_lift_conversion_category segmentine göre segmentlere ayırın:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

segments.conversion_action segmenti, dönüşüm işlemi kaynak adını customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID biçiminde döndürür. conversion_action kaynağını ayrı olarak sorgulamadan, kullanıcıların okuyabileceği dönüşüm işlemi adlarını almak için lift_measurement_config kaynağındaki segments.conversion_action_name segmentini seçin. Aşağıdaki sorgu, Dönüşüm Artışı metriklerini dönüşüm işlemine, dönüşüm işlemi adına ve dönüşüm kategorisine göre segmentlere ayırır:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

Aşağıdaki sorgu, Dönüşüm Artışı metriklerini segments.device segmentine göre segmentlere ayırır. Demografik dökümleri almak için ayrı isteklerde segments.age_range veya segments.gender segmentini değiştirin (isteğe bağlı olarak dönüşüm kategorisi veya dönüşüm işlemi segmentleriyle birleştirilir):

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

Sonuçları coğrafi konuma göre dökümünü almak için segments.country ve segments.country_localized_name segmentlerini ekleyin (isteğe bağlı olarak dönüşüm kategorisi veya dönüşüm işlemi segmentleriyle birleştirilir). segments.country segmenti, geoTargetConstants/CRITERION_ID biçiminde global bir coğrafi hedef sabit kaynak adı döndürür (ör. ABD için geoTargetConstants/2840).

Aşağıdaki sorgu, Dönüşüm Artışı metriklerini ülke ölçütü kaynak adına ve yerelleştirilmiş ülke adına göre segmentlere ayırır:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

A/B + Dönüşüm Artışı raporlaması

Google Ads API v25 ve sonraki sürümlerde, A/B + Dönüşüm Artışı çalışmaları, Google Ads API'de iki kollu bir denemeyi (kontrol ve tedavi stratejilerini karşılaştıran) ayırma ölçümüyle birleştirerek her bir kolun artımlılığını değerlendirir ve Bayesçi kazanan puanlarını hesaplar. experiment kaynağında, düzeltilmemiş kol-kol trafik metriklerini karşılaştıran doğrudan deneme raporlamasının aksine, lift_measurement_config kaynağını segments.experiment_arm segmentiyle sorgulamak, her kolun artımlı artışını, reklam gösterilmeyen bir kontrol grubu referans değerine göre ölçer.

Denemeleri ve kolları keşfetme

A/B + Dönüşüm Artışı araştırması, salt okunur (OUTPUT_ONLY) experiment.lift_measurement_config alanı aracılığıyla bir LiftMeasurementConfig kaynağını iki kollu bir experiment kaynağına bağlar.

Bağlı denemeyi ve kollarını tek bir istekte keşfetmek için ilişkilendirilmiş experiment alanlarıyla ExperimentArm kaynağını sorgulayın ve experiment.lift_measurement_config alanını filtreleyin. Yanıtta her kolun kontrol durumu (experiment_arm.control), trafik bölme (experiment_arm.traffic_split), bağlı kampanyalar (experiment_arm.campaigns) ve kaynak adı yer alır. segments.experiment_arm segmentinde filtreleme yapmak için döndürülen experiment_arm.resource_name değerini (customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID olarak biçimlendirilmiş) kullanın:

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'

Aşağıdakini değiştirin:

  • CUSTOMER_ID: Araştırmanın sahibi olan hesabın 10 haneli müşteri kimliği (kısa çizgi olmadan).
  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.

Bilinen bir EXPERIMENT_ID ile başlarsanız (veya hesaptaki artış özellikli tüm denemeleri listelemek isterseniz) WHERE experiment.experiment_id = EXPERIMENT_ID (veya WHERE experiment.lift_measurement_config IS NOT NULL) ile filtrelenmiş aynı experiment_arm sorgusunu çalıştırın.

Kol başına artımlılık ve kazanan puanlarını sorgulama

Her bir kolun artımlılığını ölçmek ve bir kolun kazanan olma istatistiksel olasılığını değerlendirmek için lift_measurement_config kaynağına yönelik sorgunuza segments.experiment_arm segmentini ekleyin.

Aşağıdaki Bayes kazanan puanı metrikleri, belirli bir kolun üstün olma olasılığını (0.0 ile 1.0 arasında, her iki kolda da raporlanabilir pozitif artış olduğunda her iki kolda toplam 1.0) değerlendirir:

  • metrics.incremental_conversions_winner_score: Bu kolun, kol trafiği bölme (experiment_arm.traffic_split) ile normalleştirilmiş artımlı dönüşümler için kazanan olma olasılığı.
  • metrics.incremental_conversion_value_winner_score: Bu kolun, kol trafiği bölme (experiment_arm.traffic_split) ile normalleştirilmiş artımlı dönüşüm değeri için kazanan olma olasılığı. Google Ads API v27 ve sonraki sürümlerde, yalnızca çalışmanın birincil metriği dönüşüm değeri olduğunda doldurulur ve dönüşüm sayısı birincil çalışmalarında atlanır (ayarlanmadan bırakılır).
  • metrics.cost_per_incremental_conversion_winner_score: Bu kolun, harcamaya göre normalleştirilmiş artımlı dönüşüm başına maliyet (en düşük artımlı EBM) açısından kazanan olma olasılığı.
  • metrics.incremental_conversion_value_per_cost_winner_score: Bu kolun, harcamaya göre normalleştirilmiş maliyet başına artımlı dönüşüm değeri (en yüksek iROAS) açısından kazanan olma olasılığı. Google Ads API v27 ve sonraki sürümlerde, yalnızca çalışmanın birincil metriği dönüşüm değeri olduğunda doldurulur ve dönüşüm sayısı birincil olan çalışmalarda atlanır (ayarlanmadan bırakılır).

Aşağıdaki sorgu, her iki kol için de kol başına artımlılık ve Bayes kazanan puanlarını alır:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

Tek bir kolu filtrelemek için WHERE ifadesine AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' ekleyin. Burada EXPERIMENT_ID, deneme kimliği ve ARM_ID, experiment_arm.resource_name alanında döndürülen kol kimliğidir. segments.experiment_arm segmenti, WHERE yan tümcelerinde (=, !=, IN, NOT IN) filtrelemeyi destekler ancak ORDER BY yan tümcesinde sıralama yapamazsınız.

A/B + Dönüşüm Artışı sonuçlarını yorumlama

A/B + Dönüşüm Artışı araştırması, iki hipotezi aynı anda değerlendirir: başa baş kol üstünlüğü (metrics.*_winner_score) ve reklam gösterilmeyen kontrol grubuna (metrics.incremental_* ve *_p_value) karşı nedensel artış. ENABLED araştırma yayını devam ederken (STUDY_IN_PROGRESS_*, müşterinin saat dilimindeki geçerli tarih lift_measurement_flight.end_date veya daha öncesi olduğunda), başa baş kol karşılaştırması ve kontrol grubu dönüşüm modellemesi hâlâ kararlı hale gelmektedir. Devam eden metrikleri ön metrikler olarak değerlendirin ve yayın tamamlanana kadar bir deneme kolunu yükseltmekten veya bütçeleri yeniden tahsis etmekten kaçının.

Tamamlanan çalışmalarda bir deneme kolu, minimum kesinlik eşiklerini (en az 4 anlık görüntü günü, 65 ölçeklendirilmemiş referans dönüşüm ve 150 ölçeklendirilmemiş reklam gösterilen dönüşüm) karşıladığında, 0 <= p_value <= 0.50 olduğunda ve çalışmanın birincil metriğinde 0.55 değerinden büyük (> 0.55) bir Bayesçi kazanan puanı elde ettiğinde başa baş kazanan olarak sınıflandırılır. Bu çift hipotezli değerlendirme, iki farklı kazanan durumu üretir (bu durumlar Google Ads API 27 sürümü ve sonraki sürümlerde lift_guidance.outcome alanına da yansıtılır):

  • Nedensel artışla net kazanan (AB_WINNER_WITH_LIFT): Kazanan kol, rakip koldan daha iyi performans gösterir (winner_score > 0.55) ve reklamın gösterilmediği kontrol grubuna kıyasla istatistiksel olarak önemli artımlı dönüşümler veya dönüşüm değeri sağlar. Kazanan kolun stratejisini tanıtın veya ölçeklendirin ve yüksek performans gösteren grupları incelemek için boyut dökümlerini sorgulayın.
  • Karşılaştırmada kazanan, kontrol grubuyla eşit (AB_WINNER_PARITY_VS_CONTROL): Kazanan kol, rakip koldan daha iyi performans gösterir (winner_score > 0.55) ancak her iki kol da sorgulanan düzeyde, reklam gösterilmeyen kontrol grubuna kıyasla istatistiksel olarak anlamlı bir artış sağlamaz. Kazanan koldaki harcamayı ölçeklendirmeden önce, pozitif nedensel artışın başka bir yerde izole edilip edilmediğini doğrulamak için ALL dönüşümleri (segments.conversion_lift_included_conversion_action_types = 'ALL') ve segments.conversion_lift_conversion_category dökümlerini sorgulayın.

POSITIVE_LIFT_DETECTED sonucu, A/B + Dönüşüm Artışı sorgu ayrıntı düzeylerinde aşağıdaki gibi uygulanır:

  • Birleşik kol (OVERALL) çalışma satırları (segments.experiment_arm içermeyen sorgular): Çalışma, reklam gösterilmeyen kontrol grubuna (p_value <= 0.50) kıyasla pozitif artış sağladı ve her iki kol da 0.55 değerinden yüksek bir başa baş kazanan puanı elde etmedi.
  • Kol başına (segments.experiment_arm) satırlar: Bir kol kazandığında (winner_score > 0.55) ve her iki kol da kontrol grubuna göre pozitif artış elde ettiğinde, kazanan kol satırı AB_WINNER_WITH_LIFT değerini, kazanmayan kol satırı ise POSITIVE_LIFT_DETECTED değerini döndürür.
  • Dönüşüm kategorisi (segments.conversion_lift_conversion_category) dilim satırları: Kazanan puanları dönüşüm kategorisine göre değerlendirilmediğinden pozitif artış satırları her zaman POSITIVE_LIFT_DETECTED değerini döndürür.

Bir dilim NOT_ENOUGH_DATA veya NO_SIGNIFICANT_LIFT döndürdüğünde, tek dilimli örnek yetersizliğine dayalı olarak kolları duraklatmayın veya kitleleri hariç tutmayın. Genel araştırma metriklerini ve ALL dönüşümleri (segments.conversion_lift_included_conversion_action_types = 'ALL') kontrol edin.

Birleştirilmiş kol ve çoklu çalışma sonuçlarını sorgulama

lift_measurement_config kaynağındaki bir sorgudan segments.experiment_arm segmentini çıkardığınızda API, her iki birleştirilmiş kolda toplanan çalışma düzeyinde artımlılığı döndürür. Birleştirilmiş kol sorgularında, yalnızca rakip kollar için geçerli olan ve segments.experiment_arm olmadan birleştirilmiş kol satırlarında atlanan (ayarlanmadan bırakılan) dört metrics.*_winner_score metriğini atlayın. Dönüşüm Artışı ve artımlı EBM sorgulama ile Dönüşüm değeri artışı ve artımlı ROAS sorgulama bölümlerindeki çalışma düzeyinde sorguları kullanın.

A/B + Dönüşüm Artışı sonuçlarını segments.experiment_arm segmentine göre segmentlere ayırdığınızda API, ek döküm boyutu olarak yalnızca segments.conversion_lift_conversion_category segmentini destekler. Kol harcaması, ayrı dönüşüm kategorileriyle ilişkilendirilmediğinden segments.conversion_lift_conversion_category segmentini dahil ettiğinizde dönüşüm ve dönüşüm değeri artışı metriklerini değerlendirin (Google Ads API v27 ve sonraki sürümlerde QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE hatasıyla sorgu doğrulamasında başarısız olan artımlı EBM ve artımlı ROAS metriklerini hariç tutun). segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name ve segments.date segmentleri, segments.experiment_arm segmenti ve metrics.*_winner_score metrikleriyle uyumlu değil. segments.experiment_arm ile birlikte bu uyumsuz segmentlerden herhangi birini seçmek QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatası (ve sorgu herhangi bir metrics.*_winner_score metriği de seçerse QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE hatası) döndürür.

Tek bir istekte birden fazla çalışma yapılandırmasının sonuçlarını almak için IN operatörüyle filtreleyin:

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'

Aşağıdakini değiştirin:

  • CONFIG_ID_1: İlk artış ölçümü yapılandırmasının tam sayı kimliği.
  • CONFIG_ID_2: İkinci artış ölçümü yapılandırmasının tam sayı kimliği.
  • START_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü başlangıç tarihi (ör. 20260501).
  • END_DATE: Tırnak içine alınmamış 8 haneli YYYYMMDD tam sayı olarak anlık görüntü bitiş tarihi (ör. 20260515).

Tam tarih eşitliği (= START_DATE ve = END_DATE), yalnızca tam olarak aynı anlık görüntü aralığını paylaşan çalışmaların satırlarını döndürür. Farklı yayın başlangıç tarihlerine veya en son değerlendirilen anlık görüntü tarihlerine sahip çalışmaları sorgularken aralık operatörleriyle (>= ve <=) filtreleme yapın veya WHERE yan tümcesindeki tarih filtrelerini çıkarın. Bu sırada SELECT yan tümcesindeki hem segments.conversion_lift_start_date hem de segments.conversion_lift_end_date segmentlerini koruyun.

Arama Artışı raporlaması

Google Ads API 26 ve sonraki sürümlerde reklam kampanyalarınızın sağladığı organik arama sorgusu hacmindeki artışı ölçmek için Arama Artışı raporlama kaynaklarını sorgulayın. Arama Artışı, reklamlarınızın gösterildiği kullanıcılar ile gösterilmediği kontrol grubu arasında markanız veya ürünlerinizle ilgili arama davranışı farkını ölçer.

Arama Artışı kaynakları ve segmentasyonu

Arama Artışı araştırmaları için yapılandırılan anahtar kelime gruplarıyla ilgili ayrıntıları almak üzere SearchLiftKeywordBundle kaynağını sorgulayın. SearchLiftKeywordBundle kaynağı, Google Ads API'de salt okunurdur (tüm alanlar OUTPUT_ONLY). Anahtar kelime grupları, Google Ads kullanıcı arayüzünde veya Google temsilciniz ya da GPS iletişim kişiniz tarafından yapılandırılır. GAQL'de sorgulanabilir alanları şunlardır: resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) ve status (SearchLiftKeywordBundleStatus) (yinelenen keywords alanı GAQL sorgularında seçilemez).

Arama Artışı metriklerini ve genel çalışma yapılandırmalarını almak için LiftMeasurementConfig kaynağını sorgulayın.

Google Ads API v27 ve sonraki sürümlerde, Arama Artışı metriklerini veya segmentlerini (segments.search_lift_keyword_bundle ya da segments.search_property) sorgularken lift_measurement_config üzerindeki GAQL SELECT ifadesinde salt okunur (OUTPUT_ONLY) lift_measurement_config.lift_guidance alanını (lift_guidance.outcome ve lift_guidance.guidance_message, LiftGuidance türünde) da seçebilirsiniz. lift_measurement_config üzerinde, yalnızca meta veri yapılandırma sorgularında lift_guidance atlanır ve lift_guidance.guidance_message satır içi Markdown bağlantıları (ör. [Learn more](https://support.google.com/...)) içerebilir. Arama Artışı için lift_guidance.outcome; STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (en az %70 kesinlik, p_value <= 0.30), NO_SIGNIFICANT_LIFT veya NOT_ENOUGH_DATA (en az 1.000.000 toplam gösterim veya 100.000 dilim gösterimi, en az 75 gözlemlenen arama ve 20 çerez grubundan en az 17'si eşiklerine göre değerlendirilir. Burada, tek bir yetersiz anahtar kelime paketi, genel çalışma sonuçlarının NOT_ENOUGH_DATA bildirmesine neden olur) değerini döndürür.

Arama Artışı performansını aşağıdaki boyutlara göre segmentlere ayırın:

  • segments.search_lift_keyword_bundle: Anahtar kelime grubu kaynak adına göre segmentlere ayırın. segments.search_property, segments.date ve demografik segmentlerle (segments.device, segments.age_range ve segments.gender) uyumludur. Her anahtar kelime grubu, tüm kampanya maliyetini ve gösterimlerini raporlar. Anahtar kelimeler birden fazla gruba ait olabilir. Anahtar kelime grupları genelinde Arama Artışı metriklerini toplamayın metrics.search_lift_cost_micros, metrics.search_lift_impressions veya toplamayın.
  • segments.search_property: Aramanın gerçekleştiği arama mülküne göre segmentlere ayırın. Bu mülk, SearchLiftSearchProperty enum (ör. GOOGLE_SEARCH veya YOUTUBE) tarafından tanımlanır. segments.search_property segmenti yalnızca segments.search_lift_keyword_bundle ve segments.date segmentleriyle uyumludur. segments.search_property ile demografik segmentleri (segments.device, segments.age_range veya segments.gender) birleştirmek sorgu doğrulamasının başarısız olmasına neden olur. segments.search_property, reklamların yayınlandığı yerler yerine sonraki organik aramaların gerçekleştiği yerlere göre bölümlere ayırdığından, segments.search_property ile segmentlere ayrılan satırlar, Google Ads API 26 sürümünde bölümlere ayrılmamış kampanya düzeyindeki maliyeti ve gösterimleri tekrarlar. Google Ads API v27'den itibaren sekiz harcama ve gösterim metriğinin (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost* ve metrics.normalized_incremental_searches_per_impression*) tümü segments.search_property ile uyumsuzdur ve QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE hatasıyla sorgu doğrulama başarısız olur.
  • Demografik ve tarih segmentleri: segments.device, segments.age_range, segments.gender ve segments.date.

Arama artışı metrikleri

LiftMeasurementConfig kaynağı, arama davranışı değişikliklerini değerlendirmek için Arama Artışı metrikleri sağlar:

Artış istatistiksel olarak pozitif olduğunda, aşağıdaki normalleştirilmiş artımlı metrikler ve bunlara karşılık gelen %90 tek taraflı güven sınırları (*_p90_lower_bound ve *_p90_upper_bound) raporlanır:

Örnek Arama Artışı sorguları

Aşağıdaki GAQL sorguları, Arama Artışı anahtar kelime gruplarının ve performans metriklerinin nasıl alınacağını gösterir.

Anahtar kelime grubu sorgusu

Arama Artışı ölçümleri için yapılandırılmış anahtar kelime gruplarını almak üzere search_lift_keyword_bundle kaynağını sorgulayın:

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

Metrik sorgusu

Anahtar kelime paketi sorgusunda alınan search_lift_keyword_bundle.resource_name değerleri, aşağıdaki sorguda segments.search_lift_keyword_bundle segmentinde döndürülen değerlere karşılık gelir. Çalışmanızın CONFIG_ID, bağlı kampanyalar ve uçuş planını keşfetmek için lift_measurement_config ve lift_measurement_flight kaynaklarında Çalışma yapılandırmalarını ve uçuşları keşfetme bölümündeki adımları uygulayın (uçuşları lift_measurement_flight.lift_type = 'SEARCH' ölçütüne göre filtreleyin).

Aşağıdaki sorgu, anahtar kelime grubuna ve arama mülküne göre segmentlere ayrılmış Arama Artışı metriklerini alır (metrics.search_lift_cost_micros veya metrics.search_lift_impressions seçilirken segments.search_property değerini atlayın):

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

Aşağıdakini değiştirin:

  • CONFIG_ID: Artış ölçümü yapılandırmasının tam sayı kimliği.