Versionshinweise

v19.1 (16.04.2025)

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

Assets

• Es wurde ein Feld asset_coverage für AssetGroup hinzugefügt, das Informationen zu Lücken in Ihrer Asset-Gruppe zurückgibt.
  • Enthält ein untergeordnetes Feld ad_strength_action_items, das eine Liste von Aktionen zurückgibt, mit denen Werbetreibende die Anzeigeneffektivität einer Asset-Gruppe verbessern können.

Kampagnen

• Sie können jetzt Leads in Kampagnen für lokale Dienstleistungen bewerten oder Feedback dazu geben. Im Rahmen dieser Änderung wurde in Version 19.1
  • Neuer Dienst mit dem Namen LocalServicesLeadService hinzugefügt. Mit der Methode ProvideLeadFeedback können Sie Bewertungen und Feedback für Leads hochladen.
  • Dem Feld LocalServicesLead wurde ein neues Feld namens lead_feedback_submitted hinzugefügt, mit dem Sie feststellen können, ob Feedback zu einem Lead gesendet wurde.
• Neue Messwertspalte für App-Kampagnen biddable_cohort_app_post_install_conversions hinzugefügt.

Demand Gen

• Für die Nachfragegenerierung wurden zusätzliche Methoden in den Planungsdiensten eingeführt.

• Kanaleinstellungen für Demand Gen-Kampagnen werden jetzt auf Anzeigengruppenebene unterstützt. Im Feld demand_gen_ad_group_settings können Sie eine vordefinierte allgemeine Gruppierung von Kanälen oder einen Teil der Kanäle auswählen. In der aktuellen Version werden die folgenden Kanäle unterstützt:

  • YouTube-In-Stream-Anzeige
  • YouTube-In-Feed
  • YouTube Shorts
  • Discover
  • Gmail
  • Display

• Es wurde ein neuer Asset-Typ für TALL_PORTRAIT_MARKETING_IMAGE freigegeben. Dieser Asset-Typ bezieht sich auf das Feld tall_portrait_marketing_images des Demand Gen-Anzeigenformats mit mehreren Assets.

Änderungsverlauf

• Unterstützung für drei weitere Ressourcentypen in ChangeStatusResourceType hinzugefügt:
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• Diese drei detaillierteren Typen können Sie im Bericht change_status abrufen.

Conversions

• Sie können das Feld google_ads_conversion_customer jetzt beim Erstellen eines neuen Kunden über die Google Ads API festlegen. Dieses Feld war bisher schreibgeschützt.
• Beim Hochladen von Offline-Conversions können Sie jetzt den Typ des Kunden angeben, der mit der Conversion verknüpft ist.
• Für ClickConversion wurde ein neues session_attributes-Feld eingeführt.

Google Lokale Dienstleistungen

• Es wurde eine neue RPC-Funktion (ProvideLeadFeedback) zu LocalServicesLeadService hinzugefügt, um Feedback zur Qualität von LocalServicesLead zu geben.
• Der Ressource LocalServicesLead wurde das neue Feld lead_feedback_submitted hinzugefügt, das bestätigt, ob für eine bestimmte Ressource Feedback gegeben wurde.

Planungsdienste

• Unterstützung für monatliche Prognosen für die angestrebte Häufigkeit in ReachPlanService.GenerateReachForecast hinzugefügt.
  • Entwickler können TargetFrequencyTimeUnit.MONTHLY in TargetFrequencySettings festlegen, wenn sie den planbaren Produktcode TARGET_FREQUENCY verwenden, um eine monatliche Reichweitenprognose für die Zielhäufigkeit zu generieren.
• Es wurde eine neue Methode ReachPlanService.GenerateConversionRates hinzugefügt, mit der Werbetreibende vorgeschlagene Conversion-Raten für unterstützte planbare Produkte anfordern können.
• Demand Gen-Prognose in ReachPlanService.GenerateReachForecast:
  • Entwickler können jetzt Reichweitenprognosen für Demand Gen-Kampagnen anfordern. Entwickler können den neuen planbaren Produktcode DEMAND_GEN_MAX_CONVERSIONS verwenden, um Prognosen zur Reichweite von Demand Gen-Kampagnen zu erstellen.
  • Es wurde ein neues Feld conversion_rate hinzugefügt, mit dem Entwickler, die Reichweitenprognosen für Demand Gen-Kampagnen anfordern, eine Conversion-Rate angeben können. Vorgeschlagene Conversion-Preise können mit der neuen Methode ReachPlanService.GenerateConversionRates abgerufen werden. Dieses Feld ist für Anfragen zur Nachfrageprognose erforderlich. Sie wird für andere planbare Produkte nicht unterstützt.
  • Den zurückgegebenen Vorhersagen wurde ein neues Feld conversions hinzugefügt. Dieses Feld enthält die Anzahl der Conversions an einem bestimmten Punkt auf der Reichweitenkurve. Conversions werden nur für das planbare Produkt DEMAND_GEN_MAX_CONVERSIONS unterstützt.

Empfehlungen

• Das neue Feld ad_strength ist für ImprovePerformanceMaxAdStrengthRecommendation verfügbar. Es gibt den aktuellen Wert für die Anzeigeneffektivität der Asset-Gruppe zurück, die mit der Empfehlung verknüpft ist.

Shopping

• Sie können Markenausschlüsse für Shopping-Anzeigen in Performance Max-Kampagnen jetzt überschreiben. Diese Option wird über ein neues Feld pmax_campaign_settings auf Kampagnenebene angezeigt und funktioniert nur für Performance Max-Kampagnen für den Einzelhandel. Wenn Sie versuchen, dieses Feld für einen inkompatiblen Kampagnentyp festzulegen, wird ein neuer CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED-Fehler ausgegeben.

Videos

• Schreibgeschützte Unterstützung für Audioanzeigen hinzugefügt. Weitere Informationen zu dieser Funktion finden Sie in der Google Ads-Hilfe. Durch diese Änderung werden folgende Daten offengelegt:
  • Ein neuer AdvertisingChannelSubType mit dem Namen YOUTUBE_AUDIO.
  • Ein neuer AdGroupType mit dem Namen YOUTUBE_AUDIO.
  • Eine neue Aufzählung von Anzeigenformaten mit dem Namen YOUTUBE_AUDIO_AD und die entsprechenden YouTubeAudioAdInfo-Felder.
• Den Messwerten für die Reichweite von Suchanfragen wurden neue Messwerte und Segmente mit demografischen Anpassungen hinzugefügt. Im Rahmen dieser Änderungen gilt Folgendes:
  • Es wurden zwei neue Messwertspalten mit den Namen coviewed_impressions und primary_impressions eingeführt.
  • Es wurden zwei neue Segmente mit den Namen adjusted_age_range und adjusted_gender eingeführt.
  • Wenn eines der beiden neuen Segmente zusammen mit einem Feld für den Messwert „Reichweite“ (coviewed_impressions, primary_impressions, unique_users oder average_impression_frequency_per_user) ausgewählt ist, muss auch das andere Segment ausgewählt sein, damit gültige Statistiken für diese Spalten abgerufen werden können.
  • Diese Funktion ist derzeit nur für Kunden auf der Zulassungsliste verfügbar.

Version 19 (26.02.2025)

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

Kontoverwaltung

• Den folgenden Werten wurde CustomerError hinzugefügt, um anstehende Änderungen zu berücksichtigen:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Anzeigen

• Wir haben DemandGenMultiAssetAdInfo.tall_portrait_marketing_images hinzugefügt, um in Demand Gen-Anzeigen Assets mit Bildern im Hochformat mit einem Seitenverhältnis von 9:16 zu unterstützen.

Assets

• (Nur für Konten auf der Zulassungsliste) Unterstützung für Nachrichten-Assets über Asset.business_message_asset, BusinessMessageAsset und die folgenden Enumerationen und Fehler hinzugefügt.
  • Enums:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • Fehler:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW wurde hinzugefügt, um die automatische Generierung einer Landingpage-Vorschau zu unterstützen.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS ist jetzt standardmäßig für responsive Demand Gen-Videoanzeigen aktiviert.
• (Nur für Konten auf der Zulassungsliste; Zulassungsliste derzeit geschlossen) Asset.app_deep_link_asset und AppDeepLinkAsset wurden hinzugefügt.

Conversions

• Conversion-Zielvorhaben
  • LifecycleGoalValueSettings.high_lifetime_value ist jetzt nicht mehr in der Betaphase und kann geändert werden.
  • CustomerLifecycleGoal.owner_customer wurde hinzugefügt, um den Ressourcennamen des Kunden anzuzeigen, zu dem das Zielvorhaben für den Kundenlebenszyklus gehört.
• ConversionActionType.SALESFORCE wurde eingestellt.

Feeds

• Alle feedbezogenen Entitäten wie Feed, FeedMapping, FeedService, AdGroupFeed und feed_placeholder_view wurden entfernt. Nutzer sollten jetzt assets verwenden, um denselben Zweck zu erreichen. Eine Liste aller entfernten Entitäten finden Sie in den Migrationshinweisen.

Hotel und Reisen

• min_days und max_days von ValueRuleItineraryAdvanceBookingWindow wurden zu einem optional-Feld, damit 0 als Wert angegeben werden kann. So können Sie auf Reisesuchanfragen reagieren, die heute stattfinden.

Performance Max-Kampagne

• (Nur für Konten auf der Zulassungsliste) Markenrichtlinien
  • Campaign.brand_guidelines_enabled ist nur beim Erstellen einer Performance Max-Kampagne veränderbar.
  • Das ist nicht mit Performance Max-Kampagnen für die Reisebranche kompatibel.
  • Wenn Sie Markenrichtlinien für bestehende Performance Max-Kampagnen aktivieren möchten, verwenden Sie eine neu hinzugefügte CampaignService.EnablePMaxBrandGuidelines. Markenrichtlinien können nicht deaktiviert werden.
  • Es wurden Campaign.brand_guidelines und BrandGuidelines hinzugefügt, um die Farben und Schriftfamilie der Marke festzulegen.
  • Neue Fehlerwerte:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• Mit der Option AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS können jetzt automatisch erweiterte Video-Assets für Performance Max-Kampagnen generiert werden.

Planung

• (Nur für Konten auf der Zulassungsliste) Wir haben die Funktion ContentCreatorInsightsService.GenerateTrendingInsights hinzugefügt, mit der Nutzer anhand bestimmter Zielgruppendefinitionen angesagte Themen auf YouTube sehen können.
• Es wurde die Option GenerateCreatorInsightsRequest.country_locations[] hinzugefügt, um Länder anzugeben, in denen nach den angegebenen Kriterien gesucht werden soll.
• GenerateCreatorInsightsRequest.search_brand wurde hinzugefügt, um eine Marke anzugeben, nach der nach Creatorn gesucht werden soll
• Es wurden neue Felder zu YouTubeChannelInsights hinzugefügt, um zusätzliche Kanalinformationen für search_channels-Anfragen bereitzustellen:
  • channel_url
  • channel_description
  • top_videos
• AudienceInsightsAttributeMetadata wurden neue Metadatenfelder hinzugefügt:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

Videos

• Nach der Veröffentlichung von DataLinkService.CreateDataLink haben wir die folgenden Methoden hinzugefügt, um zuvor erstellte Datenverknüpfungen zu ändern:
  • RemoveDataLink zum Entfernen von Datenverknüpfungen in einem Google Ads-Konto
  • UpdateDataLink zum Akzeptieren, Ablehnen und Widerrufen von Datenverknüpfungen in einem Google Ads-Konto
• Unterstützung für VIDEO_OUTSTREAM aus den folgenden Enumerationen entfernt:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

Version 18 (16.10.2024)

In Version 18 wurden die folgenden neuen Funktionen und Updates hinzugefügt.

Kontoverwaltung

• (Nur für Konten auf der Zulassungsliste) DataLinkService.CreateDataLink wurde hinzugefügt. Damit können Sie ein Google Ads-Konto mit Creator-Videos verknüpfen, die auf dem YouTube-Kanal des Creators gehostet werden. Über Videoverknüpfungen können im Google Ads-Konto Partneranzeigen mit Creator-Videos ausgeliefert werden.

Anzeigengruppen

• Es wurde AdGroup.exclude_demographic_expansion hinzugefügt. Damit können Sie ausschließen, dass demografische Merkmale maximiert werden, wenn optimized_targeting_enabled true ist. Diese Funktion wurde bisher nur für Demand Gen-Kampagnen unterstützt.

Anzeigen

• Es wurde die Option AdGroupAd.ad_group_ad_asset_automation_settings hinzugefügt, mit der die automatische Asset-Generierung für Anzeigen aktiviert oder deaktiviert werden kann.
• AssetAutomationType wurden die folgenden Werte hinzugefügt:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• AdNetworkType.GOOGLE_OWNED_CHANNELS wurde hinzugefügt. Dieser Parameter wird für Anzeigen verwendet, die auf Google-Kanälen wie YouTube, Gmail und im Discover-Feed ausgeliefert werden.

Assets

• AssetType.DISCOVERY_CAROUSEL_CARD wurde in AssetType.DEMAND_GEN_CAROUSEL_CARD umbenannt.

Kampagnen

• Es wurde metrics.store_visits_last_click_model_attributed_conversions hinzugefügt, mit dem die Anzahl der Ladenbesuche zurückgegeben wird, die mit dem Modell „Letzter Klick“ einer Kampagne zugeordnet wurden.
• Die folgenden Messwerte zu Videoaufrufen wurden für eine Kampagne hinzugefügt:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• Es wurde das Symbol metrics.results_conversions_purchase hinzugefügt, mit dem Conversion-Käufe für die Ergebnisse der einheitlichen Zielvorhaben einer Kampagne zurückgegeben werden.
• Der Standardwert von DemandGenCampaignSettings.upgraded_targeting wurde von false in true geändert.

Kriterium

• Der Messwert content_criterion_view wurde hinzugefügt. Er gibt Leistungsmesswerte für auf bestimmte Inhalte ausgerichtete Inhalte zurück, z. B. Keywords, Placements und Themen für Display-, Demand Gen- und Videokampagnen.

Hotel und Reisen

• Unterstützung für Reisefeeds in Suchanzeigen
  • ClickType.TRAVEL_ASSETS wurde hinzugefügt, um Messwerte von Reisefeeds in Suchanzeigen zu segmentieren.
  • Es wurde das Symbol AssetSetType.TRAVEL_FEED hinzugefügt, mit dem Sie die Verwendung des Reisefeeds in Suchanzeigen aktivieren oder deaktivieren können.
• (Nur für Konten auf der Zulassungsliste) Reisepläne wurden als neue Conversion-Wert-Regel mit den folgenden neuen Feldern und Werten hinzugefügt:
  • ConversionValueRule.itinerary_condition mit ValueRuleItineraryCondition, mit dem ein Reservierungszeitraum, eine Reiseplanlänge und Wochentage für den Reisebeginn angegeben werden können
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• Die folgenden Segmente wurden für Berichte vom Typ campaign und ad_group hinzugefügt, um Leistungsdaten für Hotel- und Suchkampagnen nach bestimmten Zielorten (Städten, Ländern und Regionen) segmentieren zu können:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Lokale Dienstleistungen

• PhoneCallDetails.call_recording_url ist leer, anstatt eine ungültige URL anzugeben, wenn die Anrufaufzeichnung für die betreffende Unterhaltung mit einem Lead aus den lokalen Dienstleistungen nicht vorhanden ist.
• Es wurde CategoryBid.target_cpa_bid_micro hinzugefügt, mit dem Sie den Ziel-CPA für eine Kategorie über Campaign.local_services_campaign_settings festlegen können.

Performance Max-Kampagne

• Unterstützung für Markenrichtlinien
  • Das Symbol Campaign.brand_guidelines_enabled gibt an, ob Markenrichtlinien für eine bestimmte Performance Max-Kampagne aktiviert sind. Wenn diese Option aktiviert ist, müssen Assets mit field_type = BUSINESS_NAME, LOGO oder LANDSCAPE_LOGO als CampaignAsset-Ressourcen und nicht als AssetGroupAsset-Ressourcen verknüpft werden.
  • Es wurden die Fehler CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED und CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED hinzugefügt. Sie weisen darauf hin, dass Performance Max-Kampagnen mit aktivierten Markenrichtlinien nicht die erforderlichen CampaignAsset-Ressourcen haben, die mit der Kampagne verknüpft sind.
  • Wenn die Markenrichtlinien aktiviert sind, muss mindestens ein Asset mit BUSINESS_NAME und mindestens ein Asset mit LOGO als CampaignAsset-Ressource mit der Kampagne verknüpft sein.field_type Bei Performance Max-Kampagnen für Onlineverkäufe mit einem Produktfeed muss diese Anforderung nur erfüllt werden, wenn es Assets gibt, die mit den Asset-Gruppen der Kampagne verknüpft sind.
  • AssetLinkError wurden die folgenden Werte hinzugefügt:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, nicht aktiviert, wird ausgegeben, wenn versucht wird, Marken-Assets in Performance Max-Kampagnen als CampaignAsset-Ressourcen anstelle von AssetGroupAsset-Ressourcen zu verknüpfen.
    • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL Fehler, der auftritt, wenn versucht wird, Marken-Assets in Performance Max-Kampagnen, in denen Markenrichtlinien aktiviert sind, als AssetGroupAsset-Ressourcen an Kampagnen zu verknüpfen, anstatt als CampaignAsset-Ressourcen.
• Es wurde performance_max_placement_view hinzugefügt, mit dem Impressionen der Placements zurückgegeben werden, auf denen Performance Max-Anzeigen ausgeliefert wurden.
• Hinzugefügt: AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planung

• (Nur für Konten auf der Zulassungsliste) Es wurde ein neuer Dienst mit der Methode ContentCreatorInsightsService.GenerateCreatorInsights hinzugefügt, mit dem Nutzer Statistiken zu den beliebtesten YouTube-Creatorn abrufen können. So können Kunden nach Creatorn suchen, die eine Kombination aus Zielgruppen- und Inhalts-Targeting verwenden, oder Creator-Statistiken anhand einer Liste von YouTube-Kanal-IDs abrufen.
• Aktualisierungen für AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • audience, baseline_audience und data_month wurden in audience_definition verschoben.
  • Mit audience_description lassen sich jetzt mithilfe generativer KI Targeting-Vorschläge aus einer kostenlosen Textbeschreibung generieren.
• Es wurde AudienceInsightsService.GenerateTargetingSuggestionMetrics hinzugefügt, über das Messwerte zur potenziellen Reichweite für bestimmte Kombinationen von Zielgruppen-Targetings zurückgegeben werden.

Empfehlungen

• Mit RecommendationService.GenerateRecommendations können jetzt Empfehlungen zu optimierten Budgetvorschlägen während der Kampagnenerstellung generiert werden. Dazu muss der Empfehlungstyp CAMPAIGN_BUDGET in GenerateRecommendationsRequest.recommendation_types[] eingefügt werden. Das funktioniert für Performance Max- und Suchkampagnen.

Berichte

• Die Felder summary_row_setting und return_total_results_count von SearchGoogleAdsRequest wurden durch das Feld search_settings vom Typ SearchSettings ersetzt.
  • omit_results
  • return_summary_row
  • return_total_results_count
• Die folgenden neuen Messwerte zu allgemeinen ungültigen Klicks wurden hinzugefügt, z. B. solche, die von Bots oder Crawlern generiert wurden oder unregelmäßige Muster aufweisen. Sie können mit dem Bericht campaign abgefragt werden.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• Den folgenden Werten wurde QuotaError hinzugefügt:
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

v17.1.0 (07.08.2024)

Die folgenden neuen Funktionen und Updates wurden in Version 17.1 hinzugefügt.

Assets

• Über 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

• ShareablePreviewService.GenerateShareablePreviews() generiert die URLs shareable_preview_url in der Antwort für teilbare Anzeigenvorschauen für aktivierte und pausierte Asset-Gruppen.
  • 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 den Status ändern: ASSET_GROUP.

Conversions

• Neues Segmentfeld für die SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, über die Sie Diagnosedaten zum Conversion-Upload auf Conversion-Aktionsebene aufrufen können.
• Den Offline-Diagnoseberichten werden die folgenden Messwerte 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(), das ein primäres Attribut und eine Sammlung von Zielgruppenattributen als Eingabe akzeptiert und die Schätzungen der Überschneidung der potenziellen YouTube-Reichweite zwischen dem primären Attribut und den Zielgruppenattributen zurückgibt.

Berichte

• Unterstützung für die Segmentierung von per_store_view basierend auf segments.date

Videos

• Unterstützung für das Abrufen von Informationen zu den folgenden Standardgebotsstrategien für Videokampagnen mithilfe von Berichten wie ad_group und campaign:
  • Campaign.fixed_cpm (Fester CPM (Cost-per-1000-Impressions))
  • Campaign.target_cpv (Ziel-CPV (Cost-per-View))
• Campaign.video_campaign_settings mit denen Sie anhand der folgenden Berichtsfelder festlegen 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, mit dem Sie die folgenden Berichte nach dem Videoanzeigenformat segmentieren können:
  • 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 mit anderen Diensten in der Google Ads API abgeglichen. Unter Objekte abrufen finden Sie die empfohlene Methode zum Abrufen von Anzeigen und anderen Ressourcentypen.
• Es wurden weitere Validierungen für ImageAdInfo.image_asset hinsichtlich Abmessungen und Format hinzugefügt. Wenn das Bild ungültig ist, können die folgenden Fehler auftreten:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Assets

• Neues Enum hinzugefügt: ClickType.AD_IMAGE
• Die folgenden neuen Berichte mit neuen Messwerten für Performance Max- und Suchkampagnen wurden hinzugefügt:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Zielgruppen

• OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED wurde hinzugefügt

Batchjobs

• Es wurde BatchJobError.REQUEST_TOO_LARGE hinzugefügt. Dieser Fehler wird ausgegeben, wenn die eingereichte AddBatchJobOperationsRequest größer als 10484504 Byte ist.
• Unterstützung für das Festlegen von MutateOperation.asset_group_operation bei Verwendung von BatchJobService hinzugefügt. So können Sie mit der Batchverarbeitung ganze Performance Max-Kampagnen erstellen und verwalten. Weitere Informationen findest du in unserem neuen Leitfaden.

Kampagnen

• In allen Feldern, Enumerationen und Fehlern aller Ressourcen in der Google Ads API, z. B. Kampagnen, Anzeigen und Assets, wurde „Discovery“ in „Demand Gen“ umbenannt. AdvertisingChannelType.DISCOVERY wird beispielsweise zu AdvertisingChannelType.DEMAND_GEN.
• Es wurde das Symbol Campaign.keyword_match_type hinzugefügt, mit dem Sie die Keyword-Option für alle Keywords in einer Kampagne festlegen können.

Conversions

• Für SKAdNetwork gilt Folgendes:
  • 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 auch dann mit der Antwort zurückgegeben, wenn sie null sind. So sind sie mit anderen Messwerten konsistent.
  • 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

• Die folgenden Felder wurden zu AdGroupCriterion hinzugefügt, um anzugeben, ob das Kriterium für die Anzeigengruppe ausgeliefert wird, oder die Gründe dafür, dass dies nicht der Fall ist:
  • 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

• „Add“ (Hinzufügen) mit LocalServicesLeadService.AppendLeadConversation(): Hiermit wird ein neuer LocalServicesLeadConversation an LocalServicesLead angehängt. Je nachdem, wie der Lead erstellt wurde, werden die Nachrichten über geeignete Kanäle wie SMS an die Nutzer gesendet.
  • Die Größe von AppendLeadConversationRequest.conversations ist auf 1.000 beschränkt.
  • In Conversation.local_services_lead kann nur LocalServicesLead mit lead_type auf LeadType.MESSAGE festgelegt werden.
• ConversationType wurde neue Enum-Werte hinzugefügt:
  • WHATSAPP für eine Unterhaltung, die über WhatsApp gestartet wurde.
  • ADS_API, um eine Unterhaltung darzustellen, die mit der neuen Methode LocalServicesLeadService.AppendLeadConversation() begonnen wurde.
• local_services_verification_artifact wurden die folgenden neuen Felder hinzugefügt:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Berichte

• Bei Abfragen für product_link können Sie jetzt 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.
• Wenn Sie eine page_size an GoogleAdsService.Search übergeben, wird der Fehler RequestError.PAGE_SIZE_NOT_SUPPORTED ausgegeben.

Shopping

• Neuer Bericht shopping_product hinzugefügt, der der Seite Produkte in der Google Ads-Benutzeroberfläche entspricht. Es werden Daten zum aktuellen Status von Produkten aus Google Merchant Center-Konten zurückgegeben, die mit einem Google Ads-Konto verknüpft sind.
  • Wenn Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream verwenden, können Sie Messwerte im Bericht shopping_product mit segments.date filtern. Eine Segmentierung nach Datum ist nicht zulässig und führt zu einem Fehler vom Typ ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Vereinheitlichte Zielvorhaben

• UserListCustomerTypeService.MutateUserListCustomerTypes() wurde hinzugefügt, um Zielgruppenkundentypen zu konfigurieren.
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings wurde entfernt. Verwenden Sie stattdessen UserListCustomerTypeService.MutateUserListCustomerTypes(), um Zielgruppeneinstellungen für Zielvorhaben für den Kundenlebenszyklus zu konfigurieren.
  • Sie können eine Nutzerliste anhängen oder loslösen, indem Sie UserListCustomerType.customer_type_category auf UserListCustomerTypeCategory.PURCHASERS festlegen, um sie in eine vorhandene Kundendefinition für Zielvorhaben des Kundenlebenszyklus aufzunehmen oder daraus auszuschließen. Weitere Informationen finden Sie unter Zielgruppen segmentieren.

Videos

• Die folgenden Werte wurden zu 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 Inventareinstellungen für Video-Assets beim Erstellen von DemandGenVideoResponsiveAdInfo zu unterstützen.
• (Nur für Konten auf der Zulassungsliste) Campaign.video_brand_safety_suitability kann jetzt geändert werden.

Archivierte Versionshinweise

Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.