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 lub sieci wyszukiwania, kampanii wideo, kampanii reklam hoteli lub standardowej kampanii produktowej, zapoznaj się z artykułem Segmenty odbiorców.

Tworzenie list odbiorców

Listę odbiorców możesz utworzyć i zaktualizować za pomocą AudienceService. Każda lista Audience musi mieć unikalną nazwę. Ta lista odbiorców wielokrotnego użytku umożliwia łączenie wielu wymiarów odbiorców:

Sprawdzanie `MutateAudienceResult` pod kątem `audience_id`

Podczas tworzenia listy odbiorców za pomocą AudienceService.MutateAudiences każda operacja zwraca MutateAudienceResult. Możesz sprawdzić MutateAudienceResult, aby uzyskać audience_id, analizując zwróconą wartość resource_name. Możesz też sprawdzić pola, które można modyfikować (np. name), w zwróconym obiekcie audience, gdy response_content_type jest ustawiony na MUTABLE_RESOURCE:

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

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 różne sposoby.

Sygnały grupy plików

Kampanie Performance Max używają AssetGroupSignal do kierowania na docelowych odbiorców. Więcej informacji o kierowaniu na odbiorców za pomocą sygnałów grupy plików znajdziesz w przewodniku Sygnały grupy plików.

Kryterium w grupie reklam

Kampanie generujące popyt i kampanie promujące aplikacje obsługują dodawanie kryterium grupy reklam odbiorców za pomocą AdGroupCriterion w celu kierowania na odbiorców lub dostarczania sygnałów dotyczących odbiorców. Możesz kierować reklamy na odbiorców na poziomie grupy reklam za pomocą AudienceInfo kryteriów w AdGroupCriterion.audience, ustawiając pole AudienceInfo.audience (ad_group_criterion.audience.audience) na nazwę zasobu odbiorców.

Aby skonfigurować kierowanie na odbiorców:

Włącz kierowanie na odbiorców w AdGroup

Musisz włączyć kierowanie na odbiorców w AdGroup ustawiając use_audience_grouped na true podczas tworzenia grupy reklam. Po utworzeniu grupy reklam tego ustawienia nie można zmienić.

Dzięki temu możesz dodawać AdGroupCriterion z odbiorcami. Jeśli ta wartość nie jest ustawiona na true, kolejna prośba o kierowanie na odbiorców zakończy się niepowodzeniem.

Utwórz AdGroupCriterion

Utwórz AdGroupCriterion i ustaw pole AudienceInfo.audience w AdGroupCriterion.audience na nazwę zasobu odbiorców utworzonych w sekcji Tworzenie list odbiorców.

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

Podczas tworzenia kampanii możesz opcjonalnie ustawić 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 lub 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 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 Odniesienie 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 detailed_demographic w exclusion_dimension.
Jak sobie poradzić W przypadku wykluczeń w exclusion_dimension używaj tylko user_list.
Wskazówki dotyczące profilaktyki Podczas tworzenia lub aktualizacji listy odbiorców upewnij się, że w exclusion_dimension używana jest tylko user_list.
DUPLICATE_AUDIENCE_SEGMENT
Podsumowanie Lista odbiorców zawiera zduplikowane segmenty.
Typowe przyczyny Dodanie tego samego segmentu do tej samej listy odbiorców kilka razy.
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 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 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.
Wstecz
Przegląd
Dalej
Pierwsze kroki z segmentami odbiorców