Version 16.1.0 (24.04.2024)
Die folgenden Funktionen und Änderungen wurden in Version 16.1 hinzugefügt.
Kontoverwaltung
CustomerNegativeCriterion.ip_block
, womit eine IP-Adresse als negatives Kriterium auf Kundenebene hinzugefügt werden kann.- Neuer enum-Wert:
ProductLinkError.LINK_EXISTS
. - Neuer enum-Wert:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Assets
- Unterstützung für Assets mit Bezug zu Demand Gen für
ad_group_ad_asset_view
undasset_field_type_view
. - Neuer enum-Wert:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Zielgruppen
- Neuer enum-Wert:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
. Dadurch wird die Anzahl der Listen ähnlicher Nutzer, die ein Kunde haben kann, auf 1.000 beschränkt.
Kampagnen
- Unterstützung von Gebotssimulationen für Ziel-ROAS-Kampagnen für App-Kampagnen unter Verwendung des Berichts
campaign_simulation
- Neuer enum-Wert:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - Neuer enum-Wert:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - Neuer enum-Wert:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Conversions
SkAdNetworkConversionValueSchema.postback_mappings
, das SKAdNetwork 4.0-Funktionen unterstützt.- Warnungen für
CustomerSkAdNetworkConversionValueSchemaService
werden alsMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
unterstützt. Wenn dieser Wert auftrue
gesetzt ist, werden alle nicht blockierenden Fehler im Zusammenhang mit Vorgangsfehlern alsMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
zurückgegeben. - Neue enum-Werte in
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Kriterien
- Neue Felder in
BrandInfo
:display_name
primary_url
rejection_reason
status
- Neue Aufzählung:
BrandRequestRejectionReason
. - Neuer enum-Wert:
CriterionType.LIFE_EVENT
.
Tests
- Neuer enum-Wert:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Lokale Dienstleistungen
local_services_lead.credit_details.credit_state
undlocal_services_lead.credit_details.credit_state_last_update_date_time
, die den Guthabenstatus bzw. den Zeitstempel für die Aktualisierung des Guthabenstatus zurückgeben.local_services_lead_conversation.message_details.attachment_urls
gibt die URLs zurück, mit denen der Inhalt des Anhangs heruntergeladen werden kann.
Videos
customer.video_brand_safety_suitability
undBrandSafetySuitability
, die das Abrufen der Markensicherheitseignung für Videos auf Kundenebene unterstützen.- Neuer enum-Wert:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
Version 16 (21.02.2024)
In Version 16 wurden die folgenden Funktionen und Änderungen hinzugefügt.
Kontoverwaltung
advertising_partner
vonAccountLink
zuProductLink
undProductLinkInvitation
migriert.data_partner
undgoogle_ads
wurden ausAccountLink
entfernt.IdentityVerificationService
wurde hinzugefügt, um die Überprüfung von Werbetreibenden zu verwalten.StartIdentityVerification()
wird verwendet, um eine Bestätigungssitzung mit dem bereitgestelltenverification_program
zu starten. Es wird eine neue Bestätigungssitzung erstellt und bei einer erfolgreichen Überprüfung wird eine leere Antwort zurückgegeben.IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
wurde hinzugefügt.
GetIdentityVerification()
kann zum Abrufen von Verifizierungsinformationen verwendet werden, wodurch mehrereIdentityVerification
-Objekte zurückgegeben werden. JedesIdentityVerification
-Objekt enthält Folgendes:verification_program
– die Art des Programms zur Identitätsüberprüfungidentity_verification_requirement
mit Details zur Frist, bis zu der der Werbetreibende die Überprüfung abschließen mussverification_progress
mit Details zur Überprüfungssitzung, darunter:program_status
steht für den aktuellen Status dieser Überprüfungssitzung.action_url
leitet den Kunden zu einer URL weiter, um die Bestätigung abzuschließen.invitation_link_expiration_time
steht für das Ablaufdatum für denaction_url
- Aufzählungen:
- Fehler:
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
wurde hinzugefügt.
Assets
- Änderungen an
asset_group
:- Zeitbezogene Segmente wie
segments.year
undsegments.month
werden jetzt unterstützt. campaign
wurde zu einer zugeordneten Ressource erstellt, anstatt die Ressource zu segmentieren.
- Zeitbezogene Segmente wie
Kampagnen
- Änderungen an Demand Gen-Kampagnen:
- Unterstützung für das Festlegen von
Campaign.shopping_setting
für eine vorhandene Demand Gen-Kampagne wurde hinzugefügt. ShoppingSetting.disable_product_feed
wurde hinzugefügt, um den optionalen Produktfeed von Demand Gen-Kampagnen zu deaktivieren.Ad.demand_gen_product_ad
und die entsprechendeDemandGenProductAdInfo
wurden hinzugefügt, die für Demand Gen-Kampagnen mit einem anderen Wert alsCampaign.shopping_setting
verfügbar sind.
- Unterstützung für das Festlegen von
- In die folgenden Felder zu
AdGroup
wurden hinzugefügt, um anzugeben, ob die Anzeigengruppe ausgeliefert wird oder warum sie nicht ausgeliefert wird:primary_status
primary_status_reasons
- In die folgenden Felder zu
AdGroupAd
wurden hinzugefügt, um anzugeben, ob die Anzeige der Anzeigengruppe ausgeliefert wird oder warum sie nicht ausgeliefert wird:primary_status
primary_status_reasons
- Folgende Werte wurden zu
AdGroupError
hinzugefügt:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Testen
Experiment.sync_enabled
wurde hinzugefügt, um anzugeben, ob die Synchronisierung im Test aktiviert werden soll. Wenn die Synchronisierung aktiviert ist, werden Änderungen, die während des laufenden Tests an der ursprünglichen Kampagne vorgenommen werden, automatisch in die Testkampagne kopiert.ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
wurde hinzugefügt.CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
wurde hinzugefügt.
Hotels und Reisen
- In
ListingDimensionInfo
wurden für eine Anzeige mit möglichen Aktivitäten die folgenden Felder hinzugefügt, um das Erstellen von Eintragsgruppen basierend auf dem Bundesstaat und der Stadt zu ermöglichen, in denen die Reiseaktivität verfügbar ist: - Die folgenden Segmente werden in
travel_activity_performance_view
unterstützt:
Lokale Dienstleistungen
- Wir haben
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
undBusinessRegistrationCheckArtifact
hinzugefügt, damit Werbetreibende den Fortschritt der Überprüfung der Gewerbeanmeldung im Blick behalten können. - Eine neue Ressource
local_services_employee
wurde hinzugefügt, über die Werbetreibende die von ihnen hinzugefügten Mitarbeiterinformationen abrufen können.
Planung
score
wurde ausAudienceInsightsAttributeMetadata
entfernt.
Empfehlungen
RecommendationService.GenerateRecommendations()
wurde hinzugefügt, das Empfehlungen auf Grundlage der angegebenen Einstellungen zurückgibt, z. B. Empfehlungstypen und Werbekanaltypen. Das ist besonders hilfreich beim Erstellen einer Kampagne.RecommendationMetrics.conversions_value
wurde hinzugefügt.- Für empfohlene Keywords, für die die Keyword-Option nicht festgelegt wurde, ist
recommended_match_type
jetzt aufUNSPECIFIED
statt aufUNKNOWN
festgelegt. - Folgende Arten von Empfehlungen wurden hinzugefügt:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
. Hier wird empfohlen, die Gebotsstrategie „Conversion-Wert maximieren“ zu aktivieren.IMPROVE_GOOGLE_TAG_COVERAGE
: Hier wird empfohlen, das Google-Tag auf weiteren Seiten zu implementierenPERFORMANCE_MAX_FINAL_URL_OPT_IN
. Hier wird empfohlen, die Erweiterung der finalen URL für Ihre Performance Max-Kampagnen zu aktivieren.REFRESH_CUSTOMER_MATCH_LIST
: Hier wird empfohlen, eine Kundenliste zu aktualisieren, die in den letzten 90 Tagen nicht aktualisiert wurdeCUSTOM_AUDIENCE_OPT_IN
. Hier wird empfohlen, eine benutzerdefinierte Zielgruppe zu erstellen.LEAD_FORM_ASSET
: Hier wird empfohlen, Assets mit Lead-Formular auf Kampagnen- oder Kundenebene hinzuzufügen.IMPROVE_DEMAND_GEN_AD_STRENGTH
: Hier wird empfohlen, die Anzeigeneffektivität in Demand Gen-Kampagnen zu verbessern
Shopping
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
undCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
wurden hinzugefügt, um detailliertere Fehler für Shopping-Kampagnen anzuzeigen, die mit einem Comparison Shopping Service Center-Konto verknüpft sind.- Folgende Werte wurden zu
AssetGroupListingGroupFilterError
hinzugefügt:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
Lebenszyklusziele
update
wurdeCustomerLifecycleGoalOperation
undCampaignLifecycleGoalOperation
hinzugefügt, um diese Vorgangstypen mit anderen Vorgangstypen in der API einheitlich zu gestalten.
Version 15 (18.10.2023)
In Version 15 wurden die folgenden neuen Funktionen und Updates eingeführt.
Kontoverwaltung
- Wenn Ihr Konto aufgrund von nicht autorisierten Kontoaktivitäten gesperrt wurde, werden
customer.status
undcustomer_client.status
jetzt alsSUSPENDED
zurückgegeben. Bisher wurden sie alsENABLED
zurückgegeben. - Unterstützung zum Hinzufügen und Entfernen einer Verknüpfung zwischen einem Google Ads-Konto und einem Merchant Center-Konto wurde hinzugefügt:
ProductLink.merchant_center
undMerchantCenterIdentifier
wurden hinzugefügt.LinkedProductType.MERCHANT_CENTER
wurde hinzugefügt.
ProductLinkInvitationService
undProductLinkInvitation
wurden hinzugefügt, um die Aktualisierung einer Verknüpfungseinladung zu unterstützen, die von anderen Produkten gesendet wurde. Diese sind für Hotel Center- und Merchant Center-Konten verfügbar.MerchantCenterLinkService
wurde entfernt.- Verwenden Sie
ProductLinkInvitationService
undProductLinkService
, um Google Ads-Konten mit Merchant Center-Konten zu verknüpfen.
- Verwenden Sie
AccountLink.hotel_center
und die Unterstützung für die Aktualisierung von Verknüpfungseinladungen aus Hotel Center-Konten mitAccountLinkService
wurden entfernt.- Verwenden Sie
ProductLinkInvitationService
, um eine Verknüpfungseinladung von einem Hotel Center-Konto zu aktualisieren.
- Verwenden Sie
Assets
ImageAdInfo.media_file
wurde durchImageAdInfo.image_asset
ersetzt, um das Hinzufügen und Entfernen von Bildern mithilfe der Assets zu unterstützen. Aus diesem Grund haben wir auchMediaFileService
entfernt, das nicht mehr benötigt wird.ListingGroupFilterDimension.webpage
wurde hinzugefügt, um das Erstellen eines Eintragsgruppenfilters basierend auf benutzerdefinierten Labels und URL-Teilstrings zu unterstützen.- Außerdem wurde
AssetGroupListingGroupFilter.vertical
durchAssetGroupListingGroupFilter.listing_source
undListingGroupFilterListingSource
ersetzt
- Außerdem wurde
asset_group_asset.source
wurde hinzugefügt, um die Quelle des Assets der Asset-Gruppe anzuzeigen.ad_group_ad_asset_view.source
wurde hinzugefügt, um die Quelle des Anzeigen-Assets der Anzeigengruppe zu sehen.
Zielgruppen
- Für den Kundenabgleich wurde
CustomerMatchUserListMetadata.consent
hinzugefügt, um das Erteilen einer Einwilligung zu unterstützen. Ab dem 6. März 2024 wird bei fehlenden Einwilligungen von Nutzern im EWR „Nicht eingewilligt“ als Einwilligungswert festgelegt. Daten von Nutzern im EWR, die keine Einwilligung erteilt haben, werden nicht verarbeitet und können nicht für personalisierte Anzeigen über den Kundenabgleich verwendet werden. Weitere Informationen finden Sie in unserem Leitfaden zum Kundenabgleich. - Für Ladenverkäufe wurde
UserData.consent
hinzugefügt, um die Einwilligung zu erteilen. Weitere Informationen finden Sie in unserem Leitfaden für Ladenverkäufe. Wenn Sie den Kundenabgleich für Ladenverkäufe verwenden, finden Sie weitere Informationen in den FAQs. UserList.lookalike_user_list
wurde hinzugefügt, um das Erstellen eines Ähnlichen Segments zu unterstützen. Das ist eine Zielgruppe, die auf Grundlage der angegebenen Quellzielgruppe erstellt wird. Ähnliche Segmente können nur in einer Demand Gen-Kampagne verwendet werden.
Kampagnen
Änderungen bei Performance Max-Kampagnen:
- In
AssetGroupSignal
werden jetzt zwei Signaltypen unterstützt, die einer Asset-Gruppe zugewiesen werden können, um die Ausrichtung zu optimieren:AssetGroupSignal.audience
Audience.scope
undAudience.asset_group
wurden hinzugefügt, um die Zielgruppennutzung auf eine bestimmte Asset-Gruppe zu beschränken.Audience.asset_group
muss nur festgelegt werden, wennAudience.scope
gleichASSET_GROUP
ist.
AssetGroupSignal.search_theme
CriterionType.SEARCH_THEME
wurde hinzugefügt, um diesen neuen Kriteriumstyp zu unterstützen. Dieser neue Kriteriumstyp kann nur in Performance Max-Kampagnen verwendet werden, um einAssetGroupSignal
zu erstellen. Dazu mussAssetGroupSignal.search_theme
einSearchThemeInfo
-Kriterium enthalten.
AssetGroupSignalOperation.exempt_policy_violation_keys
wurde hinzugefügt, um das Anfordern einer Ausnahme beim Hinzufügen von Asset-Gruppensignalen zu unterstützen.- Es wurde ein neuer
asset_group_top_combination_view
hinzugefügt, um die leistungsstärksten Assets auf Asset-Gruppenebene zu erfassen. asset_group
kann jetzt mit Messwertfeldern abgefragt werden, um das Abrufen der Leistung einer Performance Max-Kampagne zu unterstützen.- In
PerformanceMaxUpgradeStatus
wurdeUPGRADE_ELIGIBLE
inUPGRADE_ELIGIBLE
umbenannt.
- In
Bei Demand Gen- und Discovery-Kampagnen mit Ziel-CPA wird in den Simulationen für Ziel-CPA-Gebote auf Kampagnenebene (
campaign_simulation.target_cpa_point_list.points
) jetztTargetCpaSimulationPoint.interactions
stattTargetCpaSimulationPoint.clicks
zurückgegeben.BrandSuggestionService
wurde hinzugefügt, die Marken anhand des angegebenen Markenpräfixes und der ausgeschlossenen Markenliste vorschlagen kann. Mit diesen Marken können Sie einBRAND
-Kriterium erstellen, einem freigegebenenBRANDS
-Satz hinzufügen und dann mit einer Kampagne verknüpfen, indem Sie einCampaignCriterion
erstellen, bei dembrand_list
dem freigegebenen Satz zugewiesen ist. Die Kampagnenkriterien können in Suchkampagnen ausgerichtet und in Performance Max-Kampagnen ausgeschlossen werden.- Felder:
- Aufzählungen:
Campaign.asset_automation_settings[]
wurde hinzugefügt, um den Automatisierungsstatus jedes Asset-Typs anzuzeigen.Der Aufzählung
CampaignPrimaryStatusReason
wurden die folgenden Werte hinzugefügt:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversions
CallConversion.consent
undClickConversion.consent
wurden hinzugefügt, um das Bereitstellen einer Einwilligung zu unterstützen. Weitere Informationen finden Sie in unserem Leitfaden zu Anruf-Conversions und dem Leitfaden zu Klick-Conversions.- Die folgenden Felder für SKAdNetwork wurden hinzugefügt, die bei Abfragen mit
customer
odercampaign
verfügbar sind: metrics.sk_ad_network_conversions
wurde durchmetrics.sk_ad_network_installs
ersetzt.- Unterstützung für die Diagnose von Offline-Conversion-Uploads wurde hinzugefügt.
offline_conversion_upload_client_summary
wurde aus einem Feld in der Ressourcecustomer
in einen Bericht auf oberster Ebene verschoben. In diesem Bericht finden Sie nützliche Details zum Conversion-Upload-Status, z. B. die Anzahl der erfolgreichen Ereignisse, die Erfolgsquote und den Fehlerprozentsatz.- Warnung: Eine hochgeladene Conversion, die einen
ConversionUploadError.CLICK_NOT_FOUND
-Fehler auslöst, wird zwar als erfolgreich gezählt, wird aber alsOfflineConversionAlert
gekennzeichnet.
- Warnung: Eine hochgeladene Conversion, die einen
job_id
wurde als optionaler Parameter für die folgenden Anfragetypen hinzugefügt, sodass Sie mehrere Uploadanfragen logisch zu einem einzigen konzeptionellen Job gruppieren können:INVALID_JOB_ID
zu folgenden Fehlern hinzugefügt:INVALID_CONVERSION_ACTION
wurde durchNO_CONVERSION_ACTION_FOUND
undINVALID_CONVERSION_ACTION_TYPE
in den folgenden Fehlern ersetzt:
- Es wurden drei Berichte zur Unterstützung der netzwerkübergreifenden Attribution der Android Privacy Sandbox ohne Weiterleitungen hinzugefügt:
android_privacy_shared_key_google_campaign
, dershared_campaign_key
und einige Felder zum Codieren des Schlüssels enthält.android_privacy_shared_key_google_ad_group
, dershared_ad_group_key
und einige Felder zum Codieren des Schlüssels enthält.android_privacy_shared_key_google_network_type
, dershared_network_type_key
und einige Felder zum Codieren des Schlüssels enthält.
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
wurde hinzugefügt. EinConversionActionOperation
, der versucht, eines der eingestellten regelbasierten Attributionsmodelle zu verwenden, schlägt jetzt mit diesem Fehler fehl. Zuvor schlug der Vorgang mit dem FehlerUNKNOWN
fehl.
Hotels und Reisen
- Die folgenden Felder in
travel_activity_group_view
undtravel_activity_performance_view
werden jetzt unterstützt:- Segmente:
- Messwerte:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
Google Lokale Dienstleistungen
LocalServicesSettings
und die zugehörigen Felder wurden demcustomer
-Bericht hinzugefügt, um die detaillierten Lizenz- und Versicherungsstatus eines Werbetreibenden für lokale Dienstleistungen zurückzugeben.- Folgende neue Berichte für Lokale Dienstleistungen wurden hinzugefügt:
local_services_lead
enthält alle Details zu Anfragen für Google Lokale Dienstleistungen, z. B.lead_charged
,lead_type
,lead_status
.- Aufzählungen:
local_services_lead_conversation
enthält Details zu Nachrichten und Telefongesprächen wieconversation_channel
,call_duration_millis
,call_recording_url
.- Die URL für die Anrufaufzeichnung wird anhand des Zielkundenkontos und seiner Verwaltungskonten authentifiziert.
local_services_verification_artifact
gibt die Artefakte eines Werbetreibenden für Google Lokale Dienstleistungen zurück, z. B. Zuverlässigkeitsüberprüfungen, Gewerbelizenzen und Versicherungsdaten. Alle Dokumente im Zusammenhang mit Lizenz und Versicherung können über eine URL aufgerufen werden.
Planung
- Unterstützung für die Rückgabe von
Forecast.views
undPlannedProductForecast.views
fürReachPlanService.ListPlannableProducts
für entsprechende Produkttypen wurde hinzugefügt. - Unterstützung für die Rückgabe von
PlannableTargeting.surface_targeting
fürReachPlanService.ListPlannableProducts
, das die verfügbaren Oberflächen für ein Produkt beschreibt, wurde hinzugefügt. - Eine neue
ReachPlanSurface
-Enum wurde hinzugefügt. - Die Ausrichtung auf Zielhäufigkeit mit
AdvancedProductTargeting.target_frequency_settings
, dasPlannedProductForecast.average_frequency
zurückgibt, wird jetzt unterstützt. AudienceInsightsService.GenerateSuggestedTargetingInsights
wurde hinzugefügt, um vorgeschlagene Zielgruppen zurückzugeben.- Folgende Werte wurden zu
ReachPlanError
hinzugefügt:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Empfehlungen
RecommendationSubscriptionService
wurde hinzugefügt, um Empfehlungsabos zu verwalten:- Folgende Arten von Empfehlungen wurden hinzugefügt:
FORECASTING_SET_TARGET_CPA
: Hier wird empfohlen, einen Ziel-CPA für Kampagnen, für die kein Ziel-CPA angegeben ist, vor einem saisonalen Ereignis festzulegen, das voraussichtlich den Traffic erhöhen wird.SET_TARGET_CPA
. Es wird empfohlen, einen Ziel-CPA für Kampagnen festzulegen, für die kein Ziel-CPA angegeben ist.SET_TARGET_ROAS
: Es wird empfohlen, einen Ziel-ROAS für Kampagnen festzulegen, für die kein Ziel-ROAS angegeben ist.
Berichterstellung
- Folgende neue Messwerte wurden hinzugefügt, die mit
campaign
(verfügbar für Display-, Video-, Discovery- und App-Kampagnen) undsegments.device
abgefragt werden können:
Shopping
ShoppingSetting.sales_country
wurde entfernt. Dessen Werte werden jetzt alsShoppingSetting.feed_label
zurückgegeben.- Über das Feld
ShoppingSetting.feed_label
können Sie weiterhin einen bestimmten Merchant Center-Feed für eine Kampagne verwenden. Hier sollte der Wert des Feedlabels oder der aus zwei Buchstaben bestehende Ländercode festgelegt werden, der zuvor fürShoppingSetting.sales_country
verwendet wurde. Weitere Informationen finden Sie im Supportartikel zu Feedlabels.
- Über das Feld
- Die Abhängigkeit von Produktkategorien von einem Ländercode in Berichten wurde entfernt.
Die Gruppe der unterstützten Kategorie-IDs hat sich nicht geändert.
- Die folgenden Felder in
shopping_performance_view
wurden ersetzt:segments.product_bidding_category_level1
mitsegments.product_category_level1
segments.product_bidding_category_level2
mitsegments.product_category_level2
segments.product_bidding_category_level3
mitsegments.product_category_level3
segments.product_bidding_category_level4
mitsegments.product_category_level4
segments.product_bidding_category_level5
mitsegments.product_category_level5
product_bidding_category_constant
wurde durchproduct_category_constant
ersetzt, um alle verfügbaren Lokalisierungen einer Kategorie in einem wiederkehrenden Feld zurückzugeben.ListingDimensionInfo.product_bidding_category
wurde durchListingDimensionInfo.product_category
ersetzt.ListingGroupFilterDimension.product_bidding_category
wurde durchListingGroupFilterDimension.product_category
ersetzt.
- Die folgenden Felder in
- Die Unterstützung für das Hinzufügen von
Campaign.shopping_setting
zu Suchkampagnen wurde entfernt. Wenn Sie versuchen, eine Suchkampagne mitCampaign.shopping_setting
zu erstellen oder einer vorhandenen SuchkampagneCampaign.shopping_setting
hinzuzufügen, wird jetztOPERATION_NOT_PERMITTED_FOR_CONTEXT
zurückgegeben. - Die Unterstützung für das Hinzufügen von
CampaignCriterion.listing_scope
zu Suchkampagnen wurde entfernt. Wenn Sie versuchen, einer bestehenden SuchkampagneCampaignCriterion.listing_scope
hinzuzufügen, führt dies jetzt zuOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Folgende Messwerte für Conversions mit Warenkorbdaten wurden hinzugefügt:
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- Alle diese Messwerte können in den folgenden Berichten ausgewählt werden:
Einheitliche Ziele
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
wurde hinzugefügt, um Zielvorhaben für die Kundenakquisition auf Kundenebene zu konfigurieren.- Bericht:
customer_lifecycle_goal
- Bericht:
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
wurde hinzugefügt, um Zielvorhaben für die Kundenakquisition auf Kampagnenebene zu konfigurieren.- Bericht:
campaign_lifecycle_goal
- Bericht:
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
wurde hinzugefügt.- Folgende Werte wurden zu
ConversionGoalCampaignConfigError
hinzugefügt:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Videos
- Die Ausrichtung auf Google TV auf Kampagnenebene wird jetzt unterstützt:
NetworkSettings.target_google_tv_network
wurde hinzugefügtAdNetworkType.GOOGLE_TV
wurde hinzugefügt.
- Die Ausrichtung auf YouTube auf Kampagnenebene wird jetzt unterstützt:
NetworkSettings.target_youtube
wurde hinzugefügt- In
AdNetworkType
wurdenYOUTUBE_WATCH
undYOUTUBE_SEARCH
zuYOUTUBE
zusammengeführt. CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
wurde hinzugefügt.
Version 14.1.0 (9. August 2023)
Die folgenden neuen Funktionen und Updates wurden in Version 14.1 eingeführt.
Kontoverwaltung
Customer.customer_agreement_setting
– gibt an, ob der Kunde die Nutzungsbedingungen für das Lead-Formular akzeptiert hat
Assets
- Neue Felder in
AssetGroup
, die Aufschluss darüber geben, ob die Asset-Gruppe bereitgestellt wird oder warum sie nicht bereitgestellt wird:primary_status
primary_status_reasons
- Neue Felder in
AssetGroupAsset
, die Aufschluss darüber geben, ob das Asset der Asset-Gruppe ausgeliefert wird oder warum es nicht ausgeliefert wird:primary_status
primary_status_details
primary_status_reasons
- Neue Werte in der Aufzählung
CallToActionType
:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
- Neue Werte in der
AssetLinkError
-Enum:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
Abrechnung
- Neue Felder in
Invoice
undAccountSummary
:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
Kampagnen
Neue Werte in der
CampaignPrimaryStatusReason
-Enum:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(Nur Konten auf der Zulassungsliste)
DiscoveryCampaignSettings
mitupgraded_targeting
:- Wenn
upgraded_targeting
auftrue
gesetzt ist, können Sie einen Standort und eine Sprache als Anzeigengruppenkriterium hinzufügen
- Wenn
Kriterien
Neuer enum-Wert:
CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(Nur Konten auf der Zulassungsliste) Unterstützung für das Hinzufügen von
LanguageInfo
undLocationInfo
alsAdGroupCriterion
:- Diese Option ist nur für Discovery-Kampagnen mit aktivierter aktualisierter Ausrichtung verfügbar
Tests
- Neue Werte in der
ExperimentError
-Enum:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
Empfehlungen
- Neue Arten von Empfehlungen:
PerformanceMaxOptInRecommendation
. Hier wird empfohlen, die erste Performance Max-Kampagne im Konto zu erstellen.ImprovePerformanceMaxAdStrengthRecommendation
. Hier wird empfohlen, die Stärke der Asset-Gruppe einer Performance Max-Kampagne zu verbessern.MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
: Hier wird empfohlen, eine Kampagne mit dynamischen Suchanzeigen zu einer Performance Max-Kampagne zu migrieren
Berichterstellung
- Neue Messwerte und Segmente zu neuen und wiederkehrenden Kunden:
- Neue
customer_search_term_insight
- undcampaign_search_term_insight
-Ansichten:- Mit
metrics.search_volume
wird der Volumenbereich für die Statistikkategorie zu Suchbegriffen angezeigt.
- Mit
Shopping
- Neue Felder für Eintragsgruppen:
- Neues Feld:
ShoppingSetting.advertising_partner_ids
- Neue Werte in der
CampaignError
-Enum:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
Videos
- (nur Konten, die auf der Zulassungsliste stehen)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
und die zugehörigeDiscoveryVideoResponsiveAdInfo
Version 14 (07.06.2023)
Die folgenden neuen Funktionen und Updates wurden in Version 14 eingeführt.
Kampagnen
CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD
wurde hinzugefügt
Conversions
Unterstützung für die Identifizierung von Google Analytics-Conversions und die Ermittlung, ob eine Conversion aus einer Universal Analytics- oder GA4-Property importiert wird:
- Folgende Werte wurden zu
ConversionActionType
hinzugefügt:UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
ConversionAction.google_analytics_4_settings
wurde hinzugefügt
- Folgende Werte wurden zu
Customer.offline_conversion_client_summaries
wurde hinzugefügt, in dem die Status- und Diagnosedaten der Offline-Conversion-Uploads und -Anpassungen des Kunden zusammengefasst werden.- Aufzählungen
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- Aufzählungen
Den Antworten von
ConversionAdjustmentUploadService.UploadConversionAdjustments
undConversionUploadService.UploadClickConversions
zum Verknüpfen einer Antwort mit einemOfflineConversionUploadSummary.job_id
wurdejob_id
hinzugefügt.
Kriterien
Unterstützung zum Abrufen, Erstellen und Aktualisieren von auszuschließenden Keywords auf Kontoebene wurde hinzugefügt:
- Felder:
- Aufzählungen:
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- Fehler:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST
wurde hinzugefügt
Hotelanzeigen
SuggestTravelAssetsRequest.place_id
wurde inSuggestTravelAssetsRequest.place_ids
umbenannt
Planung
- Folgende Methoden wurden aus
KeywordPlanService
entfernt:GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
wurde hinzugefügt, um Prognosemesswerte für Keyword-Kampagnen zu generieren, ohne zuerst einen Keyword-Plan erstellen zu müssen.- Keine Unterstützung mehr zum Abrufen des Berichts „
campaign_criterion_simulation
“ - Die Unterstützung für
YOUTUBE_DYNAMIC_LINEUP
als Dimension inAudienceInsightsService.ListAudienceInsightsAttributes
wurde hinzugefügt. DynamicLineupAttributeMetadata.sample_channels
wurde hinzugefügt. Es wird inGenerateAudienceCompositionInsights
-Antworten verwendet, um Beispielkanäle in Paketen bereitzustellen.
Empfehlungen
DynamicImageExtensionOptInRecommendation
wurde hinzugefügt. Dort wird empfohlen, dynamische Bilderweiterungen im Konto zu aktivieren.LowerTargetRoasRecommendation
hinzugefügt, das empfiehlt, den Ziel-ROAS zu senkenRaiseTargetCpaRecommendation
wurde hinzugefügt, in der empfohlen wird, den Ziel-CPA zu erhöhenResponsiveSearchAdAssetRecommendation.current_ad
wurde hinzugefügt
Berichterstellung
- Folgende Werte wurden zu
ServedAssetFieldType
hinzugefügt, die inad_group_ad_asset_view.pinned_field
verfügbar sind:SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
Archivierte Versionshinweise
Archivierte Versionshinweise finden Sie unter Nicht mehr unterstützte Versionen.