Dołącz do nas na żywo na Discordzie na serwerze społeczności Google Advertising and Measurement oraz w YouTube 29 stycznia o 10:00 czasu EST. Omówimy nowe funkcje dodane w wersji 23 interfejsu Google Ads API.

Ustawienia i filtrowanie zasobów reklamowych w przypadku reklam wertykalnych

Reklamy w branży zapewniają specjalistyczne funkcje w kampaniach w sieci wyszukiwania z włączonymi funkcjami AI Max, które są połączone z plikiem danych branżowych, np. z plikami danych o hotelach. Możesz określać, które formaty reklam w branży mają być wyświetlane na poziomie grupy reklam, a także kontrolować, na które elementy pliku danych są kierowane reklamy w branży, za pomocą reguł grupy elementów reklam w branży.

Przegląd

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

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.
Zarządzanie elementami reklam w formacie pionowym: filtruj i kieruj reklamy na określone zasoby reklamowe z połączonego pliku danych w formacie pionowym (wcześniej nazywanego plikiem danych o podróżach) za pomocą systemu opartego na regułach, który obejmuje SharedSet andSharedCriterion`.

Wymagania wstępne

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

Typ kampanii: musi to być kampania w sieci wyszukiwania.
Plik danych o branży: z kampanią musi być powiązany aktywny plik danych o branży.
AI Max: w kampanii musi być włączone ustawienie „AI Max”.

Ustawienia formatu grupy reklam

Możesz teraz skonfigurować, które formaty reklam w branży są aktywne w określonej grupie reklam. Zarządza się nim za pomocą pola vertical_ads_format_setting w zasobie AdGroup.

Dostępne formaty

Reklamy tekstowe: domyślnie włączone. Można je wyłączyć.
Linki do rezerwacji: wymagają samodzielnego włączania rozszerzeń.
Reklamy promujące usługi w określonej branży: wymagają wyrażenia zgody.

Reguły weryfikacji

Nie możesz jednocześnie zrezygnować z wyświetlania wszystkich 3 formatów w jednej grupie reklam.
Te ustawienia dotyczą tylko typów grup reklam STANDARD i SEARCH_DYNAMIC_ADS.

Przykład: aktualizowanie ustawień formatu

Poniższy przykład pokazuje, jak wyłączyć reklamy tekstowe i włączyć reklamy promujące produkty w pionie w przypadku istniejącej grupy reklam.

Java

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .setVerticalAdsFormatSetting(
     
   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 pionowych

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

Jak działa model danych

Model danych wykorzystuje podejście oparte na wspólnych kryteriach:

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

Obsługiwane wymiary

W SharedCriterion możesz filtrować podmioty na podstawie tych wymiarów:

item_code: konkretny identyfikator informacji.
city_criterion_id, region_criterion_id, country_criterion_id: Stałe geotargetowania.
brand_text: nazwa marki.
hotel_class: ocena w gwiazdkach (1–5).
vertical_ads_item_category: Kategoria, np. CONCERT.

Przykład kodu: tworzenie i łączenie reguł

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

Python

# 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_LISTshared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

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

# Rule A: Include Boston and SF
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 = 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
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...

Raportowanie

Dane o skuteczności reklam wideo możesz pobrać za pomocą metod GoogleAdsService.SearchStream lub GoogleAdsService.Search. W przypadku interfejsu Google Ads API w wersji 23 dodano konkretne segmenty umożliwiające szczegółowe raportowanie.

Nowe segmenty

segments.vertical_ads_listing_city: miasto powiązane z wizytówką.
segments.vertical_ads_vertical_type: typ pionowy, np. hotel lub wypożyczalnia samochodów.

Przykładowe zapytanie GAQL

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
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
`INVALID_VERTICAL_ADS_FORMAT_SETTING`	Wszystkie 3 formaty reklam (tekstowe, z linkiem do rezerwacji i promocyjne) zostały wyłączone jednocześnie.	Upewnij się, że w `VerticalAdsFormatSetting` włączono co najmniej 1 format (ustawiono wartość „true”).
`VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...`	Kampania nie ma włączonych funkcji AI Max lub nie ma aktywnego pliku danych pionowych.	Włącz AI Max w ustawieniach kampanii i upewnij się, że jest z nią połączony prawidłowy plik danych o branży.
`VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST`	Nazwa zasobu SharedSet podana w obiekcie AdGroupCriterion nie istnieje.	Sprawdź, czy nazwa zasobu shared_set pasuje do utworzonego zestawu.
`VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...`	Użyty typ kryterium nie jest obsługiwany w przypadku określonej branży, np. klasa hotelu w przypadku wypożyczalni samochodów.	Sprawdź, czy wymiar `vertical_ads_item_group_rule` jest zgodny z typem branży.