Tworzenie list odbiorców i zarządzanie nimi

Audience to lista wielokrotnego użytku zawierająca precyzyjne segmenty, kierowanie demograficzne i wykluczenia. Kierowanie na odbiorców jest obsługiwane w przypadku kampanii Performance Max, kampanii generujących popyt i kampanii promujących aplikacje. Jeśli chcesz kierować reklamy na segmenty odbiorców bezpośrednio w kampanii w sieci reklamowej, kampanii w sieci wyszukiwania, kampanii wideo, kampanii reklam hoteli lub standardowej kampanii produktowej, zapoznaj się z sekcją Segmenty odbiorców.

Utwórz listy odbiorców

Tworzenie i aktualizowanie listy odbiorców za pomocą AudienceService. Każdy Audience musi mieć unikalną nazwę. Ta grupa odbiorców, której można używać wielokrotnie, pozwala łączyć ze sobą różne wymiary odbiorców:

Sprawdź w odpowiedzi MutateAudienceResult wartość audience_id.

Podczas tworzenia listy odbiorców za pomocą funkcji AudienceService.MutateAudiences każda operacja zwraca wartość MutateAudienceResult. Możesz sprawdzić MutateAudienceResult, aby uzyskać audience_id, analizując zwrócony resource_name, a także możesz sprawdzić pola, które można zmieniać (np. name), w zwróconym obiekcie audience, gdy response_content_type ma wartość 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, możesz użyć GoogleAdsService.SearchStream, aby pobrać atrybuty list odbiorców.

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

Docelowi odbiorcy

Na listy odbiorców można kierować reklamy na wiele sposobów w zależności od typu kampanii.

Sygnały dotyczące grupy plików

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

Kryterium w grupie reklam

Kampanie generujące popyt i kampanie promujące aplikacje obsługują dodawanie kryterium grupy reklam kierowanej na odbiorców za pomocą parametru AdGroupCriterion, aby kierować reklamy na odbiorców lub dostarczać sygnały dotyczące odbiorców. Możesz kierować reklamy na odbiorców na poziomie grupy reklam, używając kryteriów AudienceInfo w polu 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

Kierowanie na odbiorców musisz włączyć w AdGroup, ustawiając wartość 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 do odbiorców. Jeśli ta wartość nie jest ustawiona na true, kolejne żądanie kierowania reklam na tę listę odbiorców zakończy się niepowodzeniem.

Utwórz AdGroupCriterion

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

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

Możesz też ustawić wartość use_audience_grouped na true podczas tworzenia kampanii. Jeśli to ustawienie jest włączone, zobaczysz błąd, gdy spróbujesz dodać kryteria, które wykluczają segmenty i dane demograficzne na poziomie kampanii.

Sprawdzone metody

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

Typowe błędy

Podczas tworzenia lub aktualizowania Audience interfejs Google Ads API sprawdza poprawność żądania 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łanie do identyfikatora segmentu, który nie istnieje lub jest niedostępny.
Jak postępować Zanim utworzysz lub zaktualizujesz listę 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 W tym detailed_demographic w exclusion_dimension.
Jak postępować W przypadku wykluczeń w exclusion_dimension używaj tylko user_list.
Wskazówki dotyczące profilaktyki Podczas tworzenia lub aktualizowania listy odbiorców w polu user_list używaj tylko znaku exclusion_dimension.
DUPLICATE_AUDIENCE_SEGMENT
Podsumowanie Grupa odbiorców zawiera zduplikowane segmenty.
Typowe przyczyny Dodawanie tego samego segmentu kilka razy do tej samej listy odbiorców.
Jak postępować Usuń z definicji listy odbiorców zduplikowane segmenty.
Wskazówki dotyczące profilaktyki Sprawdź, czy wszystkie segmenty w grupie 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 postępować Podczas tworzenia listy odbiorców użyj unikalnej nazwy.
Wskazówki dotyczące profilaktyki Zanim utworzysz nową listę odbiorców, sprawdź, czy nie ma już listy o takiej nazwie.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Podsumowanie Lista odbiorców zawiera zbyt wiele wymiarów tego samego typu.
Typowe przyczyny uwzględnianie w jednej grupie odbiorców wielu wymiarów tego samego typu (np. wielu wymiarów wieku);
Jak postępować 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 Grupa odbiorców zawiera zbyt wiele segmentów.
Typowe przyczyny przekroczenie maksymalnej dozwolonej liczby segmentów na liście odbiorców;
Jak postępować Zmniejsz liczbę segmentów w definicji listy odbiorców.
Wskazówki dotyczące profilaktyki Zapoznaj się z dokumentacją, aby dowiedzieć się więcej o limitach liczby segmentów w przypadku poszczególnych odbiorców.
Wstecz
Przegląd
Dalej
Pierwsze kroki z segmentami odbiorców