Tworzenie list odbiorców i zarządzanie nimi

Audience to zbiór precyzyjnych segmentów, kierowania demograficznego i wykluczeń, który można używać wielokrotnie. Kierowanie na odbiorców jest obsługiwane w kampaniach Performance Max, generujących popyt i promujących aplikacje. Jeśli chcesz kierować reklamy bezpośrednio na segmenty odbiorców w kampanii w sieci reklamowej, sieci wyszukiwania, sieci wideo, kampanii reklam hoteli lub standardowej kampanii produktowej, przejdź do sekcji Segmenty odbiorców.

Tworzenie list odbiorców

Listę odbiorców możesz utworzyć i zaktualizować za pomocą usługi AudienceService. Każdy Audience musi mieć unikalną nazwę. Ta lista odbiorców wielokrotnego użytku może zawierać kombinację kilku wymiarów odbiorców:

Pobieranie list odbiorców

Podobnie jak w przypadku innych zasobów, do pobierania atrybutów list odbiorców możesz używać GoogleAdsService.SearchStream.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Docelowi odbiorcy

W zależności od typu kampanii reklamy można kierować na odbiorców na kilka sposobów.

Sygnały dotyczące grupy plików

Kampanie Performance Max używają elementu AssetGroupSignal do kierowania reklam na odbiorców. Więcej informacji o kierowaniu na odbiorców za pomocą sygnałów dotyczących grupy plików znajdziesz w przewodniku Grupy plików.

Kryterium w grupie reklam

Kampanie generujące popyt i kampanie promujące aplikacje obsługują dodawanie kryterium grupy reklam dotyczącego odbiorców za pomocą AdGroupCriterion w celu kierowania reklam na odbiorców lub dostarczania sygnałów dotyczących odbiorców.

Aby skonfigurować kierowanie na odbiorców:

Włącz kierowanie na odbiorców w elemencie AdGroup

Musisz włączyć kierowanie na odbiorców w elemencie AdGroup, ustawiając use_audience_grouped na true podczas tworzenia grupy reklam.

Umożliwi to dodanie elementu AdGroupCriterion z odbiorcami. Jeśli ta wartość nie jest ustawiona na true, późniejsza próba kierowania na odbiorców zakończy się niepowodzeniem.

Utwórz element AdGroupCriterion

Utwórz element AdGroupCriterion i ustaw pole audience na nazwę zasobu listy odbiorców utworzonej wcześniej w tym przewodniku.

Opcjonalnie: włącz kierowanie na odbiorców w kampanii

Podczas tworzenia kampanii możesz opcjonalnie ustawić wartość use_audience_grouped na true. W przypadku tego ustawienia otrzymasz błąd, jeśli spróbujesz dodać kryteria, które wykluczałyby segmenty i dane demograficzne na poziomie kampanii.

Sprawdzone metody

  • Używaj list odbiorców do tworzenia person. Listy odbiorców najlepiej sprawdzają się w kampaniach Performance Max, kampaniach generujących popyt i kampaniach promujących aplikacje, w których chcesz łączyć wiele segmentów i kryteriów demograficznych, aby kierować reklamy na konkretną personę.
  • Używaj segmentów odbiorców do bezpośredniego kierowania. W przypadku kampanii w sieci reklamowej, sieci wyszukiwania, sieci wideo, kampanii reklam hoteli i standardowych kampanii produktowych lub gdy musisz kierować reklamy tylko na jeden segment (np. listę remarketingową), używaj segmentów odbiorców zamiast list odbiorców.

Typowe błędy

Podczas tworzenia lub aktualizowania elementu Audience interfejs Google Ads API sprawdza żądanie i w przypadku niepowodzenia weryfikacji zwraca błędy z AudienceError wyliczenia, jeśli weryfikacja się nie powiedzie.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Podsumowanie Nie znaleziono segmentu odbiorców w żądaniu.
Typowe przyczyny Odwoływanie się do identyfikatora segmentu, który nie istnieje lub jest niedostępny.
Jak sobie poradzić Przed utworzeniem lub zaktualizowaniem listy odbiorców upewnij się, że wszystkie identyfikatory segmentów istnieją i są dostępne.
Wskazówki dotyczące profilaktyki Przed dodaniem identyfikatorów segmentów do listy odbiorców sprawdź, czy są one prawidłowe.
DIMENSION_INVALID
Podsumowanie Wymiar odbiorców jest nieprawidłowy.
Typowe przyczyny Dodanie elementu detailed_demographic do elementu exclusion_dimension.
Jak sobie poradzić W przypadku wykluczeń w elemencie exclusion_dimension używaj tylko elementu user_list.
Wskazówki dotyczące profilaktyki Podczas tworzenia lub aktualizowania listy odbiorców upewnij się, że w elemencie exclusion_dimension używany jest tylko element user_list.
DUPLICATE_AUDIENCE_SEGMENT
Podsumowanie Lista odbiorców zawiera zduplikowane segmenty.
Typowe przyczyny Dodanie tego samego segmentu kilka razy do tej samej listy odbiorców.
Jak sobie poradzić Usuń zduplikowane segmenty z definicji listy odbiorców.
Wskazówki dotyczące profilaktyki Upewnij się, że wszystkie segmenty na liście odbiorców są unikalne.
NAME_ALREADY_IN_USE
Podsumowanie Nazwa listy odbiorców jest już używana.
Typowe przyczyny Próba utworzenia kilku list odbiorców o tej samej nazwie.
Jak sobie poradzić Podczas tworzenia listy odbiorców użyj unikalnej nazwy.
Wskazówki dotyczące profilaktyki Przed utworzeniem nowej listy odbiorców sprawdź, czy nie ma już listy o tej samej nazwie.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Podsumowanie Lista odbiorców zawiera zbyt wiele wymiarów tego samego typu.
Typowe przyczyny Dodanie do jednej listy odbiorców kilku wymiarów tego samego typu (np. kilku wymiarów wieku).
Jak sobie poradzić Upewnij się, że definicja listy odbiorców zawiera tylko 1 wymiar każdego typu.
Wskazówki dotyczące profilaktyki Sprawdź definicję listy odbiorców, aby upewnić się, że nie zawiera ona zduplikowanych typów wymiarów.
TOO_MANY_SEGMENTS
Podsumowanie Lista odbiorców zawiera zbyt wiele segmentów.
Typowe przyczyny Przekroczenie maksymalnej dozwolonej liczby segmentów na liście odbiorców.
Jak sobie poradzić Zmniejsz liczbę segmentów w definicji listy odbiorców.
Wskazówki dotyczące profilaktyki Sprawdź w dokumentacji limity liczby segmentów na liście odbiorców.