Steuerelemente und Inventarfilterung für vertikale Anzeigen

Vertikale Anzeigen bieten spezielle Funktionen für Suchkampagnen, die mit einem vertikalen Feed verknüpft sind, z. B. Hotels, und für die AI Max für Suchkampagnen aktiviert ist. Sie können auf Anzeigengruppenebene festlegen, welche vertikalen Anzeigenformate ausgeliefert werden, und mithilfe von Regeln für Artikelgruppen in vertikalen Anzeigen festlegen, auf welche Feedentitäten die Ausrichtung erfolgen soll.

Übersicht

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

1. Formateinstellungen:Sie können bestimmte Anzeigenformate (Textanzeigen, Buchungslinks und Anzeigen für Reiseangebote) auf Anzeigengruppenebene aktivieren oder deaktivieren.
2. Verwaltung von Elementen für vertikale Anzeigen:Sie können bestimmtes Inventar aus Ihrem verknüpften vertikalen Feed (früher „Reisefeed“) mithilfe eines regelbasierten Systems mit SharedSet und SharedCriterion filtern und darauf ausrichten.

Vorbereitung

Bevor Sie diese Funktionen implementieren, müssen Sie sicherstellen, dass Ihre Kampagne die folgenden Anforderungen erfüllt:

• Kampagnentyp:Suchkampagne.
• Vertikaler Feed:Auf Kunden- oder Kampagnenebene muss ein aktiver vertikaler Datenfeed verknüpft sein. Informationen zum Verknüpfen eines Feeds auf Kampagnenebene finden Sie unter Branchenspezifische Datenfeeds auf Kampagnenebene verknüpfen. Wenn Sie einen vertikalen 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.

Vertikale Datenfeeds auf Kampagnenebene verknüpfen

Wenn Sie Reisefeeds in Suchanzeigen aktivieren und die Einstellungen für vertikale Anzeigen in Ihrer Kampagne aktivieren möchten, können Sie Ihr Asset-Set für vertikale Datenfeeds auf Kampagnenebene verknüpfen. Gehen Sie dazu so vor: Wenn Sie diese Funktionen für alle Kampagnen in Ihrem Konto aktivieren möchten, können 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 asset_set auf den Ressourcennamen Ihrer Asset-Sammlung für vertikale Feeds und campaign auf den Ressourcennamen Ihrer Kampagne fest.
2. Erstellen Sie ein CampaignAssetSetOperation, wobei create auf CampaignAssetSet festgelegt ist.
3. Senden Sie den Vorgang mit CampaignAssetSetService.MutateCampaignAssetSets.

Weitere Informationen zum Verwalten von Reisefeeds in großem Umfang finden Sie in der Dokumentation zu Reisefeeds in Suchanzeigen.

Einstellungen für Anzeigenformate auf Anzeigengruppenebene

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

Verfügbare Formate

• Textanzeigen (disable_text_ads): Standardmäßig aktiviert. Kann deaktiviert werden.
• Buchungslinks (enable_booking_links): Aktivierung erforderlich. Wird nur für die Branchenfeeds HOTELS und THINGS_TO_DO unterstützt.
• Vertikale Werbeanzeigen (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 festgelegt werden, wenn der aktive vertikale Feed der Kampagne HOTELS oder THINGS_TO_DO ist.
• Diese Einstellungen gelten nur für die Anzeigengruppentypen SEARCH_STANDARD und SEARCH_DYNAMIC_ADS.

Beispiel: Formateinstellungen aktualisieren

Im folgenden Java-Beispiel wird gezeigt, wie Sie Textanzeigen deaktivieren und Anzeigen für vertikale Werbung 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 Elementen für vertikale Anzeigen

Wenn Sie eine bestimmte Teilmenge Ihres Feedinventars ansprechen möchten, z. B. „Hotels in Boston“ 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 einen SharedSet vom Typ VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
2. SharedCriterion: Fügen Sie diesem Satz Regeln (Kriterien) hinzu. In jeder Regel werden eine Dimension, z. B. „Stadt“ oder „Hotelklasse“, und ein Wert angegeben. Sie können auch negative Kriterien erstellen, um Elemente auszuschließen.
3. AdGroupCriterion: Verknüpfen Sie die SharedSet mit Ihrer AdGroup. Verwenden Sie dazu eine AdGroupCriterion (vertical_ads_item_group_rule_list).

Unterstützte Dimensionen

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

• item_code: ID des Eintrags (für alle Branchentypen unterstützt).
• city_criterion_id, region_criterion_id, country_criterion_id: Ressourcennamen für Geo Target Constant (geoTargetConstants/{id}; unterstützt für alle vertikalen Typen außer FLIGHTS).
• hotel_class: Sternebewertung von 1 bis 5 (nur HOTELS).
• user_rating (ab v24): Abgerundete Nutzerbewertung von 1 bis 5 (nur THINGS_TO_DO).
• venue, event_participant_display_name (ab v24): Filter für den Veranstaltungsort und den Anzeigenamen des Teilnehmers (nur EVENTS).

Codebeispiel: Regeln erstellen und verknüpfen

In diesem Python-Beispiel wird eine Regel erstellt, um Elemente in „Boston“ oder „San Francisco“ einzuschließen und „1-Sterne-“ und „2-Sterne-Hotels“ auszuschließen:

# 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 Element

Ab dem v25 können Sie für Suchkampagnen für die Reisebranche (Suchkampagnen mit aktiviertem 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 Hotelfeed-Elemente festlegen. Verwenden Sie dazu das Kriterium EntityBid (ad_group_criterion.entity_bid) mit CriterionType.VERTICAL_ADS_ITEM_BID und entity_bid.item_code.

Auszuschließende Kriterien (negative = true), Kampagnen, die nicht im Suchnetzwerk ausgeliefert werden, sowie 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. Für VERTICAL_ADS_ITEM_BID-Kriterien werden keine Leistungsmesswerte erfasst. Vollständige Schemadetails, GAQL-Abfragen und Beispiele für Mutate-Nutzlasten finden Sie im Leitfaden „Reisefeeds in Suchanzeigen“ unter Manuelle CPC-Gebote pro Entität. Informationen zum Festlegen multiplikativer Anzeigengruppengebotsanpassungen für Reiseplandimensionen für Hotelanzeigen mit AdGroupBidModifier finden Sie unter Gebote mit Gebotsanpassungen anpassen.

Leistungsberichte

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

Segmente für vertikale Anzeigen

• segments.vertical_ads_hotel_class: Ganzzahliger Wert (1 bis 5 Sterne), der die Klassifizierung für einen Hoteleintrag angibt.
• segments.vertical_ads_listing: Kennung für einen bestimmten vertikalen Anzeigeneintrag.
• segments.vertical_ads_listing_brand: Marke, die mit einem vertikalen Anzeigeneintrag verknüpft ist.
• segments.vertical_ads_listing_city: Die Stadt, die mit dem Eintrag verknüpft ist.
• segments.vertical_ads_listing_country: Das mit dem Eintrag verknüpfte Land.
• segments.vertical_ads_listing_region: Die mit dem Eintrag verknüpfte Region.
• segments.vertical_ads_partner_account: Das Partnerkonto in einem Partner Center (z. B. Hotel Center), das Inventarfeeddaten bereitstellt.
• segments.vertical_ads_vertical: Der Branchentyp, z. B. Hotel oder Mietwagen.
• segments.vertical_ads_event_participant_display_names: Die Anzeigenamen der Teilnehmer in einem Veranstaltungseintrag, z. B. Künstler, Redner oder Teams.
• segments.vertical_ads_listing_user_rating (ab v24): Ganzzahliger Wert (1 bis 5), der die Nutzerbewertung des vertikalen Anzeigeneintrags angibt.
• segments.vertical_ads_listing_venue (ab v24): Der Name des Veranstaltungsorts für den Eintrag mit vertikalen Anzeigen (z. B. ein Konzertort).
• segments.vertical_ads_price_tier (ab v25): Bucket für die relative Preiswettbewerbsfähigkeit von Hoteleinträgen.
• segments.vertical_ads_rate_rule_id (ab v25): String-ID, die den Regeln für private oder bedingte Preise entspricht, die auf das Gebot oder die Impression angewendet wurden.
• segments.vertical_ads_rate_type (ab v25): Kategorisierung des öffentlichen, privaten oder nutzerabhängigen Preistyps.

Dimensionssegmente für Reisepläne

Ab v25 können Sie Leistungsberichte für vertikale Anzeigen, die mit Feeds für Reisen und Unterkünfte verknüpft sind, mithilfe von Dimensionen für Reisepläne segmentieren:

• segments.advance_booking_window: Der Reservierungszeitraum für den Reiseplan in Tagen.
• segments.length_of_booking: Die Dauer der Buchung für den Reiseplan in Tagen.
• segments.start_date: Das Startdatum der Buchung im Format yyyy-MM-dd.
• segments.start_day_of_week: Der erste Wochentag 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 möglichen Impressionen mit View-Cap darstellen, die im Abfragekontext verfügbar sind.
• metrics.vertical_ads_average_booking_value_micros: Klickgewichteter durchschnittlicher Tagespreis in Mikros, einschließlich Steuern und Gebühren, für die gesamte Aufenthaltsdauer.
• metrics.vertical_ads_price_difference_percentage: Prozentuale Differenz zwischen dem vom Werbetreibenden angebotenen Preis und dem niedrigsten konkurrierenden Preis für dieselbe Unterkunft.

Beispiele für GAQL-Abfragen

Mit dieser Abfrage werden Wettbewerbs- und Buchungsmesswerte für vertikale Anzeigen abgerufen, die nach Stadt des Eintrags, Preisstufe und Tariftyp segmentiert sind:

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

Mit dieser Abfrage werden standardmäßige Leistungsmesswerte nach Buchungsdimensionen für Reisepläne segmentiert:

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

Die folgenden Fehler können beim Konfigurieren von vertikalen Anzeigen auftreten: