Ustawienia i filtrowanie zasobów reklamowych w przypadku reklam wertykalnych

Reklamy wertykalne udostępniają specjalistyczne funkcje kampaniom w sieci wyszukiwania z włączonymi funkcjami AI Max w kampaniach w sieci wyszukiwania, które są połączone z plikiem danych wertykalnych, np. z danymi o hotelach. Możesz określić, które formaty reklam w branży mają być wyświetlane na poziomie grupy reklam, a także które elementy pliku danych mają być kierowane za pomocą reguł grupy elementów reklam w branży.

Przegląd

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

  1. Ustawienia formatu: możesz włączyć lub wyłączyć określone formaty reklam (reklamy tekstowe, linki do rezerwacji i reklamy promujące w formacie pionowym) na poziomie grupy reklam.
  2. Zarządzanie elementami reklam w branży: filtruj i kieruj reklamy na konkretne zasoby reklamowe z połączonego pliku danych branży (wcześniej nazywanego plikiem danych o podróżach) za pomocą systemu opartego na regułach, który obejmuje operatory 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 sieci wyszukiwania i włączyć w kampanii elementy sterujące reklamami w branży, możesz połączyć zestaw komponentów pliku danych o branży na poziomie kampanii, wykonując te czynności: Aby włączyć te funkcje we wszystkich kampaniach na koncie, możesz też połączyć plik danych na poziomie klienta, postępując zgodnie z instrukcjami dotyczącymi łączenia na poziomie klienta w przewodniku po plikach danych o miejscach noclegowych w reklamach w wyszukiwarce.

  1. Utwórz obiekt CampaignAssetSet, ustawiając asset_set na nazwę zasobu zestawu komponentów z plikiem danych branżowych, a campaign na nazwę zasobu kampanii.
  2. Utwórz CampaignAssetSetOperation z wartością create ustawioną na CampaignAssetSet.
  3. Prześlij operację za pomocą metody CampaignAssetSetService.MutateCampaignAssetSets.

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

Ustawienia formatu reklamy w grupie reklam

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

Dostępne formaty

Reguły weryfikacji

  • Nie możesz jednocześnie zrezygnować z wyświetlania wszystkich 3 formatów w jednej grupie reklam.
  • Wartość parametru enable_booking_links można ustawić na true tylko wtedy, gdy aktywny pionowy plik danych kampanii ma wartość HOTELS lub THINGS_TO_DO.
  • Te ustawienia dotyczą tylko typów grup reklam SEARCH_STANDARD i SEARCH_DYNAMIC_ADS.

Przykład: aktualizowanie ustawień formatu

Poniższy przykład w języku Java pokazuje, jak wyłączyć reklamy tekstowe i włączyć reklamy promujące produkty w pionie w dotychczasowej 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 elementami reklam promujących branżę

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

Jak działa model danych

Model danych korzysta z podejścia opartego na wspólnych kryteriach:

  1. SharedSet: utwórz SharedSet o typie VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
  2. SharedCriterion: dodaj do tego zbioru reguły (kryteria). Każda reguła określa wymiar, np. Miasto lub Klasa hotelu, oraz wartość. Możesz też tworzyć kryteria wykluczające, aby wykluczać produkty.
  3. AdGroupCriterion: połącz SharedSet z AdGroup za pomocą AdGroupCriterion (vertical_ads_item_group_rule_list).

Obsługiwane wymiary

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

  • item_code: konkretny identyfikator informacji (obsługiwany w przypadku wszystkich typów branż).
  • city_criterion_id, region_criterion_id, country_criterion_id: Nazwy zasobów stałych wartości docelowych geograficznych (geoTargetConstants/{id}; obsługiwane w przypadku wszystkich typów pionowych z wyjątkiem FLIGHTS).
  • hotel_class: ocena w gwiazdkach od 1 do 5 (HOTELS).
  • user_rating (od v24): zaokrąglona w dół ocena użytkownika w skali od 1 do 5 (THINGS_TO_DO).
  • venue, event_participant_display_name (od v24): filtry nazwy miejsca wydarzenia i nazwy wyświetlanej uczestnika (tylko EVENTS).

Ten przykład w języku Python tworzy regułę, która uwzględnia 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 za poszczególne elementy

Od v25 w przypadku kampanii w sieci wyszukiwania dotyczących podróży (kampanii 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 ustalania stawek CPC ustawiany samodzielnie (BiddingStrategyType.MANUAL_CPC), możesz ustawiać ręczne zastąpienia stawek CPC (cpc_bid_micros) dla poszczególnych elementów pliku danych o hotelach za pomocą kryterium EntityBid (ad_group_criterion.entity_bid) z warunkami CriterionType.VERTICAL_ADS_ITEM_BID i entity_bid.item_code.

Kryteria wykluczające (negative = true), kampanie w sieci innej niż wyszukiwania oraz strategie automatycznego 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, zapytania GAQL i przykłady ładunków mutacji znajdziesz w artykule Ręczne określanie stawek CPC za poszczególne obiekty w przewodniku po plikach danych o miejscach noclegowych w reklamach w wyszukiwarce.

Raporty skuteczności

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

Segmenty reklam pionowych

Segmenty wymiaru planu podróży

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

Dane reklam pionowych

Od v25 możesz pobierać te dane dotyczące reklam w branży:

Przykładowe zapytania GAQL

To zapytanie pobiera dane dotyczące konkurencji i rezerwacji w przypadku reklam wertykalnych w podziale na miasto, w którym znajduje się obiekt, przedział cenowy i rodzaj 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 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 w formacie pionowym:

Kod błędu Przyczyna Zalecane działanie
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING Wszystkie 3 formaty reklam (tekstowe, z linkiem do rezerwacji i promocyjne) zostały wyłączone jednocześnie lub enable_booking_links włączono je w przypadku branży innej niż HOTELS lub THINGS_TO_DO. Upewnij się, że w sekcji VerticalAdsFormatSetting włączony jest 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 Kampania nie ma włączonych funkcji AI Max w kampaniach w sieci wyszukiwania. Włącz AI Max w kampaniach w sieci wyszukiwania w ustawieniach kampanii.
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED Kampania nie ma aktywnego pliku danych o branży. Upewnij się, że prawidłowy plik danych pionowych jest połączony na poziomie klienta lub kampanii.
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST Podana w AdGroupCriterion nazwa zasobu SharedSet nie istnieje lub nie ma typu VERTICAL_ADS_ITEM_GROUP_RULE_LIST. Sprawdź, czy nazwa zasobu shared_set odwołuje się do istniejącego zasobu SharedSet typu VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
CriterionError.CANNOT_ADD_REMOVED_VERTICAL_ADS_ITEM_GROUP_RULE_LIST_SHARED_SET SharedSet, do którego odwołuje się AdGroupCriterion, ma stan REMOVED. Odwołaj się do włączonego elementu 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ślonej branży, np. klasa hotelu w przypadku wypożyczalni samochodów. Sprawdź, czy vertical_ads_item_group_rule wymiar jest zgodny z typem pionowym.