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, kampanii w sieci wyszukiwania, kampanii 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żda lista Audience musi mieć unikalną nazwę. Ta lista odbiorców wielokrotnego użytku może zawierać kombinację kilku wymiarów odbiorców:

Sprawdzanie elementu MutateAudienceResult pod kątem wartości audience_id

Podczas tworzenia listy odbiorców za pomocą metody AudienceService.MutateAudiences każda operacja zwraca element MutateAudienceResult. Aby uzyskać wartość audience_id, możesz sprawdzić element MutateAudienceResult, analizując zwróconą wartość resource_name lub sprawdzając modyfikowalny obiekt audience, gdy wartość response_content_type jest ustawiona na MUTABLE_RESOURCE:

# Inspect MutateAudienceResult to get audience_id
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = resource_name.split("/")[-1]
    print(f"Created audience with resource_name '{resource_name}' and audience_id '{audience_id}'.")

    # If response_content_type is MUTABLE_RESOURCE, you can access result.audience.id directly:
    if result.audience and result.audience.id:
        print(f"Audience ID from mutable resource: {result.audience.id}")

Reklamy możesz kierować na odbiorców na poziomie grupy reklam za pomocą kryteriów AudienceInfo, ustawiając pole audience w elemencie AdGroupCriterion na nazwę zasobu odbiorców.

Pobieranie list odbiorców

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

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

Kierowanie na odbiorców

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

Sygnały dotyczące grupy plików

Kampanie Performance Max używają elementu AssetGroupSignal do kierowania 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 w grupie reklam dotyczącego odbiorców za pomocą AdGroupCriterion w celu kierowania 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

Podczas tworzenia grupy reklam musisz włączyć w niej kierowanie na odbiorców w AdGroup, ustawiając use_audience_grouped na true.

Umożliwi to dodawanie elementu AdGroupCriterion z odbiorcami. Jeśli ta wartość nie jest ustawiona na true, kolejna 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 odbiorców utworzonego 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, jeśli spróbujesz dodać kryteria, które wykluczałyby segmenty i dane demograficzne na poziomie kampanii, otrzymasz błąd.

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ć kilka 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, kampanii w sieci wyszukiwania, kampanii wideo, kampanii reklam hoteli i standardowych kampanii produktowych lub gdy chcesz 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 wyliczenia AudienceError.

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 uwzględnieniem identyfikatorów segmentów na liście odbiorców sprawdź, czy są one prawidłowe.
DIMENSION_INVALID
Podsumowanie Wymiar odbiorców jest nieprawidłowy.
Typowe przyczyny Uwzględnienie elementu detailed_demographic w elemencie 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 Dodawanie 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 takiej samej nazwie.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Podsumowanie Lista odbiorców zawiera zbyt wiele wymiarów tego samego typu.
Typowe przyczyny Uwzględnienie na jednej liście 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 jeden 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.
Wstecz
Przegląd
Dalej
Pierwsze kroki z segmentami odbiorców