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ı) birleştirmenize olanak tanıyan etkili bir hedefleme seçeneğidir.

JSON gösterimi 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
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ılmış mı olduğunu belirtir.
description

string

Bu kitlenin açıklaması.
dimensions[]

object (AudienceDimension)

Kitle bileşimini belirten pozitif boyutlar.
exclusionDimension

object (AudienceExclusionDimension)

Kitle bileşimini belirten negatif boyut.
scope

enum (AudienceScope)

Bu kitlenin kullanılabileceği kapsamı tanımlar. Varsayılan olarak kapsam CUSTOMER'dir. Kitleler, tek bir assetGroup tarafından özel kullanım için ASSET_GROUP kapsamında oluşturulabilir. Kapsam ASSET_GROUP iken CUSTOMER iken CUSTOMER yerine ASSET_GROUP olarak değişebiliyor.
assetGroup

string

Sabit. Bu kitlenin kapsamının ayarlandığı öğe grubu. Yalnızca kapsam ASSET_GROUP olduğunda ayarlanmalıdır. Oluşturulduktan sonra sabit kalır. ASSET_GROUP kapsamına sahip bir kitle CUSTOMER kapsamına yükseltilirse bu alan otomatik olarak temizlenir.
name

string

Kitlenin adı. Hesaptaki tüm kitleler genelinde benzersiz olmalıdır. Minimum uzunluk 1, maksimum uzunluk 255 olmalıdır. Kapsam ayarlanmadığında veya CUSTOMER olarak ayarlandığında gereklidir. Kapsam ASSET_GROUP olduğunda ayarlanamaz veya güncellenemez.

AudienceStatus

Olası kitle durumu türlerini içeren enum.

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ıldı 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
Birleştirme alanı dimension. Kitleye ait 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ş grubu.

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

integer

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

integer

Dahil edilecek maksimum yaş. Maksimum yaş belirtilmesi gerekmez. Belirtilmesi halinde 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 belirlenmemiş kullanıcıları dahil edin.

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. Kullanıcılar en az bir segmente aitse 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
Birleştirme alanı segment. Pozitif segment. segment şunlardan yalnızca biri olabilir:
userList

object (UserListSegment)

Kullanıcı listesi segmenti.
userInterest

object (UserInterestSegment)

Yakın İlgi Alanı 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 adresini ziyaret edin.

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 olaylar kaynağı.

DetailedDemographicSegment

Ayrıntılı demografi segmenti.

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

string

Ayrıntılı demografi kaynağı.

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
Birleştirme alanı segment. Hariç tutulacak segment. segment şunlardan yalnızca biri olabilir:
userList

object (UserListSegment)

Hariç tutulacak kullanıcı listesi segmenti.

AudienceScope

Olası kitle kapsamı değerlerini içeren enum.

Sıralamalar
UNSPECIFIED Kapsam belirtilmedi.
UNKNOWN Alınan değer bu sürümde bilinmiyor.
CUSTOMER Kitle, müşteri düzeyinde belirlenir.
ASSET_GROUP Kitle, belirli bir AssetGroup altında ayarlanır.