Version 17.1.0 (07.08.2024)
Die folgenden neuen Funktionen und Updates wurden in v17_1 hinzugefügt.
Assets
- Mit
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
können Sie bestimmte automatisch erstellte Assets entfernen, die mit responsiven Suchanzeigen verknüpft sind.
Zielgruppen
- Neue enum-Werte in
UserListCustomerTypeCategory
:LOYALTY_TIER_1_MEMBERS
LOYALTY_TIER_2_MEMBERS
LOYALTY_TIER_3_MEMBERS
LOYALTY_TIER_4_MEMBERS
LOYALTY_TIER_5_MEMBERS
LOYALTY_TIER_6_MEMBERS
LOYALTY_TIER_7_MEMBERS
Kampagnen
- Über
ShareablePreviewService.GenerateShareablePreviews()
werden die URLs (shareable_preview_url
in der Antwort) für Vorschauen von Anzeigen, die geteilt werden können, für aktivierte und pausierte Asset-Gruppen generiert.- Im Feld
expiration_date_time
wird das Ablaufdatum der URLs in der Antwort angegeben. - Wenn ein Fehler auftritt, gibt die Methode anstelle der URLs
partial_failure_error
zurück.
- Im Feld
Änderungsverlauf
- Neuer Ressourcentyp für Änderungsstatus:
ASSET_GROUP
.
Conversions
- Neues Segmentfeld für die SKAdNetwork-Version:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
enthält eine Diagnose für den Conversion-Upload auf Ebene der Conversion-Aktion.- Die folgenden Messwerte werden den Offline-Diagnoseberichten hinzugefügt, um die Anzahl der hochgeladenen Conversions anzugeben, die noch verarbeitet werden:
Planung
AudienceInsights.GenerateAudienceOverlapInsights()
akzeptiert ein eingegebenes primäres Attribut und eine Sammlung von Zielgruppenattributen und gibt die Schätzungen der Überschneidung der potenziellen YouTube-Reichweite zwischen dem primären Attribut und den Zielgruppenattributen zurück.
Berichterstellung
- Unterstützung für die Segmentierung von
per_store_view
basierend aufsegments.date
Videos
- Unterstützung zum Abrufen von Informationen zu den folgenden Standard-Gebotsstrategien für Videokampagnen mit Berichten, z. B.
ad_group
,campaign
:Campaign.fixed_cpm
(fester CPM (Cost-per-1000-Impressions))Campaign.target_cpv
(Ziel-CPV (Cost-per-View))
Campaign.video_campaign_settings
, mit dem Sie mithilfe der folgenden Berichtsfelder bestimmen können, in welchem Inventar die Videoanzeigen ausgeliefert werden können:segments.ad_format_type
: Damit können Sie die folgenden Berichte nach Videoanzeigenformattyp segmentieren:
Version 17 (05.06.2024)
Die folgenden Funktionen und Änderungen wurden in Version 17 hinzugefügt.
Anzeigen
AdService.getAd
wurde entfernt. Dadurch wird dieAdService
gemäß anderen Diensten in der Google Ads API Weitere Informationen finden Sie unter Objekte abrufen für die empfohlene Methode zum Abrufen von Anzeigen und anderen Ressourcentypen.- Weitere Validierungen hinzugefügt für
ImageAdInfo.image_asset
bezüglich Dimensionen und Format. Folgende Fehler können auftreten, wenn das Bild ungültig:
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
- Hinzugefügt
BatchJobError.REQUEST_TOO_LARGE
, Dieser wird ausgelöst, wenn der eingereichteAddBatchJobOperationsRequest
größer als 104.845.04 Byte ist. - Die Einstellung
MutateOperation.asset_group_operation
wird jetzt unterstützt. wenn SieBatchJobService
verwenden. So können Sie mithilfe der Batchverarbeitung erstellen und Performance Max-Kampagnen verwalten. Weitere Informationen finden Sie in unserem neuen Leitfaden.
Kampagnen
- „Discovery“ wurde in allen Feldern, Aufzählungen und Fehlern in „Demand Gen“ umbenannt
in der Google Ads API wie Kampagnen, Anzeigen und Assets. Für
Beispiel:
AdvertisingChannelType.DISCOVERY
ist jetztAdvertisingChannelType.DEMAND_GEN
- Hinzugefügt
Campaign.keyword_match_type
Damit können Sie die Keyword-Option für alle Keywords in einer Kampagne festlegen.
Conversions
- Für SKAdNetwork
Conversions
segments.sk_ad_network_conversion_value
wurde umbenannt insegments.sk_ad_network_fine_conversion_value
segments.sk_ad_network_redistributed_fine_conversion_value
wurde hinzugefügt.
- Die folgenden Messwerte werden jetzt mit der Antwort zurückgegeben, auch wenn sind sie null. Dadurch stimmen sie mit anderen Messwerten überein.
Kriterien
- Zu folgenden Feldern in
AdGroupCriterion
hinzugefügt ob das Kriterium für die Anzeigengruppe ausgeliefert wird, oder aus welchen Gründen Bereitstellung:primary_status
primary_status_reasons
- Unterstützung für
metrics.search_impression_share
hinzugefügt fürgender_view
- Unterstützung für
metrics.phone_calls
hinzugefügt fürkeyword_view
Lokale Dienstleistungen
LocalServicesLeadService.AppendLeadConversation()
hinzugefügt zum Anhängen eines neuenLocalServicesLeadConversation
anLocalServicesLead
, wodurch das Ereignis Nachrichten an Nutzer über geeignete Kanäle wie SMS, je nachdem, wie die Lead generiert wurde.- Die Größe von
AppendLeadConversationRequest.conversations
ist begrenzt auf 1.000. - Nur
LocalServicesLead
mitlead_type
festgelegt aufLeadType.MESSAGE
kann in derConversation.local_services_lead
- Die Größe von
- Neue enum-Werte zu hinzugefügt
ConversationType
:WHATSAPP
steht für eine über WhatsApp gestartete Unterhaltung.ADS_API
steht für eine Unterhaltung, die mit dem neuenLocalServicesLeadService.AppendLeadConversation()
.
- 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 nur Felder auswählen, die sich auf ein verknüpftes Produkt beziehen
wenn Sie
product_link
abfragen. Mehrere auswählen mehrerer verknüpfter ProdukteQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
Beispiel:product_link.advertising_partner.customer
undproduct_link.data_partner.data_partner_id
kann nicht in derselben Abfrage ausgewählt werden. - Übergeben von
page_size
anGoogleAdsService.Search
führt zu einerRequestError.PAGE_SIZE_NOT_SUPPORTED
Fehler.
Shopping
- Der neue Bericht
shopping_product
wurde hinzugefügt, entspricht der Seite Produkte der Google Ads-Benutzeroberfläche. Sie können jetzt Daten, die sich auf den aktuellen Status der Produkte aus dem Google Merchant Center beziehen -Konten, die mit einem Google Ads-Konto verknüpft sind.- Sie können Messwerte aus der
shopping_product
-Bericht mitsegments.date
bei VerwendungGoogleAdsService.Search
oderGoogleAdsService.SearchStream
Eine Segmentierung nach Datum ist nicht zulässig und es wird einShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
Fehler.
- Sie können Messwerte aus der
Einheitliche Ziele
UserListCustomerTypeService.MutateUserListCustomerTypes()
hinzugefügt um Zielgruppenkunden .CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
wurde entfernt. Wenn Sie die Zielgruppeneinstellungen von Zielvorhaben für den Kundenlebenszyklus konfigurieren möchten, verwenden Sie StattdessenUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Nutzerliste durch Einstellung hinzufügen oder entfernen
UserListCustomerType.customer_type_category
bisUserListCustomerTypeCategory.PURCHASERS
um sie in eine bestehende Kundendefinition aufzunehmen oder von ihr auszuschließen für Zielvorhaben des Kundenlebenszyklus. Rufen Sie auf und segmentieren Sie Ihre Zielgruppen .
- Nutzerliste durch Einstellung hinzufügen oder entfernen
Videos
- Folgende Werte wurden hinzugefügt:
ContentLabelType
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
hinzugefügt um die Inventareinstellungen für Video-Assets beim ErstellenDemandGenVideoResponsiveAdInfo
- (Nur Konten auf der Zulassungsliste) Made
Campaign.video_brand_safety_suitability
änderbar.
Version 16.1.0 (24.04.2024)
Die folgenden Funktionen und Änderungen wurden in Version 16.1 hinzugefügt.
Kontoverwaltung
CustomerNegativeCriterion.ip_block
mit dem das Hinzufügen einer IP-Adresse als negatives Kriterium auf Kundenebene unterstützt wird.- 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, um
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 ist 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 Target
ROAS-Kampagnengebotssimulationen für
App-Kampagnen mit dem
campaign_simulation
-Bericht. - 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
mit Unterstützung für SKAdNetwork 4,0 Funktionen.- Unterstützung für Warnungen hinzugefügt für
CustomerSkAdNetworkConversionValueSchemaService
alsMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
Wenn dieser Wert auftrue
gesetzt ist, werden alle nicht blockierenden Fehler im Zusammenhang mit Vorgangsfehlern angezeigt. zurückgegeben alsMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
- 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
gibt den Kreditstatus und den Zeitstempel zurück, aktualisiert wurde.local_services_lead_conversation.message_details.attachment_urls
gibt die URLs zurück, die zum Herunterladen des Inhalts der Anhang.
Videos
customer.video_brand_safety_suitability
undBrandSafetySuitability
die die Eignung von Videos für die Markensicherheit beim Kunden- 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
migriert von VonAccountLink
anProductLink
undProductLinkInvitation
data_partner
undgoogle_ads
wurden entfernt ausAccountLink
- Hinzugefügt
IdentityVerificationService
bis die Überprüfung von Werbetreibenden zu verwalten.StartIdentityVerification()
wird zum Starten einer Überprüfungssitzung mit der angegebenenverification_program
Er erstellt eine neue Überprüfungssitzung und gibt eine leere Antwort für eine Bestätigung erstellt.GetIdentityVerification()
kann zum Abrufen von Verifizierungsinformationen verwendet werden, Mehrere Objekte vonIdentityVerification
JedeIdentityVerification
enthält:verification_program
also das Programm zur Identitätsbestätigung,identity_verification_requirement
die Details zur Frist enthält, bis zu der sollte der Werbetreibendeverification_progress
die folgende Informationen zur Überprüfung enthält:program_status
steht für den aktuellen Status dieses Bestätigungssitzungaction_url
leitet den Kunden zu einer URL weiter, auf der er den Vorgang abschließen kann. zu überprüfen.invitation_link_expiration_time
steht für das Ablaufdatum. füraction_url
- Aufzählungen:
- Fehler:
- Hinzugefügt
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
Assets
- Änderungen an
asset_group
:- Zeitbezogene Segmente werden jetzt unterstützt, z. B.
segments.year
undsegments.month
campaign
wurde als zugeordnete Ressource erstellt Segmentierung der Ressource.
- Zeitbezogene Segmente werden jetzt unterstützt, z. B.
Kampagnen
- Änderungen an Demand Gen-Kampagnen:
- Unterstützung für Einstellung hinzugefügt
Campaign.shopping_setting
bis einer bestehenden Demand Gen-Kampagne. - Hinzugefügt
ShoppingSetting.disable_product_feed
um den optionalen Produktfeed von Demand Gen-Kampagnen zu deaktivieren. Ad.demand_gen_product_ad
hinzugefügt und die entsprechendenDemandGenProductAdInfo
, verfügbar für Demand Gen-Kampagnen mit einer Nicht-Null-WerteCampaign.shopping_setting
- Unterstützung für Einstellung hinzugefügt
- Zu folgenden Feldern in
AdGroup
hinzugefügt, um anzuzeigen, ob Anzeigen der Anzeigengruppe ausgeliefert werden oder warum keine Anzeigen ausgeliefert werden:primary_status
primary_status_reasons
- Zum Anzeigen folgenden Feldern in
AdGroupAd
hinzugefügt ob die Anzeige aus der Anzeigengruppe ausgeliefert wird oder warum sie nicht ausgeliefert wird:primary_status
primary_status_reasons
- Folgende Werte wurden hinzugefügt:
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Test
Experiment.sync_enabled
wurde hinzugefügt zu Geben Sie an, ob die Synchronisierung für den Test aktiviert werden soll. Mit Synchronisierung aktiviert, Änderungen an während der Test aktiv ist, werden automatisch in die Testkampagne kopiert.- Hinzugefügt
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
- Hinzugefügt
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
Hotel & Reisen
- Folgende Felder wurden zu
ListingDimensionInfo
für „Mögliche Aktivitäten“ Anzeige für die Erstellung von Eintragsgruppen auf der Grundlage des Bundeslandes/Bundesstaates und der Stadt, in denen die sind die folgenden Reiseaktivitäten verfügbar: - Folgende Segmente werden jetzt unterstützt:
travel_activity_performance_view
:
Lokale Dienstleistungen
- Hinzugefügt
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
undBusinessRegistrationCheckArtifact
damit Werbetreibende den Fortschritt der Gewerbeanmeldung verfolgen können zu überprüfen. - Neue Ressource hinzugefügt
local_services_employee
zum Zulassen um die von ihnen hinzugefügten Mitarbeiterinformationen abzurufen.
Planung
score
wurde entfernt ausAudienceInsightsAttributeMetadata
Empfehlungen
- Hinzugefügt
RecommendationService.GenerateRecommendations()
gibt Empfehlungen basierend auf den angegebenen Einstellungen zurück, z. B. und Werbekanaltypen. Das ist besonders hilfreich, während der Kampagnenerstellung. - Hinzugefügt
RecommendationMetrics.conversions_value
- Empfohlene Keywords mit nicht festgelegter Keyword-Option haben jetzt
recommended_match_type
aufUNSPECIFIED
statt aufUNKNOWN
festgelegt. - Die folgenden Arten von Empfehlungen wurden hinzugefügt:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
wird empfohlen, die Gebotsstrategie „Conversion-Wert maximieren“ zu aktivieren, StrategieIMPROVE_GOOGLE_TAG_COVERAGE
Es wird empfohlen, das Google-Tag auf mehr SeitenPERFORMANCE_MAX_FINAL_URL_OPT_IN
Sie sollten die Funktion „Erweiterung der finalen URL“ für Ihre Performance Max-Kampagne KampagnenREFRESH_CUSTOMER_MATCH_LIST
Es empfiehlt sich, eine Kundenliste zu aktualisieren, den letzten 90 TagenCUSTOM_AUDIENCE_OPT_IN
in der Sie eine benutzerdefinierte Zielgruppe erstellen,LEAD_FORM_ASSET
Hier wird empfohlen, Assets mit Lead-Formular zur Kampagne oder zum Kunden hinzuzufügen. LevelIMPROVE_DEMAND_GEN_AD_STRENGTH
Hier wird empfohlen, die Anzeigeneffektivität bei Demand Gen-Kampagnen zu verbessern.
Shopping
- Hinzugefügt
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
undCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
um detailliertere Fehler für Shopping-Kampagnen anzuzeigen, die mit einem Comparison Shopping Service Center Konto. - Folgende Werte wurden hinzugefügt:
AssetGroupListingGroupFilterError
: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
hinzugefügt zuCustomerLifecycleGoalOperation
undCampaignLifecycleGoalOperation
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 eines nicht autorisierten Kontos gesperrt wurde
Aktivitäten
customer.status
undcustomer_client.status
werden jetzt alsSUSPENDED
Bisher wurden sie alsENABLED
- Unterstützung für das Hinzufügen und Entfernen einer Verknüpfung zwischen einem Google Ads-Konto und
ein Merchant Center-Konto:
- Hinzugefügt
ProductLink.merchant_center
undMerchantCenterIdentifier
- Hinzugefügt
LinkedProductType.MERCHANT_CENTER
- Hinzugefügt
- Hinzugefügt
ProductLinkInvitationService
undProductLinkInvitation
zum Support Link-Einladung aktualisieren, die von anderen Produkten gesendet wurde, verfügbar für Hotel und Merchant Center Konten zentrieren. 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 für die Aktualisierung von Linkeinladungen wurden entfernt über Hotel Center-KontenAccountLinkService
- 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 ersetzt durchImageAdInfo.image_asset
für den Support mithilfe der Assets Bilder hinzufügen und entfernen. Infolgedessen haben wir auchMediaFileService
, das nicht mehr benötigt wird. - Hinzugefügt
ListingGroupFilterDimension.webpage
zum Erstellen eines Eintragsgruppenfilters basierend auf benutzerdefinierten Labels und URLs Teilzeichenfolgen.AssetGroupListingGroupFilter.vertical
auch ersetzt durchAssetGroupListingGroupFilter.listing_source
undListingGroupFilterListingSource
asset_group_asset.source
zum Anzeigen hinzugefügt Die Quelle des Asset-Gruppen-Assets- Hinzugefügt
ad_group_ad_asset_view.source
bis um die Quelle des Anzeigen-Assets der Anzeigengruppe zu sehen.
Zielgruppen
- Für den Kundenabgleich, hinzugefügt
CustomerMatchUserListMetadata.consent
um die Einwilligung zu unterstützen. Ab 6. März 2024 bei Einwilligung: fehlt für Nutzer im EWR, 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 für Anzeigen verwendet werden Personalisierung mithilfe des Kundenabgleichs. In unserer Leitfaden zum Kundenabgleich . - Für Ladenverkäufe wird
UserData.consent
hinzugefügt zu eine Einwilligung geben. In unserer Leitfaden für Ladenverkäufe für erhalten Sie weitere Informationen. Wenn Sie den Kundenabgleich für Ladenverkäufe verwenden, FAQs Informationen. - Hinzugefügt
UserList.lookalike_user_list
bis das Erstellen eines Lookalike- wurde eine Zielgruppe erstellt, basierend auf der angegebenen Quellzielgruppe. Ähnliche Segmente können in einer Demand Gen-Kampagne .
Kampagnen
Änderungen bei Performance Max-Kampagnen:
AssetGroupSignal
unterstützt jetzt zwei Signaltypen, die einer Asset-Gruppe hinzugefügt werden können, um die Ausrichtung zu optimieren:AssetGroupSignal.audience
Audience.scope
hinzugefügt undAudience.asset_group
zum Einschränken für eine bestimmte Asset-Gruppe.Audience.asset_group
muss festgelegt werden wenn und nur wennAudience.scope
gleichASSET_GROUP
AssetGroupSignal.search_theme
- Hinzugefügt
CriterionType.SEARCH_THEME
um diesen neuen Kriteriumstyp zu unterstützen. Dieser neue Kriteriumstyp kann nur werden in Performance Max-Kampagnen verwendet, um eineAssetGroupSignal
indem Sie das FeldAssetGroupSignal.search_theme
mit einemSearchThemeInfo
-Kriterium.
- Hinzugefügt
- Hinzugefügt
AssetGroupSignalOperation.exempt_policy_violation_keys
, um beim Hinzufügen von Signalen für Asset-Gruppen eine Ausnahme zu beantragen. - Hinzugefügte neue
asset_group_top_combination_view
um die leistungsstärksten Assets auf Asset-Gruppenebene zu erfassen. asset_group
kann jetzt mit Messwertfeldern abgefragt werden um die Leistung einer Performance Max-Kampagne abzurufen.- In
PerformanceMaxUpgradeStatus
, hatUPGRADE_ELIGIBLE
inUPGRADE_ELIGIBLE
umbenannt.
Für Demand Gen- und Auffindbarkeit Ziel-CPA-Kampagnen: Simulationen für Ziel-CPA-Gebote auf Kampagnenebene (
campaign_simulation.target_cpa_point_list.points
) gibt jetzt Ergebnisse zurückTargetCpaSimulationPoint.interactions
anstelle vonTargetCpaSimulationPoint.clicks
BrandSuggestionService
wurde hinzugefügt, der Folgendes kann: Marken basierend auf dem angegebenen Markenpräfix und der ausgeschlossenen Liste von Marken. Mit diesen Marken können SieBRAND
Kriterium, hinzugefügt einem freigegebenenBRANDS
-Satz hinzugefügt und einer Kampagne zugeordnet, indem SieCampaignCriterion
mitbrand_list
ist auf den freigegebenen Satz festgelegt. Die Kampagnenkriterien lassen sich auf Suchkampagnen ausrichten und in Performance Max-Kampagnen.- Felder:
- Aufzählungen:
Hinzugefügt
Campaign.asset_automation_settings[]
um den Automatisierungsstatus jedes Asset-Typs anzuzeigen.Folgende Werte wurden hinzugefügt:
CampaignPrimaryStatusReason
Aufzählung:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversions
CallConversion.consent
hinzugefügt undClickConversion.consent
zum Support Einwilligung geben. In unserer Leitfaden zu Anruf-Conversions und im Leitfaden zu Klick-Conversions. Details.- Die folgenden Felder in Bezug auf
SKAdNetwork
die bei Abfragen mit
customer
odercampaign
: - "
metrics.sk_ad_network_conversions
" wurde ersetzt durchmetrics.sk_ad_network_installs
- Die Diagnose von Offline-Conversion-Uploads wird jetzt unterstützt.
- Die
offline_conversion_upload_client_summary
aus einem Feld in dercustomer
-Ressource zu einem Bericht auf oberster Ebene. Verwenden um nützliche Details zum Conversion-Upload-Status zu erhalten, z. B. Anzahl erfolgreicher Ereignisse, Erfolgsquote und Fehlerprozentsatz.- Warnung: Eine Conversion, die hochgeladen wird, aber zu einer
ConversionUploadError.CLICK_NOT_FOUND
wird zwar als Erfolg gewertet, er ist aber auchOfflineConversionAlert
- Warnung: Eine Conversion, die hochgeladen wird, aber zu einer
job_id
wurde als optionaler Parameter für die folgenden Anfragetypen hinzugefügt: mehrere Uploadanfragen logisch zu einem einzigen Konzept zusammenfassen, Job:INVALID_JOB_ID
wurde den folgenden Fehlern hinzugefügt:INVALID_CONVERSION_ACTION
durchNO_CONVERSION_ACTION_FOUND
undINVALID_CONVERSION_ACTION_TYPE
:
- Die
- Drei Berichte zur Unterstützung der netzwerkübergreifenden Privacy Sandbox für Android hinzugefügt
Attribution ohne
Weiterleitungen:
android_privacy_shared_key_google_campaign
mitshared_campaign_key
und einige Felder zur Codierung des Schlüssels.android_privacy_shared_key_google_ad_group
mitshared_ad_group_key
und einige Felder zur Codierung des Schlüssels.android_privacy_shared_key_google_network_type
mitshared_network_type_key
und einige Felder zur Codierung des Schlüssels.
- Hinzugefügt
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
EinConversionActionOperation
, der versucht, eine der eingestellten regelbasierten Attributionen zu verwenden Modelle mit diesem Fehler fehl. Zuvor schlug der Vorgang mit dem folgenden Fehler fehl:UNKNOWN
Fehler.
Hotel & Reisen
- Die folgenden Felder werden jetzt unterstützt in
travel_activity_group_view
undtravel_activity_performance_view
:- 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 zugehörige descustomer
-Berichts für die Rückgabe eines lokalen Detaillierte Lizenz- und Versicherungsstatus des Werbetreibenden für Dienste- Folgende neue Berichte wurden für Lokal hinzugefügt
Dienste:
local_services_lead
enthält alle Details zu Google Lokale Dienstleistungen Ads-Leads wielead_charged
,lead_type
,lead_status
- Aufzählungen:
local_services_lead_conversation
enthält Details zu Nachrichten und Telefongesprächen, z. B.conversation_channel
,call_duration_millis
,call_recording_url
.- Die URL zur Anrufaufzeichnung ist für den Zielkunden authentifiziert Konto und den zugehörigen Verwaltungskonten.
local_services_verification_artifact
werden Artefakte eines Werbetreibenden, die Google Lokale Dienstleistungen nutzen, zurückgegeben, z. B. Zuverlässigkeitsüberprüfung, Unternehmenslizenzen und Unternehmensversicherungsdaten. Alle verknüpften Dokumente mit Lizenz und Versicherung kann über eine URL aufgerufen werden.
Planung
- Unterstützung für die Rückgabe von
Forecast.views
undPlannedProductForecast.views
fürReachPlanService.ListPlannableProducts
. - Support für die Rückgabe hinzugefügt
PlannableTargeting.surface_targeting
fürReachPlanService.ListPlannableProducts
, der die verfügbaren Oberflächen für ein Produkt beschreibt. - Hinzugefügte neue
ReachPlanSurface
-Enum. - Unterstützung für Targeting
Häufigkeit mit
AdvancedProductTargeting.target_frequency_settings
, Dieser gibt Folgendes zurück:PlannedProductForecast.average_frequency
- Hinzugefügt
AudienceInsightsService.GenerateSuggestedTargetingInsights
um vorgeschlagene Zielgruppen zu erhalten. - Folgende Werte wurden hinzugefügt:
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Empfehlungen
- Hinzugefügt
RecommendationSubscriptionService
zum Verwalten von Empfehlungsabos: - Die folgenden Arten von Empfehlungen wurden hinzugefügt:
FORECASTING_SET_TARGET_CPA
wird empfohlen, einen Ziel-CPA für Kampagnen festzulegen, vor einem saisonalen Ereignis, das voraussichtlich ansteigen wird, Zugriffe.SET_TARGET_CPA
wird empfohlen, einen Ziel-CPA für Kampagnen festzulegen, angegeben ist.SET_TARGET_ROAS
wird empfohlen, einen Ziel-ROAS für Kampagnen festzulegen, angegeben ist.
Berichterstellung
- Folgende neue Messwerte wurden hinzugefügt, die abgefragt werden können:
campaign
(verfügbar für Display-, Video-, Discovery- und App-Kampagnen) undsegments.device
:
Shopping
ShoppingSetting.sales_country
entfernt, dessen Werte jetzt als zurückgegeben werdenShoppingSetting.feed_label
- Sie können weiterhin ein bestimmtes Merchant Center-Konto
-Feed für eine Kampagne mithilfe von
die
ShoppingSetting.feed_label
ein. Er sollte auf den Wert des Feedlabels oder das aus zwei Buchstaben bestehende Land festgelegt werden Code, der zuvor fürShoppingSetting.sales_country
verwendet wurde. Weitere Informationen finden Sie im Hilfeartikel zu Feeds Labels hinzu.
- Sie können weiterhin ein bestimmtes Merchant Center-Konto
-Feed für eine Kampagne mithilfe von
die
- 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 wurden ersetzt in
shopping_performance_view
: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 ersetzt durchproduct_category_constant
, gibt alle verfügbaren Lokalisierungen einer Kategorie in einem wiederkehrenden Feld zurück. - "
ListingDimensionInfo.product_bidding_category
" wurde ersetzt durchListingDimensionInfo.product_category
- "
ListingGroupFilterDimension.product_bidding_category
" wurde ersetzt durchListingGroupFilterDimension.product_category
- Die folgenden Felder wurden ersetzt in
- Keine Unterstützung mehr für das Hinzufügen
Campaign.shopping_setting
zum Suchen Kampagnen. Der Versuch, eine Suchkampagne mitCampaign.shopping_setting
oder hinzufügenCampaign.shopping_setting
in ein Ergebnisse einer bestehenden SuchkampagneOPERATION_NOT_PERMITTED_FOR_CONTEXT
- Keine Unterstützung mehr für das Hinzufügen
CampaignCriterion.listing_scope
auf Suchkampagnen anwenden. HinzufügenCampaignCriterion.listing_scope
auf eine bestehende Suchkampagne anwenden,OPERATION_NOT_PERMITTED_FOR_CONTEXT
- Folgende Conversions mit Einkaufswagen 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
- Hinzugefügt
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
zum Konfigurieren von Zielvorhaben für die Kundenakquisition auf Kundenebene.- Bericht:
customer_lifecycle_goal
- Bericht:
- Hinzugefügt
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
um Zielvorhaben für die Kundenakquisition auf Kampagnenebene zu konfigurieren.- Bericht:
campaign_lifecycle_goal
- Bericht:
- Hinzugefügt
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
- Folgende Werte wurden hinzugefügt:
ConversionGoalCampaignConfigError
: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
- Hinzugefügt
AdNetworkType.GOOGLE_TV
- Hinzugefügt
- Die Ausrichtung auf YouTube wird jetzt auf Kampagnenebene unterstützt:
- Hinzugefügt
NetworkSettings.target_youtube
- In
AdNetworkType
zusammengeführtYOUTUBE_WATCH
undYOUTUBE_SEARCH
inYOUTUBE
. - Hinzugefügt
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
- Hinzugefügt
Archivierte Versionshinweise
Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.