Version 17 (05.06.2024)
Die folgenden Funktionen und Änderungen wurden in Version 17 hinzugefügt.
Anzeigen
AdService.getAd
wurde entfernt. Damit entsprichtAdService
den anderen Diensten in der Google Ads API. Die empfohlene Methode zum Abrufen von Anzeigen und anderen Ressourcentypen finden Sie unter Objekte abrufen.- Es wurden weitere Validierungen für
ImageAdInfo.image_asset
bezüglich Dimensionen und Format hinzugefügt. Bei einem ungültigen Image können folgende Fehler ausgegeben werden:
Assets
- Neue Aufzählung hinzugefügt:
ClickType.AD_IMAGE
- Die folgenden neuen Berichte mit neuen Messwerten für Performance Max-Kampagnen und Suchkampagnen wurden hinzugefügt:
Zielgruppen
Batchjobs
- Es wurde
BatchJobError.REQUEST_TOO_LARGE
hinzugefügt, das ausgelöst wird, wenn das eingereichteAddBatchJobOperationsRequest
-Element größer als 10484.504 Byte ist. - Die Einstellung von
MutateOperation.asset_group_operation
bei der Verwendung vonBatchJobService
wird jetzt unterstützt. So können Sie die Batchverarbeitung verwenden, um ganze Performance Max-Kampagnen zu erstellen und zu verwalten. Weitere Informationen finden Sie in unserem neuen Leitfaden.
Kampagnen
- „Discovery“ wurde in allen Feldern, Aufzählungen und Fehlern aller Ressourcen in der Google Ads API, wie Kampagnen, Anzeigen und Assets, in „Demand Gen“ umbenannt. Beispiel:
AdvertisingChannelType.DISCOVERY
ist jetztAdvertisingChannelType.DEMAND_GEN
. Campaign.keyword_match_type
wurde hinzugefügt, damit Sie die Keyword-Option für alle Keywords in einer Kampagne festlegen können.
Conversions
- Für SKAdNetwork-Conversions
segments.sk_ad_network_conversion_value
wurde insegments.sk_ad_network_fine_conversion_value
umbenannt.segments.sk_ad_network_redistributed_fine_conversion_value
wurde hinzugefügt.
- Die folgenden Messwerte werden jetzt mit der Antwort zurückgegeben, auch wenn sie null sind. Dadurch stimmen sie mit anderen Messwerten überein.
Kriterien
- In die folgenden Felder in
AdGroupCriterion
eingefügt, um zu sehen, ob das Kriterium für die Anzeigengruppe ausgeliefert wird oder warum es nicht ausgeliefert wird:primary_status
primary_status_reasons
- Unterstützung für
metrics.search_impression_share
fürgender_view
hinzugefügt - Unterstützung für
metrics.phone_calls
fürkeyword_view
hinzugefügt
Lokale Dienstleistungen
LocalServicesLeadService.AppendLeadConversation()
wurde hinzugefügt, um eine neueLocalServicesLeadConversation
anLocalServicesLead
anzufügen, die die Nachrichten an Nutzer über entsprechende Kanäle wie SMS sendet, je nachdem, wie der Lead erstellt wurde.- Die Größe von
AppendLeadConversationRequest.conversations
ist auf 1.000 begrenzt. - Nur
LocalServicesLead
, für dielead_type
aufLeadType.MESSAGE
gesetzt ist, kann inConversation.local_services_lead
angegeben werden.
- Die Größe von
- Neue Aufzählungswerte zu
ConversationType
hinzugefügt:WHATSAPP
steht für eine über WhatsApp gestartete Unterhaltung.ADS_API
steht für eine Unterhaltung, die mit der neuen MethodeLocalServicesLeadService.AppendLeadConversation()
eingeführt wurde.
- Die folgenden neuen Felder wurden zu
local_services_verification_artifact
hinzugefügt:local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
Berichterstellung
- Sie können jetzt bei der Abfrage von
product_link
nur Felder auswählen, die sich auf ein verknüpftes Produkt beziehen. Wenn Sie mehrere Felder mehrerer verknüpfter Produkte auswählen, wirdQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
ausgegeben. Beispielsweise könnenproduct_link.advertising_partner.customer
undproduct_link.data_partner.data_partner_id
nicht in derselben Abfrage ausgewählt werden. - Die Übergabe von
page_size
anGoogleAdsService.Search
führt zum FehlerRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Shopping
- Es wurde ein neuer Bericht
shopping_product
hinzugefügt, der der Seite Produkte in der Google Ads-Benutzeroberfläche entspricht. Sie unterstützt die Rückgabe von Daten zum aktuellen Status von Produkten aus Google Merchant Center-Konten, die mit einem Google Ads-Konto verknüpft sind.- Sie können Messwerte aus dem Bericht
shopping_product
mitsegments.date
filtern, wenn SieGoogleAdsService.Search
oderGoogleAdsService.SearchStream
verwenden. Eine Segmentierung nach Datum ist nicht zulässig und gibt den FehlerShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
zurück.
- Sie können Messwerte aus dem Bericht
Einheitliche Ziele
UserListCustomerTypeService.MutateUserListCustomerTypes()
wurde zum Konfigurieren von Zielgruppenkundentypen hinzugefügt.CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
wurde entfernt. Wenn Sie Zielgruppeneinstellungen von Zielvorhaben für den Kundenlebenszyklus konfigurieren möchten, verwenden Sie stattdessenUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Um eine Nutzerliste hinzuzufügen oder zu trennen, setzen Sie
UserListCustomerType.customer_type_category
aufUserListCustomerTypeCategory.PURCHASERS
, um sie in eine bestehende Kundendefinition für Zielvorhaben für den Kundenlebenszyklus aufzunehmen oder daraus auszuschließen. Weitere Informationen finden Sie unter Zielgruppen segmentieren.
- Um eine Nutzerliste hinzuzufügen oder zu trennen, setzen Sie
Videos
- Die folgenden Werte wurden
ContentLabelType
hinzugefügt. Sie können dieseContentLabelTypes
auf Kundenebene ausschließen:BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
AdVideoAsset.ad_video_asset_info
wurde hinzugefügt, um die Inventareinstellungen für Video-Assets beim Erstellen vonDemandGenVideoResponsiveAdInfo
zu unterstützen.- (Nur Konten auf der Zulassungsliste)
Campaign.video_brand_safety_suitability
wurde änderbar.
Version 16.1.0 (24.04.2024)
Die folgenden Funktionen und Änderungen wurden in Version 16.1 hinzugefügt.
Kontoverwaltung
CustomerNegativeCriterion.ip_block
unterstützt das Hinzufügen einer IP-Adresse als negatives Kriterium auf Kundenebene.- Neuer Enum-Wert:
ProductLinkError.LINK_EXISTS
. - Neuer Enum-Wert:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Assets
- Unterstützung für Assets im Zusammenhang mit 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
, der die Anzahl der Listen mit ähnlichen Nutzern, die ein Kunde haben kann, auf 1.000 begrenzt.
Kampagnen
- Unterstützung für die Rückgabe von Ziel-ROAS-Gebotssimulationen für App-Kampagnen mithilfe des
campaign_simulation
-Berichts. - 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
unterstützt SKAdNetwork 4.0-Funktionen.- Unterstützung für Warnungen für
CustomerSkAdNetworkConversionValueSchemaService
alsMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
wurde hinzugefügt. Wenntrue
festgelegt 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 Status der Zuordnung bzw. den Zeitstempel für die Aktualisierung des Guthabenstatus zurückgeben.local_services_lead_conversation.message_details.attachment_urls
gibt die URLs zurück, die zum Herunterladen des Inhalts des Anhangs verwendet werden können.
Videos
customer.video_brand_safety_suitability
undBrandSafetySuitability
unterstützen das Abrufen der Eignung für Markensicherheit von Videos auf Kundenebene.- Neuer enum-Wert:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
Version 16 (21.02.2024)
Die folgenden Funktionen und Änderungen wurden in Version 16 hinzugefügt.
Kontoverwaltung
advertising_partner
wurde vonAccountLink
zuProductLink
undProductLinkInvitation
migriert.data_partner
undgoogle_ads
wurden ausAccountLink
entfernt.IdentityVerificationService
wurde hinzugefügt, um die Überprüfung des Werbetreibenden zu verwalten.StartIdentityVerification()
wird verwendet, um eine Überprüfungssitzung mit dem angegebenenverification_program
zu starten. Es wird eine neue Bestätigungssitzung erstellt und für eine erfolgreich erstellte Überprüfung eine leere Antwort zurückgegeben.IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
wurde hinzugefügt.
GetIdentityVerification()
kann zum Abrufen von Bestätigungsinformationen verwendet werden, die mehrere Objekte vonIdentityVerification
zurückgeben. JedesIdentityVerification
enthält Folgendes:verification_program
(der Typ des Programms zur Identitätsbestätigung)identity_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 Verifizierungssitzung.action_url
leitet den Kunden an eine URL weiter, um die Bestätigung abzuschließen.invitation_link_expiration_time
steht für das Ablaufdatum füraction_url
.
- Aufzählungen:
- Fehler:
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
wurde hinzugefügt.
Assets
- Änderungen an
asset_group
:- Unterstützung für zeitbezogene Segmente wie
segments.year
undsegments.month
wurde hinzugefügt. campaign
wurde als zugeordnete Ressource erstellt, anstatt sie zu segmentieren.
- Unterstützung für zeitbezogene Segmente wie
Kampagnen
- Änderungen an Demand Gen-Kampagnen:
- Das Festlegen von
Campaign.shopping_setting
für eine vorhandene Demand Gen-Kampagne wird jetzt unterstützt. ShoppingSetting.disable_product_feed
wurde hinzugefügt, um den optionalen Produktfeed von Demand Gen-Kampagnen zu deaktivieren.- Es wurden
Ad.demand_gen_product_ad
und die entsprechendeDemandGenProductAdInfo
hinzugefügt, die für Demand Gen-Kampagnen mit einemCampaign.shopping_setting
ungleich null verfügbar ist.
- Das Festlegen von
- In die folgenden Felder in
AdGroup
eingefügt, um zu sehen, ob Anzeigen aus der Anzeigengruppe ausgeliefert werden oder warum sie nicht ausgeliefert wird:primary_status
primary_status_reasons
- In die folgenden Felder in
AdGroupAd
eingefügt, um anzugeben, ob die Anzeige aus der Anzeigengruppe ausgeliefert wird oder warum sie nicht ausgeliefert wird:primary_status
primary_status_reasons
- Die folgenden Werte wurden
AdGroupError
hinzugefügt:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Experiment
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 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
- Der
ListingDimensionInfo
für eine Anzeige mit möglichen Aktivitäten wurden die folgenden Felder hinzugefügt, um das Erstellen von Eintragsgruppen basierend auf dem Bundesland und der Stadt zu ermöglichen, in denen die Reiseaktivität verfügbar ist: - Die folgenden Segmente werden jetzt in
travel_activity_performance_view
unterstützt:
Lokale Dienstleistungen
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
undBusinessRegistrationCheckArtifact
wurden hinzugefügt, damit Werbetreibende den Fortschritt der Überprüfung der Gewerbeanmeldung beobachten können.- Die neue Ressource
local_services_employee
wurde hinzugefügt, damit Werbetreibende die hinzugefügten Mitarbeiterinformationen abrufen können.
Planung
score
wurde ausAudienceInsightsAttributeMetadata
entfernt.
Empfehlungen
RecommendationService.GenerateRecommendations()
wurde hinzugefügt, mit dem Empfehlungen basierend auf den angegebenen Einstellungen zurückgegeben werden, z. B. Empfehlungstypen und Werbekanaltypen. Das ist besonders beim Erstellen von Kampagnen hilfreich.RecommendationMetrics.conversions_value
wurde hinzugefügt.- Für empfohlene Keywords mit nicht festgelegter Keyword-Option wird jetzt für
recommended_match_type
UNSPECIFIED
anstelle vonUNKNOWN
festgelegt. - Die folgenden Arten von Empfehlungen wurden hinzugefügt:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
, der empfohlen wird, die Gebotsstrategie „Conversion-Wert maximieren“ zu aktivierenIMPROVE_GOOGLE_TAG_COVERAGE
– es wird empfohlen, das Google-Tag auf mehr Seiten zu implementierenPERFORMANCE_MAX_FINAL_URL_OPT_IN
, wobei empfohlen wird, die Erweiterung der finalen URL für Ihre Performance Max-Kampagnen zu aktivierenREFRESH_CUSTOMER_MATCH_LIST
empfiehlt, eine Kundenliste zu aktualisieren, die in den letzten 90 Tagen nicht aktualisiert wurde.CUSTOM_AUDIENCE_OPT_IN
– empfiehlt das Erstellen einer benutzerdefinierten ZielgruppeLEAD_FORM_ASSET
– es wird empfohlen, Assets mit Lead-Formular auf Kampagnen- oder Kundenebene hinzuzufügenIMPROVE_DEMAND_GEN_AD_STRENGTH
, der empfohlen wird, die Anzeigeneffektivität bei 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 anzugeben, die mit einem Comparison Shopping Service Center-Konto verknüpft sind.- Die folgenden Werte wurden
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 zu vereinheitlichen.
Version 15 (18.10.2023)
In Version 15 wurden die folgenden neuen Funktionen und Aktualisierungen 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 für das 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 das Aktualisieren einer Verknüpfungseinladung von anderen Produkten zu unterstützen, die für Hotel Center- und Merchant Center-Konten verfügbar sind.MerchantCenterLinkService
wurde entfernt.- Wenn Sie Google Ads-Konten mit Merchant Center-Konten verknüpfen möchten, verwenden Sie
ProductLinkInvitationService
undProductLinkService
.
- Wenn Sie Google Ads-Konten mit Merchant Center-Konten verknüpfen möchten, verwenden Sie
AccountLink.hotel_center
und die Unterstützung zum Aktualisieren von Verknüpfungseinladungen aus Hotel Center-Konten mitAccountLinkService
wurden entfernt.- Wenn Sie eine Einladung zur Verknüpfung aus einem Hotel Center-Konto aktualisieren möchten, verwenden Sie
ProductLinkInvitationService
.
- Wenn Sie eine Einladung zur Verknüpfung aus einem Hotel Center-Konto aktualisieren möchten, 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. Daher haben wir auch die nicht mehr benötigteMediaFileService
entfernt.ListingGroupFilterDimension.webpage
wurde hinzugefügt, um das Erstellen eines Filter für Eintragsgruppen 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 Asset-Gruppen-Assets anzuzeigen.ad_group_ad_asset_view.source
wurde hinzugefügt, um die Quelle des Anzeigen-Assets der Anzeigengruppe aufzurufen.
Zielgruppen
- Für den Kundenabgleich wurde
CustomerMatchUserListMetadata.consent
hinzugefügt, um die Einwilligung zu ermöglichen. Ab dem 6. März 2024 gilt: Wenn keine Einwilligung für Nutzer im EWR vorliegt, wird für den Einwilligungswert „Nicht eingewilligt“ festgelegt. Daten von Nutzern im EWR, die keine Einwilligung erteilt haben, werden nicht verarbeitet und können nicht über den Kundenabgleich für personalisierte Anzeigen verwendet werden. Weitere Informationen - Für Ladenverkäufe wurde
UserData.consent
hinzugefügt, um die Einwilligung zu unterstützen. Weitere Informationen finden Sie in unserem Leitfaden für Ladenverkäufe. Wenn Sie den Kundenabgleich für Ladenverkäufe verwenden, finden Sie in den FAQs weitere Informationen. UserList.lookalike_user_list
wurde hinzugefügt, um ein ähnliches Segment zu erstellen. Dabei handelt es sich um eine Zielgruppe, die anhand der angegebenen Quellzielgruppe erstellt wurde. Ä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 hinzugefügt 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 dann festgelegt werden, wennAudience.scope
aufASSET_GROUP
gesetzt 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 eineAssetGroupSignal
zu erstellen. Dazu mussAssetGroupSignal.search_theme
mit einemSearchThemeInfo
-Kriterium ausgefüllt werden.
AssetGroupSignalOperation.exempt_policy_violation_keys
wurde hinzugefügt, um beim Hinzufügen von Signalen für Asset-Gruppen eine Ausnahme zu beantragen.- Eine neue
asset_group_top_combination_view
wurde hinzugefügt, um Berichte zu den leistungsstärksten Assets auf Asset-Gruppenebene zu erstellen. 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
Für 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
anstelle vonTargetCpaSimulationPoint.clicks
zurückgegeben.BrandSuggestionService
wurde hinzugefügt. Damit können Marken anhand des angegebenen Markenpräfixes und der ausgeschlossenen Markenliste vorgeschlagen werden. Mit diesen Marken können Sie einBRAND
-Kriterium erstellen, einem freigegebenenBRANDS
-Satz hinzufügen und es dann mit einer Kampagne verknüpfen. Erstellen Sie dazu eineCampaignCriterion
, bei derbrand_list
den freigegebenen Satz aufweist. Die Kampagnenkriterien können in Suchkampagnen ausgerichtet bzw. in Performance Max-Kampagnen ausgeschlossen werden.- Felder:
- Aufzählungen:
Campaign.asset_automation_settings[]
wurde hinzugefügt, um den Automatisierungsstatus jedes Asset-Typs anzuzeigen.Die folgenden Werte wurden der Aufzählung
CampaignPrimaryStatusReason
hinzugefügt:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversions
CallConversion.consent
undClickConversion.consent
wurden hinzugefügt, um das Einholen einer Einwilligung zu unterstützen. Weitere Informationen finden Sie in unserem Leitfaden zu Anruf-Conversions und im Leitfaden zu Klick-Conversions.- Die folgenden Felder zu SKAdNetwork-Conversions wurden hinzugefügt, die bei Abfragen mit
customer
odercampaign
verfügbar sind: metrics.sk_ad_network_conversions
wurde durchmetrics.sk_ad_network_installs
ersetzt.- Die Diagnose von Offline-Conversion-Uploads wird jetzt unterstützt.
offline_conversion_upload_client_summary
wurde aus einem Feld in der Ressourcecustomer
in einen Bericht auf oberster Ebene verschoben. In diesem Bericht erhalten Sie nützliche Details zum Status des Conversion-Uploads, z. B. die Anzahl der erfolgreichen Ereignisse, die Erfolgsquote und den Fehlerprozentsatz.- Warnung: Eine Conversion, die hochgeladen wird und zu einem
ConversionUploadError.CLICK_NOT_FOUND
-Fehler führt, wird trotzdem als erfolgreich gezählt, aber auch alsOfflineConversionAlert
gekennzeichnet.
- Warnung: Eine Conversion, die hochgeladen wird und zu einem
job_id
wurde als optionaler Parameter für die folgenden Anfragetypen hinzugefügt, damit sich mehrere Uploadanfragen logisch zu einem einzigen konzeptionellen Job zusammenfassen lassen:INVALID_JOB_ID
wurde den folgenden Fehlern hinzugefügt:INVALID_CONVERSION_ACTION
wurde bei folgenden Fehlern durchNO_CONVERSION_ACTION_FOUND
undINVALID_CONVERSION_ACTION_TYPE
ersetzt:
- Es wurden drei Berichte zur Unterstützung der netzwerkübergreifenden Attribution ohne Weiterleitungen der Android Privacy Sandbox ohne Weiterleitungen hinzugefügt:
android_privacy_shared_key_google_campaign
, dershared_campaign_key
und einige Felder zur Codierung des Schlüssels enthält.android_privacy_shared_key_google_ad_group
, dershared_ad_group_key
und einige Felder zur Codierung des Schlüssels enthält.android_privacy_shared_key_google_network_type
, dershared_network_type_key
und einige Felder zur Codierung 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 detaillierte Lizenz- und Versicherungsstatus von Werbetreibenden für Google Lokale Dienstleistungen zurückzugeben.- Für Lokale Dienstleistungen wurden die folgenden neuen Berichte hinzugefügt:
local_services_lead
enthält alle Details zu Google Lokale Dienstleistungen-Leads, z. B.lead_charged
,lead_type
undlead_status
.- Aufzählungen:
local_services_lead_conversation
enthält Details zu Nachrichten und Unterhaltungen, z. B.conversation_channel
,call_duration_millis
undcall_recording_url
.- Die URL zur Anrufaufzeichnung wird gegenüber dem Zielkundenkonto und dessen Verwaltungskonten authentifiziert.
local_services_verification_artifact
gibt Artefakte eines Werbetreibenden für Google Lokale Dienstleistungen zurück, z. B. Zuverlässigkeitsüberprüfung, Unternehmenslizenzen und Unternehmensversicherungsdaten. Alle mit der Lizenz und Versicherung verknüpften Dokumente können über eine URL aufgerufen werden.
Planung
- Die Rückgabe von
Forecast.views
undPlannedProductForecast.views
fürReachPlanService.ListPlannableProducts
für anwendbare Produkttypen wurde hinzugefügt. - Die Rückgabe von
PlannableTargeting.surface_targeting
fürReachPlanService.ListPlannableProducts
wurde hinzugefügt. Darin werden die verfügbaren Oberflächen für ein Produkt beschrieben. - Ein neues
ReachPlanSurface
-Enum wurde hinzugefügt. - Das Targeting auf die Zielhäufigkeit mit
AdvancedProductTargeting.target_frequency_settings
, dasPlannedProductForecast.average_frequency
zurückgibt, wurde hinzugefügt. AudienceInsightsService.GenerateSuggestedTargetingInsights
wurde hinzugefügt, um vorgeschlagene Zielgruppen zurückzugeben.- Die folgenden Werte wurden
ReachPlanError
hinzugefügt:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Empfehlungen
- Der Dienst
RecommendationSubscriptionService
wurde hinzugefügt, der Empfehlungsabos verwaltet: - Die folgenden Arten von Empfehlungen wurden hinzugefügt:
FORECASTING_SET_TARGET_CPA
: Hier wird empfohlen, einen Ziel-CPA für Kampagnen festzulegen, für die noch kein Ziel-CPA festgelegt ist, und zwar vor einem saisonalen Ereignis, durch das voraussichtlich der Traffic steigen wird.SET_TARGET_CPA
. Hier wird empfohlen, für Kampagnen, für die kein Ziel-CPA angegeben ist, einen Ziel-CPA festzulegen.SET_TARGET_ROAS
. Hier wird empfohlen, einen Ziel-ROAS für Kampagnen festzulegen, für die noch keiner 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 jetzt alsShoppingSetting.feed_label
zurückgegeben werden.- Sie können weiterhin einen bestimmten Merchant Center-Feed für eine Kampagne verwenden, indem Sie das Feld
ShoppingSetting.feed_label
verwenden. Es sollte auf den Wert des Feedlabels oder den aus zwei Buchstaben bestehenden Ländercode festgelegt werden, der zuvor fürShoppingSetting.sales_country
verwendet wurde. Weitere Informationen finden Sie im Hilfeartikel zu Feedlabels.
- Sie können weiterhin einen bestimmten Merchant Center-Feed für eine Kampagne verwenden, indem Sie das Feld
- Die Abhängigkeit von Produktkategorien von einem Ländercode in Berichten wurde entfernt.
Der Satz 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, das alle verfügbaren Lokalisierungen einer Kategorie in einem wiederkehrenden Feld zurückgibt.ListingDimensionInfo.product_bidding_category
wurde durchListingDimensionInfo.product_category
ersetzt.ListingGroupFilterDimension.product_bidding_category
wurde durchListingGroupFilterDimension.product_category
ersetzt.
- Die folgenden Felder in
- Das Hinzufügen von
Campaign.shopping_setting
zu Suchkampagnen wird nicht mehr unterstützt. Wenn Sie versuchen, eine Suchkampagne mitCampaign.shopping_setting
zu erstellen oderCampaign.shopping_setting
einer bestehenden Suchkampagne hinzuzufügen, wird jetztOPERATION_NOT_PERMITTED_FOR_CONTEXT
ausgegeben. - Das Hinzufügen von
CampaignCriterion.listing_scope
zu Suchkampagnen wird nicht mehr unterstützt. Wenn Sie versuchen,CampaignCriterion.listing_scope
einer vorhandenen Suchkampagne hinzuzufügen, wird jetztOPERATION_NOT_PERMITTED_FOR_CONTEXT
zurückgegeben. - 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
- Wir haben
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
zum Konfigurieren von Zielvorhaben für die Kundenakquisition auf Kundenebene hinzugefügt.- Bericht:
customer_lifecycle_goal
- Bericht:
- Wir haben
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
zum Konfigurieren von Zielvorhaben für die Kundenakquisition auf Kampagnenebene hinzugefügt.- Bericht:
campaign_lifecycle_goal
- Bericht:
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
wurde hinzugefügt.- Die folgenden Werte wurden
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:
- Hinzugefügt
NetworkSettings.target_google_tv_network
AdNetworkType.GOOGLE_TV
wurde hinzugefügt.
- Hinzugefügt
- Die Ausrichtung auf YouTube wird jetzt auf Kampagnenebene unterstützt:
- Hinzugefügt
NetworkSettings.target_youtube
- In
AdNetworkType
wurdenYOUTUBE_WATCH
undYOUTUBE_SEARCH
mitYOUTUBE
zusammengeführt. CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
wurde hinzugefügt.
- Hinzugefügt
Archivierte Versionshinweise
Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.