Pliki danych o podróżach w reklamach w wyszukiwarce

Gdy połączysz pliki danych o hotelach, kwaterach wakacyjnych lub atrakcjach z kontem Google Ads, Google Ads automatycznie wzbogaci dotychczasowe kampanie w sieci wyszukiwania o ceny i zdjęcia pochodzące z tych plików danych. Ta funkcja jest znana jako pliki danych o miejscach noclegowych w reklamach w wyszukiwarce.

Jak ustawienia klienta i ustawienia kampanii wchodzą ze sobą w interakcje

Domyślnie kampanie dziedziczą linki do plików danych o podróżach (zestawy komponentów TRAVEL_FEED) z poziomu klienta za pomocą powiązań CustomerAssetSet. Aby zastąpić ustawienia na poziomie klienta w przypadku konkretnej kampanii, musisz dodać znak TRAVEL_FEED do pola excluded_parent_asset_set_types kampanii i zarządzać linkami na poziomie kampanii za pomocą parametru CampaignAssetSet.

• Dziedzicz pliki danych o klientach (domyślnie): zachowaj połączenie z plikami danych o klientach na poziomie klienta CustomerAssetSet i upewnij się, że Campaign.excluded_parent_asset_set_types nie zawiera TRAVEL_FEED.
• Rezygnacja na poziomie klienta: usuń powiązanie na poziomie klientaCustomerAssetSet i nie łącz powiązania na poziomie kampaniiCampaignAssetSet.
• Rezygnacja z konkretnej kampanii: dodaj TRAVEL_FEED do Campaign.excluded_parent_asset_set_types i usuń wszystkie powiązania na poziomie kampanii CampaignAssetSet.
• Włączanie tylko w przypadku konkretnej kampanii: usuń powiązanie na poziomie klientaCustomerAssetSet, a następnie utwórz link na poziomie kampaniiCampaignAssetSet w przypadku tej kampanii.
• Używaj plików danych na poziomie kampanii, podczas gdy inne kampanie nadal dziedziczą pliki danych: dodaj TRAVEL_FEED do Campaign.excluded_parent_asset_set_types kampanii i utwórz dla niego link CampaignAssetSet na poziomie kampanii.

Rezygnacja z plików danych o miejscach noclegowych w reklamach w wyszukiwarce

Jeśli nie chcesz korzystać z tej funkcji, możesz zrezygnować z plików danych o miejscach noclegowych w reklamach w wyszukiwarce na poziomie klienta i kampanii za pomocą interfejsu Google Ads API.

Rezygnowanie na poziomie klienta

Aby zrezygnować z plików danych o miejscach noclegowych w reklamach w wyszukiwarce na poziomie klienta:

1. Pobierz zarówno customer_asset_set.resource_name, jak i asset_set.resource_name dla wszystkich linków CustomerAssetSet, których typ to TRAVEL_FEED, korzystając z raportu customer_asset_set:

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

2. Dla każdego elementu customer_asset_set.resource_name utwórz element CustomerAssetSetOperation i ustaw wartość remove na wartość customer_asset_set.resource_name pobraną w poprzednim kroku.

3. Prześlij żądanie do CustomerAssetSetService.MutateCustomerAssetSets za pomocą utworzonych obiektów CustomerAssetSetOperation.

Jeśli chcesz ponownie włączyć tę funkcję na poziomie klienta:

1. W przypadku każdego bazowego AssetSet (asset_set.resource_name), z którym chcesz utworzyć połączenie, utwórz nowy CustomerAssetSet z parametrem asset_set ustawionym na asset_set.resource_name i parametrem customer ustawionym na nazwę zasobu klienta.
2. Dla każdego elementu CustomerAssetSet utworzonego w poprzednim kroku utwórz element CustomerAssetSetOperation z ustawionym na CustomerAssetSet elementem create.
3. Prześlij żądanie do CustomerAssetSetService.MutateCustomerAssetSets za pomocą utworzonych obiektów CustomerAssetSetOperation.

Rezygnowanie na poziomie kampanii

Aby zrezygnować z plików danych o podróżach w reklamach w sieci wyszukiwania na poziomie kampanii, musisz najpierw wykluczyć odziedziczony stan zgody na poziomie klienta:

1. Pobierz excluded_parent_asset_set_types za pomocą raportu campaign:

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

2. Utwórz nowy obiekt Campaign z parametrem excluded_parent_asset_set_types ustawionym na poprzednie wartości TRAVEL_FEED i parametrem resource_name ustawionym na nazwę zasobu kampanii.

3. Utwórz CampaignOperation i ustaw update na wcześniej utworzony Campaign oraz update_mask.

4. Prześlij prośbę do CampaignService.MutateCampaigns, korzystając z CampaignOperation utworzonego w poprzednim kroku.

Następnie usuń wszystkie powiązania pliku danych o podróżach na poziomie kampanii:

1. W przypadku kampanii, z której chcesz zrezygnować, pobierz zarówno campaign_asset_set.resource_name, jak i asset_set.resource_name dla wszystkich linków CampaignAssetSet, których typ to TRAVEL_FEED, korzystając z raportu 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. Dla każdego elementu campaign_asset_set.resource_name utwórz element CampaignAssetSetOperation i ustaw wartość remove na wartość campaign_asset_set.resource_name pobraną w poprzednim kroku.

3. Prześlij żądanie do CampaignAssetSetService.MutateCampaignAssetSets za pomocą utworzonych obiektów CampaignAssetSetOperation.

Jeśli chcesz ponownie włączyć tę funkcję na poziomie kampanii:

1. W przypadku każdego bazowego AssetSet (asset_set.resource_name), z którego chcesz korzystać, utwórz nowy CampaignAssetSet z parametrem asset_set ustawionym na asset_set.resource_name i parametrem campaign ustawionym na nazwę zasobu kampanii.
2. Dla każdego elementu CampaignAssetSet utworzonego w poprzednim kroku utwórz element CampaignAssetSetOperation z ustawionym na CampaignAssetSet elementem create.
3. Prześlij żądanie do CampaignAssetSetService.MutateCampaignAssetSets za pomocą utworzonych obiektów CampaignAssetSetOperation.

Przywracanie stanu zgody klienta na poziomie kampanii

Aby przywrócić dziedziczenie ustawienia na poziomie klienta w przypadku kampanii, wykonaj te czynności:

1. Utwórz nowy obiekt Campaign z parametrem excluded_parent_asset_set_types without TRAVEL_FEED na liście i parametrem resource_name ustawionym na nazwę zasobu kampanii.
2. Utwórz CampaignOperation i ustaw update na wcześniej utworzony Campaign oraz update_mask.
3. Prześlij prośbę do CampaignService.MutateCampaigns, korzystając z CampaignOperation utworzonego w poprzednim kroku.

Samodzielne ustawianie stawek CPC za poszczególne elementy

Od wersji v25 interfejsu Google Ads API możesz konfigurować samodzielne ustawianie stawek CPC dla poszczególnych obiektów w kampaniach w sieci wyszukiwania dotyczących podróży za pomocą zasobu AdGroupCriterion z typem kryterium CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid).

Wymagania wstępne i wymagania dotyczące zgodności

Aby tworzyć kryteria VERTICAL_ADS_ITEM_BID i nimi zarządzać, musisz spełniać te warunki:

• Typ kampanii: kampanie w sieci wyszukiwania dotyczące podróży (kampanie w sieci wyszukiwaniaAdvertisingChannelType.SEARCH z włączonymi funkcjami AI Max w kampaniach w sieci wyszukiwaniaCampaign.ai_max_setting.enable_ai_max i powiązanym plikiem danych o hotelach [TRAVEL_FEED zestaw komponentów]; obsługiwane są tylko pliki danych o hotelach).
• Strategia ustalania stawek: tylko CPC ustawiany samodzielnie (BiddingStrategyType.MANUAL_CPC).
  • Nie jest obsługiwana w przypadku strategii automatycznego określania stawek ani strategii inteligentnego określania stawek (takich jak Maksymalizacja liczby konwersji, Maksymalizacja wartości konwersji, Docelowy CPA czy Docelowy ROAS).
• Tylko kryteria pozytywne: parametr negative musi mieć wartość false. Ujemne stawki za jednostki nie są obsługiwane.
• Wymagany identyfikator i stawka za podmiot: entity_bid.item_code i cpc_bid_micros są wymagane podczas tworzenia kryterium stawki za podmiot.

Schemat i definicje pól

• Zasób: AdGroupCriterion (ad_group_criterion)
• Format nazwy zasobu: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• Wyliczenie typu kryterium: CriterionType.VERTICAL_ADS_ITEM_BID
• Wiadomość: EntityBid (ad_group_criterion.entity_bid)

Obsługiwane usługi i operacje

Przykłady kodu i ładunku

Z przykładów poniżej dowiesz się, jak odczytywać, tworzyć, aktualizować i usuwać VERTICAL_ADS_ITEM_BID kryteria.

Odczytywanie stawek za jednostkę za pomocą GAQL

Użyj symbolu GoogleAdsService.Search lub GoogleAdsService.SearchStream, aby wysłać zapytanie o kryteria VERTICAL_ADS_ITEM_BID:

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'

Tworzenie stawki za encję

Wyślij operację create do:AdGroupCriterionService.MutateAdGroupCriteria

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

Aktualizowanie dotychczasowej kwoty stawki za encję

Wyślij operację update z parametrem updateMask do:AdGroupCriterionService.MutateAdGroupCriteria

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

Usuwanie stawki za encję

Wyślij operację remove do:AdGroupCriterionService.MutateAdGroupCriteria

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

Reguły weryfikacji i obsługa błędów

Raporty skuteczności

Za pomocą ClickType.TRAVEL_ASSETS możesz identyfikować dane o skuteczności reklam wyświetlanych jako pliki danych o miejscach noclegowych w reklamach w wyszukiwarce, np. pobierać dane o skuteczności reklam we wszystkich kampaniach:

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

Segmenty wymiaru planu podróży

Możesz też dzielić na segmenty raporty o skuteczności kampanii z połączonymi plikami danych o podróżach według wymiarów planu podróży:

• segments.advance_booking_window: Okres rezerwacji z wyprzedzeniem dla planu podróży w dniach.
• segments.length_of_booking: długość rezerwacji planu podróży w dniach.
• segments.start_date: data rozpoczęcia rezerwacji w formacie yyyy-MM-dd.
• segments.start_day_of_week: dzień tygodnia rozpoczęcia rezerwacji.
• segments.user_set_dates: wskazuje, czy wybrano daty określone przez użytkownika (USER_SELECTED lub DEFAULT_SELECTION).

Przykładowe zapytanie

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