Steuerelemente und Inventarfilterung für vertikale Anzeigen

Vertikale Anzeigen bieten spezielle Funktionen für Suchkampagnen mit aktivierter Funktion „AI Max für Suchkampagnen“, die mit einem branchenspezifischen Feed verknüpft sind, z. B. Hotels. Sie können auf Anzeigengruppenebene festlegen, welche vertikalen Anzeigenformate ausgeliefert werden, und mit Regeln für Artikelgruppen für vertikale Anzeigen steuern, auf welche Feedentitäten die Ausrichtung erfolgt.

Übersicht

In diesem Leitfaden werden zwei Hauptfunktionen für die Verwaltung vertikaler Anzeigen behandelt:

1. Formateinstellungen:Sie können auf Anzeigengruppenebene bestimmte Anzeigenformate (Textanzeigen, Buchungslinks und vertikale Anzeigen für Angebote) aktivieren oder deaktivieren.
2. Verwaltung von Artikeln für vertikale Anzeigen : Sie können bestimmte Inventare aus Ihrem verknüpften branchenspezifischen Feed (früher: Reisefeed) filtern und darauf ausrichten. Dazu verwenden Sie ein regelbasiertes System mit SharedSet und SharedCriterion.

Vorbereitung

Bevor Sie diese Funktionen implementieren, muss Ihre Kampagne die folgenden Anforderungen erfüllen:

• Kampagnentyp:Es muss sich um eine Suchkampagne handeln.
• Branchenspezifischer Feed:Auf Kunden- oder Kampagnenebene muss ein aktiver branchenspezifischer Datenfeed verknüpft sein. Informationen zum Verknüpfen eines Feeds auf Kampagnenebene finden Sie unter Branchenspezifische Datenfeeds auf Kampagnenebene verknüpfen. Wenn Sie einen branchenspezifischen Datenfeed verknüpfen, werden Reisefeeds in Suchanzeigen aktiviert und die Einstellungen für vertikale Anzeigen für die Kampagne freigeschaltet.
• AI Max für Suchkampagnen:Die Einstellung „AI Max für Suchkampagnen“ muss für die Kampagne aktiviert sein.

Hinweis: Wenn Sie die Einstellungen für die Formateinstellungen für eine Kampagne ohne „AI Max für Suchkampagnen“ oder einen aktiven branchenspezifischen Datenfeed ändern, tritt ein Fehler mit der Meldung VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX oder VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED auf. Wenn Sie eine Regel für Artikelgruppen mit einer Dimension hinzufügen, die für den branchenspezifischen Typ nicht unterstützt wird, tritt ein Fehler mit der Meldung VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE auf.

Branchenspezifische Datenfeeds auf Kampagnenebene verknüpfen

Wenn Sie Reisefeeds in Suchanzeigen (TFSA) aktivieren und die Einstellungen für vertikale Anzeigen in Ihrer Kampagne freischalten möchten, können Sie Ihre Asset-Sammlung für branchenspezifische Datenfeeds auf Kampagnenebene verknüpfen. Gehen Sie dazu so vor: Alternativ können Sie diese Funktionen für alle Kampagnen in Ihrem Konto aktivieren, indem Sie den Feed auf Kundenebene verknüpfen. Folgen Sie dazu der Anleitung zum Verknüpfen auf Kundenebene im Leitfaden zu Reisefeeds in Suchanzeigen.

1. Erstellen Sie ein CampaignAssetSet-Objekt und legen Sie für asset_set den Ressourcennamen Ihrer Asset-Sammlung für branchenspezifische Feeds und für campaign den Ressourcennamen Ihrer Kampagne fest.
2. Erstellen Sie ein CampaignAssetSetOperation und legen Sie für create das CampaignAssetSet fest.
3. Senden Sie den Vorgang mit CampaignAssetSetService.MutateCampaignAssetSets.

Weitere Informationen zum Verwalten von Reisefeeds im großen Maßstab finden Sie in der Dokumentation zu Reisefeeds in Suchanzeigen.

Formateinstellungen für Anzeigengruppen

Sie können konfigurieren, welche vertikalen Anzeigenformate für eine bestimmte Anzeigengruppe aktiv sind. Dies wird über das vertical_ads_format_setting (VerticalAdsFormatSetting) Feld in der AdGroup Ressource verwaltet.

Verfügbare Formate

• Textanzeigen (disable_text_ads): Standardmäßig aktiviert. Kann deaktiviert werden.
• Buchungslinks (enable_booking_links): Aktivierung erforderlich. Wird nur für branchenspezifische Feeds vom Typ HOTELS und THINGS_TO_DO unterstützt.
• Vertikale Anzeigen für Angebote (enable_vertical_promotion_ads): Aktivierung erforderlich.

Validierungsregeln

• Sie können nicht alle drei Formate gleichzeitig für eine einzelne Anzeigengruppe deaktivieren.
• enable_booking_links kann nur auf true gesetzt werden, wenn der aktive branchenspezifische Feed der Kampagne HOTELS oder THINGS_TO_DO ist.
• Diese Einstellungen gelten nur für SEARCH_STANDARD und SEARCH_DYNAMIC_ADS Anzeigengruppentypen.

Beispiel: Formateinstellungen aktualisieren

Im folgenden Java-Beispiel wird gezeigt, wie Sie Textanzeigen deaktivieren und vertikale Anzeigen für Angebote für eine vorhandene Anzeigengruppe aktivieren:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        AdGroup.VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

Verwaltung von Artikeln für vertikale Anzeigen

Wenn Sie auf eine bestimmte Teilmenge Ihres Feedinventars ausrichten möchten, z. B. „Hotels in Berlin“ oder „1-Sterne-Hotels ausschließen“, müssen Sie Regeln für Artikelgruppen für vertikale Anzeigen verwenden.

Funktionsweise des Datenmodells

Das Datenmodell verwendet einen Ansatz mit gemeinsamen Kriterien:

1. SharedSet: Erstellen Sie ein SharedSet mit dem Typ VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
2. SharedCriterion: Fügen Sie dieser Gruppe Regeln (Kriterien) hinzu. Jede Regel gibt eine Dimension an, z. B. Stadt oder Hotelklasse, und einen Wert. Sie können auch negative Kriterien erstellen, um Artikel auszuschließen.
3. AdGroupCriterion: Verknüpfen Sie das SharedSet mit Ihrer AdGroup über ein AdGroupCriterion (vertical_ads_item_group_rule_list).

Unterstützte Dimensionen

Sie können Entitäten in SharedCriterion (VerticalAdsItemGroupRuleInfo) je nach SharedSet's vertical_ads_item_vertical_type nach den folgenden Dimensionen filtern:

• item_code: Spezifische Eintrags-ID (wird für alle branchenspezifischen Typen unterstützt).
• city_criterion_id, region_criterion_id, country_criterion_id: Ressourcennamen für geografische Zielkonstanten (geoTargetConstants/{id}; werden für alle branchenspezifischen Typen außer FLIGHTS unterstützt).
• hotel_class: Sternebewertung von 1 bis 5 (HOTELS only).
• user_rating (ab v24 ): Gerundete Nutzerbewertung von 1 bis 5 (THINGS_TO_DO only).
• venue, event_participant_display_name (ab v24 ): Filter für Veranstaltungsort und Anzeigename des Teilnehmers (EVENTS only).

Codebeispiel: Regeln erstellen und verknüpfen

In diesem Python-Beispiel wird eine Regel erstellt, mit der Artikel in „Berlin“ oder „San Francisco“ eingeschlossen und „1-Sterne-“ und „2-Sterne-Hotels“ ausgeschlossen werden:

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

Manuelle CPC-Gebote pro Entität

Ab v25 können Sie für Suchkampagnen für die Reisebranche (Suchkampagnen mit aktivierter Funktion „AI Max für Suchkampagnen“ und einem verknüpften Hotelfeed), die die Gebotsstrategie „Manuelle CPC-Gebote“ (BiddingStrategyType.MANUAL_CPC) verwenden, manuelle CPC-Gebotsüberschreibungen (cpc_bid_micros) für einzelne Hotelfeedartikel festlegen. Verwenden Sie dazu das Kriterium EntityBid (ad_group_criterion.entity_bid) mit CriterionType.VERTICAL_ADS_ITEM_BID und entity_bid.item_code.

Negative Kriterien (negative = true), Nicht-Suchkampagnen und automatische oder Smart Bidding-Strategien werden für VERTICAL_ADS_ITEM_BID nicht unterstützt und geben ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT zurück. Leistungsmesswerte werden für VERTICAL_ADS_ITEM_BID-Kriterien nicht ausgefüllt. Vollständige Schemadetails, GAQL-Abfragen und Beispiele für Mutate-Nutzlasten finden Sie im Leitfaden zu manuellen CPC-Geboten pro Entität in Reisefeeds in Suchanzeigen.

Leistungsberichte

Sie können Leistungsmesswerte für vertikale Anzeigen mit den GoogleAdsService.SearchStream oder GoogleAdsService.Search Methoden abrufen.

Segmente für vertikale Anzeigen

• segments.vertical_ads_hotel_class: Ganzzahliger Wert (1 bis 5 Sterne) für die Sternebewertung eines Hoteleintrags.
• segments.vertical_ads_listing: Kennung für einen bestimmten Eintrag für vertikale Anzeigen.
• segments.vertical_ads_listing_brand: Marke, die mit einem Eintrag für vertikale Anzeigen verknüpft ist.
• segments.vertical_ads_listing_city: Stadt, die mit dem Eintrag verknüpft ist.
• segments.vertical_ads_listing_country: Land, das mit dem Eintrag verknüpft ist.
• segments.vertical_ads_listing_region: Region, die mit dem Eintrag verknüpft ist.
• segments.vertical_ads_partner_account: Das Partnerkonto in einem Partner Center (z. B. Hotel Center), das Inventarfeeddaten liefert.
• segments.vertical_ads_vertical: Der branchenspezifische Typ, z. B. Hotel oder Mietwagen.
• segments.vertical_ads_event_participant_display_names: Die Anzeigenamen der Teilnehmer in einem Veranstaltungs-Eintrag, z. B. Künstler, Redner oder Teams.
• segments.vertical_ads_listing_user_rating (ab v24 ): Ganzzahliger Wert (1 bis 5) für die Nutzerbewertung des Eintrags für vertikale Anzeigen.
• segments.vertical_ads_listing_venue (ab v24 ): Der Name des Veranstaltungsorts für den Eintrag für vertikale Anzeigen (z. B. ein Konzertsaal).
• segments.vertical_ads_price_tier (ab v25 ): Bucket für die relative Wettbewerbsfähigkeit des Preises für Hoteleinträge.
• segments.vertical_ads_rate_rule_id (ab v25 ): String-Kennung für private oder bedingte Preisregeln, die auf das Gebot oder die Impression angewendet werden.
• segments.vertical_ads_rate_type (ab v25 ): Kategorisierung des öffentlichen, privaten oder nutzerabhängigen Preistyps.

Segmente für Dimensionen von Reiseplänen

Ab v25 können Sie Leistungsberichte für vertikale Anzeigen, die mit Reise- und Unterkunfts feeds verknüpft sind, nach Dimensionen für Reisepläne segmentieren:

• segments.advance_booking_window: Das Vorbuchungsfenster für den Reiseplan in Tagen.
• segments.length_of_booking: Die Buchungsdauer für den Reiseplan in Tagen.
• segments.start_date: Das Startdatum der Buchung im Format yyyy-MM-dd.
• segments.start_day_of_week: Der Starttag der Woche der Buchung.
• segments.user_set_dates: Gibt an, ob vom Nutzer angegebene Daten ausgewählt wurden (USER_SELECTED oder DEFAULT_SELECTION).

Messwerte für vertikale Anzeigen

Ab v25 können Sie die folgenden Messwerte für vertikale Anzeigen abrufen:

• metrics.vertical_ads_potential_impressions: Potenzielle Impressionen, die die Gesamtzahl der sichtbarkeitsbegrenzten möglichen Impressionen im Abfragekontext darstellen.
• metrics.vertical_ads_average_booking_value_micros: Klickgewichteter durchschnittlicher Tagespreis in Mikros, einschließlich Steuern und Gebühren, über die gesamte Aufenthaltsdauer.
• metrics.vertical_ads_price_difference_percentage: Prozentuale Differenz zwischen dem vom Werbetreibenden angebotenen Preis und dem niedrigsten Preis der Konkurrenz für dieselbe Unterkunft.

Hinweis: Die metrics.vertical_ads_* Messwerte und die Segmente für Dimensionen von Reiseplänen (segments.advance_booking_window, segments.length_of_booking, segments.start_date, segments.start_day_of_week, und segments.user_set_dates) können nicht zusammen in derselben GAQL-Abfrage ausgewählt werden.

Beispiel für GAQL-Abfragen

Diese Abfrage ruft Wettbewerbs- und Buchungsmesswerte für vertikale Anzeigen ab, segmentiert nach Stadt des Eintrags, Preisklasse und Preistyp:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Diese Abfrage segmentiert Standardleistungsmesswerte nach Buchungsdimensionen für Reisepläne:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Fehlerbehandlung

Dies sind häufige Fehler, die bei der Konfiguration vertikaler Anzeigen auftreten können:

Fehlercode	Ursache	Empfohlene Maßnahmen
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING	Alle drei Anzeigenformate (Textanzeigen, Buchungslinks, Anzeigen für Angebote) wurden gleichzeitig deaktiviert oder enable_booking_links wurde für eine andere Branche als HOTELS oder THINGS_TO_DO aktiviert.	Achten Sie darauf, dass in VerticalAdsFormatSetting mindestens ein Format aktiviert ist, und aktivieren Sie Buchungslinks nur für HOTELS oder THINGS_TO_DO Feeds.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX	Für die Kampagne ist „AI Max für Suchkampagnen“ nicht aktiviert.	Aktivieren Sie „AI Max für Suchkampagnen“ in den Kampagneneinstellungen.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED	Für die Kampagne ist kein aktiver branchenspezifischer Datenfeed vorhanden.	Achten Sie darauf, dass auf Kunden- oder Kampagnen ebene ein gültiger branchenspezifischer Feed verknüpft ist.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST	Der in AdGroupCriterion angegebene Ressourcename für SharedSet ist nicht vorhanden oder hat nicht den Typ VERTICAL_ADS_ITEM_GROUP_RULE_LIST.	Prüfen Sie, ob der shared_set Ressourcename auf ein vorhandenes SharedSet vom Typ VERTICAL_ADS_ITEM_GROUP_RULE_LIST verweist.
CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET	Das in dem AdGroupCriterion referenzierte SharedSet hat den Status REMOVED.	Verweisen Sie auf ein aktiviertes SharedSet vom Typ VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE	Die verwendete Kriteriendimension wird für die jeweilige Branche nicht unterstützt, z. B. die Hotelklasse für Mietwagen.	Prüfen Sie, ob die vertical_ads_item_group_rule Dimension mit Ihrem branchenspezifischen Typ übereinstimmt.