Reisefeeds in Suchanzeigen

Wenn Ihre Produktfeeds für Hotels, Ferienunterkünfte oder Aktivitäten mit Ihrem Google Ads-Konto verknüpft sind, werden vorhandene Suchkampagnen in Google Ads automatisch mit Preisen und Bildern aus Ihren Feeds ergänzt. Diese Funktion wird als Reisefeeds in Suchanzeigen bezeichnet.

Hinweis: Wenn Sie Ihren vertikalen Datenfeed auf Kunden- oder Kampagnenebene verknüpfen, können in Ihrer Kampagne auch Steuerelemente und die Inventarfilterung für vertikale Anzeigen verwendet werden, wenn AI Max aktiviert ist. Bei manuellen CPC-Geboten können Sie für Hotelfeeds in Suchkampagnen für die Reisebranche manuelle CPC-Gebote pro Entität festlegen.

Zusammenspiel von Kunden- und Kampagneneinstellungen

Standardmäßig werden Links zu Reisefeeds (TRAVEL_FEED Asset-Sammlungen) von der Kundenebene über CustomerAssetSet Verknüpfungen an Kampagnen weitergegeben. Wenn Sie die Einstellungen auf Kundenebene für eine bestimmte Kampagne überschreiben möchten, müssen Sie TRAVEL_FEED dem Feld der Kampagne excluded_parent_asset_set_types hinzufügen und kampagnenspezifische Links mit CampaignAssetSet verwalten.

• Kundenfeeds übernehmen (Standard) : Lassen Sie die CustomerAssetSet-Verknüpfung auf Kundenebene verknüpft und stellen Sie sicher, dass Campaign.excluded_parent_asset_set_types nicht TRAVEL_FEED enthält.
• Auf Kundenebene deaktivieren:Entfernen Sie die CustomerAssetSet-Verknüpfung auf Kundenebene und verknüpfen Sie keine CampaignAssetSet-Verknüpfung auf Kampagnenebene.
• Bestimmte Kampagne deaktivieren:Fügen Sie TRAVEL_FEED zu Campaign.excluded_parent_asset_set_types hinzu und entfernen Sie alle CampaignAssetSet-Verknüpfungen auf Kampagnenebene.
• Nur bestimmte Kampagne aktivieren:Entfernen Sie die CustomerAssetSet-Verknüpfung auf Kundenebene und erstellen Sie dann eine CampaignAssetSet-Verknüpfung auf Kampagnenebene für diese Kampagne.
• Kampagnenspezifische Feeds verwenden, während andere Kampagnen weiterhin Feeds übernehmen:Fügen Sie TRAVEL_FEED zu Campaign.excluded_parent_asset_set_types der Kampagne hinzu und erstellen Sie eine CampaignAssetSet-Verknüpfung auf Kampagnenebene für sie.

Reisefeeds in Suchanzeigen deaktivieren

Wenn Sie diese Funktion nicht verwenden möchten, können Sie Reisefeeds in Suchanzeigen mit der Google Ads API auf Kunden- und Kampagnenebene deaktivieren.

Auf Kundenebene deaktivieren

So deaktivieren Sie Reisefeeds in Suchanzeigen auf Kundenebene:

1. Rufen Sie mit dem customer_asset_set Bericht sowohl customer_asset_set.resource_name als auch asset_set.resource_name für alle CustomerAssetSet Verknüpfungen ab, deren Typ TRAVEL_FEED ist:

   SELECT
     customer_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM customer_asset_set
   WHERE asset_set.type = 'TRAVEL_FEED'
   

2. Erstellen Sie für jeden customer_asset_set.resource_name eine CustomerAssetSetOperation und legen Sie für remove den in Schritt 1 abgerufenen customer_asset_set.resource_name fest.

3. Senden Sie mit den erstellten CustomerAssetSetOperation Objekten eine Anfrage an CustomerAssetSetService.MutateCustomerAssetSets.

Wenn Sie diese Funktion auf Kundenebene wieder aktivieren möchten, gehen Sie so vor:

1. Erstellen Sie für jede zugrunde liegende AssetSet (asset_set.resource_name) die Sie verknüpfen möchten, eine neue CustomerAssetSet. Legen Sie für asset_set den Wert asset_set.resource_name und für customer den Ressourcennamen Ihres Kunden fest.
2. Erstellen Sie für jede CustomerAssetSet in Schritt 1 erstellte CustomerAssetSetOperation und legen Sie für create die CustomerAssetSet fest.
3. Senden Sie mit den erstellten CustomerAssetSetOperation Objekten eine Anfrage an CustomerAssetSetService.MutateCustomerAssetSets.

Auf Kampagnenebene deaktivieren

Wenn Sie Reisefeeds in Suchanzeigen auf Kampagnenebene deaktivieren möchten, müssen Sie zuerst den übernommenen Aktivierungsstatus auf Kundenebene ausschließen:

1. Rufen Sie excluded_parent_asset_set_types mit dem campaign Bericht ab:

   SELECT
     campaign.excluded_parent_asset_set_types
   FROM campaign
   WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
   

2. Erstellen Sie ein neues Campaign-Objekt. Legen Sie für excluded_parent_asset_set_types die vorherigen Werte plus TRAVEL_FEED und resource_name den Ressourcennamen Ihrer Kampagne fest.

3. Erstellen Sie eine CampaignOperation und legen Sie für update die zuvor erstellte Campaign und für update_mask die entsprechenden Werte fest.

4. Senden Sie mit der CampaignOperation im vorherigen Schritt erstellten eine Anfrage an CampaignService.MutateCampaigns.

Entfernen Sie dann alle Verknüpfungen zu Reisefeeds auf Kampagnenebene:

1. Rufen Sie mit dem campaign_asset_set-Bericht sowohl campaign_asset_set.resource_name als auch asset_set.resource_name für alle CampaignAssetSet-Verknüpfungen der Kampagne ab, deren Typ TRAVEL_FEED ist:

   SELECT
     campaign_asset_set.resource_name,
     asset_set.resource_name,
     asset_set.name
   FROM campaign_asset_set
   WHERE campaign_asset_set.campaign =
       'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
     AND asset_set.type = 'TRAVEL_FEED'
   

2. Erstellen Sie für jeden campaign_asset_set.resource_name eine CampaignAssetSetOperation und legen Sie für remove den in Schritt 1 abgerufenen campaign_asset_set.resource_name fest.

3. Senden Sie mit den erstellten CampaignAssetSetOperation Objekten eine Anfrage an CampaignAssetSetService.MutateCampaignAssetSets.

Wenn Sie diese Funktion auf Kampagnenebene wieder aktivieren möchten, gehen Sie so vor:

1. Erstellen Sie für jede zugrunde liegende AssetSet (asset_set.resource_name) die Sie aktivieren möchten, eine neue CampaignAssetSet. Legen Sie für asset_set den Wert asset_set.resource_name und für campaign den Ressourcennamen Ihrer Kampagne fest.
2. Erstellen Sie für jede CampaignAssetSet in Schritt 1 erstellte CampaignAssetSetOperation und legen Sie für create die CampaignAssetSet fest.
3. Senden Sie mit den erstellten CampaignAssetSetOperation Objekten eine Anfrage an CampaignAssetSetService.MutateCampaignAssetSets.

Aktivierungsstatus auf Kundenebene für eine Kampagne wiederherstellen

So legen Sie fest, dass der Aktivierungsstatus einer Kampagne wieder von der Einstellung auf Kundenebene übernommen wird:

1. Erstellen Sie ein neues Campaign-Objekt. Legen Sie für excluded_parent_asset_set_types die vorherigen Werte ohne TRAVEL_FEED und für resource_name den Ressourcennamen Ihrer Kampagne fest.
2. Erstellen Sie eine CampaignOperation und legen Sie für update die zuvor erstellte Campaign und für update_mask die entsprechenden Werte fest.
3. Senden Sie mit der CampaignOperation im vorherigen Schritt erstellten eine Anfrage an CampaignService.MutateCampaigns.

Manuelle CPC-Gebote pro Entität

Ab der Google Ads API-Version v25 können Sie manuelle CPC-Gebots überschreibungen pro Entität für Hotels in Suchkampagnen für die Reisebranche mit der AdGroupCriterion Ressource und dem Kriterientyp CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid) konfigurieren.

Voraussetzungen und Kompatibilitätsanforderungen

Damit Sie VERTICAL_ADS_ITEM_BID-Kriterien erstellen und verwalten können, müssen die folgenden Bedingungen erfüllt sein:

• Kampagnentyp: Suchkampagnen für die Reisebranche (Suchkampagnen, AdvertisingChannelType.SEARCH, mit aktiviertem AI Max für Suchkampagnen Campaign.ai_max_setting.enable_ai_max und einem verknüpften Hotelfeed [TRAVEL_FEED Asset-Sammlung]; nur Hotelfeeds werden unterstützt).
• Gebotsstrategie: Nur manuelle CPC-Gebote (BiddingStrategyType.MANUAL_CPC).
  • Nicht für automatische oder Smart Bidding-Strategien (z. B. „Conversions maximieren“, „Conversion-Wert maximieren“, „Ziel-CPA“ oder „Ziel-ROAS“) verfügbar.
• Nur positive Kriterien: negative muss auf false gesetzt sein. Negative Gebote für Entitäten werden nicht unterstützt.
• Erforderliche Entitäts-ID und Gebot: entity_bid.item_code und cpc_bid_micros sind erforderlich, wenn Sie ein Kriterium für ein Entitätsgebot erstellen.

Schema- und Felddefinitionen

• Ressource:AdGroupCriterion (ad_group_criterion)
• Format des Ressourcennamens:customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Enum für Kriterientyp: CriterionType.VERTICAL_ADS_ITEM_BID
• Nachricht: EntityBid (ad_group_criterion.entity_bid)

Feld	Typ	Verhalten	Beschreibung
entity_bid	EntityBid	IMMUTABLE	Kriterium, das eine manuelle Gebotsüberschreibung für einen einzelnen Artikel darstellt.
entity_bid.item_code	string	IMMUTABLE, erforderlich	Die ID oder der Code, der eine bestimmte Hoteleinheit angibt (Hotel-Listing-ID) die mit dem Partner-Hotelfeed übereinstimmt (1 bis 256 Zeichen, gekürzt).
cpc_bid_micros	int64	Lesen/Schreiben	Der manuelle CPC-Gebotsbetrag in Mikros (z. B. 1000000 entspricht $1.00).
negative	bool	IMMUTABLE	Muss false sein.

Hinweis: Leistungsmesswerte wie metrics.impressions, metrics.clicks und metrics.cost_micros werden für VERTICAL_ADS_ITEM_BID Kriterien nicht ausgefüllt oder unterstützt. Wenn Sie Leistungsmesswerte pro Eintrag abrufen möchten, fragen Sie die campaign oder ad_group Ressource ab, segmentiert nach segments.vertical_ads_listing (siehe Leistungs berichte in Steuerelemente und Inventarfilterung für vertikale Anzeigen).

Unterstützte Dienste und Vorgänge

Dienst	Methode	Unterstützte Aktionen
AdGroupCriterionService	MutateAdGroupCriteria	create, update (cpc_bid_micros), remove
GoogleAdsService	Search / SearchStream	Kriterienattribute, Artikelcodes und Gebotswerte abfragen

Code- und Nutzlastbeispiele

Die folgenden Beispiele zeigen, wie Sie VERTICAL_ADS_ITEM_BID-Kriterien lesen, erstellen, aktualisieren und entfernen.

Entitätsgebote mit GAQL lesen

Verwenden Sie GoogleAdsService.Search oder GoogleAdsService.SearchStream, um VERTICAL_ADS_ITEM_BID Kriterien abzufragen:

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

Entitätsgebot erstellen

Senden Sie einen create-Vorgang an AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

Vorhandenen Entitätsgebotsbetrag aktualisieren

Senden Sie einen update-Vorgang mit einer updateMask an AdGroupCriterionService.MutateAdGroupCriteria:

Hinweis: entity_bid.item_code ist IMMUTABLE. Wenn Sie den Gebotsbetrag ändern möchten, aktualisieren Sie cpc_bid_micros. Wenn Sie den Artikelcode der Entität ändern möchten, entfernen Sie das Kriterium und erstellen Sie ein neues.

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

Entitätsgebot entfernen

Senden Sie einen remove-Vorgang an AdGroupCriterionService.MutateAdGroupCriteria:

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

Validierungsregeln und Fehlerbehandlung

Szenario	Trigger / Bedingung	Zurückgegebener Fehlercode
Keine Kampagne mit manuellen CPC-Geboten	Versuch, ein Entitätsgebot für eine Kampagne mit automatischen oder Smart Bidding-Geboten zu erstellen.	ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Ungültiger Kampagnentyp	Entitätsgebot zu einer Kampagne hinzufügen, die keine Suchkampagne ist (z. B. eine Display Kampagne).	ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Negatives Kriterium	negative = true für VERTICAL_ADS_ITEM_BID festlegen.	ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
Fehlender Artikelcode oder fehlendes Gebot	Versuch, entity_bid zu erstellen, ohne item_code oder cpc_bid_micros anzugeben.	RequestError.REQUIRED_FIELD_MISSING / FieldError.REQUIRED
Artikelcode ändern	Versuch, entity_bid.item_code für ein vorhandenes Kriterium zu aktualisieren.	RequestError.IMMUTABLE_FIELD / FieldError.IMMUTABLE_FIELD

Leistungsberichte

Mit ClickType.TRAVEL_ASSETS können Sie Leistungsdaten für Anzeigen abrufen, die als Reisefeeds in Suchanzeigen ausgeliefert werden. So können Sie beispielsweise Leistungsdaten für die Anzeigen in allen Ihren Kampagnen abrufen:

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

Dimensionen für Reisepläne segmentieren

Sie können Leistungsberichte für Kampagnen mit verknüpften Reisefeeds auch nach Dimensionen für Reisepläne segmentieren:

• segments.advance_booking_window: Der Reservierungszeitraum 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).

Beispielabfrage

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS