Tworzenie list odbiorców i zarządzanie nimi

Audience to zbiór precyzyjnych segmentów, kierowania demograficznego i wykluczeń, którego 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 docelowych odbiorców w kampanii w sieci reklamowej, sieci wyszukiwania, kampanii wideo, kampanii reklam hoteli lub standardowej kampanii produktowej, zapoznaj się z artykułem 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, umożliwia łączenie wielu wymiarów odbiorców:

• Segmenty odbiorców
  • Segmenty list użytkowników
  • Segmenty odbiorców o podobnych zainteresowaniach lub segmenty na rynku
  • Segmenty zdarzeń z życia
  • Segmenty szczegółowych danych demograficznych
  • Niestandardowe segmenty odbiorców (CustomAudienceSegment)
• Wiek: AgeDimension
• Płeć: GenderDimension
• Dochód gospodarstwa domowego: HouseholdIncomeDimension
• Status rodzicielski: ParentalStatusDimension

Sprawdź 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 przez przeanalizowanie zwróconego resource_name, a także sprawdzić pola zmienne (takie jak 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, 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

Na odbiorców można kierować reklamy na różne sposoby w zależności od typu kampanii.

Sygnały dotyczące grupy plików

Kampanie Performance Max używają AssetGroupSignal do kierowania reklam na docelowych odbiorców. Aby dowiedzieć się, jak kierować reklamy na docelowych odbiorców za pomocą sygnałów dotyczących grup plików, zapoznaj się z przewodnikiem 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 dotyczącego odbiorców za pomocą AdGroupCriterion, aby kierować reklamy na odbiorców lub dostarczać sygnały dotyczące odbiorców. Możesz kierować reklamy na docelowych odbiorców na poziomie grupy reklam, używając kryteriów AudienceInfo 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

Podczas tworzenia grupy reklam musisz włączyć kierowanie na odbiorców w obiekcie AdGroup, ustawiając parametr use_audience_grouped na true. Po utworzeniu grupy reklam nie można zmienić tego ustawienia.

Dzięki temu możesz dodać AdGroupCriterion z grupami odbiorców. Jeśli ta wartość nie jest ustawiona na true, kolejne żądanie kierowania na odbiorców nie powiedzie się.

Utwórz AdGroupCriterion

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

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

Podczas tworzenia kampanii możesz opcjonalnie ustawić parametr use_audience_grouped na true. Jeśli wybierzesz to ustawienie, przy próbie dodania kryteriów, które wykluczałyby segmenty i dane demograficzne na poziomie kampanii, pojawi się błąd.

Sprawdzone metody

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

Typowe błędy

Podczas tworzenia lub aktualizowania obiektu Audience interfejs Google Ads API sprawdza poprawność żądania i w razie niepowodzenia zwraca błędy z typu wyliczeniowego AudienceError.