Audience

Audiens adalah opsi penargetan efektif yang memungkinkan Anda memadukan berbagai atribut segmen, seperti demografi dan minat terperinci, untuk membuat audiens yang mewakili bagian dari segmen target.

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

string

Tidak dapat diubah. Nama resource audiens. Nama audiens memiliki bentuk:

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

string (int64 format)

Hanya output. ID audiens.
status

enum (AudienceStatus)

Hanya output. Status audiens ini. Menunjukkan apakah audiens diaktifkan atau dihapus.
name

string

Wajib. Nama audiens. Nama tersebut harus unik untuk semua audiens. Panjangnya harus minimal 1 dan panjang maksimal 255.
description

string

Deskripsi audiens ini.
dimensions[]

object (AudienceDimension)

Dimensi positif yang menentukan komposisi audiens.
exclusionDimension

object (AudienceExclusionDimension)

Dimensi negatif yang menentukan komposisi audiens.

AudienceStatus

Enum yang berisi kemungkinan jenis status audiens.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
ENABLED Status diaktifkan - audiens diaktifkan dan dapat ditargetkan.
REMOVED Status dihapus - audiens dihapus dan tidak dapat digunakan untuk penargetan.

AudienceDimension

Dimensi positif yang menentukan audiens pengguna.

Representasi 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.
}
Kolom
Kolom union dimension. Dimensi yang menentukan pengguna yang termasuk dalam audiens. dimension hanya ada berupa salah satu diantara berikut:
age

object (AgeDimension)

Dimensi yang menentukan pengguna menurut usia mereka.
gender

object (GenderDimension)

Dimensi yang menentukan pengguna menurut gender mereka.
householdIncome

object (HouseholdIncomeDimension)

Dimensi yang menentukan pengguna berdasarkan pendapatan rumah tangganya.
parentalStatus

object (ParentalStatusDimension)

Dimensi yang menentukan pengguna menurut status keorangtuaannya.
audienceSegments

object (AudienceSegmentDimension)

Dimensi yang menentukan pengguna berdasarkan keanggotaan mereka di segmen audiens lain.

AgeDimension

Dimensi yang menentukan pengguna menurut usia mereka.

Representasi JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
Kolom
ageRanges[]

object (AgeSegment)

Rentang usia yang berdekatan untuk disertakan dalam dimensi.
includeUndetermined

boolean

Sertakan pengguna yang usianya tidak ditentukan.

AgeSegment

Rentang usia berdekatan.

Representasi JSON 
{
  "minAge": integer,
  "maxAge": integer
}
Kolom
minAge

integer

Usia minimum yang disertakan. Usia minimum harus ditentukan dan minimal harus 18 tahun. Nilai yang diperbolehkan adalah 18, 25, 35, 45, 55, dan 65.
maxAge

integer

Usia maksimum yang disertakan. Usia maksimum tidak perlu ditentukan. Jika ditentukan, maxAge harus lebih besar dari minAge, dan nilai yang diizinkan adalah 24, 34, 44, 54, dan 64.

GenderDimension

Dimensi yang menentukan pengguna menurut gender mereka.

Representasi JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
Kolom
genders[]

enum (GenderType)

Segmen demografis gender yang disertakan.
includeUndetermined

boolean

Sertakan pengguna yang gendernya tidak ditentukan.

HouseholdIncomeDimension

Dimensi yang menentukan pengguna berdasarkan pendapatan rumah tangganya.

Representasi JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
Kolom
incomeRanges[]

enum (IncomeRangeType)

Segmen demografis pendapatan rumah tangga yang disertakan.
includeUndetermined

boolean

Sertakan pengguna yang pendapatan rumah tangganya tidak ditentukan.

ParentalStatusDimension

Dimensi yang menentukan pengguna menurut status keorangtuaannya.

Representasi JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
Kolom
parentalStatuses[]

enum (ParentalStatusType)

Segmen demografis status keorangtuaan disertakan.
includeUndetermined

boolean

Sertakan pengguna yang status keorangtuaannya belum ditentukan.

AudienceSegmentDimension

Dimensi yang menentukan pengguna berdasarkan keanggotaan mereka di segmen audiens lain.

Representasi JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
Kolom
segments[]

object (AudienceSegment)

Segmen audiens yang disertakan. Pengguna disertakan jika mereka termasuk dalam setidaknya satu segmen.

AudienceSegment

Segmen audiens positif.

Representasi 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.
}
Kolom
Kolom union segment. Segmen positif. segment hanya ada berupa salah satu diantara berikut:
userList

object (UserListSegment)

Segmen daftar pengguna.
userInterest

object (UserInterestSegment)

Segmen Minat atau Berniat beli.
lifeEvent

object (LifeEventSegment)

Segmen audiens live streaming.
detailedDemographic

object (DetailedDemographicSegment)

Segmen demografis terperinci.
customAudience

object (CustomAudienceSegment)

Segmen audiens kustom.

UserListSegment

Segmen daftar pengguna. Penghentian Audiens Serupa mulai Mei 2023. Lihat https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html untuk opsi lainnya.

Representasi JSON 
{
  "userList": string
}
Kolom
userList

string

Resource daftar pengguna.

UserInterestSegment

Segmen minat pengguna.

Representasi JSON 
{
  "userInterestCategory": string
}
Kolom
userInterestCategory

string

Resource minat pengguna.

LifeEventSegment

Segmen siaran langsung.

Representasi JSON 
{
  "lifeEvent": string
}
Kolom
lifeEvent

string

Resource peristiwa kehidupan.

DetailedDemographicSegment

Segmen demografis terperinci.

Representasi JSON 
{
  "detailedDemographic": string
}
Kolom
detailedDemographic

string

Referensi demografi terperinci.

CustomAudienceSegment

Segmen audiens kustom.

Representasi JSON 
{
  "customAudience": string
}
Kolom
customAudience

string

Resource audiens kustom.

AudienceExclusionDimension

Dimensi negatif yang menentukan pengguna yang akan dikecualikan dari audiens.

Representasi JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
Kolom
exclusions[]

object (ExclusionSegment)

Segmen audiens yang akan dikecualikan.

ExclusionSegment

Segmen audiens yang akan dikecualikan dari audiens.

Representasi JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
Kolom
Kolom union segment. Segmen yang akan dikecualikan. segment hanya ada berupa salah satu diantara berikut:
userList

object (UserListSegment)

Segmen daftar pengguna yang akan dikecualikan.