Audience

Kitle, hedef segmentlerinizin bölümlerini temsil eden kitleler oluşturmak için farklı segment özelliklerini (ör. ayrıntılı demografi ve yakın ilgi alanları) kesiştirmenize olanak tanıyan etkili bir hedefleme seçeneğidir.

JSON gösterimi 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
Alanlar
resourceName

string

Sabit. Kitlenin kaynak adı. Kitle adları şu biçimdedir:

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

string (int64 format)

Yalnızca çıkış. Kitlenin kimliği.
status

enum (AudienceStatus)

Yalnızca çıkış. Bu kitlenin durumu. Kitlenin etkin mi yoksa kaldırıldı mı olduğunu belirtir.
name

string

Zorunlu. Kitlenin adı. Tüm kitlelerde benzersiz olmalıdır. En az 1, maksimum uzunluğu ise 255 olmalıdır.
description

string

Bu kitlenin açıklaması.
dimensions[]

object (AudienceDimension)

Kitle bileşimini belirten pozitif boyutlar.
exclusionDimension

object (AudienceExclusionDimension)

Kitle bileşimini belirten negatif boyut.

AudienceStatus

Olası kitle durumu türlerini içeren sıralama.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Etkin durumu: Kitle etkindir ve hedeflenebilir.
REMOVED "Kaldırıldı durumu:" Kitle kaldırılır ve hedefleme için kullanılamaz.

AudienceDimension

Kullanıcının kitlesini belirten pozitif boyut.

JSON gösterimi 
{

  // 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.
}
Alanlar
dimension alanı. Kitleye ait olan kullanıcıları belirten boyut. dimension şunlardan yalnızca biri olabilir:
age

object (AgeDimension)

Kullanıcıları yaşlarına göre belirten boyut.
gender

object (GenderDimension)

Kullanıcıları cinsiyetlerine göre belirten boyut.
householdIncome

object (HouseholdIncomeDimension)

Kullanıcıları hane gelirlerine göre belirten boyut.
parentalStatus

object (ParentalStatusDimension)

Kullanıcıları ebeveynlik durumlarına göre belirten boyut.
audienceSegments

object (AudienceSegmentDimension)

Kullanıcıları diğer kitle segmentlerindeki üyeliklerine göre belirten boyut.

AgeDimension

Kullanıcıları yaşlarına göre belirten boyut.

JSON gösterimi 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Alanlar
ageRanges[]

object (AgeSegment)

Boyuta dahil edilecek bitişik yaş aralığı.
includeUndetermined

boolean

Yaşı belirlenmemiş kullanıcıları dahil et.

AgeSegment

Bitişik yaş aralığı.

JSON gösterimi 
{
  "minAge": integer,
  "maxAge": integer
}
Alanlar
minAge

integer

Dahil edilecek minimum yaş. Minimum yaş belirtilmeli ve en az 18 yaşında olmalıdır. İzin verilen değerler 18, 25, 35, 45, 55 ve 65'tir.
maxAge

integer

Eklenecek maksimum yaş. Maksimum yaş belirtmek gerekmez. Belirtilirse maxAge minAge'den büyük olmalıdır ve izin verilen değerler 24, 34, 44, 54 ve 64'tür.

GenderDimension

Kullanıcıları cinsiyetlerine göre belirten boyut.

JSON gösterimi 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Alanlar
genders[]

enum (GenderType)

Cinsiyet demografik segmentleri dahil edildi.
includeUndetermined

boolean

Cinsiyeti belirlenmemiş kullanıcıları dahil et.

HouseholdIncomeDimension

Kullanıcıları hane gelirlerine göre belirten boyut.

JSON gösterimi 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Alanlar
incomeRanges[]

enum (IncomeRangeType)

Dahil edilen hane geliri demografik segmentleri.
includeUndetermined

boolean

Hane geliri belirlenemeyen kullanıcıları dahil et.

ParentalStatusDimension

Kullanıcıları ebeveynlik durumlarına göre belirten boyut.

JSON gösterimi 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Alanlar
parentalStatuses[]

enum (ParentalStatusType)

Ebeveynlik durumu demografik segmentleri dahil edildi.
includeUndetermined

boolean

Ebeveynlik durumu belirsiz olan kullanıcıları dahil et.

AudienceSegmentDimension

Kullanıcıları diğer kitle segmentlerindeki üyeliklerine göre belirten boyut.

JSON gösterimi 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Alanlar
segments[]

object (AudienceSegment)

Dahil edilen kitle segmentleri. En az bir segmente ait olan kullanıcılar dahil edilir.

AudienceSegment

Pozitif kitle segmenti.

JSON gösterimi 
{

  // 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.
}
Alanlar
segment alanı. Pozitif segment. segment şunlardan yalnızca biri olabilir:
userList

object (UserListSegment)

Kullanıcı listesi segmenti.
userInterest

object (UserInterestSegment)

Yakın ilgi alanı segmenti veya Pazardaki segment.
lifeEvent

object (LifeEventSegment)

Canlı etkinlik kitle segmenti.
detailedDemographic

object (DetailedDemographicSegment)

Ayrıntılı demografi segmenti.
customAudience

object (CustomAudienceSegment)

Özel kitle segmenti

UserListSegment

Kullanıcı listesi segmenti. Benzer Kitleler özelliği Mayıs 2023'te kullanımdan kaldırılacak. Diğer seçenekler için https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html sayfasını inceleyin.

JSON gösterimi 
{
  "userList": string
}
Alanlar
userList

string

Kullanıcı listesi kaynağı.

UserInterestSegment

Kullanıcı ilgi alanı segmenti.

JSON gösterimi 
{
  "userInterestCategory": string
}
Alanlar
userInterestCategory

string

Kullanıcının ilgi alanı kaynağı.

LifeEventSegment

Canlı etkinlik segmenti.

JSON gösterimi 
{
  "lifeEvent": string
}
Alanlar
lifeEvent

string

Yaşamdaki önemli olay kaynağı.

DetailedDemographicSegment

Ayrıntılı demografi segmenti.

JSON gösterimi 
{
  "detailedDemographic": string
}
Alanlar
detailedDemographic

string

Ayrıntılı demografik kaynak.

CustomAudienceSegment

Özel kitle segmenti

JSON gösterimi 
{
  "customAudience": string
}
Alanlar
customAudience

string

Özel kitle kaynağı.

AudienceExclusionDimension

Kitleden hariç tutulacak kullanıcıları belirten negatif boyut.

JSON gösterimi 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Alanlar
exclusions[]

object (ExclusionSegment)

Hariç tutulacak kitle segmenti.

ExclusionSegment

Bir kitleden hariç tutulacak kitle segmenti.

JSON gösterimi 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Alanlar
segment alanı. Hariç tutulacak segment. segment şunlardan yalnızca biri olabilir:
userList

object (UserListSegment)

Hariç tutulacak kullanıcı listesi segmenti.