Audience

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

Representasi JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  },
  "scope": enum (AudienceScope),
  "assetGroup": string,
  "name": string
}
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.
description

string

Deskripsi audiens ini.
dimensions[]

object (AudienceDimension)

Dimensi positif yang menentukan komposisi audiens.
exclusionDimension

object (AudienceExclusionDimension)

Dimensi negatif yang menentukan komposisi audiens.
scope

enum (AudienceScope)

Menentukan cakupan yang dapat digunakan audiens ini. Secara default, cakupannya adalah CUSTOMER. Audiens dapat dibuat dengan cakupan ASSET_GROUP untuk penggunaan eksklusif oleh satu assetGroup. Cakupan dapat berubah dari ASSET_GROUP ke CUSTOMER tetapi tidak dari CUSTOMER ke ASSET_GROUP.
assetGroup

string

Tidak dapat diubah. Grup aset yang mencakup audiens ini. Harus ditetapkan jika dan hanya jika cakupan adalah ASSET_GROUP. Tidak dapat diubah setelah dibuat. Jika audiens dengan cakupan ASSET_GROUP diupgrade ke cakupan CUSTOMER, kolom ini akan otomatis dihapus.
name

string

Nama audiens. ID audiens harus unik di semua audiens dalam akun. Nama harus memiliki panjang minimum 1 dan panjang maksimum 255. Wajib jika cakupan tidak ditetapkan atau ditetapkan ke CUSTOMER. Tidak dapat ditetapkan atau diperbarui jika cakupan adalah ASSET_GROUP.

AudienceStatus

Enum yang berisi kemungkinan jenis status audiens.

Enum
UNSPECIFIED Tidak ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui dalam versi ini.
ENABLED Status aktif - 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 berdasarkan usia mereka.
gender

object (GenderDimension)

Dimensi yang menentukan pengguna berdasarkan gender mereka.
householdIncome

object (HouseholdIncomeDimension)

Dimensi yang menentukan pengguna berdasarkan pendapatan rumah tangga mereka.
parentalStatus

object (ParentalStatusDimension)

Dimensi yang menentukan pengguna berdasarkan status keorangtuaan mereka.
audienceSegments

object (AudienceSegmentDimension)

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

AgeDimension

Dimensi yang menentukan pengguna berdasarkan 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 yang berdekatan.

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

integer

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

integer

Usia maksimum untuk 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 berdasarkan 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 tangga mereka.

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 berdasarkan status keorangtuaan mereka.

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

enum (ParentalStatusType)

Menyertakan segmen demografis status keorangtuaan.
includeUndetermined

boolean

Sertakan pengguna yang status keorangtuaannya tidak 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 akan 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 siaran langsung.
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 acara live.

Representasi JSON 
{
  "lifeEvent": string
}
Kolom
lifeEvent

string

Resource peristiwa kehidupan.

DetailedDemographicSegment

Segmen demografis terperinci.

Representasi JSON 
{
  "detailedDemographic": string
}
Kolom
detailedDemographic

string

Sumber daya demografis 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.

AudienceScope

Enum yang berisi kemungkinan nilai cakupan audiens.

Enum
UNSPECIFIED Cakupan belum ditentukan.
UNKNOWN Nilai yang diterima tidak diketahui dalam versi ini.
CUSTOMER Audiens ini dicakup di tingkat pelanggan.
ASSET_GROUP Audiens ini tercakup dalam AssetGroup tertentu.