Audience

مخاطب یک گزینه هدف‌گیری مؤثر است که به شما امکان می‌دهد ویژگی‌های بخش مختلف، مانند مشخصات جمعیتی دقیق و وابستگی‌ها را قطع کنید تا مخاطبانی ایجاد کنید که بخش‌هایی از بخش‌های هدف شما را نشان می‌دهند.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
زمینه های
resourceName

string

تغییرناپذیر. نام منبع مخاطب نام مخاطبان به شکل زیر است:

customers/{customerId}/audiences/{audience_id}

id

string ( int64 format)

فقط خروجی شناسه مخاطب

status

enum ( AudienceStatus )

فقط خروجی وضعیت این مخاطب نشان می دهد که آیا مخاطب فعال یا حذف شده است.

name

string

ضروری. نام مخاطب. باید در بین همه مخاطبان منحصر به فرد باشد. طول آن باید حداقل 1 و حداکثر طول 255 باشد.

description

string

توصیف این مخاطب

dimensions[]

object ( AudienceDimension )

ابعاد مثبتی که ترکیب مخاطب را مشخص می کند.

exclusionDimension

object ( AudienceExclusionDimension )

بعد منفی که ترکیب مخاطب را مشخص می کند.

وضعیت مخاطب

فهرست شامل انواع وضعیت مخاطبین احتمالی است.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
ENABLED وضعیت فعال - مخاطب فعال است و می توان آن را هدف قرار داد.
REMOVED وضعیت حذف شده - مخاطب حذف شده است و نمی توان از آن برای هدف گیری استفاده کرد.

ابعاد مخاطب

بعد مثبتی که مخاطبان کاربر را مشخص می کند.

نمایندگی 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.
}
زمینه های
dimension میدان اتحادیه ابعاد مشخص کننده کاربرانی که به مخاطبان تعلق دارند. dimension فقط می تواند یکی از موارد زیر باشد:
age

object ( AgeDimension )

ابعادی که کاربران را بر اساس سن آنها مشخص می کند.

gender

object ( GenderDimension )

ابعادی که کاربران را بر اساس جنسیت آنها مشخص می کند.

householdIncome

object ( HouseholdIncomeDimension )

بعد مشخص کردن کاربران بر اساس درآمد خانوارشان.

parentalStatus

object ( ParentalStatusDimension )

ابعادی که کاربران را بر اساس وضعیت والدینشان مشخص می کند.

audienceSegments

object ( AudienceSegmentDimension )

ابعادی که کاربران را با عضویت آنها در سایر بخش‌های مخاطب مشخص می‌کند.

ابعاد سنی

ابعادی که کاربران را بر اساس سن آنها مشخص می کند.

نمایندگی JSON
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
زمینه های
ageRanges[]

object ( AgeSegment )

محدوده سنی پیوسته در بعد گنجانده شود.

includeUndetermined

boolean

شامل کاربرانی که سن آنها مشخص نشده است.

بخش سنی

محدوده سنی پیوسته

نمایندگی JSON
{
  "minAge": integer,
  "maxAge": integer
}
زمینه های
minAge

integer

حداقل سن برای گنجاندن حداقل سن باید مشخص شود و باید حداقل 18 سال باشد. مقادیر مجاز 18، 25، 35، 45، 55، و 65 هستند.

maxAge

integer

حداکثر سن برای گنجاندن حداکثر سن لازم نیست مشخص شود. اگر مشخص شده باشد، maxAge باید بیشتر از minAge باشد و مقادیر مجاز 24، 34، 44، 54 و 64 هستند.

ابعاد جنسیتی

ابعادی که کاربران را بر اساس جنسیت آنها مشخص می کند.

نمایندگی JSON
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
زمینه های
genders[]

enum ( GenderType )

شامل بخش‌های جمعیتی جنسیتی.

includeUndetermined

boolean

شامل کاربرانی شود که جنسیت آنها مشخص نشده است.

بعد درآمد خانوار

بعد مشخص کردن کاربران بر اساس درآمد خانوارشان.

نمایندگی JSON
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
زمینه های
incomeRanges[]

enum ( IncomeRangeType )

شامل بخش های جمعیتی درآمد خانوار.

includeUndetermined

boolean

شامل کاربرانی شود که درآمد خانوارشان مشخص نشده است.

بعد وضعیت والدین

ابعادی که کاربران را بر اساس وضعیت والدینشان مشخص می کند.

نمایندگی JSON
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
زمینه های
parentalStatuses[]

enum ( ParentalStatusType )

شامل بخش‌های جمعیتی وضعیت والدین.

includeUndetermined

boolean

شامل کاربرانی شود که وضعیت والدینشان نامشخص است.

AudienceSegmentDimension

ابعادی که کاربران را با عضویت آنها در سایر بخش‌های مخاطب مشخص می‌کند.

نمایندگی JSON
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
زمینه های
segments[]

object ( AudienceSegment )

شامل بخش های مخاطب کاربران در صورتی که حداقل به یک بخش تعلق داشته باشند شامل می شوند.

بخش مخاطب

بخش مخاطبان مثبت

نمایندگی 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.
}
زمینه های
segment میدان اتحادیه بخش مثبت segment می تواند تنها یکی از موارد زیر باشد:
userList

object ( UserListSegment )

بخش لیست کاربران

userInterest

object ( UserInterestSegment )

Affinity یا In-market segment.

lifeEvent

object ( LifeEventSegment )

بخش مخاطبان رویداد زنده.

detailedDemographic

object ( DetailedDemographicSegment )

بخش جمعیتی تفصیلی

customAudience

object ( CustomAudienceSegment )

بخش مخاطب سفارشی

UserListSegment

بخش لیست کاربران غروب آفتاب مخاطبان مشابه در ماه مه 2023 شروع می‌شود. برای سایر گزینه‌ها به https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html مراجعه کنید.

نمایندگی JSON
{
  "userList": string
}
زمینه های
userList

string

منبع لیست کاربران

UserInterestSegment

بخش علاقه کاربر

نمایندگی JSON
{
  "userInterestCategory": string
}
زمینه های
userInterestCategory

string

منبع علاقه کاربر

LifeEventSegment

بخش رویداد زنده

نمایندگی JSON
{
  "lifeEvent": string
}
زمینه های
lifeEvent

string

منبع رویداد زندگی

بخش جمعیتی تفصیلی

بخش جمعیتی تفصیلی

نمایندگی JSON
{
  "detailedDemographic": string
}
زمینه های
detailedDemographic

string

منبع دقیق جمعیتی

CustomAudienceSegment

بخش مخاطب سفارشی

نمایندگی JSON
{
  "customAudience": string
}
زمینه های
customAudience

string

منبع مخاطب سفارشی

بعد حذف مخاطب

بعد منفی که کاربران را برای حذف از مخاطب مشخص می کند.

نمایندگی JSON
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
زمینه های
exclusions[]

object ( ExclusionSegment )

بخش مخاطب حذف شود.

ExclusionSegment

بخش مخاطبی که باید از یک مخاطب حذف شود.

نمایندگی JSON
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
زمینه های
segment میدان اتحادیه بخش باید حذف شود. segment می تواند تنها یکی از موارد زیر باشد:
userList

object ( UserListSegment )

بخش لیست کاربر حذف می شود.