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 automatisch mit Preisen und Bildern aus Ihren Feeds ergänzt. Diese Funktion wird als Reisefeeds in Suchanzeigen bezeichnet.

Zusammenspiel von Kundeneinstellungen und Kampagneneinstellungen

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

• Kundenfeeds übernehmen (Standardeinstellung): Die CustomerAssetSet-Verknüpfung auf Kundenebene wird beibehalten und Campaign.excluded_parent_asset_set_types enthält keine TRAVEL_FEED.
• Auf Kundenebene deaktivieren:Entfernen Sie die Zuordnung auf Kundenebene CustomerAssetSet und verknüpfen Sie keine CampaignAssetSet 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 für eine bestimmte Kampagne aktivieren:Entfernen Sie die Verknüpfung auf Kundenebene CustomerAssetSet und erstellen Sie dann einen Link auf Kampagnenebene CampaignAssetSet für diese Kampagne.
• Kampagnenspezifische Feeds verwenden, während andere Kampagnen weiterhin übernommen werden:Fügen Sie TRAVEL_FEED zum Campaign.excluded_parent_asset_set_types der Kampagne 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 nutzen, 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 sowohl customer_asset_set.resource_name als auch asset_set.resource_name für alle CustomerAssetSet-Links ab, deren Typ TRAVEL_FEED ist, indem Sie den Bericht customer_asset_set verwenden:

   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 jedes customer_asset_set.resource_name ein CustomerAssetSetOperation und legen Sie remove auf das customer_asset_set.resource_name fest, das Sie im vorherigen Schritt abgerufen haben.

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

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, ein neues CustomerAssetSet mit asset_set, das auf asset_set.resource_name festgelegt ist, und customer, das auf den Ressourcennamen Ihres Kunden festgelegt ist.
2. Erstellen Sie für jedes CustomerAssetSet, das im vorherigen Schritt erstellt wurde, ein CustomerAssetSetOperation mit create, das auf das CustomerAssetSet festgelegt ist.
3. Senden Sie eine Anfrage an CustomerAssetSetService.MutateCustomerAssetSets mit den erstellten CustomerAssetSetOperation-Objekten.

Auf Kampagnenebene deaktivieren

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

1. excluded_parent_asset_set_types mit dem Bericht campaign abrufen:

   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 ein CampaignOperation und legen Sie update auf den zuvor erstellten Campaign und update_mask entsprechend 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 jedes campaign_asset_set.resource_name ein CampaignAssetSetOperation und legen Sie remove auf das campaign_asset_set.resource_name fest, das Sie im vorherigen Schritt abgerufen haben.

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 mit asset_set, die auf asset_set.resource_name festgelegt ist, und campaign, die auf den Ressourcennamen Ihrer Kampagne festgelegt ist.
2. Erstellen Sie für jedes CampaignAssetSet, das im vorherigen Schritt erstellt wurde, ein CampaignAssetSetOperation mit create, das auf das CampaignAssetSet festgelegt ist.
3. Senden Sie eine Anfrage an CampaignAssetSetService.MutateCampaignAssetSets mit den erstellten CampaignAssetSetOperation-Objekten.

Opt-in-Status auf Kundenebene für eine Kampagne wiederherstellen

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

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

Manuelle CPC-Gebote auf Kampagnenebene

Ab der Google Ads API-Version v25 können Sie mit der Ressource AdGroupCriterion mit dem Kriterientyp CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid) manuelle CPC-Gebotsüberschreibungen pro Einheit für Hotels in Suchkampagnen für Reiseunternehmen 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 AI Max für Suchkampagnen aktiviert Campaign.ai_max_setting.enable_ai_max und einem zugehörigen Hotelfeed [Asset-Sammlung TRAVEL_FEED]; es werden nur Hotelfeeds unterstützt).
• Gebotsstrategie:Nur manueller CPC (BiddingStrategyType.MANUAL_CPC).
  • Nicht unterstützt bei automatisierten oder Smart Bidding-Strategien wie „Conversions maximieren“, „Conversion-Wert maximieren“, „Ziel-CPA“ oder „Ziel-ROAS“.
• Nur positive Kriterien:negative muss auf false gesetzt werden. 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 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}
• Criterion type enum: CriterionType.VERTICAL_ADS_ITEM_BID
• Nachricht:EntityBid (ad_group_criterion.entity_bid)

Unterstützte Dienste und Vorgänge

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"
        }
      }
    }
  ]
}

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"
      }
    }
  ]
}

Entitätsgebot 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'

Segmente für die Dimension „Reiseplan“

Sie können Leistungsberichte für Kampagnen mit verknüpften Reisefeeds auch nach Routendimensionen segmentieren:

• segments.advance_booking_window: Der Reservierungszeitraum für den Reiseplan in Tagen.
• segments.length_of_booking: Die Buchungsdauer für die Reise 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 Datumsangaben 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