Ustawienia i filtrowanie zasobów reklamowych w przypadku reklam wertykalnych

Reklamy pionowe udostępniają specjalne funkcje AI Max w kampaniach w sieci wyszukiwania, które są połączone z plikiem danych pionowych, np. z plikiem danych o hotelach. Możesz określić, które formaty reklam pionowych mają być wyświetlane na poziomie grupy reklam, a także które encje pliku danych mają być objęte kierowaniem za pomocą reguł grupy produktów w reklamach pionowych.

Przegląd

W tym przewodniku omawiamy 2 główne funkcje zarządzania reklamami pionowymi:

  1. Ustawienia formatu: możesz akceptować lub rezygnować z określonych formatów reklam (reklamy tekstowe, linki do rezerwacji i reklamy promujące podróże) na poziomie grupy reklam.
  2. Zarządzanie produktami w reklamach pionowych: możesz filtrować i kierować reklamy na określone zasoby z połączonego pliku danych pionowych (wcześniej nazywanego plikiem danych o podróżach) za pomocą systemu opartego na regułach, który wykorzystuje SharedSet i SharedCriterion.

Wymagania wstępne

Zanim wdrożysz te funkcje, upewnij się, że Twoja kampania spełnia te wymagania:

Aby aktywować pliki danych o miejscach noclegowych w reklamach w wyszukiwarce i włączyć ustawienia reklam pionowych w kampanii, możesz połączyć zestaw komponentów pliku danych pionowych na poziomie kampanii, wykonując te czynności. Jeśli chcesz włączyć te funkcje we wszystkich kampaniach na koncie, możesz połączyć plik danych na poziomie klienta, postępując zgodnie z instrukcjami dotyczącymi łączenia na poziomie klienta w przewodniku Pliki danych o miejscach noclegowych w reklamach w wyszukiwarce.

  1. Utwórz obiekt CampaignAssetSet, ustawiając asset_set na nazwę zasobu zestawu komponentów pliku danych pionowych, a campaign na nazwę zasobu kampanii.
  2. Utwórz CampaignAssetSetOperation, ustawiając create na CampaignAssetSet.
  3. Prześlij operację za pomocą CampaignAssetSetService.MutateCampaignAssetSets.

Więcej informacji o zarządzaniu plikami danych o podróżach na dużą skalę znajdziesz w dokumentacji Pliki danych o miejscach noclegowych w reklamach w wyszukiwarce.

Ustawienia formatu grupy reklam

Możesz skonfigurować, które formaty reklam pionowych mają być aktywne w określonej grupie reklam. Zarządzanie odbywa się za pomocą pola vertical_ads_format_setting (VerticalAdsFormatSetting) w zasobie AdGroup.

Dostępne formaty

Reguły weryfikacji

  • Nie możesz jednocześnie wyłączyć wszystkich 3 formatów w jednej grupie reklam.
  • Wartość enable_booking_links można ustawić na true tylko wtedy, gdy aktywny plik danych pionowych kampanii to HOTELS lub THINGS_TO_DO.
  • Te ustawienia mają zastosowanie tylko do SEARCH_STANDARD i SEARCH_DYNAMIC_ADS typów grup reklam.

Przykład: aktualizowanie ustawień formatu

Ten przykład w języku Java pokazuje, jak wyłączyć reklamy tekstowe i włączyć reklamy promujące podróże w istniejącej grupie reklam:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        AdGroup.VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

Zarządzanie produktami w reklamach pionowych

Aby kierować reklamy na określony podzbiór zasobów pliku danych, np. „Hotele w Bostonie” lub „Wyklucz hotele 1-gwiazdkowe”, musisz użyć reguł grupy produktów w reklamach pionowych.

Jak działa model danych

Model danych korzysta z podejścia opartego na kryteriach udostępnionych:

  1. SharedSet: utwórz SharedSet z typem VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
  2. SharedCriterion: dodaj do tego zestawu reguły (kryteria). Każda reguła określa wymiar, np. miasto lub klasę hotelu, oraz wartość. Możesz też utworzyć kryteria wykluczające, aby wykluczyć produkty.
  3. AdGroupCriterion: połącz SharedSet z AdGroup za pomocą AdGroupCriterion (vertical_ads_item_group_rule_list).

Obsługiwane wymiary

Możesz filtrować encje na podstawie tych wymiarów w SharedCriterion (VerticalAdsItemGroupRuleInfo), w zależności od SharedSet's vertical_ads_item_vertical_type:

  • item_code: identyfikator konkretnej oferty (obsługiwany w przypadku wszystkich typów pionowych).
  • city_criterion_id, region_criterion_id, country_criterion_id: nazwy zasobów stałych celów kierowania geograficznego (geoTargetConstants/{id}; obsługiwane w przypadku wszystkich typów pionowych z wyjątkiem FLIGHTS).
  • hotel_class: liczba gwiazdek od 1 do 5 (HOTELS tylko).
  • user_rating (od v24): zaokrąglona w dół ocena użytkownika od 1 do 5 (THINGS_TO_DO tylko).
  • venue, event_participant_display_name (od v24): filtry miejsca wydarzenia i wyświetlanej nazwy uczestnika (EVENTS tylko).

Ten przykład w języku Python tworzy regułę, która obejmuje produkty w „Bostonie” lub „San Francisco” i wyklucza hotele „1-gwiazdkowe” i „2-gwiazdkowe”:

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

Samodzielne ustawianie stawek CPC dla poszczególnych encji

Od v25 w przypadku kampanii w sieci wyszukiwania dotyczących podróży (kampanie w sieci wyszukiwania z włączonymi funkcjami AI Max w kampaniach w sieci wyszukiwania i połączonym plikiem danych o hotelach), które korzystają ze strategii samodzielnego ustawiania stawek CPC (BiddingStrategyType.MANUAL_CPC), możesz ustawiać samodzielne zastąpienia stawek CPC (cpc_bid_micros) dla poszczególnych produktów w pliku danych o hotelach za pomocą kryterium EntityBid (ad_group_criterion.entity_bid) z CriterionType.VERTICAL_ADS_ITEM_BID i entity_bid.item_code.

Kryteria wykluczające (negative = true), kampanie inne niż w sieci wyszukiwania oraz strategie automatycznego określania stawek lub inteligentnego określania stawek nie są obsługiwane w przypadku VERTICAL_ADS_ITEM_BID i zwracają ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT. Wskaźniki skuteczności nie są wypełniane w przypadku kryteriów VERTICAL_ADS_ITEM_BID. Szczegółowe informacje o schemacie, zapytaniach GAQL i przykładach ładunku mutacji znajdziesz w artykule Samodzielne ustawianie stawek CPC dla poszczególnych encji w przewodniku Pliki danych o miejscach noclegowych w reklamach w wyszukiwarce.

Raporty skuteczności

Dane o skuteczności reklam pionowych możesz pobierać za pomocą metod GoogleAdsService.SearchStream lub GoogleAdsService.Search.

Segmenty reklam pionowych

Segmenty wymiaru planu podróży

Od v25 w przypadku reklam pionowych połączonych z plikami danych o podróżach i zakwaterowaniu możesz dzielić raporty skuteczności na segmenty według wymiarów planu podróży:

Dane o reklamach pionowych

Od v25 możesz pobierać te dane o reklamach pionowych:

Przykładowe zapytania GAQL

To zapytanie pobiera dane o konkurencji i rezerwacjach w reklamach pionowych podzielone na segmenty według miasta oferty, przedziału cenowego i typu stawki:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

To zapytanie dzieli standardowe wskaźniki skuteczności na segmenty według wymiarów rezerwacji planu podróży:

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.clicks,
  metrics.all_conversions_value
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

Obsługa błędów

Oto typowe błędy, które mogą wystąpić podczas konfigurowania reklam pionowych:

Kod błędu Przyczyna Zalecane działanie
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING Wszystkie 3 formaty reklam (tekstowe, linki do rezerwacji, reklamy promujące podróże) zostały wyłączone jednocześnie lub włączono enable_booking_links w przypadku typu pionowego innego niż HOTELS lub THINGS_TO_DO. Upewnij się, że w VerticalAdsFormatSetting jest włączony co najmniej 1 format, a linki do rezerwacji są włączone tylko w przypadku plików danych HOTELS lub THINGS_TO_DO.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX W kampanii nie są włączone funkcje AI Max w kampaniach w sieci wyszukiwania. Włącz funkcje AI Max w kampaniach w sieci wyszukiwania w ustawieniach kampanii.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED W kampanii nie ma aktywnego pliku danych pionowych. Upewnij się, że prawidłowy plik danych pionowych jest połączony na poziomie klienta lub kampanii poziomie.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST Nazwa zasobu SharedSet podana w AdGroupCriterion nie istnieje lub nie ma typu VERTICAL_ADS_ITEM_GROUP_RULE_LIST. Sprawdź, czy nazwa zasobu shared_set odwołuje się do istniejącego SharedSet typu VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET Zasób SharedSet wskazany w AdGroupCriterion ma stan REMOVED. Odwołaj się do włączonego SharedSet typu VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE Użyty wymiar kryterium nie jest obsługiwany w przypadku określonego typu pionowego, np. klasa hotelu w przypadku wynajmu samochodów. Sprawdź, czy wymiar vertical_ads_item_group_rule jest zgodny z typem pionowym.