Audience

Odbiorcy to skuteczna opcja kierowania, która umożliwia stosowanie różnych atrybutów segmentu, np. szczegółowych danych demograficznych i podobnych zainteresowań, aby tworzyć listy odbiorców, które będą reprezentowały sekcje segmentów docelowych.

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

string

Niezmienne. 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.
name

string

To pole jest wymagane. Nazwa listy odbiorców. Powinien on być niepowtarzalny wśród wszystkich odbiorców. Jego minimalna długość to 1, a maksymalna – 255 znaków.
description

string

Opis tej listy odbiorców.
dimensions[]

object (AudienceDimension)

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

object (AudienceExclusionDimension)

Wymiar ujemny określający strukturę grupy odbiorców.

AudienceStatus

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

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. 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 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 mieć 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 ich 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)

Sąsiadujący przedział wiekowy, który ma zostać uwzględniony w wymiarze.
includeUndetermined

boolean

Uwzględnij użytkowników, których wieku nie udało się określić.

AgeSegment

Kontrastowy 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 określono parametr maxAge, musi on 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 ich płci.

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

enum (GenderType)

Uwzględniono segmenty demograficzne płci.
includeUndetermined

boolean

Uwzględnij użytkowników, których płeć nie została 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ędniono segmenty demograficzne dochodu gospodarstwa domowego.
includeUndetermined

boolean

Uwzględnij użytkowników, których dochód gospodarstwa domowego nie został 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. Użytkownicy są uwzględniani, jeśli 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 niewykluczający. segment może mieć tylko jedną z tych wartości:
userList

object (UserListSegment)

Segment listy użytkowników.
userInterest

object (UserInterestSegment)

Segment odbiorców o podobnych zainteresowaniach lub segment 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. W maju 2023 r. wycofamy funkcję Podobni odbiorcy. 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żytkowników.

Zapis JSON 
{
  "userInterestCategory": string
}
Pola
userInterestCategory

string

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

LifeEventSegment

Segment wydarzenia na żywo.

Zapis JSON 
{
  "lifeEvent": string
}
Pola
lifeEvent

string

Zasób zdarzenia z życia.

DetailedDemographicSegment

Szczegółowy segment demograficzny.

Zapis JSON 
{
  "detailedDemographic": string
}
Pola
detailedDemographic

string

Zasób ze szczegółowymi danymi demograficznymi.

CustomAudienceSegment

Niestandardowy segment odbiorców.

Zapis JSON 
{
  "customAudience": string
}
Pola
customAudience

string

Zasób odbiorców niestandardowych.

AudienceExclusionDimension

Wymiar wykluczającego określający użytkowników, których chcesz wykluczyć z grupy 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 grupy 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 mieć tylko jedną z tych wartości:
userList

object (UserListSegment)

Segment listy użytkowników do wykluczenia.