Wenn Sie die kausale Wirkung Ihrer Werbekampagnen auf die Markenwahrnehmung, Conversions, den Conversion-Wert und das organische Suchverhalten messen möchten, können Sie die Berichtsressourcen für die Steigerungsmessung in der Google Ads API abfragen:
- Berichte zur Anzeigenwirkung auf die Markenbekanntheit: Hier wird ausgewertet, wie sich die Anzeigenpräsenz auf die Markenwahrnehmung auswirkt. Dabei werden die in der Google Ads API ab Version 25 verfügbaren Messwerttypen berücksichtigt.
- Berichte zur Conversion-Steigerung: Hier werden zusätzliche Conversions, der Conversion-Wert, die Kosten pro zusätzlicher Conversion (iCPA) und der zusätzliche ROAS (iROAS) im Vergleich zu einer Holdback-Gruppe ohne Anzeigenbereitstellung in der Google Ads API ab Version 25 gemessen. Dazu gehören:
- Eigenständige Berichte zur Conversion-Steigerung: Hier wird die Inkrementalität auf Studienebene und segmentiert für alle gemessenen Kampagnen ausgewertet.
- Berichte zu A/B-Tests und Conversion-Lift: Hier werden die Inkrementalität der Holdback-Gruppe pro Vergleichsarm und die bayesschen Kopf-an-Kopf-Gewinnerwerte für konkurrierende Testvergleichsarme ausgewertet.
- Berichte zum Suchanstieg: Quantifiziert den zusätzlichen Anstieg des Volumens organischer Suchanfragen in der Google Suche und auf YouTube, der durch die Anzeigenpräsenz in der Google Ads API ab Version 26 verursacht wird.
Informationen zu Standard-Testberichten für A/B-Tests zu den Ressourcen experiment und campaign finden Sie unter Berichte zu Tests erstellen.
Berichte zur Anzeigenwirkung auf die Markenbekanntheit
Wenn Sie herausfinden möchten, wie sich Ihre Werbekampagnen auf die Markenwahrnehmung auswirken, können Sie in der Google Ads API ab Version 25 die entsprechenden Ressourcen für die Analyse der Anzeigenwirkung auf die Markenbekanntheit abfragen.
Brand Lift-Ressourcen und Aufschlüsselungsansichten
Konfigurationen, Flights und Aufschlüsselungsansichten für die Anzeigenwirkung auf die Markenbekanntheit sind in der Google Ads API schreibgeschützt (alle Felder sind OUTPUT_ONLY) und werden in der Google Ads-Benutzeroberfläche oder über Ihren Google-Ansprechpartner oder GPS-Kontakt konfiguriert. Fragen Sie diese Ressourcen mit dem Parameter customer_id des Kontos (Verwaltungs- oder untergeordnetes Konto) ab, das Inhaber der Studie ist.
Fragen Sie die Ressource LiftMeasurementFlight ab, um den Zeitplan für die Anzeigenlaufzeit und die Metadaten der Umfragesammlung auf Anzeigenlaufzeitebene abzurufen, einschließlich des Status der Anzeigenlaufzeit (lift_measurement_flight.status, definiert durch die Aufzählung LiftMeasurementFlightStatus mit den Werten ENABLED für aktive Anzeigenlaufzeiten und STOPPED für manuell angehaltene Anzeigenlaufzeiten), der Datumsbereiche der Anzeigenlaufzeit (lift_measurement_flight.start_date und lift_measurement_flight.end_date) in der Zeitzone des Kunden und des Fortschritts der Zielumfrageantworten (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, wobei 0 gleich 0 % und 1000000 gleich 100 % ist). Wenn Sie feststellen möchten, ob ein ENABLED-Flug im Gange oder abgeschlossen ist, vergleichen Sie das aktuelle Datum in der Zeitzone des Kunden mit lift_measurement_flight.start_date und lift_measurement_flight.end_date und prüfen Sie, ob response_collection_ratio_micros den Wert 1000000 erreicht hat.
Fragen Sie die Ressource LiftMeasurementConfig ab, um allgemeine Messwerte zur Anzeigenwirkung auf die Markenbekanntheit auf Studienebene abzurufen, oder fragen Sie die folgenden Aufschlüsselungsressourcen ab, um Messwerte zur Anzeigenwirkung auf die Markenbekanntheit über bestimmte Dimensionen hinweg zu analysieren:
LiftMeasurementCampaign: Aufschlüsselung nach Kampagne.LiftMeasurementAgeRange: Aufschlüsselung nach Altersgruppe.LiftMeasurementDevice: Aufschlüsselung nach Gerät.LiftMeasurementGender: Aufschlüsselung nach Geschlecht.LiftMeasurementVideo: Aufschlüsselung nach Video-Asset.
Fügen Sie das Segment segments.brand_lift_measurement_type hinzu, um die Messwerte zur Anzeigenwirkung auf die Markenbekanntheit nach dem Typ der gestellten Frage aufzuschlüsseln, der durch das Enum BrandLiftMeasurementType definiert wird (z. B. RECALL oder AWARENESS). Wenn Sie das Segment segments.brand_lift_measurement_type weglassen, gibt die API Messwerte für einen einzelnen automatisch ausgewählten Messungstyp pro Segment zurück.
Fügen Sie das Segment segments.date hinzu, um die Messwerte zur Anzeigenwirkung auf die Markenbekanntheit nach Datum (YYYY-MM-DD) aufzuschlüsseln. Der Messwert metrics.cost_per_lifted_cookie wird in Mikroeinheiten der Währung des Kontos zurückgegeben, zu dem die Studie gehört.
In der Google Ads API ab Version 27 können Sie auch das Feld mit Lesezugriff (OUTPUT_ONLY) lift_guidance (lift_guidance.outcome und lift_guidance.guidance_message vom Typ LiftGuidance) in der SELECT-Klausel der Google Ads Query Language (GAQL) für lift_measurement_config und die fünf Aufschlüsselungsressourcen für die Anzeigenwirkung auf die Markenbekanntheit (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender und lift_measurement_video) auswählen, um eine statistische Interpretation auf Zeilenebene zu erhalten. In lift_measurement_config wird lift_guidance nur dann ausgefüllt, wenn die Abfrage auch Lift-Messwerte oder -Segmente auswählt oder filtert (bei reinen Metadaten-Konfigurationsabfragen wird es weggelassen). lift_guidance.guidance_message kann Inline-Markdown-Links enthalten (z. B. [Learn more](https://support.google.com/...)). Sie können nicht nach lift_guidance-Unterfeldern in WHERE- oder ORDER BY-Klauseln filtern oder sortieren. Eine Beschreibung der LiftOutcomeEnum.LiftOutcome-Werte, die in lift_guidance.outcome zurückgegeben werden, finden Sie unter Ergebnisse der Anzeigenwirkung auf die Markenbekanntheit interpretieren.
Grenzwerte für die Berichterstellung und leere Antworten
Berichte zur Anzeigenwirkung auf die Markenbekanntheit sind sowohl latenzgesteuert (erfordern eine Pipeline-Verzögerung von 24–48 Stunden nach Beginn einer Studie) als auch antwortgesteuert pro gemessenem Typ (segments.brand_lift_measurement_type), um die statistische Berichterstellung und die Datenschutzschwellenwerte zu erfüllen:
- Rate positiver Antworten (
metrics.brand_lift_baseline_positive_response_rate*undmetrics.brand_lift_exposed_positive_response_rate*): Mindestens 50 Umfrageantworten im entsprechenden Zweig (Test- oder Kontrollgruppe). - Strikter Grenzwert für positive Steigerung (Gesamtstudie zu
LiftMeasurementConfigoder unabhängiges Segment): Statistisch positive Steigerung (p_value <= 0.50) mit mindestens 2.000 Antworten insgesamt und 860 Antworten pro Zweig. - Lockerer Grenzwert für positive Steigerung bei Segmenten (bei einer Aufschlüsselungsressource, wenn die Gesamtstudie den strengen Grenzwert mit positiver Steigerung erfüllt): Statistisch positive Steigerung (
p_value <= 0.50) mit mindestens 500 Antworten insgesamt und 200 Antworten pro Gruppe. - Grenzwert für nicht positive Steigerung erreicht (
NO_SIGNIFICANT_LIFTim Vergleich zuNOT_ENOUGH_DATA): Mindestens 4.100 Antworten insgesamt pro Messwert,wenn keine statistisch positive Steigerung erkannt wird.
Abfragen an LiftMeasurementConfig und die fünf Ressourcen für die Aufschlüsselung der Anzeigenwirkung auf die Markenbekanntheit (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign und LiftMeasurementVideo) geben in den folgenden Fällen eine leere Antwort (results: []) anstelle eines Fehlers zurück:
- Der abgefragte
customer_id-Parameter steht nicht auf der Zulassungsliste oder ist nicht der Inhaber der Studie. - Die Datumsfilter für
WHEREliegen außerhalb der ausgewerteten Laufzeitdaten (lift_measurement_flight.start_dateundlift_measurement_flight.end_date). - Die Studie oder das spezifische demografische Segment, Gerät, die Kampagne oder das Video hat die Berichtsverzögerung von 24–48 Stunden und die Schwellenwerte für das Volumen der Umfrageantworten noch nicht erreicht, auch wenn
LiftMeasurementConfigGesamtergebnisse der Studie zurückgibt.
So beheben Sie Fehler bei leeren Antworten:
- Fragen Sie
lift_measurement_flightab, um zu prüfen, oblift_measurement_flight.status = 'ENABLED', ob IhreWHERE-Datumsfilter zwischenlift_measurement_flight.start_dateundlift_measurement_flight.end_dateliegen, und prüfen Sie den Umfragefortschritt inlift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros(wobei1000000= 100 %). - Fragen Sie
LiftMeasurementConfigab, um zu prüfen, ob für die gesamte Studie meldefähige Brand Lift-Messwerte generiert wurden, bevor Sie Ressourcen für die Aufschlüsselung nach Dimensionen abfragen.
Ergebnisse der Anzeigenwirkung auf die Markenbekanntheit interpretieren
In der Google Ads API ab Version 27 gibt das Feld lift_guidance.outcome einen LiftOutcomeEnum.LiftOutcome-Wert zurück, der den statistischen Status jeder zurückgegebenen Zeile klassifiziert, zusammen mit menschenlesbaren Hinweisen zur Behebung in lift_guidance.guidance_message:
- Ergebnisse laufender Studien (wenn
lift_measurement_flight.statusden WertENABLEDhat und das aktuelle Datum in der Zeitzone des Kunden am oder vor demlift_measurement_flight.end_dateliegt, wobeilift_measurement_flight.survey_lift_measurement.response_collection_ratio_microskleiner als1000000ist):STUDY_IN_PROGRESS_WITH_LIFT: Die Studie läuft und es zeichnet sich ein vorläufiger positiver Anstieg ab.STUDY_IN_PROGRESS_NO_LIFT_YET: Die Studie läuft und es ist ein ausreichendes Anfangsvolumen vorhanden. Es wurde jedoch noch kein statistisch signifikanter Anstieg festgestellt.STUDY_IN_PROGRESS_COLLECTING_DATA: Die Studie läuft und es werden aktiv erste Umfrageantworten erfasst, um die Schwellenwerte für die statistische Berichterstellung zu erreichen.
- Ergebnisse abgeschlossener Studien (wenn
lift_measurement_flight.end_dateverstrichen ist oderlift_measurement_flight.survey_lift_measurement.response_collection_ratio_microsden Wert1000000erreicht hat):POSITIVE_LIFT_DETECTED: Für die abgeschlossene Studie oder das abgeschlossene Segment wurde eine statistisch signifikante positive Steigerung festgestellt.NO_SIGNIFICANT_LIFT: Die abgeschlossene Studie oder das Segment hat die Schwellenwerte für die statistische Genauigkeit erreicht (mindestens 4.100 Antworten insgesamt pro Messwert) und es wurde kein statistisch signifikanter positiver Anstieg festgestellt.NOT_ENOUGH_DATA: Die abgeschlossene Studie oder das Segment hat die für die statistische Berichterstellung erforderlichen Grenzwerte für Umfrageantworten nicht erreicht (mindestens 2.000 Antworten insgesamt und 860 Antworten pro Gruppe für eine positive Steigerung in der Gesamtstudie,500 Antworten insgesamt und 200 Antworten pro Gruppe für eine positive Steigerung in einem Segment, wenn die Gesamtstudie eine positive Steigerung aufweist, oder 4.100 Antworten insgesamt pro Messwert,wenn keine positive Steigerung festgestellt wird).
Beachten Sie bei der Interpretation der Ergebnisse zur Anzeigenwirkung auf die Markenbekanntheit die folgenden Richtlinien:
- Laufende im Vergleich zu abgeschlossenen Flights (
STUDY_IN_PROGRESS_*): Während einENABLED-Studien-Flight noch läuft (bevorlift_measurement_flight.end_datevergeht und bevorresponse_collection_ratio_micros1000000erreicht), stabilisieren sich die Umfrageantworten und die verzerrungskorrigierte Modellierung noch. Betrachten Sie laufende Messwerte als vorläufig und vermeiden Sie es, Kampagnen zu pausieren oder Budgets zu reduzieren, bis die Laufzeit abgeschlossen ist. - Positiver Anstieg (
POSITIVE_LIFT_DETECTED): Wenn ein positiver Brand Lift festgestellt wird, rufen Sie die Ressourcen für die dimensionale Aufschlüsselung (LiftMeasurementAgeRange,LiftMeasurementGender,LiftMeasurementDevice,LiftMeasurementCampaignundLiftMeasurementVideo) ab, um leistungsstarke Zielgruppenkohorten („Lichtblicke“) zu identifizieren und die Resonanz von Creatives im gesamten Markentrichter zu bewerten. - Unzureichende Daten oder kein signifikanter Anstieg (
NOT_ENOUGH_DATAoderNO_SIGNIFICANT_LIFT): Wenn die Anzahl der Umfrageantworten nicht ausreicht (weniger als 4.100 Antworten insgesamt pro Messwert ohne positiven Anstieg oder weniger als die strengen Grenzwerte von 2.000/860 oder die weniger strengen Grenzwerte von 500/200 für einen positiven Anstieg) oder kein statistisch signifikanter Anstieg in einem Segment festgestellt wird, sollten Sie dies nicht als Misserfolg der Kampagne betrachten oder Zielgruppen aufgrund unzureichender Stichproben in einem einzelnen Segment ausschließen. Prüfen Sie die allgemeinen Studienmesswerte aufLiftMeasurementConfig, fragen Sie andere befragtesegments.brand_lift_measurement_type-Werte ab (z. B.RECALLoderAWARENESSim oberen Trichterbereich) und prüfen Sie die verbleibenden Aufschlüsselungsdimensionen.
Beispielabfragen zur Anzeigenwirkung auf die Markenbekanntheit
Da sich Flug-Metadaten und Statistiken zur Steigerung auf separaten Ressourcen befinden, sind für die Abfrage von Flugdetails und Leistungsstatistiken separate GAQL-Abfragen erforderlich.
Abfrage von Fluginformationen
Wenn Sie Metadaten für einen Brand Lift-Flight abrufen möchten, z. B. den Status, den Messtyp, die geplanten Termine und den Fortschritt der Umfrageerfassung, fragen Sie die Ressource LiftMeasurementFlight ab:
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung (lift_measurement_config.lift_measurement_config_id).
Statistikabfrage
Wenn Sie Messwerte zur Anzeigenwirkung auf die Markenbekanntheit abrufen möchten, fragen Sie die Ressource LiftMeasurementConfig oder die entsprechende Aufschlüsselungsressource ab. Mit der folgenden Abfrage werden beispielsweise Messwerte zur Anzeigenwirkung auf die Markenbekanntheit aus der Ressource LiftMeasurementCampaign abgerufen, segmentiert nach Kampagne und Typ der Analyse der Anzeigenwirkung auf die Markenbekanntheit:
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
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.
Berichte zur Conversion-Steigerung
In der Google Ads API ab Version 25 wird in Berichten zur Conversion-Steigerung die inkrementelle Auswirkung Ihrer Anzeigen auf Conversions und den Conversion-Wert gemessen. In Studien zur Conversion-Steigerung wird das Conversion-Verhalten einer Testgruppe (Nutzer, die Ihre Anzeigen sehen konnten) mit dem einer Kontrollgruppe (Nutzer, die Ihre Anzeigen nicht sehen konnten) verglichen.
Konfigurationen, Laufzeiten und Testlinks für die Conversion-Steigerung sind in der Google Ads API schreibgeschützt (alle Felder sind OUTPUT_ONLY) und werden in der Google Ads-Benutzeroberfläche oder über Ihren Google-Ansprechpartner oder GPS-Kontakt konfiguriert. Fragen Sie die Ressource lift_measurement_config mit dem Parameter customer_id des Kontos ab, dem die Studie gehört. Über ein Verwaltungskonto können kontoübergreifende Studien zur Conversion-Steigerung, die zu diesem Konto gehören, direkt abgefragt werden. Fragen Sie Studien ab, die einem untergeordneten Konto gehören, indem Sie den Parameter customer_id des untergeordneten Kontos verwenden (optional mit dem Header login-customer-id authentifiziert).
Berichte zur Conversion-Steigerung unterstützen zwei Studien-Workflows, die beide dieselbe Studien- und Flight-Erkennung, dieselben kumulativen Snapshot-Zeiträume und dieselben Conversion-Aktionsbereiche verwenden:
- Eigenständige Berichte zur Conversion-Steigerung: Hier werden die allgemeine Steigerung, der Cost-per-Incremental-Conversion (iCPA) und der inkrementelle Return on Advertising Spend (iROAS) für die ausgewählten Conversion-Aktionen oder alle Conversion-Aktionen aus den gemessenen Kampagnen in der Studie erfasst.
- Berichte zu A/B-Tests und Conversion-Steigerung: Messen die Inkrementalität pro Verzweigung und die bayesschen Gewinnerwerte zwischen zwei konkurrierenden Testverzweigungen (Kontroll- und Testgruppe) sowie die Gesamtinkrementalität der Studie.
Wenn Sie Hilfe beim Erstellen gültiger Abfragen für die Ressource lift_measurement_config benötigen, verwenden Sie das Tool Google Ads Query Builder.
In der Google Ads API v27 und höher können Sie das schreibgeschützte (OUTPUT_ONLY) Feld lift_measurement_config.lift_guidance (lift_guidance.outcome und lift_guidance.guidance_message vom Typ LiftGuidance) in der GAQL-SELECT-Klausel für lift_measurement_config auswählen, um eine statistische Interpretation auf Zeilenebene für eigenständige Conversion-Steigerungs- und A/B- + Conversion-Steigerungs-Abfragen zu erhalten.
In lift_measurement_config wird lift_guidance nur dann ausgefüllt, wenn die Abfrage auch Lift-Messwerte oder -Segmente auswählt oder filtert. Bei Abfragen, die nur Metadaten enthalten, wird es weggelassen. lift_guidance.guidance_message kann Inline-Markdown-Links enthalten (z. B. [Learn more](https://support.google.com/...)). Sie können in WHERE- oder ORDER BY-Klauseln nicht nach lift_guidance-Unterfeldern filtern oder sortieren. Das Feld lift_guidance.outcome gibt einen der folgenden LiftOutcomeEnum.LiftOutcome-Werte zurück:
- Ergebnisse laufender Studien (wenn
lift_measurement_flight.statusden WertENABLEDhat und das aktuelle Datum in der Zeitzone des Kunden am oder vor demlift_measurement_flight.end_dateliegt):STUDY_IN_PROGRESS_WITH_LIFT: Die Studie läuft und es zeichnet sich ein vorläufiger positiver Anstieg ab.STUDY_IN_PROGRESS_NO_LIFT_YET: Die Studie läuft und es ist ein ausreichendes Anfangsvolumen vorhanden. Es wurde jedoch noch kein statistisch signifikanter Anstieg festgestellt.STUDY_IN_PROGRESS_COLLECTING_DATA: Die Studie läuft und es werden aktiv erste Conversion-Daten für die statistischen Berichts-Grenzwerte erhoben.
- Abgeschlossene Studienergebnisse (nach Ablauf von
lift_measurement_flight.end_date):POSITIVE_LIFT_DETECTED: Für die abgeschlossene Studie, den Vergleichsarm oder das Segment wurde ein statistisch signifikanter positiver Anstieg festgestellt.AB_WINNER_WITH_LIFT: Eine A/B- und Conversion-Steigerungsstudie, die mit einem erfolgreichen Vergleichsarm im direkten Vergleich und einer statistisch signifikanten positiven Steigerung gegenüber der nicht exponierten Kontrollgruppe abgeschlossen wurde.AB_WINNER_PARITY_VS_CONTROL: Eine A/B-Studie und eine Conversion-Lift-Studie wurden abgeschlossen. Ein Vergleichsarm hat im direkten Vergleich gewonnen, aber die Leistung war gleichauf mit der nicht exponierten Kontrollgruppe.NO_SIGNIFICANT_LIFT: Die abgeschlossene Studie, die Vergleichsgruppe oder das Segment hat die Schwellenwerte für die statistische Genauigkeit erreicht und es wurde kein statistisch signifikanter positiver Anstieg festgestellt.NOT_ENOUGH_DATA: Die abgeschlossene Studie, der Vergleichsarm oder das Segment hat nicht genügend Conversions erzielt, um die Schwellenwerte für die statistische Genauigkeit zu erreichen.
Studienkonfigurationen und Flüge entdecken
Wenn Sie einen Bericht zu einer Studie zur Conversion-Steigerung erstellen möchten, müssen Sie zuerst die Studienkonfiguration und den Zeitplan ermitteln:
- Studienkonfiguration abrufen: Fragen Sie die Ressource
LiftMeasurementConfigab, um den Namen der Studie, das Holdback-Verhältnis (lift_measurement_config.conversion_lift_holdback_ratio_micros), die erfassten Conversion-Aktionen (lift_measurement_config.conversion_actions) und – in Google Ads API v26 und höher – die aktiv verknüpften Kampagnen (lift_measurement_config.campaigns) abzurufen. Das Feldconversion_lift_holdback_ratio_microswird in Mikros angegeben, wobei1,000,000100 % entspricht (300000steht beispielsweise für eine Holdback-Gruppe von 30 %). Wenn Sie dieCONFIG_IDder Studie nicht kennen, lassen Sie dieWHERE-Klausel weg, um alle Studienkonfigurationen im Konto aufzulisten. - Flugbeobachtungsfenster abrufen: Fragen Sie die Ressource
LiftMeasurementFlightab, um die geplanten Flugdaten (lift_measurement_flight.start_dateundlift_measurement_flight.end_date) in der Zeitzone des Kunden zu finden. Da eine einzelneLiftMeasurementConfig-Ressource Flights für die Anzeigenwirkung auf die Markenbekanntheit (SURVEY), die Conversion-Steigerung (CONVERSION) und den Suchanstieg (SEARCH) gruppieren kann, fügen Sie das Feldlift_measurement_flight.lift_typein dieSELECT-Klausel ein und filtern Sie in derWHERE-Klausel nachlift_measurement_flight.lift_type = 'CONVERSION'. Die Felderlift_measurement_flight.start_dateundlift_measurement_flight.end_datekönnen inORDER BY-Klauseln sortiert werden, aber Sie können in einerWHERE-Klausel nicht nach ihnen filtern.
Mit der folgenden Abfrage wird die Studienkonfiguration abgerufen. Lassen Sie das Feld lift_measurement_config.campaigns in der Google Ads API-Version 25 weg, da für dieses Feld die Google Ads API-Version 26 oder höher erforderlich ist:
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
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung (lift_measurement_config.lift_measurement_config_id).
Mit der folgenden Abfrage wird der Zeitplan für die Studie zur Conversion-Steigerung abgerufen:
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung (lift_measurement_config.lift_measurement_config_id).
In der Google Ads API ab Version 26 können Sie die mit einer Kampagne verknüpfte Konfiguration für die Messung des Anstiegs auch direkt über die Ressource campaign ermitteln, indem Sie das Feld campaign.lift_measurement_config abfragen. Wenn Sie dieses Feld abfragen, müssen Sie die Ressource LiftMeasurementConfig nicht separat referenzieren:
SELECT
campaign.id,
campaign.lift_measurement_config
FROM campaign
WHERE campaign.id = CAMPAIGN_ID
Ersetzen Sie Folgendes:
CAMPAIGN_ID: die ganzzahlige ID der Kampagne (campaign.id).
Das Feld campaign.lift_measurement_config gibt einen Ressourcennamen im Format customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID zurück. Wenn eine Kampagne an mehreren Studien zur Anzeigenwirkung auf die Markenbekanntheit teilgenommen hat, wird in diesem Feld die zuletzt verknüpfte Konfiguration (aktiv oder inaktiv) angegeben. Im Feld lift_measurement_config.campaigns werden dagegen nur aktiv verknüpfte Kampagnen aufgeführt.
Kumulative Snapshot-Zeiträume abfragen
Die Ergebnisse der Conversion-Steigerung sind als tägliche kumulative Auswertungsmomente ab dem Startdatum der Laufzeit strukturiert:
- Das Segment
segments.conversion_lift_start_datebleibt an das Startdatum der Laufzeit (lift_measurement_flight.start_date) angepinnt. - Das Segment
segments.conversion_lift_end_datewird täglich bis zum Enddatum der Laufzeit (lift_measurement_flight.end_date) aktualisiert.
Sowohl segments.conversion_lift_start_date als auch segments.conversion_lift_end_date sind INT64-Felder, die als achtstellige Ganzzahlen ohne Anführungszeichen und ohne Bindestriche im Format YYYYMMDD (z. B. 20260501) formatiert sind. Im Gegensatz dazu geben die Felder lift_measurement_flight.start_date und lift_measurement_flight.end_date Datumsstrings im ISO 8601-Format YYYY-MM-DD (z. B. 2026-05-01) zurück. Im Gegensatz zu Abfragen zur Anzeigenwirkung auf die Markenbekanntheit und zum Suchanstieg ist das Segment segments.date mit allen Messwerten und Segmenten zur Conversion-Steigerung inkompatibel. Wenn Sie das Segment segments.date zusammen mit Segmenten für die Conversion-Steigerung (z. B. segments.conversion_lift_start_date) in der SELECT-Klausel auswählen, wird der Fehler QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE zurückgegeben. Wenn Sie segments.date mit Messwerten für die Conversion-Steigerung kombinieren, wird der Fehler QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE zurückgegeben.
Der neueste berechnete Snapshot kann während der Datenverarbeitung hinter dem Enddatum eines aktiven Flights zurückbleiben. Fragen Sie immer die Ressource lift_measurement_config nach verfügbaren (segments.conversion_lift_start_date,
segments.conversion_lift_end_date)-Paaren ab, sortiert nach segments.conversion_lift_end_date DESC, um den neuesten ausgewerteten Snapshot zu ermitteln.
Mit der folgenden Abfrage werden die verfügbaren Snapshot-Datumsbereiche für eine Studie abgerufen:
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
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.
Nach Conversion-Aktionsbereich filtern
Bei der Conversion-Steigerung wird die Inkrementalität in zwei Bereichen bewertet, die durch das Segment segments.conversion_lift_included_conversion_action_types definiert sind:
SELECTED: Conversion-Aktionen, die bei der Einrichtung der Studie ausgewählt wurden, oder alle gebotsfähigen (primären) Conversion-Aktionen, wenn keine benutzerdefinierten Conversion-Aktionen angegeben wurden.ALL: Alle Conversion-Aktionen aus den Kampagnen, die in der Studie analysiert werden.
Wenn Sie die Ressource lift_measurement_config nach Messwerten zur Conversion-Steigerung abfragen, ohne nach dem Segment segments.conversion_lift_included_conversion_action_types zu filtern, gibt die API zwei Zeilen pro Segment zurück: eine für ALL und eine für SELECTED. In GAQL muss jedes Segmentfeld, das kein Datumsfeld ist (und jedes Datumssegment für Conversion-Steigerungs-Snapshots), das in der WHERE-Klausel gefiltert wird, auch in der SELECT-Klausel enthalten sein. Andernfalls gibt die API den Fehler QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE zurück.
Wenn Sie in der WHERE-Klausel nach segments.conversion_lift_included_conversion_action_types =
'SELECTED' filtern, fügen Sie dieses Segment in die SELECT-Klausel ein.
Eigenständige Berichte zur Conversion-Steigerung
Mit eigenständigen Studien zur Conversion-Steigerung wird die zusätzliche Wirkung Ihrer Anzeigen im Vergleich zu einer Holdback-Gruppe gemessen, die Ihre Anzeigen nicht gesehen hat. Dabei werden die Kampagnen nicht in konkurrierende Testarme aufgeteilt.
Conversion-Steigerung und inkrementellen CPA abfragen
In Berichten zur Conversion-Steigerung werden Punktschätzungen zusammen mit einseitigen 90-%-Konfidenzgrenzen (*_p90_lower_bound und *_p90_upper_bound, die zusammen ein zweiseitiges 80-%-Konfidenzintervall bilden) und p-Werten (p_value <= 0.10 entspricht einer einseitigen statistischen Signifikanz von 90 %) angegeben:
metrics.conversion_lift_baseline_conversions: Geschätzte Baseline-Conversions, skaliert auf die Größe der Testgruppe (metrics.conversion_lift_exposed_conversionsentspricht alsometrics.conversion_lift_baseline_conversions + metrics.incremental_conversions). Wird weggelassen, wenn<= 0.metrics.conversion_lift_exposed_conversions: Geschätzte Conversions in der Testgruppe. Wird weggelassen, wenn<= 0.metrics.incremental_conversions: Inkrementelle Conversions, die der Anzeigenpräsenz zugeordnet werden, mit einseitigen Konfidenzgrenzen von 90 % (metrics.incremental_conversions_p90_lower_boundundmetrics.incremental_conversions_p90_upper_bound) und statistischer Signifikanz (metrics.incremental_conversions_p_value).metrics.cost_per_incremental_conversion: Kosten pro zusätzlicher Conversion (iCPA) mit einseitigen Konfidenzgrenzen von 90 % (metrics.cost_per_incremental_conversion_p90_lower_boundundmetrics.cost_per_incremental_conversion_p90_upper_bound). Wird in Standardwährungseinheiten des Kontos zurückgegeben, zu dem die Studie gehört (z. B. steht11.5für$11.50in USD, nicht in Mikroeinheiten – im Gegensatz zu den Messwertenmetrics.cost_microsodermetrics.cost_per_conversion). Das Feldmetrics.cost_per_incremental_conversion_p90_upper_boundist nicht festgelegt, wennmetrics.incremental_conversions_p90_lower_bound <= 0.metrics.relative_conversion_lift: Relative Steigerung der Conversions als Dezimalzahl (0.20steht beispielsweise für eine Steigerung von 20 %) mit einseitigen Konfidenzgrenzen von 90 % (metrics.relative_conversion_lift_p90_lower_boundundmetrics.relative_conversion_lift_p90_upper_bound).
In den folgenden Fällen werden in der API die Messwerte für die Conversion-Steigerung in den zurückgegebenen Zeilen weggelassen:
- Das inklusive Snapshot-Fenster beträgt weniger als 4 Tage.
- Das nicht skalierte erfasste Conversion-Volumen liegt unter den Mindestschwellenwerten für die Genauigkeit (weniger als 65 erfasste Baseline-Conversions in der Holdback-Gruppe oder weniger als 150 erfasste Conversions in der Testgruppe, bewertet vor der Skalierung von
metrics.conversion_lift_baseline_conversions). - Der gemessene Anstieg ist nicht positiv (
metrics.incremental_conversions_p_value > 0.5für Conversion-Messwerte odermetrics.incremental_conversion_value_p_value > 0.5für Conversion-Wert-Messwerte). - In der Google Ads API v27 und höher werden iROAS-Messwerte (
metrics.incremental_conversion_value_per_cost*) und Messwerte für den Conversion-Wert-Gewinner (metrics.incremental_conversion_value_winner_scoreundmetrics.incremental_conversion_value_per_cost_winner_score) für eine Studie abgefragt, die bei der Einrichtung mit der Conversion-Anzahl anstelle des Conversion-Werts als primärem Messwert konfiguriert wurde. Messwerte für den kostenlosen Conversion-Wert (metrics.conversion_lift_baseline_conversion_value,metrics.conversion_lift_exposed_conversion_value,metrics.incremental_conversion_value*undmetrics.relative_conversion_value_lift*) werden in Studien zur Conversion-Anzahl weiterhin ausgefüllt, wenn die Steigerung des Conversion-Werts erfasst werden kann. - Mehrere Zeilen oder Studien werden zusammengefasst, weil Sie die Felder
lift_measurement_config.lift_measurement_config_id,segments.conversion_lift_start_date,segments.conversion_lift_end_dateodersegments.conversion_lift_included_conversion_action_typesin derSELECT-Klausel weggelassen haben.
Beachten Sie die folgenden Richtlinien, wenn Sie die Ergebnisse der eigenständigen Conversion-Steigerung interpretieren:
- Laufende im Vergleich zu abgeschlossenen Flights (
STUDY_IN_PROGRESS_*): Während einENABLED-Studien-Flight noch läuft (wenn das aktuelle Datum in der Zeitzone des Kunden am oder vor demlift_measurement_flight.end_dateliegt), stabilisieren sich die Conversion-Modellierung für Baseline und Testgruppe sowie die Attribution verzögerter Conversions noch. Betrachten Sie laufende Messwerte als vorläufig und vermeiden Sie es, Kampagnen zu pausieren oder Budgets zu reduzieren, bis die Laufzeit beendet ist. - Positive Steigerung (
POSITIVE_LIFT_DETECTED): Die Messwerte für die Conversion-Steigerung können in Berichten erfasst werden undlift_guidance.outcome = 'POSITIVE_LIFT_DETECTED'wird ausgelöst, wenn die gemessene Steigerung positiv ist (p_value <= 0.50, was einer Wahrscheinlichkeit von mindestens 50 % mit einer positiven Punktschätzung entspricht, währendp_value <= 0.10eine einseitige statistische Signifikanz von 90 % angibt, wobei*_p90_lower_bound >= 0) und die Mindestgenauigkeitsschwellen (mindestens 4 Snapshot-Tage, mindestens 65 nicht skalierte Baseline-Conversions und mindestens 150 nicht skalierte Conversions mit Anzeigenbereitstellung) erreicht werden. Wenn ein positiver Anstieg erkannt wird, können Sie dimensionale Aufschlüsselungen (demografische Merkmale, Gerät, Land oder Conversion-Kategorie und Conversion-Aktion) abfragen, um leistungsstarke Kohorten („Lichtblicke“) zu identifizieren. - Nicht genügend Daten oder keine signifikante Steigerung (
NOT_ENOUGH_DATAoderNO_SIGNIFICANT_LIFT): Wenn das Datenvolumen nicht ausreicht (weniger als 65 nicht skalierte Baseline-Conversions oder weniger als 150 nicht skalierte Conversions in der Testgruppe) oder keine statistisch signifikante Steigerung in einem Segment festgestellt wird, sollten Sie dies nicht als Kampagnenfehler betrachten oder Zielgruppen aufgrund unzureichender Stichproben in einem einzelnen Segment ausschließen. Prüfen Sie die allgemeinen Studienmesswerte und fragen Siesegments.conversion_lift_included_conversion_action_types = 'ALL'ab (wennSELECTEDkeinen Anstieg zeigt) oder die verbleibenden dimensionalen Aufschlüsselungen, um zu sehen, ob an anderer Stelle ein positiver Anstieg isoliert wurde.
Mit der folgenden Abfrage werden die Gesamt-Conversion-Steigerung, die Konfidenzgrenzen und der iCPA abgerufen:
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Steigerung des Conversion-Werts und iROAS abfragen
Wenn Sie den zusätzlichen Umsatz aus Ihren Werbeausgaben ermitteln möchten, fragen Sie die Messwerte für den Conversion-Wert und den Messwert metrics.incremental_conversion_value_per_cost ab.
Messwerte für den Conversion-Wert, die nicht auf Kosten basieren (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* und metrics.relative_conversion_value_lift*), werden immer dann erfasst, wenn die Studie eine Steigerung des Conversion-Werts aufweist, die in Berichten erfasst werden kann. Dabei spielt es keine Rolle, ob der primäre Messwert der Studie die Anzahl der Conversions oder der Conversion-Wert ist. In der Google Ads API v27 und höher werden die iROAS-Messwerte (metrics.incremental_conversion_value_per_cost*) zusammen mit metrics.incremental_conversion_value_winner_score und metrics.incremental_conversion_value_per_cost_winner_score nur zurückgegeben, wenn die Studie bei der Einrichtung mit dem Conversion-Wert als primärem Messwert konfiguriert wurde. Bei Studien mit der Conversion-Anzahl als primärem Messwert werden sie weggelassen:
metrics.conversion_lift_baseline_conversion_value: Geschätzter Baseline-Conversion-Wert in der Währung des Kontos, dem die Studie gehört, skaliert auf die Größe der Testgruppe. Wird weggelassen, wenn<= 0.metrics.conversion_lift_exposed_conversion_value: Geschätzter Conversion-Wert in der Testgruppe. Wird weggelassen, wenn<= 0.metrics.incremental_conversion_value: Zusätzlicher Conversion-Wert, der Anzeigen zugeordnet wird, mit einseitigen Konfidenzgrenzen von 90 % (metrics.incremental_conversion_value_p90_lower_boundundmetrics.incremental_conversion_value_p90_upper_bound) und statistischer Signifikanz (metrics.incremental_conversion_value_p_value).metrics.relative_conversion_value_lift: Relative Steigerung des Conversion-Werts, ausgedrückt als Dezimalanteil (z. B. steht0.20für eine Steigerung von 20 %), mit einseitigen Konfidenzgrenzen von 90 % (metrics.relative_conversion_value_lift_p90_lower_boundundmetrics.relative_conversion_value_lift_p90_upper_bound).metrics.incremental_conversion_value_per_cost: Zusätzlicher ROAS (Return on Advertising Spend), ausgedrückt als dimensionsloses Währungsverhältnis (z. B. steht2.5für$2.50des zusätzlichen Conversion-Werts pro$1.00, die in der Währung des Kontos ausgegeben werden, zu dem die Studie gehört), mit 90 % einseitigen Konfidenzgrenzen (metrics.incremental_conversion_value_per_cost_p90_lower_boundundmetrics.incremental_conversion_value_per_cost_p90_upper_bound). Das Feldmetrics.incremental_conversion_value_per_cost_p90_lower_boundist nicht festgelegt, wennmetrics.incremental_conversion_value_p90_lower_bound < 0.
Mit der folgenden Abfrage werden die Steigerung des Conversion-Werts, die Konfidenzgrenzen und der iROAS abgerufen:
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Ergebnisse nach Dimension segmentieren
Segmentieren Sie Messwerte für zusätzliche Conversions nach Conversion-Kategorie, Conversion-Aktion, demografischen Merkmalen, Gerät oder Geografie. Wählen Sie beim Abfragen der Ressource lift_measurement_config nur kompatible Segmentkombinationen aus:
- Segmente für Conversion-Kategorie und Conversion-Aktion: Sie können die Segmente
segments.conversion_lift_conversion_category,segments.conversion_actionundsegments.conversion_action_nameeinzeln auswählen, miteinander kombinieren oder mit maximal einer demografischen, Geräte- oder Länderdimension kombinieren. (Wenn Sie das Segmentsegments.experiment_armabfragen, ist nur das Segmentsegments.conversion_lift_conversion_categorykompatibel.) - Demografische, Geräte- und geografische Segmente: Die Dimensionen
segments.age_range,segments.gender,segments.deviceund „Land“ (segments.countrymitsegments.country_localized_name) sind untereinander und mit dem Segmentsegments.experiment_armnicht kompatibel. Wählen Sie pro Abfrage höchstens eine dieser vier Dimensionen aus.
Wenn Sie in der SELECT-Klausel inkompatible Segmente auswählen, schlägt die Abfragevalidierung fehl und es wird ein QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE-Fehler zurückgegeben. Verwenden Sie den Google Ads Query Builder, um Segmentkombinationen interaktiv zu validieren.
Bewerten Sie Messwerte zur Kosteneffizienz (metrics.cost_per_incremental_conversion* und metrics.incremental_conversion_value_per_cost*) nur in Zeilen für die gesamte Studie oder in segments.experiment_arm-Zeilen. In den Google Ads API-Versionen 25 und 26 können im Schema die sechs Messwerte für das Kostenverhältnis (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 und metrics.incremental_conversion_value_per_cost_p90_upper_bound) mit den acht Segmenten, die nicht zu einer Verzweigung gehören (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country und segments.country_localized_name), ausgewählt werden. Ab der Google Ads API-Version 27 schlägt die Abfragevalidierung fehl, wenn einer dieser sechs Messwerte für das Kostenverhältnis mit einem dieser acht Segmente, die nicht zu einer Verzweigung gehören, ausgewählt wird. Es wird der Fehler QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE zurückgegeben.
Conversion-Wert-Messwerte ohne Aufpreis (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* und metrics.relative_conversion_value_lift*) werden weiterhin für die Segmente „Conversion-Kategorie“, „Conversion-Aktion“, „Demografische Merkmale“, „Gerät“ und „Land“ unterstützt, wenn die Steigerung des Conversion-Werts erfasst werden kann (unabhängig davon, ob der primäre Messwert der Studie die Conversion-Anzahl oder der Conversion-Wert ist).
Wenn Sie die Steigerung für Conversion-Kategorien auswerten möchten, die im Enum ConversionActionCategory definiert sind (z. B. PURCHASE, SIGNUP oder SUBMIT_LEAD_FORM), segmentieren Sie die Ergebnisse nach dem Segment 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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Das Segment segments.conversion_action gibt den Ressourcennamen der Conversion-Aktion im Format customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID zurück. Wählen Sie das Segment segments.conversion_action_name in der Ressource lift_measurement_config aus, um menschenlesbare Namen von Conversion-Aktionen abzurufen, ohne die Ressource conversion_action separat abzufragen. In der folgenden Abfrage werden Messwerte zur Conversion-Steigerung nach Conversion-Aktion, Name der Conversion-Aktion und Conversion-Kategorie segmentiert:
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Mit der folgenden Abfrage werden die Messwerte zur Conversion-Steigerung nach dem Segment segments.device segmentiert. Ersetzen Sie das Segment segments.age_range oder segments.gender in separaten Anfragen, um demografische Aufschlüsselungen abzurufen (optional kombiniert mit Segmenten für Conversion-Kategorien oder Conversion-Aktionen):
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Wenn Sie die Ergebnisse nach geografischer Einheit aufschlüsseln möchten, fügen Sie die Segmente segments.country und segments.country_localized_name hinzu (optional kombiniert mit Segmenten für Conversion-Kategorie oder Conversion-Aktion). Das Segment segments.country gibt einen globalen Ressourcennamen für die geografische Zielkonstante im Format geoTargetConstants/CRITERION_ID zurück (z. B. geoTargetConstants/2840 für die USA).
In der folgenden Abfrage werden die Messwerte zur Conversion-Steigerung nach dem Ressourcennamen des Länderkriteriums und dem lokalisierten Ländernamen segmentiert:
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Berichte zu A/B-Tests und Conversion-Steigerung
In der Google Ads API ab Version 25 werden bei Studien zur Conversion-Steigerung mit A/B-Tests zweiarmige Tests (Vergleich von Kontroll- und Teststrategien) mit Holdback-Messungen in der Google Ads API kombiniert, um die Inkrementalität einzelner Arme zu bewerten und bayessche Gewinner-Scores zu berechnen. Im Gegensatz zu direkten Testberichten für die Ressource experiment, bei denen nicht angepasste Traffic-Messwerte für die einzelnen Testgruppen verglichen werden, wird bei der Abfrage der Ressource lift_measurement_config mit dem Segment segments.experiment_arm die inkrementelle Steigerung jeder Testgruppe im Vergleich zu einer nicht exponierten Holdback-Baseline gemessen.
Tests und Testverzweigungen entdecken
Bei einer Studie zu A/B-Tests und Conversion-Steigerung wird eine LiftMeasurementConfig-Ressource über das schreibgeschützte (OUTPUT_ONLY) Feld experiment.lift_measurement_config mit einer zweiarmigen experiment-Ressource verknüpft.
Wenn Sie den verknüpften Test und seine Verzweigungen in einer einzigen Anfrage ermitteln möchten, fragen Sie die Ressource ExperimentArm mit den zugeordneten experiment-Feldern ab und filtern Sie nach dem Feld experiment.lift_measurement_config. Die Antwort enthält den Kontrollstatus (experiment_arm.control), die Aufteilung des Traffics (experiment_arm.traffic_split), die verknüpften Kampagnen (experiment_arm.campaigns) und den Ressourcennamen der einzelnen Verzweigungen.
Verwenden Sie den zurückgegebenen experiment_arm.resource_name-Wert (formatiert als customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID), um nach dem Segment segments.experiment_arm zu filtern:
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'
Ersetzen Sie Folgendes:
CUSTOMER_ID: die 10-stellige Kundennummer des Kontos, zu dem die Studie gehört (ohne Bindestriche).CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.
Wenn Sie mit einer bekannten EXPERIMENT_ID beginnen (oder alle Tests im Konto auflisten möchten, für die die Steigerung aktiviert ist), führen Sie dieselbe experiment_arm-Abfrage aus, gefiltert nach WHERE experiment.experiment_id = EXPERIMENT_ID (oder WHERE
experiment.lift_measurement_config IS NOT NULL).
Inkrementalität und Gewinnerwerte pro Verzweigung abfragen
Wenn Sie die Inkrementalität für jede Gruppe messen und die statistische Wahrscheinlichkeit bewerten möchten, dass eine Gruppe die beste Leistung erzielt, fügen Sie das Segment segments.experiment_arm in Ihre Abfrage an die Ressource lift_measurement_config ein.
Mit den folgenden bayesschen Messwerten für den Gewinner-Score wird die Wahrscheinlichkeit (von 0.0 bis 1.0, wobei die Summe für beide Verzweigungen 1.0 beträgt, wenn beide Verzweigungen eine positive Steigerung aufweisen, die in Berichten berücksichtigt werden kann) bewertet, dass eine bestimmte Verzweigung besser ist:
metrics.incremental_conversions_winner_score: Die Wahrscheinlichkeit, dass diese Verzweigung der Gewinner für zusätzliche Conversions ist, normalisiert nach der Aufteilung des Traffics auf die Verzweigungen (experiment_arm.traffic_split).metrics.incremental_conversion_value_winner_score: Die Wahrscheinlichkeit, dass diese Verzweigung der Gewinner für den zusätzlichen Conversion-Wert ist, normalisiert nach der Aufteilung des Traffics auf die Verzweigungen (experiment_arm.traffic_split). In der Google Ads API ab Version 27 wird dieser Wert nur ausgefüllt, wenn der primäre Messwert der Studie der Conversion-Wert ist. Bei Studien mit der Conversion-Anzahl als primärem Messwert wird er weggelassen (nicht festgelegt).metrics.cost_per_incremental_conversion_winner_score: Die Wahrscheinlichkeit, dass diese Gruppe der Gewinner für die Kosten pro zusätzlicher Conversion (niedrigster iCPA) ist, normalisiert nach Ausgaben.metrics.incremental_conversion_value_per_cost_winner_score: Die Wahrscheinlichkeit, dass diese Verzweigung die beste für den zusätzlichen Conversion-Wert pro Kosten (höchster iROAS) ist, normiert nach Ausgaben. In der Google Ads API ab Version 27 wird dieser Wert nur ausgefüllt, wenn der primäre Messwert der Studie der Conversion-Wert ist. Bei Studien, bei denen die Conversion-Anzahl der primäre Messwert ist, wird er weggelassen (nicht festgelegt).
Mit der folgenden Abfrage werden die Inkrementalität pro Gruppe und die bayesschen Gewinnerwerte für beide Gruppen abgerufen:
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'
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Wenn Sie nach einer einzelnen Verzweigung filtern möchten, fügen Sie der WHERE-Klausel AND segments.experiment_arm =
'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' hinzu. Dabei ist EXPERIMENT_ID die Test-ID und ARM_ID die Verzweigungs-ID, die im Feld experiment_arm.resource_name zurückgegeben wird. Das Segment segments.experiment_arm unterstützt das Filtern in WHERE-Klauseln (=, !=, IN, NOT IN), aber Sie können es nicht in einer ORDER BY-Klausel sortieren.
Ergebnisse von A/B-Tests und Tests zur Conversion-Steigerung interpretieren
In einer Studie zu A/B-Tests und Conversion-Steigerung werden zwei Hypothesen gleichzeitig bewertet: die Überlegenheit eines Zweigs im direkten Vergleich (metrics.*_winner_score) und die kausale Steigerung im Vergleich zur nicht exponierten Holdback-Gruppe (metrics.incremental_* und *_p_value). Während eine ENABLED-Studie noch läuft (STUDY_IN_PROGRESS_*, wenn das aktuelle Datum in der Zeitzone des Kunden am oder vor dem lift_measurement_flight.end_date liegt), stabilisieren sich der direkte Vergleich der Zweige und die Conversion-Modellierung für die Holdback-Gruppe noch. Betrachten Sie laufende Messwerte als vorläufig und vermeiden Sie es, einen Vergleichsarm zu bewerben oder Budgets neu zuzuweisen, bis die Laufzeit abgeschlossen ist.
In abgeschlossenen Studien wird eine Testverzweigung als direkter Gewinner eingestuft, wenn sie die Mindestschwellenwerte für die Genauigkeit erfüllt (mindestens 4 Snapshot-Tage, 65 nicht skalierte Baseline-Conversions und 150 nicht skalierte Conversions mit Anzeigenbereitstellung), 0 <=
p_value <= 0.50 hat und einen bayesschen Gewinnerwert von mehr als 0.55 (> 0.55) für den primären Messwert der Studie erreicht. Diese Bewertung mit zwei Hypothesen führt zu zwei unterschiedlichen Gewinnerstatus (auch in lift_guidance.outcome in der Google Ads API ab Version 27 enthalten):
- Eindeutiger Gewinner mit kausaler Steigerung (
AB_WINNER_WITH_LIFT): Der Gewinnerzweig schneidet im direkten Vergleich besser ab als der konkurrierende Zweig (winner_score > 0.55) und generiert statistisch signifikante zusätzliche Conversions oder einen höheren Conversion-Wert als die nicht exponierte Holdback-Gruppe. Bewerben oder skalieren Sie die Strategie des Gewinnerzweigs und fragen Sie dimensionale Aufschlüsselungen ab, um leistungsstarke Kohorten zu prüfen. - Direkter Gewinner auf Augenhöhe mit der Holdback-Gruppe (
AB_WINNER_PARITY_VS_CONTROL): Die Gewinnerverzweigung schneidet im direkten Vergleich besser ab als die konkurrierende Verzweigung (winner_score > 0.55), aber keine der beiden Verzweigungen erzielt auf dem abgefragten Niveau eine statistisch signifikante inkrementelle Steigerung gegenüber der nicht exponierten Holdback-Gruppe. Bevor Sie die Ausgaben für die erfolgreiche Verzweigung erhöhen, sollten Sie dieALL-Conversions (segments.conversion_lift_included_conversion_action_types = 'ALL') und diesegments.conversion_lift_conversion_category-Aufschlüsselungen abfragen, um zu prüfen, ob an anderer Stelle eine positive kausale Steigerung isoliert wurde.
Das Ergebnis POSITIVE_LIFT_DETECTED gilt für die verschiedenen Granularitäten von A/B-Tests und Conversion-Steigerung:
- Zeilen für die kombinierte Studie (
OVERALL) (Abfragen ohnesegments.experiment_arm): Die Studie hat im Vergleich zur nicht exponierten Holdback-Gruppe (p_value <= 0.50) einen positiven Anstieg erzielt und keine der beiden Gruppen hat einen Head-to-Head-Gewinnerwert von mehr als0.55erreicht. - Zeilen pro Verzweigung (
segments.experiment_arm): Wenn eine Verzweigung gewinnt (winner_score > 0.55) und beide Verzweigungen eine positive Steigerung gegenüber der Holdback-Gruppe erzielen, wird in der Zeile der GewinnerverzweigungAB_WINNER_WITH_LIFTzurückgegeben, während in der Zeile der nicht gewinnenden VerzweigungPOSITIVE_LIFT_DETECTEDzurückgegeben wird. - Zeilen für das Segment „Conversion-Kategorie“ (
segments.conversion_lift_conversion_category): Zeilen mit positiver Steigerung geben immerPOSITIVE_LIFT_DETECTEDzurück, da die Gewinnerwerte nicht pro Conversion-Kategorie ausgewertet werden.
Wenn ein Slice NOT_ENOUGH_DATA oder NO_SIGNIFICANT_LIFT zurückgibt, sollten Sie keine Testgruppen pausieren oder Zielgruppen ausschließen, nur weil die Stichprobe für einen einzelnen Slice nicht ausreicht. Sehen Sie sich die allgemeinen Messwerte der Studie und die ALL-Conversions (segments.conversion_lift_included_conversion_action_types = 'ALL') an.
Ergebnisse aus kombinierten Studienarmen und mehreren Studien abfragen
Wenn Sie das Segment segments.experiment_arm in einer Abfrage der Ressource lift_measurement_config weglassen, gibt die API die Steigerung der Conversions auf Studien-Ebene zurück, die über beide kombinierten Gruppen aggregiert wurde. Lassen Sie bei Abfragen mit kombinierten Verzweigungen die vier metrics.*_winner_score-Messwerte weg, die nur für konkurrierende Verzweigungen gelten und in Zeilen mit kombinierten Verzweigungen ohne segments.experiment_arm weggelassen (nicht festgelegt) werden. Verwenden Sie die Abfragen auf Studienebene in Conversion-Steigerung und iCPA abfragen und Steigerung des Conversion-Werts und iROAS abfragen.
Wenn Sie die Ergebnisse von A/B- und Conversion-Steigerungstests nach dem Segment segments.experiment_arm segmentieren, unterstützt die API nur das Segment segments.conversion_lift_conversion_category als zusätzliche Aufschlüsselungsdimension. Da die Ausgaben für die Verzweigung nicht einzelnen Conversion-Kategorien zugeordnet werden, sollten Sie die Messwerte für die Steigerung von Conversions und Conversion-Werten auswerten, wenn Sie das Segment segments.conversion_lift_conversion_category einbeziehen. Lassen Sie dabei die Messwerte für iCPA und iROAS weg, da sie die Abfragevalidierung in der Google Ads API ab Version 27 mit einem QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE-Fehler nicht bestehen. Die Segmente segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name und segments.date sind nicht mit dem Segment segments.experiment_arm und den Messwerten metrics.*_winner_score kompatibel.
Wenn Sie eines dieser inkompatiblen Segmente zusammen mit segments.experiment_arm auswählen, wird ein QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE-Fehler zurückgegeben. Wenn in der Abfrage auch ein metrics.*_winner_score-Messwert ausgewählt ist, wird ein QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE-Fehler zurückgegeben.
Wenn Sie Ergebnisse für mehrere Studienkonfigurationen in einer einzigen Anfrage abrufen möchten, filtern Sie mit dem 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'
Ersetzen Sie Folgendes:
CONFIG_ID_1: die ganzzahlige ID der ersten Konfiguration für die Steigerungsmessung.CONFIG_ID_2: die ganzzahlige ID der zweiten Konfiguration für die Steigerungsmessung.START_DATE: das Startdatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260501).END_DATE: das Enddatum des Snapshots als 8-stelligeYYYYMMDD-Ganzzahl ohne Anführungszeichen (z. B.20260515).
Bei genauer Datumsübereinstimmung (= START_DATE und = END_DATE) werden nur Zeilen für Studien zurückgegeben, die genau dieses Snapshot-Fenster haben. Wenn Sie Studien mit unterschiedlichen Startdaten für die Laufzeit oder mit den neuesten ausgewerteten Snapshot-Daten abfragen, filtern Sie mit Bereichsoperatoren (>= und <=) oder lassen Sie die Datumsfilter aus der WHERE-Klausel weg, während Sie die Segmente segments.conversion_lift_start_date und segments.conversion_lift_end_date in der SELECT-Klausel beibehalten.
Berichte zum Suchanstieg
Wenn Sie den Anstieg des Volumens organischer Suchanfragen messen möchten, der durch Ihre Werbekampagnen in der Google Ads API ab Version 26 erzielt wurde, können Sie die Berichtsressourcen zum Suchanstieg abfragen. Mit dem Suchanstieg wird der Unterschied im Suchverhalten nach Ihrer Marke oder Ihren Produkten zwischen Nutzern, die Ihre Anzeigen gesehen haben, und einer Kontrollgruppe, die sie nicht gesehen hat, quantifiziert.
Ressourcen und Segmentierung für den Suchanstieg
Fragen Sie die Ressource SearchLiftKeywordBundle ab, um Details zu Keyword-Sets abzurufen, die für Suchanstiegsanalysen konfiguriert sind. Die Ressource SearchLiftKeywordBundle ist in der Google Ads API schreibgeschützt (alle Felder sind OUTPUT_ONLY). Keyword-Bundles werden in der Google Ads-Benutzeroberfläche oder von Ihrem Google-Ansprechpartner oder GPS-Kontakt konfiguriert. Die abfragbaren Felder in GAQL sind resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) und status (SearchLiftKeywordBundleStatus). Das wiederkehrende Feld keywords kann in GAQL-Abfragen nicht ausgewählt werden.
Fragen Sie die Ressource LiftMeasurementConfig ab, um Messwerte zum Suchanstieg und allgemeine Studienkonfigurationen abzurufen.
In Google Ads API v27 und höher können Sie auch das Feld mit Lesezugriff (OUTPUT_ONLY) lift_measurement_config.lift_guidance (lift_guidance.outcome und lift_guidance.guidance_message vom Typ LiftGuidance) in der GAQL-SELECT-Klausel für lift_measurement_config auswählen, wenn Sie Messwerte oder Segmente für den Suchanstieg (segments.search_lift_keyword_bundle oder segments.search_property) abfragen. Bei lift_measurement_config wird lift_guidance bei reinen Metadaten-Konfigurationsabfragen weggelassen und lift_guidance.guidance_message kann Inline-Markdown-Links (z. B. [Learn more](https://support.google.com/...)) enthalten. Für den Suchanstieg gibt lift_guidance.outcome STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (mindestens 70 % Sicherheit, p_value <= 0.30), NO_SIGNIFICANT_LIFT oder NOT_ENOUGH_DATA zurück (ausgewertet anhand von Schwellenwerten von mindestens 1.000.000 Impressionen insgesamt oder 100.000 Segmentimpressionen, mindestens 75 beobachteten Suchanfragen und mindestens 17 von 20 Cookie-Buckets, wobei ein einzelnes Keyword-Bundle mit zu geringer Leistung dazu führt, dass die Gesamtergebnisse der Studie NOT_ENOUGH_DATA melden).
Sie können die Leistung des Suchanstiegs nach den folgenden Dimensionen segmentieren:
segments.search_lift_keyword_bundle: Segmentierung nach dem Ressourcennamen des Keyword-Pakets. Kompatibel mit den Segmentensegments.search_property,segments.dateund den demografischen Segmenten (segments.device,segments.age_rangeundsegments.gender). Für jedes Keyword-Set werden die gesamten Kampagnenkosten und Impressionen erfasst. Keywords können zu mehreren Sets gehören. Addieren Sie die Messwerte fürmetrics.search_lift_cost_micros,metrics.search_lift_impressionsoder den Suchanstieg nicht über Keyword-Sets hinweg.segments.search_property: Segmentierung nach der Such-Property, in der die Suche stattgefunden hat, definiert durch das EnumSearchLiftSearchProperty(z. B.GOOGLE_SEARCHoderYOUTUBE). Das Segmentsegments.search_propertyist nur mit den Segmentensegments.search_lift_keyword_bundleundsegments.datekompatibel. Wenn Siesegments.search_propertymit demografischen Segmenten (segments.device,segments.age_rangeodersegments.gender) kombinieren, schlägt die Abfragevalidierung fehl. Dasegments.search_propertyPartitionen enthält, in denen nachfolgende organische Suchanfragen aufgetreten sind, und nicht, in denen Anzeigen ausgeliefert wurden, werden in Zeilen, die nachsegments.search_propertysegmentiert sind, nicht partitionierte Kosten und Impressionen auf Kampagnenebene in der Google Ads API v26 wiederholt. Ab Google Ads API-Version 27 sind alle acht Ausgaben- und Impressionsmesswerte (metrics.search_lift_cost_micros,metrics.search_lift_impressions,metrics.normalized_incremental_searches_per_cost*undmetrics.normalized_incremental_searches_per_impression*) nicht mitsegments.search_propertykompatibel und die Abfragevalidierung schlägt mit dem FehlerQueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSEfehl.- Demografische und Datumssegmente:
segments.device,segments.age_range,segments.genderundsegments.date.
Messwerte für den Suchanstieg
Die Ressource LiftMeasurementConfig liefert Messwerte zum Suchanstieg, mit denen sich Änderungen im Suchverhalten bewerten lassen:
metrics.relative_search_lift: Die Differenz des Suchvolumens zwischen der Test- und der Kontrollgruppe, ausgedrückt als Bruchteil der Suchanfragen in der Kontrollgruppe.metrics.relative_search_lift_p90_lower_boundundmetrics.relative_search_lift_p90_upper_bound: Die einseitigen Konfidenzgrenzen von 90 % (die zusammen ein beidseitiges Konfidenzintervall von 80 % bilden) für den relativen Suchanstieg.metrics.incremental_searches_p_value: Der p-Wert für zusätzliche Suchanfragen, der die statistische Wahrscheinlichkeit darstellt, dass der beobachtete Anstieg der Suchanfragen zufällig aufgetreten ist.metrics.search_lift_cost_micros: Die Gesamtkosten (in Mikros) der Anzeigenimpressionen, die für dieses Suchanstiegs-Messsegment ausgeliefert wurden. Inkompatibel mitsegments.search_propertyin der Google Ads API ab Version 27.metrics.search_lift_impressions: Die Gesamtzahl der Anzeigenimpressionen, die für dieses Segment der Suchanstiegsmessung ausgeliefert wurden. Inkompatibel mitsegments.search_propertyin der Google Ads API, Version 27 und höher.
Die folgenden normalisierten inkrementellen Messwerte werden zusammen mit den entsprechenden einseitigen 90-%-Konfidenzgrenzen (*_p90_lower_bound und *_p90_upper_bound) gemeldet, wenn die Steigerung statistisch positiv ist:
metrics.normalized_incremental_searches(mitmetrics.normalized_incremental_searches_p90_lower_boundundmetrics.normalized_incremental_searches_p90_upper_bound): Geschätzte Anzahl zusätzlicher Suchanfragen, die durch die Anzeigenpräsenz ausgelöst wurden, normalisiert über die Test- und Kontrollgruppen hinweg.metrics.normalized_incremental_searches_per_cost(mitmetrics.normalized_incremental_searches_per_cost_p90_lower_boundundmetrics.normalized_incremental_searches_per_cost_p90_upper_bound): Geschätzte zusätzliche Suchanfragen, die pro Einheit der Werbeausgaben generiert werden. Inkompatibel mitsegments.search_propertyin der Google Ads API, Version 27 und höher.metrics.normalized_incremental_searches_per_impression(mitmetrics.normalized_incremental_searches_per_impression_p90_lower_boundundmetrics.normalized_incremental_searches_per_impression_p90_upper_bound): Geschätzte zusätzliche Suchanfragen, die pro Anzeigenimpression generiert werden. Inkompatibel mitsegments.search_propertyin der Google Ads API, Version 27 und höher.
Beispiele für Suchanfragen für den Suchanstieg
Die folgenden GAQL-Abfragen zeigen, wie Sie Keyword-Pakete und Leistungsmesswerte für den Suchanstieg abrufen.
Abfrage für Keyword-Set
Wenn Sie Keyword-Sets abrufen möchten, die für die Messung des Suchanstiegs konfiguriert sind, fragen Sie die Ressource search_lift_keyword_bundle ab:
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
Messwertabfrage
Die in der Keyword-Bundle-Abfrage abgerufenen search_lift_keyword_bundle.resource_name-Werte entsprechen den Werten, die im segments.search_lift_keyword_bundle-Segment in der folgenden Abfrage zurückgegeben werden. Wenn Sie die CONFIG_ID, die verknüpften Kampagnen und den Flight-Zeitplan für Ihre Studie ermitteln möchten, folgen Sie der Anleitung unter Studienkonfigurationen und Flights ermitteln für die Ressourcen lift_measurement_config und lift_measurement_flight (Flights nach lift_measurement_flight.lift_type = 'SEARCH' filtern).
Mit der folgenden Abfrage werden Messwerte für den Suchanstieg abgerufen, die nach Keyword-Set und Such-Property segmentiert sind. Lassen Sie segments.search_property weg, wenn Sie metrics.search_lift_cost_micros oder metrics.search_lift_impressions auswählen:
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
Ersetzen Sie Folgendes:
CONFIG_ID: die ganzzahlige ID der Konfiguration für die Steigerungsmessung.