Versionshinweise

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.

Ä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:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

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 auf segments.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:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type: Damit können Sie die folgenden Berichte nach Videoanzeigenformattyp segmentieren:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

Version 17 (05.06.2024)

Die folgenden Funktionen und Änderungen wurden in Version 17 hinzugefügt.

Anzeigen

• AdService.getAd wurde entfernt. Dadurch wird die AdService 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:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

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:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Zielgruppen

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED hinzugefügt

Batchjobs

• Hinzugefügt BatchJobError.REQUEST_TOO_LARGE, Dieser wird ausgelöst, wenn der eingereichte AddBatchJobOperationsRequest größer als 104.845.04 Byte ist.
• Die Einstellung MutateOperation.asset_group_operation wird jetzt unterstützt. wenn Sie BatchJobService 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 jetzt AdvertisingChannelType.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 in segments.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.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

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ür gender_view
• Unterstützung für metrics.phone_calls hinzugefügt für keyword_view

Lokale Dienstleistungen

• LocalServicesLeadService.AppendLeadConversation() hinzugefügt zum Anhängen eines neuen LocalServicesLeadConversation an LocalServicesLead, 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 mit lead_type festgelegt auf LeadType.MESSAGE kann in der Conversation.local_services_lead
• 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 neuen LocalServicesLeadService.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 Produkte QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Beispiel: product_link.advertising_partner.customer und product_link.data_partner.data_partner_id kann nicht in derselben Abfrage ausgewählt werden.
• Übergeben von page_size an GoogleAdsService.Search führt zu einer RequestError.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 mit segments.date bei Verwendung GoogleAdsService.Search oder GoogleAdsService.SearchStream Eine Segmentierung nach Datum ist nicht zulässig und es wird ein ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION Fehler.

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 Stattdessen UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Nutzerliste durch Einstellung hinzufügen oder entfernen UserListCustomerType.customer_type_category bis UserListCustomerTypeCategory.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 .

Videos

• Folgende Werte wurden hinzugefügt: ContentLabelType Sie können diese ContentLabelTypes 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 Erstellen DemandGenVideoResponsiveAdInfo
• (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 und asset_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 als MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings Wenn dieser Wert auf true gesetzt ist, werden alle nicht blockierenden Fehler im Zusammenhang mit Vorgangsfehlern angezeigt. zurückgegeben als MutateCustomerSkAdNetworkConversionValueSchemaResponse.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 und local_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 und BrandSafetySuitability 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 Von AccountLink an ProductLink und ProductLinkInvitation
• data_partner und google_ads wurden entfernt aus AccountLink
• Hinzugefügt IdentityVerificationService bis die Überprüfung von Werbetreibenden zu verwalten.
  • StartIdentityVerification() wird zum Starten einer Überprüfungssitzung mit der angegebenen verification_program Er erstellt eine neue Überprüfungssitzung und gibt eine leere Antwort für eine Bestätigung erstellt.
    • Hinzugefügt IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
  • GetIdentityVerification() kann zum Abrufen von Verifizierungsinformationen verwendet werden, Mehrere Objekte von IdentityVerification Jede IdentityVerification 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 Werbetreibende
    • verification_progress die folgende Informationen zur Überprüfung enthält:
      • program_status steht für den aktuellen Status dieses Bestätigungssitzung
      • action_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ür action_url
  • Aufzählungen:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Fehler:
    • IdentityVerificationError
• Hinzugefügt AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT

Assets

• Änderungen an asset_group:
  • Zeitbezogene Segmente werden jetzt unterstützt, z. B. segments.year und segments.month
  • campaign wurde als zugeordnete Ressource erstellt Segmentierung der Ressource.

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 entsprechenden DemandGenProductAdInfo, verfügbar für Demand Gen-Kampagnen mit einer Nicht-Null-Werte Campaign.shopping_setting
• 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:
  • activity_state
  • activity_city
• Folgende Segmente werden jetzt unterstützt: travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Lokale Dienstleistungen

• Hinzugefügt LocalServicesVerificationArtifact.business_registration_check_verification_artifact und BusinessRegistrationCheckArtifact 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 aus AudienceInsightsAttributeMetadata

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 auf UNSPECIFIED statt auf UNKNOWN festgelegt.
• Die folgenden Arten von Empfehlungen wurden hinzugefügt:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN wird empfohlen, die Gebotsstrategie „Conversion-Wert maximieren“ zu aktivieren, Strategie
  • IMPROVE_GOOGLE_TAG_COVERAGE Es wird empfohlen, das Google-Tag auf mehr Seiten
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN Sie sollten die Funktion „Erweiterung der finalen URL“ für Ihre Performance Max-Kampagne Kampagnen
  • REFRESH_CUSTOMER_MATCH_LIST Es empfiehlt sich, eine Kundenliste zu aktualisieren, den letzten 90 Tagen
  • CUSTOM_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. Level
  • IMPROVE_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 und CampaignError.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 zu CustomerLifecycleGoalOperation und CampaignLifecycleGoalOperation 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 und customer_client.status werden jetzt als SUSPENDED Bisher wurden sie als ENABLED
• 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 und MerchantCenterIdentifier
  • Hinzugefügt LinkedProductType.MERCHANT_CENTER
• Hinzugefügt ProductLinkInvitationService und ProductLinkInvitation 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 und ProductLinkService.
• AccountLink.hotel_center und die Unterstützung für die Aktualisierung von Linkeinladungen wurden entfernt über Hotel Center-Konten AccountLinkService
  • Wenn Sie eine Einladung zur Verknüpfung aus einem Hotel Center-Konto aktualisieren möchten, verwenden Sie ProductLinkInvitationService

Assets

• "ImageAdInfo.media_file" wurde ersetzt durch ImageAdInfo.image_asset für den Support mithilfe der Assets Bilder hinzufügen und entfernen. Infolgedessen haben wir auch MediaFileService, 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 durch AssetGroupListingGroupFilter.listing_source und ListingGroupFilterListingSource
• 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 und Audience.asset_group zum Einschränken für eine bestimmte Asset-Gruppe. Audience.asset_group muss festgelegt werden wenn und nur wenn Audience.scope gleich ASSET_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 eine AssetGroupSignal indem Sie das Feld AssetGroupSignal.search_theme mit einem SearchThemeInfo-Kriterium.
  • 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, hat UPGRADE_ELIGIBLE in UPGRADE_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ück TargetCpaSimulationPoint.interactions anstelle von TargetCpaSimulationPoint.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 Sie BRAND Kriterium, hinzugefügt einem freigegebenen BRANDS-Satz hinzugefügt und einer Kampagne zugeordnet, indem Sie CampaignCriterion mit brand_list ist auf den freigegebenen Satz festgelegt. Die Kampagnenkriterien lassen sich auf Suchkampagnen ausrichten und in Performance Max-Kampagnen.

  • Felder:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Aufzählungen:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 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 und ClickConversion.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 oder campaign:
  • Segmente:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Messwerte:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• "metrics.sk_ad_network_conversions" wurde ersetzt durch metrics.sk_ad_network_installs
• Die Diagnose von Offline-Conversion-Uploads wird jetzt unterstützt.
  • Die offline_conversion_upload_client_summary aus einem Feld in der customer-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 auch OfflineConversionAlert
  • job_id wurde als optionaler Parameter für die folgenden Anfragetypen hinzugefügt: mehrere Uploadanfragen logisch zu einem einzigen Konzept zusammenfassen, Job:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • INVALID_JOB_ID wurde den folgenden Fehlern hinzugefügt:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • INVALID_CONVERSION_ACTION durch NO_CONVERSION_ACTION_FOUND und INVALID_CONVERSION_ACTION_TYPE:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Drei Berichte zur Unterstützung der netzwerkübergreifenden Privacy Sandbox für Android hinzugefügt Attribution ohne Weiterleitungen:
  • android_privacy_shared_key_google_campaign mit shared_campaign_key und einige Felder zur Codierung des Schlüssels.
  • android_privacy_shared_key_google_ad_group mit shared_ad_group_key und einige Felder zur Codierung des Schlüssels.
  • android_privacy_shared_key_google_network_type mit shared_network_type_key und einige Felder zur Codierung des Schlüssels.
• Hinzugefügt ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS Ein ConversionActionOperation, 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 und travel_activity_performance_view:
  • Segmente:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 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 des customer-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 wie lead_charged, lead_type, lead_status
    • Aufzählungen:
      • LeadStatus
      • LeadType
  • 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.
    • Aufzählungen:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Planung

• Unterstützung für die Rückgabe von Forecast.views und PlannedProductForecast.views für ReachPlanService.ListPlannableProducts .
• Support für die Rückgabe hinzugefügt PlannableTargeting.surface_targeting für ReachPlanService.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:
  • Ressource: RecommendationSubscription
  • Feld: MutateOperation.recommendation_subscription_operation
  • Aufzählung: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Fehler:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 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) und segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Shopping

• ShoppingSetting.sales_country entfernt, dessen Werte jetzt als zurückgegeben werden ShoppingSetting.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ür ShoppingSetting.sales_country verwendet wurde. Weitere Informationen finden Sie im Hilfeartikel zu Feeds Labels hinzu.
• 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 mit segments.product_category_level1
    • segments.product_bidding_category_level2 mit segments.product_category_level2
    • segments.product_bidding_category_level3 mit segments.product_category_level3
    • segments.product_bidding_category_level4 mit segments.product_category_level4
    • segments.product_bidding_category_level5 mit segments.product_category_level5
  • "product_bidding_category_constant" wurde ersetzt durch product_category_constant, gibt alle verfügbaren Lokalisierungen einer Kategorie in einem wiederkehrenden Feld zurück.
  • "ListingDimensionInfo.product_bidding_category" wurde ersetzt durch ListingDimensionInfo.product_category
  • "ListingGroupFilterDimension.product_bidding_category" wurde ersetzt durch ListingGroupFilterDimension.product_category
• Keine Unterstützung mehr für das Hinzufügen Campaign.shopping_setting zum Suchen Kampagnen. Der Versuch, eine Suchkampagne mit Campaign.shopping_setting oder hinzufügen Campaign.shopping_setting in ein Ergebnisse einer bestehenden Suchkampagne OPERATION_NOT_PERMITTED_FOR_CONTEXT
• Keine Unterstützung mehr für das Hinzufügen CampaignCriterion.listing_scope auf Suchkampagnen anwenden. Hinzufügen CampaignCriterion.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:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Einheitliche Ziele

• Hinzugefügt CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals zum Konfigurieren von Zielvorhaben für die Kundenakquisition auf Kundenebene.
  • Bericht: customer_lifecycle_goal
• Hinzugefügt CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals um Zielvorhaben für die Kundenakquisition auf Kampagnenebene zu konfigurieren.
  • Bericht: campaign_lifecycle_goal
• 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
• Die Ausrichtung auf YouTube wird jetzt auf Kampagnenebene unterstützt:
  • Hinzugefügt NetworkSettings.target_youtube
  • In AdNetworkType zusammengeführt YOUTUBE_WATCH und YOUTUBE_SEARCH in YOUTUBE.
  • Hinzugefügt CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE

Archivierte Versionshinweise

Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.