Audience

Odbiorcy to skuteczna opcja kierowania, która pozwala łączyć różne atrybuty segmentów, np. szczegółowe dane demograficzne i podobne zainteresowania, aby tworzyć listy odbiorców reprezentujące sekcje segmentów docelowych.

Zapis JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
Pola
resourceName

string

Stałe. Nazwa zasobu listy odbiorców. Nazwy list odbiorców mają postać:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator listy odbiorców.
status

enum (AudienceStatus)

Tylko dane wyjściowe. Stan tej listy odbiorców. Wskazuje, czy lista odbiorców jest włączona czy usunięta.
description

string

Opis tej listy odbiorców.
dimensions[]

object (AudienceDimension)

Wymiary niewykluczające określające strukturę grupy odbiorców.
exclusionDimension

object (AudienceExclusionDimension)

Wymiar wykluczającego określający strukturę odbiorców.
scope

enum (AudienceScope)

Określa zakres, w którym można korzystać z tej listy odbiorców. Domyślnie zakres to CUSTOMER. Listy odbiorców z zakresem ASSET_GROUP można tworzyć do użytku wyłącznego przez jedną grupę zasobów. Zakres może się zmienić z ASSET_GROUP na CUSTOMER, ale nie z CUSTOMER na ASSET_GROUP.
assetGroup

string

Stałe. Grupa plików, do której należy ta lista odbiorców. Należy go ustawić tylko wtedy, gdy zakres to ASSET_GROUP. Stała po utworzeniu. Jeśli lista odbiorców z zakresem ASSET_GROUP zostanie uaktualniona do zakresu CUSTOMER, to pole zostanie automatycznie wyczyszczone.
name

string

Nazwa listy odbiorców. Powinien być niepowtarzalny wśród wszystkich odbiorców na koncie. Musi mieć minimalną długość 1 i maksymalną 255 znaków. Wymagane, gdy zakres nie jest ustawiony lub jest ustawiony na CUSTOMER. Nie można ustawić ani zaktualizować, gdy zakres to ASSET_GROUP.

AudienceStatus

Wyliczenie zawierające możliwe typy stanu odbiorców.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ENABLED Stan włączenia – lista odbiorców jest włączona i można na nią kierować reklamy.
REMOVED Stan usunięty – lista odbiorców została usunięta i nie można jej używać do kierowania.

AudienceDimension

Wymiar dodatni określający grupę odbiorców użytkownika.

Zapis JSON 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
Pola
Pole sumy dimension. Wymiar określający użytkowników należących do listy odbiorców. dimension może być tylko jedną z tych wartości:
age

object (AgeDimension)

Wymiar określający użytkowników według wieku.
gender

object (GenderDimension)

Wymiar określający użytkowników według płci.
householdIncome

object (HouseholdIncomeDimension)

Wymiar określający użytkowników według dochodu gospodarstwa domowego.
parentalStatus

object (ParentalStatusDimension)

Wymiar określający użytkowników według ich statusu rodzicielskiego.
audienceSegments

object (AudienceSegmentDimension)

Wymiar określający użytkowników według ich przynależności do innych segmentów odbiorców.

AgeDimension

Wymiar określający użytkowników według wieku.

Zapis JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Pola
ageRanges[]

object (AgeSegment)

Przyległy przedział wiekowy, który ma zostać uwzględniony w wymiarze.
includeUndetermined

boolean

Uwzględnij użytkowników, których wiek nie został określony.

AgeSegment

Przyległy przedział wiekowy.

Zapis JSON 
{
  "minAge": integer,
  "maxAge": integer
}
Pola
minAge

integer

Minimalny wiek do uwzględnienia. Musisz określić minimalny wiek, który wynosi co najmniej 18 lat. Dozwolone wartości to 18, 25, 35, 45, 55 i 65.
maxAge

integer

Maksymalny wiek do uwzględnienia. Nie musisz określać maksymalnego wieku. Jeśli został określony, parametr maxAge musi być większy niż minAge, a dozwolone wartości to 24, 34, 44, 54 i 64.

GenderDimension

Wymiar określający użytkowników według płci.

Zapis JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Pola
genders[]

enum (GenderType)

Uwzględnione segmenty demograficzne płci.
includeUndetermined

boolean

Uwzględnij użytkowników, których płeć nie jest określona.

HouseholdIncomeDimension

Wymiar określający użytkowników według dochodu gospodarstwa domowego.

Zapis JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Pola
incomeRanges[]

enum (IncomeRangeType)

Uwzględnione segmenty demograficzne dochodów gospodarstwa domowego.
includeUndetermined

boolean

Uwzględnij użytkowników, których dochód gospodarstwa domowego nie jest określony.

ParentalStatusDimension

Wymiar określający użytkowników według ich statusu rodzicielskiego.

Zapis JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Pola
parentalStatuses[]

enum (ParentalStatusType)

Uwzględnione segmenty demograficzne statusu rodzicielskiego.
includeUndetermined

boolean

Uwzględnij użytkowników, których status rodzicielski jest nieokreślony.

AudienceSegmentDimension

Wymiar określający użytkowników według ich przynależności do innych segmentów odbiorców.

Zapis JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Pola
segments[]

object (AudienceSegment)

Uwzględnione segmenty odbiorców. Uwzględniani są użytkownicy, którzy należą do co najmniej jednego segmentu.

AudienceSegment

Niewykluczający segment odbiorców.

Zapis JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
Pola
Pole sumy segment. Segment wartości dodatnich. segment może być tylko jedną z tych wartości:
userList

object (UserListSegment)

Segment listy użytkowników.
userInterest

object (UserInterestSegment)

Segment odbiorców o podobnych zainteresowaniach lub odbiorców na rynku.
lifeEvent

object (LifeEventSegment)

Segment odbiorców związany z wydarzeniami na żywo.
detailedDemographic

object (DetailedDemographicSegment)

Szczegółowy segment demograficzny.
customAudience

object (CustomAudienceSegment)

Niestandardowy segment odbiorców.

UserListSegment

Segment listy użytkowników. Funkcja Podobni odbiorcy zostanie wycofana w maju 2023 r. Inne opcje znajdziesz na stronie https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html.

Zapis JSON 
{
  "userList": string
}
Pola
userList

string

Zasób listy użytkowników.

UserInterestSegment

Segment zainteresowań użytkownika.

Zapis JSON 
{
  "userInterestCategory": string
}
Pola
userInterestCategory

string

Zasób dotyczący zainteresowań użytkownika.

LifeEventSegment

Zdarzenie na żywo.

Zapis JSON 
{
  "lifeEvent": string
}
Pola
lifeEvent

string

Zasób związany ze zdarzeniem z życia.

DetailedDemographicSegment

Szczegółowy segment demograficzny.

Zapis JSON 
{
  "detailedDemographic": string
}
Pola
detailedDemographic

string

Szczegółowe dane demograficzne.

CustomAudienceSegment

Niestandardowy segment odbiorców.

Zapis JSON 
{
  "customAudience": string
}
Pola
customAudience

string

Zasób niestandardowej listy odbiorców.

AudienceExclusionDimension

Wymiar wykluczającego określający użytkowników, których chcesz wykluczyć z listy odbiorców.

Zapis JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Pola
exclusions[]

object (ExclusionSegment)

Segment odbiorców do wykluczenia.

ExclusionSegment

Segment odbiorców, który ma zostać wykluczony z danej listy odbiorców.

Zapis JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Pola
Pole sumy segment. Segment do wykluczenia. segment może być tylko jedną z tych wartości:
userList

object (UserListSegment)

Segment listy użytkowników do wykluczenia.

AudienceScope

Wyliczenie zawierające możliwe wartości zakresu odbiorców.

Wartości w polu enum
UNSPECIFIED Zakres nie został określony.
UNKNOWN Otrzymana wartość nie jest znana w tej wersji.
CUSTOMER Lista odbiorców jest ograniczona na poziomie klienta.
ASSET_GROUP Lista odbiorców jest ograniczona do konkretnej grupy komponentów.