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 dieser Anleitung werden zwei Hauptfunktionen für die Verwaltung von vertikalen Anzeigen 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: Sie können bestimmte Inventare aus Ihrem verknüpften Branchenfeed (früher Reisefeed) mithilfe eines regelbasierten Systems filtern und ausrichten, das SharedSet und SharedCriterion umfasst.

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 unter Vertikale Datenfeeds auf Kampagnenebene verknüpfen. Durch das Verknüpfen eines vertikalen Datenfeeds werden Reisefeeds in Suchanzeigen aktiviert und die Steuerelemente für vertikale Anzeigen für die Kampagne werden aktiviert.
• 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.
• 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.
• 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 die vertikale Promotion 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(
        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...

Elemente für vertikale Anzeigen verwalten

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) nach den folgenden Dimensionen filtern:

• item_code: Die ID des spezifischen Eintrags.
• city_criterion_id, region_criterion_id, country_criterion_id: Ressourcennamen für geografische Zielvorhaben (geoTargetConstants/{id}).
• hotel_class: Sternebewertung (1–5).
• user_rating, venue, event_participant_display_name (ab v24): Filter für Event- und Branchenlistenbewertung, Veranstaltungsort und Teilnehmername.

Codebeispiel: Regeln erstellen und verknüpfen

In diesem Python-Beispiel wird eine Regel erstellt, mit der Artikel 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...

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 Hotelklassifizierung 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 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 (ab v24): 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 Eintrags für vertikale Anzeigen 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.

Dimensionssegmente für Reisepläne

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: Das Vorausbuchungsfenster für die Reise in Tagen.
• segments.length_of_booking: Die Länge 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 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, über 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-Beispielabfrage

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.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
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: