Reisefeeds in Suchanzeigen

Wenn Sie Ihre Produktfeeds für Hotels, Ferienunterkünfte oder mögliche Aktivitäten mit Ihrem Google Ads-Konto verknüpfen, werden vorhandene Suchkampagnen automatisch um Preise und Bilder aus Ihren Feeds ergänzt. Diese Funktion wird als Reisefeeds in Suchanzeigen bezeichnet.

Zusammenspiel von Kunden- und Kampagneneinstellungen

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

• Kundenfeeds übernehmen (Standardeinstellung): Behalten Sie die Verknüpfung von CustomerAssetSet auf Kundenebene bei und achten Sie darauf, dass Campaign.excluded_parent_asset_set_types nicht TRAVEL_FEED enthält.
• Deaktivierung auf Kundenebene:Entfernen Sie die Verknüpfung auf Kundenebene (CustomerAssetSet) und verknüpfen Sie keine Kampagnenebene (CampaignAssetSet).
• 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 für eine bestimmte Kampagne aktivieren:Entfernen Sie die Verknüpfung auf Kundenebene (CustomerAssetSet) und erstellen Sie dann eine Verknüpfung auf Kampagnenebene (CampaignAssetSet) für diese Kampagne.
• Kampagnenspezifische Feeds verwenden, während andere Kampagnen weiterhin Einstellungen übernehmen:Fügen Sie der Campaign.excluded_parent_asset_set_types der Kampagne TRAVEL_FEED hinzu und erstellen Sie einen CampaignAssetSet-Link auf Kampagnenebene dafür.

Reisefeeds in Suchanzeigen deaktivieren

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

Anzeigenvorschläge auf Kundenebene deaktivieren

So deaktivieren Sie Reisefeeds in Suchanzeigen auf Kundenebene:

1. Rufen Sie mit dem Bericht customer_asset_set sowohl customer_asset_set.resource_name als auch asset_set.resource_name für alle CustomerAssetSet-Links 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 jede customer_asset_set.resource_name eine CustomerAssetSetOperation und legen Sie remove auf die im vorherigen Schritt abgerufene customer_asset_set.resource_name fest.

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

So aktivieren Sie diese Funktion wieder auf Kundenebene:

1. Erstellen Sie für jede zugrunde liegende AssetSet (asset_set.resource_name), die Sie verknüpfen möchten, eine neue CustomerAssetSet. Setzen Sie dabei asset_set auf die asset_set.resource_name und customer auf den Ressourcennamen Ihres Kunden.
2. Erstellen Sie für jeden im vorherigen Schritt erstellten CustomerAssetSet einen CustomerAssetSetOperation, wobei create auf den CustomerAssetSet festgelegt ist.
3. Senden Sie eine Anfrage an CustomerAssetSetService.MutateCustomerAssetSets mit den erstellten CustomerAssetSetOperation-Objekten.

Deaktivierung auf Kampagnenebene

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 Bericht campaign ab:

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

2. Erstellen Sie ein neues Campaign-Objekt, wobei excluded_parent_asset_set_types auf die vorherigen Werte plus TRAVEL_FEED und resource_name auf den Ressourcennamen Ihrer Kampagne festgelegt ist.

3. Erstellen Sie eine CampaignOperation und legen Sie update auf die zuvor erstellte Campaign und update_mask fest.

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

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

1. Rufen Sie für die Kampagne, die Sie deaktivieren möchten, sowohl campaign_asset_set.resource_name als auch asset_set.resource_name für alle CampaignAssetSet-Links ab, deren Typ TRAVEL_FEED ist. Verwenden Sie dazu den Bericht campaign_asset_set:

   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 jede campaign_asset_set.resource_name eine CampaignAssetSetOperation und legen Sie remove auf die im vorherigen Schritt abgerufene campaign_asset_set.resource_name fest.

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

So aktivieren Sie diese Funktion wieder auf Kampagnenebene:

1. Erstellen Sie für jede zugrunde liegende AssetSet (asset_set.resource_name), die Sie aktivieren möchten, eine neue CampaignAssetSet. Setzen Sie dabei asset_set auf die asset_set.resource_name und campaign auf den Ressourcennamen Ihrer Kampagne.
2. Erstellen Sie für jeden im vorherigen Schritt erstellten CampaignAssetSet einen CampaignAssetSetOperation, wobei create auf den CampaignAssetSet festgelegt ist.
3. Senden Sie eine Anfrage an CampaignAssetSetService.MutateCampaignAssetSets mit den erstellten CampaignAssetSetOperation-Objekten.

Aktivierungsstatus auf Kundenebene für eine Kampagne wiederherstellen

So legen Sie fest, dass der Opt-in-Status einer Kampagne wieder der Einstellung auf Kundenebene entspricht:

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

Manuelle CPC-Gebote pro Element

Ab der Google Ads API-Version v25 können Sie für Hotels in Suchkampagnen für die Reisebranche entitätsspezifische manuelle CPC-Gebotsüberschreibungen konfigurieren. Verwenden Sie dazu die Ressource AdGroupCriterion mit dem Kriteriumstyp CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid). Wenn Sie multiplikative Gebotsanpassungen für Anzeigengruppen für Dimensionen von Reiseplänen mit AdGroupBidModifier festlegen möchten, lesen Sie den Hilfeartikel Gebote mit Gebotsanpassungen anpassen.

Voraussetzungen und Kompatibilitätsanforderungen

Zum Erstellen und Verwalten von VERTICAL_ADS_ITEM_BID-Kriterien müssen die folgenden Bedingungen erfüllt sein:

• Kampagnentyp:Suchkampagnen für die Reisebranche (Suchkampagnen, AdvertisingChannelType.SEARCH, mit AI Max für Suchkampagnen, aktiviert über Campaign.ai_max_setting.enable_ai_max und eine zugehörige TRAVEL_FEED-Asset-Sammlung für Hotelfeeds; nur Hotelfeeds werden unterstützt).
• Gebotsstrategie:Nur „Manueller CPC“ (BiddingStrategyType.MANUAL_CPC).
  • Nicht unterstützt bei automatisierten oder Smart Bidding-Strategien (z. B. „Conversions maximieren“, „Conversion-Wert maximieren“, „Ziel-CPA“ oder „Ziel-ROAS“).
• Nur positive Kriterien: negative muss auf false festgelegt sein. Negative Entitätsgebote werden nicht unterstützt.
• Erforderliche Entitätskennung und Gebot: entity_bid.item_code und cpc_bid_micros sind erforderlich, wenn Sie ein Gebotskriterium für eine Entität erstellen.

Schema- und Felddefinitionen

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

Unterstützte Dienste und Vorgänge

Code- und Nutzlastbeispiele

In den folgenden Beispielen wird gezeigt, 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'

Gebot für eine Entität 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"
        }
      }
    }
  ]
}

Gebotsbetrag einer vorhandenen Entität aktualisieren

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

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

Gebot für eine Entität entfernen

Senden Sie einen remove-Vorgang an AdGroupCriterionService.MutateAdGroupCriteria:

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

Validierungsregeln und Fehlerbehandlung

Leistungsberichte

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

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

Dimensionssegmente für Reisepläne

Sie können Leistungsberichte für Kampagnen mit verknüpften Reisefeeds auch nach Reiseplandimensionen 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 erste Wochentag 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