v0 (09.11.2026)
Neue Segmente
Wir fügen die folgenden Segmente hinzu:
v0 (01.08.2026)
Neue Felder
Wir fügen synthetic_content_info zu den Ressourcen ad und asset hinzu, zusammen mit der unterstützenden SyntheticContentInfo-Nachricht, SyntheticContentAttestationStatus und den SyntheticContentSource-Enums.
v0 (10.03.2026)
Neue Segmente
Wir fügen die folgenden Segmente hinzu:
ad_format_typevertical_ads_event_participant_display_namesvertical_ads_hotel_classvertical_ads_listingvertical_ads_listing_brandvertical_ads_listing_cityvertical_ads_listing_countryvertical_ads_listing_regionvertical_ads_partner_account
v0 (05.12.2025)
Neue Messwerte
Die folgenden Messwerte sind jetzt verfügbar, wenn Sie die Ressource campaign abfragen:
Wir fügen die folgenden Messwerte für Conversions mit Warenkorbdaten hinzu:
ordersaverage_order_value_microsaverage_cart_sizecost_of_goods_sold_microsgross_profit_microsgross_profit_marginrevenue_microsunits_sold
Neue Segmente
Die Segmentierung nach Postleitzahl kann jetzt in einer Abfrage angegeben werden. Weitere Informationen finden Sie unter segments.geo_target_postal_code.
v0 (10.11.2025)
Neue URL-Felder
Wir fügen
ad.final_mobile_urlsad.tracking_url_templatead.final_url_suffixad_group.tracking_url_templatead_group.final_url_suffixad_group_criterion.final_mobile_urlsad_group_criterion.url_custom_parametersasset.final_mobile_urlsasset.url_custom_parametersasset.final_url_suffix
Neue Messwerte für UserLocationView
Die folgenden Messwerte sind jetzt verfügbar, wenn Sie die Ressource user_location_view abfragen:
all_conversions_by_conversion_dateall_conversions_value_by_conversion_dateconversions_by_conversion_dateconversions_value_by_conversion_datecross_device_conversions_by_conversion_datecross_device_conversions_value_by_conversion_datevalue_per_all_conversions_by_conversion_datevalue_per_conversions_by_conversion_date
Korrektur des Ressourcennamens
Das Ressourcennamenmuster für die folgenden effektiven Labelressourcen wurde korrigiert, sodass owner_customer_id verwendet wird, um sicherzustellen, dass es die Kundennummer enthält, die das Label besitzt:
CampaignEffectiveLabelAdGroupEffectiveLabelCriterionEffectiveLabel(inAdGroupCriterionEffectiveLabel)AdGroupAdEffectiveLabel
Beispiel:
Das Muster für CampaignEffectiveLabel wurde von customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} in customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} geändert.
v0 (12.06.2025)
Dieses Update enthält neue Felder für die Ressource customer. Aktualisieren Sie die Clientbibliothek, um alle diese Änderungen nutzen zu können.
Neue Felder
Wir fügen
customer.manager_id,customer.manager_descriptive_name,customer.sub_manager_id,customer.sub_manager_descriptive_name,customer.associate_manager_id,customer.associate_manager_descriptive_nameundcustomer.account_level
um die Search Ads 360-Kontohierarchie zu durchlaufen.
v0 (21.01.2025)
Dieses Update enthält einen neuen Parameter zum Konfigurieren der MCC-Erweiterung.
MCC-Erweiterung
Wenn Sie eine bidding_strategy abfragen, können Sie jetzt im Abschnitt PARAMETERS einen booleschen Wert (enable_mcc_expansion) festlegen.
Wenn dieser Parameter aktiviert ist, werden in der Antwort Daten aus allen Konten in der Kontohierarchie zurückgegeben, die auf customer_id basiert.
v0 (08.11.2024)
Dieses Update enthält neue Felder und neue Ressourcen. Aktualisieren Sie die Clientbibliothek, um alle diese Änderungen nutzen zu können.
Neue Felder
Wir fügen ad_group_ad.effective_labels und ad_group_criterion.effective_labels hinzu.
Effektive Labels sind übernommene oder direkt zugewiesene Labels.
Neue Ressourcen
Ansicht „Nutzerstandort“
In Kombination mit geografischen Segmenten können Sie Messwerte zu Regionen, Großräumen und Städten abrufen.
Weitere Informationen finden Sie unter user_location_view.
Im Zusammenhang mit den neuen „effective_labels“-Feldern gibt es zwei neue Ressourcen, die die Metadaten der Verknüpfung zwischen den effektiven Labels und der „ad_group_ad“ (ad_group_ad_effective_label) oder dem „ad_group_criterion“ (ad_group_criterion_effective_label) enthalten.
v0 (07.10.2024)
Dieses Update enthält neue Messwerte, Ressourcen, Felder und einige neue Zuordnungsdefinitionen. Aktualisieren Sie die Clientbibliothek, um alle diese Änderungen nutzen zu können.
Messwerte hinzugefügt
cross_device_conversions_by_conversion_date: Die Anzahl der geräteübergreifenden Conversions nach Conversion-Datum.cross_device_conversions_value_by_conversion_date: Die Summe des Werts der geräteübergreifenden Conversions nach Conversion-Datum.general_invalid_click_rate: Der Prozentsatz der Klicks, die aus der Gesamtzahl der Klicks (gefilterte + nicht gefilterte Klicks) herausgefiltert wurden, weil sie allgemeine ungültige Klicks sind.general_invalid_clicks: Anzahl der allgemeinen ungültigen Klicks.
cross_device_conversions_by_conversion_date und cross_device_conversions_value_by_conversion_date sind mit den folgenden Ressourcen kompatibel: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view und shopping_performance_view.
Feldzuordnungen neu definiert
Die Feldzuordnungen für dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions und dfaTransactionsCrossEnv haben sich für einige alte Berichte geändert.
| Feld | Vorher | Neue Definition |
|---|---|---|
dfaActions |
metrics.all_conversions - metrics.cross_device_conversions | metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date |
dfaActionsCrossEnv |
metrics.all_conversions | metrics.all_conversions_by_conversion_date |
dfaRevenue |
metrics.all_conversions_value - metrics.cross_device_conversions_value | metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date |
dfaRevenueCrossEnv |
metrics.all_conversions_value | metrics.all_conversions_value_by_conversion_date |
dfaTransactions |
metrics.all_conversions - metrics.cross_device_conversions | metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date |
dfaTransactionsCrossEnv |
metrics.all_conversions | metrics.all_conversions_by_conversion_date |
Liste der alten Berichte, bei denen die Feldzuordnung geändert wurde
Neue Felder
Wir fügen campaign.effective_labels und ad_group.effective_labels hinzu.
Effektive Labels sind übernommene oder direkt zugewiesene Labels.
Neue Ressourcen
Im Zusammenhang mit den neuen effective_labels-Feldern enthalten die neuen Ressourcen Metadaten zur Verknüpfung zwischen den effektiven Labels und der Kampagne (campaign_effective_label) oder Anzeigengruppe (ad_group_effective_label).
v0 (23.08.2024)
In diesem Update werden den Metadaten für benutzerdefinierte Spalten das Feld „renderType“ hinzugefügt.
Weitere Informationen finden Sie unter CustomColumnRenderType.
Den Ressourcen campaign_label, ad_group_label, ad_group_ad_label und ad_group_criterion_label wurde ein neues owner_customer_id-Feld hinzugefügt.
Aktualisieren Sie die Clientbibliothek, um diese neuen Felder zu nutzen.
v0 (01.08.2024)
Dieses Update umfasst die stündliche Segmentierung und mehrere neue Felder.
Stündliche Segmentierung
In einer Abfrage kann jetzt eine stündliche Segmentierung angegeben werden. Weitere Informationen finden Sie unter segments.hour.
„start_time“ wurde der Ressource „customer_manager_link“ hinzugefügt.
Weitere Informationen finden Sie unter customer_manager_link.start_time.
MULTIMEDIA_AD wurde zu ad_group_ad.ad.type hinzugefügt.
Messwerte und Segmente können jetzt mit dem Typ MULTIMEDIA_AD ausgewählt werden. Das Abfragen von multimediaspezifischen Attributen wird in dieser Version nicht unterstützt.
Der Kampagnentyp SOCIAL wurde zu campaign.advertising_channel_type und der Untertyp SOCIAL_FACEBOOK_TRACKING_ONLY zu campaign.advertising_channel_sub_type hinzugefügt.
Messwerte und Segmente können jetzt mit dem Kampagnentyp SOCIAL und dem Untertyp SOCIAL_FACEBOOK_TRACKING_ONLY ausgewählt werden. Das Abfragen von SOCIAL- oder SOCIAL_FACEBOOK_TRACKING_ONLY-spezifischen Attributen wird in dieser Version nicht unterstützt.
Unterstützung für „average_quality_score“ hinzugefügt
Weitere Informationen finden Sie unter Messwerte.
v0 (18.04.2024)
Dieses Update enthält die Ressource „Accessible Bidding Strategy“ (Zugängliche Gebotsstrategie).
Verfügbare Gebotsstrategie
Stellt eine Ansicht der Gebotsstrategien dar, die dem Kunden gehören und mit ihm geteilt werden. Im Gegensatz zu BiddingStrategy enthält diese Ressource neben den Strategien, die diesem Kunden gehören, auch Strategien, die den Verwaltungskonten des Kunden gehören und mit diesem Kunden geteilt werden. Diese Ressource stellt keine Messwerte bereit und bietet nur eine begrenzte Teilmenge der BiddingStrategy-Attribute.
Weitere Informationen finden Sie unter accessible_bidding_strategy.
v0 (12.02.2024)
Dieses Update umfasst den Zugriff auf benutzerdefinierte Spalten und benutzerdefinierte Floodlight-Variablen.
Benutzerdefinierte Spalten
Benutzerdefinierte Conversion-Spalten und benutzerdefinierte Formelspalten können jetzt in einer Abfrage angegeben werden. Weitere Informationen finden Sie in der Dokumentation zu benutzerdefinierten Spalten.
Benutzerdefinierte Floodlight-Variablen
Benutzerdefinierte Floodlight-Variablen können jetzt in einer Abfrage für Statistiken nach dem 30.01.2024 angegeben werden. Weitere Informationen finden Sie in der Dokumentation zu benutzerdefinierten Floodlight-Variablen.
v0 (09.11.2023)
Dieses Update enthält die folgenden Ressourcen. Über die Links können Sie die Felder aufrufen, die für diese Ressourcen abgefragt werden können, sowie die Messwerte und Segmentierungen, die damit verwendet werden können.
Asset-Gruppe
Asset in Asset-Gruppe
Filter für Asset-Eintragsgruppen
Weitere Informationen finden Sie unter asset_group_listing_group_filter.
Asset-Gruppensignal
Ansicht der besten Kombinationen in der Asset-Gruppe
Weitere Informationen finden Sie unter asset_group_top_combination_view.
Verkaufsansicht für Warenkorbdaten
Weitere Informationen finden Sie unter cart_data_sales_view.
Conversion
Details zur Conversion-Ressource ansehen
Ansicht „Shoppingleistung“
Aufrufen
Weitere Informationen finden Sie unter Besuch.
v0 (15.08.2023)
Dieses Update enthält die folgenden Ressourcen und einen neuen Parameter zum Konfigurieren der Währungsumrechnung für Messwerte.
Über die Links können Sie die Felder aufrufen, die für diese Ressourcen abgefragt werden können, sowie die Messwerte und Segmentierungen, die damit verwendet werden können.
Asset der Anzeigengruppe
Asset-Sammlung für Anzeigengruppe
Asset
Asset-Ressourcendetails ansehen
Asset-Sammlung
Details zur asset_set
Asset in der Asset-Sammlung
Kampagnen-Asset
Asset-Sammlung der Kampagne
Asset des Kunden
Asset-Sammlung des Kunden
Währungsumrechnung
Sie können die Währung für die Berechnung von Messwerten im Abschnitt PARAMETERS mit metrics_currency angeben.
Zugängliche Kunden auflisten
Listen Sie alle zugänglichen Konten mit der Methode „ListAccessibleCustomers“ auf.
v0 (15.05.2023)
Dieses Update enthält die folgende Ressource. Über die Links können Sie die Felder aufrufen, die für diese Ressource abgefragt werden können, sowie die Messwerte und Segmentierungen, die damit verwendet werden können.
Anzeige in Anzeigengruppe
v0 (06.04.2023)
Dieses Update enthält die folgenden Ressourcen. Über die Links können Sie die Felder aufrufen, die für jede Ressource abgefragt werden können, sowie die Messwerte und Segmentierungen, die mit dieser Ressource verwendet werden können.
Zielgruppenansicht für Anzeigengruppen
Weitere Informationen finden Sie unter ad_group_audience_view.
Label für Anzeigengruppenkriterium
Weitere Informationen finden Sie unter ad_group_criterion_label.
Label der Anzeigengruppe
Weitere Informationen finden Sie unter ad_group_label.
Ansicht „Altersgruppe“
Kampagnenkriterium
Kampagnenlabel
Suchbegriffansicht für dynamische Suchanzeigen
Weitere Informationen finden Sie unter dynamic_search_ads_search_term_view.
Webseitenansicht
Label
Weitere Informationen finden Sie unter Label.
v0 (05.12.2022)
Die Version v0 enthält die folgenden Ressourcen und Dienste. Über die Links können Sie die Felder aufrufen, die für jede Ressource abgefragt werden können, sowie die Messwerte und Segmentierungen, die mit dieser Ressource verwendet werden können.
Anzeigengruppe
Gebote
Weitere Informationen finden Sie unter bidding_strategy.
Kampagnen
Details zur Kampagnenressource
Conversion-Aktion
Weitere Informationen zur Ressource conversion_action
Kunde
Details zur Ressource customer ansehen
Keyword
Product Group
SearchAds360FieldService
- SearchAds360FieldService bietet einen Katalog aller abfragbaren Felder. Die Metadaten zu diesen Feldern umfassen Beschreibungen, Typen und die Kompatibilität mit anderen Feldern. Weitere Informationen
SearchAds360Service
SearchAds360Serviceist für das Abrufen mehrerer Ressourcen in einer einzelnen Abfrage gedacht. Zu den abfragbaren Ressourcen gehören:AdGroupBiddingStrategyCampaignConversionActionCustomerKeywordProductGroup
Messwerte wie Impressionen und Klicks können für diese Ressourcen auch mit
SearchAds360Serviceabgerufen werden:AdGroupBiddingStrategyCampaignConversionActionCustomerKeywordProductGroup
SearchAds360Serviceermöglicht die Segmentierung nach Feldern, z. B. Datumsfeldern. Weitere Informationen