Versionshinweise

Version 17 (05.06.2024)

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

Anzeigen

• AdService.getAd wurde entfernt. Damit entspricht AdService 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:
  • 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

• Es wurde BatchJobError.REQUEST_TOO_LARGE hinzugefügt, das ausgelöst wird, wenn das eingereichte AddBatchJobOperationsRequest-Element größer als 10484.504 Byte ist.
• Die Einstellung von MutateOperation.asset_group_operation bei der Verwendung von BatchJobService 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 jetzt AdvertisingChannelType.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 in segments.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.
  • 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

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

Lokale Dienstleistungen

• LocalServicesLeadService.AppendLeadConversation() wurde hinzugefügt, um eine neue LocalServicesLeadConversation an LocalServicesLead 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 die lead_type auf LeadType.MESSAGE gesetzt ist, kann in Conversation.local_services_lead angegeben werden.
• 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 Methode LocalServicesLeadService.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, wird QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE ausgegeben. Beispielsweise können product_link.advertising_partner.customer und product_link.data_partner.data_partner_id nicht in derselben Abfrage ausgewählt werden.
• Die Übergabe von page_size an GoogleAdsService.Search führt zum Fehler RequestError.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 mit segments.date filtern, wenn Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream verwenden. Eine Segmentierung nach Datum ist nicht zulässig und gibt den Fehler ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION zurück.

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 stattdessen UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Um eine Nutzerliste hinzuzufügen oder zu trennen, setzen Sie UserListCustomerType.customer_type_category auf UserListCustomerTypeCategory.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.

Videos

• Die folgenden Werte wurden ContentLabelType hinzugefügt. 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 wurde hinzugefügt, um die Inventareinstellungen für Video-Assets beim Erstellen von DemandGenVideoResponsiveAdInfo 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 und asset_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 als MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings wurde hinzugefügt. Wenn true festgelegt ist, werden alle nicht blockierenden Fehler im Zusammenhang mit Vorgangsfehlern als MutateCustomerSkAdNetworkConversionValueSchemaResponse.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 und local_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 und BrandSafetySuitability 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 von AccountLink zu ProductLink und ProductLinkInvitation migriert.
• data_partner und google_ads wurden aus AccountLink entfernt.
• IdentityVerificationService wurde hinzugefügt, um die Überprüfung des Werbetreibenden zu verwalten.
  • StartIdentityVerification() wird verwendet, um eine Überprüfungssitzung mit dem angegebenen verification_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 von IdentityVerification zurückgeben. Jedes IdentityVerification 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 muss
    • verification_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ür action_url.
  • Aufzählungen:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Fehler:
    • IdentityVerificationError
• AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT wurde hinzugefügt.

Assets

• Änderungen an asset_group:
  • Unterstützung für zeitbezogene Segmente wie segments.year und segments.month wurde hinzugefügt.
  • campaign wurde als zugeordnete Ressource erstellt, anstatt sie zu segmentieren.

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 entsprechende DemandGenProductAdInfo hinzugefügt, die für Demand Gen-Kampagnen mit einem Campaign.shopping_setting ungleich null verfügbar ist.
• 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:
  • activity_state
  • activity_city
• Die folgenden Segmente werden jetzt in travel_activity_performance_view unterstützt:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Lokale Dienstleistungen

• LocalServicesVerificationArtifact.business_registration_check_verification_artifact und BusinessRegistrationCheckArtifact 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 aus AudienceInsightsAttributeMetadata 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 von UNKNOWN festgelegt.
• Die folgenden Arten von Empfehlungen wurden hinzugefügt:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN, der empfohlen wird, die Gebotsstrategie „Conversion-Wert maximieren“ zu aktivieren
  • IMPROVE_GOOGLE_TAG_COVERAGE – es wird empfohlen, das Google-Tag auf mehr Seiten zu implementieren
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN, wobei empfohlen wird, die Erweiterung der finalen URL für Ihre Performance Max-Kampagnen zu aktivieren
  • REFRESH_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 Zielgruppe
  • LEAD_FORM_ASSET – es wird empfohlen, Assets mit Lead-Formular auf Kampagnen- oder Kundenebene hinzuzufügen
  • IMPROVE_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 und CampaignError.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 wurde CustomerLifecycleGoalOperation und CampaignLifecycleGoalOperation 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 und customer_client.status jetzt als SUSPENDED zurückgegeben. Bisher wurden sie als ENABLED 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 und MerchantCenterIdentifier wurden hinzugefügt.
  • LinkedProductType.MERCHANT_CENTER wurde hinzugefügt.
• ProductLinkInvitationService und ProductLinkInvitation 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 und ProductLinkService.
• AccountLink.hotel_center und die Unterstützung zum Aktualisieren von Verknüpfungseinladungen aus Hotel Center-Konten mit AccountLinkService wurden entfernt.
  • Wenn Sie eine Einladung zur Verknüpfung aus einem Hotel Center-Konto aktualisieren möchten, verwenden Sie ProductLinkInvitationService.

Assets

• ImageAdInfo.media_file wurde durch ImageAdInfo.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ötigte MediaFileService 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 durch AssetGroupListingGroupFilter.listing_source und ListingGroupFilterListingSource ersetzt
• 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 und Audience.asset_group wurden hinzugefügt, um die Zielgruppennutzung auf eine bestimmte Asset-Gruppe zu beschränken. Audience.asset_group muss nur dann festgelegt werden, wenn Audience.scope auf ASSET_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 eine AssetGroupSignal zu erstellen. Dazu muss AssetGroupSignal.search_theme mit einem SearchThemeInfo-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 wurde UPGRADE_ELIGIBLE in UPGRADE_ELIGIBLE umbenannt.

• 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) jetzt TargetCpaSimulationPoint.interactions anstelle von TargetCpaSimulationPoint.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 ein BRAND-Kriterium erstellen, einem freigegebenen BRANDS-Satz hinzufügen und es dann mit einer Kampagne verknüpfen. Erstellen Sie dazu eine CampaignCriterion, bei der brand_list den freigegebenen Satz aufweist. Die Kampagnenkriterien können in Suchkampagnen ausgerichtet bzw. in Performance Max-Kampagnen ausgeschlossen werden.

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

• 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 und ClickConversion.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 oder campaign verfügbar sind:
  • 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 durch metrics.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 Ressource customer 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 als OfflineConversionAlert gekennzeichnet.
  • 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:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • INVALID_JOB_ID wurde den folgenden Fehlern hinzugefügt:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • INVALID_CONVERSION_ACTION wurde bei folgenden Fehlern durch NO_CONVERSION_ACTION_FOUND und INVALID_CONVERSION_ACTION_TYPE ersetzt:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• 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, der shared_campaign_key und einige Felder zur Codierung des Schlüssels enthält.
  • android_privacy_shared_key_google_ad_group, der shared_ad_group_key und einige Felder zur Codierung des Schlüssels enthält.
  • android_privacy_shared_key_google_network_type, der shared_network_type_key und einige Felder zur Codierung des Schlüssels enthält.
• ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS wurde hinzugefügt. Ein ConversionActionOperation, der versucht, eines der eingestellten regelbasierten Attributionsmodelle zu verwenden, schlägt jetzt mit diesem Fehler fehl. Zuvor schlug der Vorgang mit dem Fehler UNKNOWN fehl.

Hotels und Reisen

• Die folgenden Felder in travel_activity_group_view und travel_activity_performance_view werden jetzt unterstützt:
  • 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 die zugehörigen Felder wurden dem customer-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 und lead_status.
    • Aufzählungen:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation enthält Details zu Nachrichten und Unterhaltungen, z. B. conversation_channel, call_duration_millis und call_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.
    • Aufzählungen:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Planung

• Die Rückgabe von Forecast.views und PlannedProductForecast.views für ReachPlanService.ListPlannableProducts für anwendbare Produkttypen wurde hinzugefügt.
• Die Rückgabe von PlannableTargeting.surface_targeting für ReachPlanService.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, das PlannedProductForecast.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:
  • Ressource: RecommendationSubscription
  • Feld: MutateOperation.recommendation_subscription_operation
  • Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Fehler:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 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) und segments.device abgefragt werden können:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Shopping

• ShoppingSetting.sales_country wurde entfernt, dessen Werte jetzt als ShoppingSetting.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ür ShoppingSetting.sales_country verwendet wurde. Weitere Informationen finden Sie im Hilfeartikel zu Feedlabels.
• 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 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 durch product_category_constant ersetzt, das alle verfügbaren Lokalisierungen einer Kategorie in einem wiederkehrenden Feld zurückgibt.
  • ListingDimensionInfo.product_bidding_category wurde durch ListingDimensionInfo.product_category ersetzt.
  • ListingGroupFilterDimension.product_bidding_category wurde durch ListingGroupFilterDimension.product_category ersetzt.
• Das Hinzufügen von Campaign.shopping_setting zu Suchkampagnen wird nicht mehr unterstützt. Wenn Sie versuchen, eine Suchkampagne mit Campaign.shopping_setting zu erstellen oder Campaign.shopping_setting einer bestehenden Suchkampagne hinzuzufügen, wird jetzt OPERATION_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 jetzt OPERATION_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:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Einheitliche Ziele

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

Archivierte Versionshinweise

Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.