Steuerelemente und Inventarfilterung für vertikale Anzeigen

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

Übersicht

In diesem Leitfaden werden zwei Hauptfunktionen für die Verwaltung von Anzeigen für bestimmte Branchen behandelt:

1. Formatsteuerung:Sie können bestimmte Anzeigenformate (Textanzeigen, Buchungslinks und Anzeigen für Branchenangebote) auf Anzeigengruppenebene aktivieren oder deaktivieren.
2. Verwaltung von Anzeigenartikeln für Branchen: Mit einem regelbasierten System, das SharedSet und SharedCriterion umfasst, können Sie bestimmte Inventare aus Ihrem verknüpften Branchenfeed (früher Reisefeed) filtern und darauf ausrichten.

Vorbereitung

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

• Kampagnentyp:Muss eine Suchkampagne sein.
• Branchenfeed:Ein aktiver Branchenfeed muss auf Kunden- oder Kampagnenebene verknüpft sein. Weitere Informationen zum Verknüpfen eines Feeds auf Kampagnenebene finden Sie hier. Durch die Verknüpfung eines vertikalen Datenfeeds werden Reisefeeds in Suchanzeigen aktiviert und die Einstellungen für vertikale Anzeigen für die Kampagne werden 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 (TFSA) aktivieren und die Steuerelemente für vertikale Anzeigen in Ihrer Kampagne verwenden möchten, können Sie die Asset-Sammlung für Ihren vertikalen Datenfeed 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 asset_set auf den Ressourcennamen Ihrer Asset-Sammlung für vertikale Feeds und campaign auf den Ressourcennamen Ihrer Kampagne fest.
2. Erstellt ein CampaignAssetSetOperation mit create, das auf CampaignAssetSet gesetzt ist.
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.

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 Feeds für die Branchen HOTELS und THINGS_TO_DO unterstützt.
• Anzeigen für vertikale Produkte (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 Anzeigengruppen vom Typ SEARCH_STANDARD und SEARCH_DYNAMIC_ADS.

Beispiel: Formateinstellungen aktualisieren

Im folgenden Java-Beispiel wird gezeigt, wie Sie Textanzeigen deaktivieren und Anzeigen für vertikale Kampagnen 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 auf eine bestimmte Teilmenge Ihres Feedinventars ausrichten 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 basiert auf gemeinsamen Kriterien:

1. SharedSet: Erstellen Sie ein SharedSet mit dem Typ VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
2. SharedCriterion: Fügen Sie diesem Set Regeln (Kriterien) hinzu. In jeder Regel wird eine Dimension wie „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 Ihrem AdGroup über eine AdGroupCriterion (vertical_ads_item_group_rule_list).

Unterstützte Dimensionen

Sie können Einheiten in SharedCriterion (VerticalAdsItemGroupRuleInfo) anhand der folgenden Dimensionen filtern, je nach vertical_ads_item_vertical_type der SharedSet:

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

Codebeispiel: Regeln erstellen und verknüpfen

In diesem Python-Beispiel wird eine Regel erstellt, mit der Elemente in „Boston“ oder „San Francisco“ eingeschlossen und Hotels mit einem oder zwei Sternen 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 auf Kampagnenebene

Ab dem v25 können Sie für Suchkampagnen für die Reisebranche (Suchkampagnen mit aktivierter AI Max für Suchkampagnen und einem verknüpften Hotelfeed), in denen die Gebotsstrategie „Manuelle CPC-Gebote“ (BiddingStrategyType.MANUAL_CPC) verwendet wird, manuelle CPC-Gebotsüberschreibungen (cpc_bid_micros) für einzelne Hotelfeed-Elemente mit dem Kriterium EntityBid (ad_group_criterion.entity_bid) mit CriterionType.VERTICAL_ADS_ITEM_BID und entity_bid.item_code festlegen.

Negative Kriterien (negative = true), Kampagnen, die keine Suchkampagnen sind, 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 das Kriterium VERTICAL_ADS_ITEM_BID nicht erfasst. Vollständige Schemadetails, GAQL-Abfragen und Beispiele für Mutate-Payloads finden Sie im Leitfaden zu Reisefeeds in Suchanzeigen unter Manuelle CPC-Gebote pro Einheit.

Leistungsberichte

Sie können Leistungsmesswerte für branchenspezifische 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 Hotelkategorie für ein 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 Land, das mit dem Eintrag verknüpft ist.
• 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 Typ der Branche, z. B. „Hotel“ oder „Mietwagen“.
• segments.vertical_ads_event_participant_display_names: Die Anzeigenamen der Teilnehmer in einer Veranstaltungsliste, 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 Anzeigenlistings angibt.
• segments.vertical_ads_listing_venue (ab v24): Der Name des Veranstaltungsorts für die vertikale Anzeigenliste (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, die den auf das Gebot oder die Impression angewendeten privaten oder bedingten Ratenregeln entspricht.
• segments.vertical_ads_rate_type (ab v25): Kategorisierung des öffentlichen, privaten oder nutzerabhängigen Preises.

Segmente für die Dimension „Reiseplan“

Ab dem v25 können Sie Leistungsberichte für vertikale Anzeigen, die mit Reise- und Unterkunftsfeeds verknüpft sind, mit den folgenden 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 die Reiseroute 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 nutzerdefinierte Datumsangaben ausgewählt wurden (USER_SELECTED oder DEFAULT_SELECTION).

Messwerte für vertikale Anzeigen

Ab v25 können Sie die folgenden Messwerte für branchenspezifische 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, 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.

GAQL-Beispielabfragen

Mit dieser Abfrage werden wettbewerbsfähige Anzeigenmesswerte und Buchungsmesswerte für die Branche abgerufen, die nach Stadt des Eintrags, Preisklasse 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

In dieser Abfrage werden Standardleistungsmesswerte nach Dimensionen für die Buchung von Routen 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

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