Pliki danych o podróżach w reklamach w wyszukiwarce

Gdy połączysz z kontem Google Ads pliki danych o produktach z usług Hotele, Kwatery wakacyjne lub Atrakcje, Google Ads automatycznie wzbogaci dotychczasowe kampanie w sieci wyszukiwania o ceny i zdjęcia pobrane z plików danych. Ta funkcja nosi nazwę plików danych o miejscach noclegowych w reklamach w wyszukiwarce.

Jak ustawienia klienta i ustawienia kampanii współdziałają ze sobą

Domyślnie kampanie dziedziczą linki do pliku 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ć TRAVEL_FEED do pola excluded_parent_asset_set_types kampanii i zarządzać linkami na poziomie kampanii za pomocą CampaignAssetSet.

• Dziedzicz pliki danych klienta (domyślnie): zachowaj połączenie z CustomerAssetSet na poziomie klienta i upewnij się, że Campaign.excluded_parent_asset_set_types nie zawiera TRAVEL_FEED.
• Rezygnacja na poziomie klienta: usuń powiązanie CustomerAssetSet na poziomie klienta i nie łącz CampaignAssetSet na poziomie kampanii.
• Zrezygnować z funkcji w konkretnej kampanii: dodaj TRAVEL_FEED do Campaign.excluded_parent_asset_set_types i usuń wszystkie powiązania CampaignAssetSet na poziomie kampanii.
• Włączenie tylko w konkretnej kampanii: usuń powiązanie na poziomie klienta CustomerAssetSet, a następnie utwórz połączenie na poziomie kampanii CampaignAssetSet dla tej kampanii.
• Używanie plików danych na poziomie kampanii, gdy inne kampanie nadal dziedziczą pliki danych: dodaj TRAVEL_FEED do Campaign.excluded_parent_asset_set_types kampanii i utwórz dla niej 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 customer_asset_set.resource_name i asset_set.resource_name dla wszystkich linków CustomerAssetSet, których typ to TRAVEL_FEED, za pomocą 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 CustomerAssetSetOperation i ustaw remove na customer_asset_set.resource_name pobrany w poprzednim kroku.

3. Prześlij żądanie do CustomerAssetSetService.MutateCustomerAssetSets, używając utworzonych obiektów CustomerAssetSetOperation.

Jeśli chcesz ponownie akceptować tę funkcję na poziomie klienta:

1. Dla każdego bazowego elementu AssetSet (asset_set.resource_name), który chcesz połączyć, utwórz nowy element CustomerAssetSet, w którym pole asset_set jest ustawione na asset_set.resource_name, a pole customer jest ustawione na nazwę zasobu klienta.
2. Dla każdego elementu CustomerAssetSet utworzonego w poprzednim kroku utwórz element CustomerAssetSetOperation z atrybutem create ustawionym na CustomerAssetSet.
3. Prześlij żądanie do CustomerAssetSetService.MutateCustomerAssetSets, używając utworzonych obiektów CustomerAssetSetOperation.

Rezygnowanie na poziomie kampanii

Aby zrezygnować z plików danych o miejscach noclegowych w reklamach w wyszukiwarce na poziomie kampanii, musisz najpierw wykluczyć odziedziczony stan akceptacji z poziomu 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, w którym excluded_parent_asset_set_types ma poprzednie wartości oraz TRAVEL_FEED, a resource_name ma nazwę zasobu kampanii.

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

4. Prześlij żądanie do CampaignService.MutateCampaigns, używając CampaignOperation utworzonego w poprzednim kroku.

Następnie usuń wszystkie powiązania z plikami danych dotyczących podróży na poziomie kampanii:

1. W przypadku kampanii, którą chcesz wyłączyć, pobierz campaign_asset_set.resource_name i asset_set.resource_name dla wszystkich linków CampaignAssetSet typu 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 CampaignAssetSetOperation i ustaw remove na campaign_asset_set.resource_name pobrany w poprzednim kroku.

3. Prześlij żądanie do CampaignAssetSetService.MutateCampaignAssetSets, używając utworzonych obiektów CampaignAssetSetOperation.

Jeśli chcesz ponownie wyrazić zgodę na tę funkcję na poziomie kampanii:

1. Dla każdego elementu AssetSet (asset_set.resource_name), który chcesz akceptować, utwórz nowy element CampaignAssetSet, w którym parametr asset_set jest ustawiony na asset_set.resource_name, a parametr campaign jest ustawiony na nazwę zasobu kampanii.
2. Dla każdego elementu CampaignAssetSet utworzonego w poprzednim kroku utwórz element CampaignAssetSetOperation z atrybutem create ustawionym na CampaignAssetSet.
3. Prześlij żądanie do CampaignAssetSetService.MutateCampaignAssetSets, używając utworzonych obiektów CampaignAssetSetOperation.

Przywracanie stanu akceptacji na poziomie klienta w przypadku kampanii

Aby ponownie ustawić stan akceptacji kampanii na dziedziczenie ustawienia na poziomie klienta:

1. Utwórz nowy obiekt Campaign z excluded_parent_asset_set_types bez TRAVEL_FEED na liście i ustaw resource_name na nazwę zasobu kampanii.
2. Utwórz CampaignOperation i ustaw update na utworzone wcześniej Campaign i update_mask.
3. Prześlij żądanie do CampaignService.MutateCampaigns, używając CampaignOperation utworzonego w poprzednim kroku.

Samodzielne ustawianie stawek CPC na poziomie elementu

Od wersji v25 interfejsu Google Ads API możesz konfigurować zastępowanie samodzielnie ustawianych stawek CPC dla poszczególnych encji w przypadku hoteli w kampaniach w sieci wyszukiwania dotyczących podróży. Służy do tego zasób AdGroupCriterion z typem kryterium CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid). Aby ustawić mnożnikowe dostosowania stawek grupy reklam w wymiarach planu podróży za pomocą AdGroupBidModifier, zapoznaj się z artykułem Dostosowywanie stawek za pomocą modyfikatorów stawek.

Wymagania wstępne i 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 wyszukiwania, AdvertisingChannelType.SEARCH, z funkcjami AI Max w kampaniach w sieci wyszukiwania włączonymi za pomocą Campaign.ai_max_setting.enable_ai_max i powiązanym zestawem komponentów pliku danych o hotelach TRAVEL_FEED; 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 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 elementy nie są obsługiwane.
• Wymagany identyfikator elementu i stawka: podczas tworzenia kryterium stawki elementu wymagane są parametry entity_bid.item_code i cpc_bid_micros.

Definicje schematu i pól

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

Obsługiwane usługi i operacje

Przykłady kodu i ładunku

Poniższe przykłady pokazują, jak odczytywać, tworzyć, aktualizować i usuwać kryteria VERTICAL_ADS_ITEM_BID.

Odczytywanie stawek za jednostkę za pomocą GAQL

Użyj 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 kwoty stawki dotychczasowego elementu

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

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

Usuwanie stawki elementu

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

Możesz używać ClickType.TRAVEL_ASSETS do identyfikowania danych o skuteczności reklam wyświetlanych jako pliki danych o miejscach noclegowych w reklamach w wyszukiwarce, np. do pobierania danych 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

Raporty skuteczności kampanii z połączonymi plikami danych o podróżach możesz też dzielić na segmenty 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 w ramach 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