CustomAudience

یک مخاطب سفارشی این لیستی از کاربران بر اساس علاقه است.

نمایندگی JSON
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
زمینه های
resourceName

string

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

customers/{customerId}/customAudiences/{custom_audience_id}

id

string ( int64 format)

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

status

enum ( CustomAudienceStatus )

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

name

string

نام مخاطب سفارشی باید برای همه مخاطبان سفارشی ایجاد شده توسط یک مشتری منحصر به فرد باشد. این فیلد برای ایجاد عملیات مورد نیاز است.

type

enum ( CustomAudienceType )

نوع مخاطب سفارشی ("INTEREST" یا "PURCHASE_INTENT" برای مخاطبان سفارشی جدید ایجاد شده مجاز نیست، اما برای مخاطبان موجود نگهداری می شود)

description

string

شرح این مخاطبان سفارشی.

members[]

object ( CustomAudienceMember )

فهرستی از اعضای مخاطب سفارشی که این مخاطب سفارشی از آنها تشکیل شده است. اعضا را می توان در طول ایجاد CustomAudience اضافه کرد. اگر اعضا در عملیات UPDATE ارائه شوند، اعضای موجود لغو خواهند شد.

CustomAudienceStatus

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

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

CustomAudienceType

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AUTO Google Ads بهترین تفسیر را در زمان ارائه به طور خودکار انتخاب می کند.
INTEREST کاربران را بر اساس علایق آنها مطابقت می دهد.
PURCHASE_INTENT کاربران را بر اساس موضوعاتی که در حال تحقیق هستند یا محصولاتی که برای خرید در نظر دارند مطابقت می دهد.
SEARCH کاربران را بر اساس آنچه در جستجوی Google جستجو کرده اند مطابقت می دهد.

CustomAudience Member

عضوی از مخاطبان سفارشی یک عضو می تواند یک KEYWORD، URL، PLACE_CATEGORY یا APP باشد. فقط می توان آن را ایجاد یا حذف کرد اما نمی توان آن را تغییر داد.

نمایندگی JSON
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
زمینه های
memberType

enum ( CustomAudienceMemberType )

نوع عضو مخاطب سفارشی، KEYWORD، URL، PLACE_CATEGORY یا APP.

value فیلد اتحادیه مقدار CustomAudienceMember. یک فیلد بسته به نوع عضو پر می شود. value فقط می تواند یکی از موارد زیر باشد:
keyword

string

یک کلمه کلیدی یا عبارت کلیدی - حداکثر 10 کلمه و 80 کاراکتر. زبان‌هایی با نویسه‌های دو عرض مانند چینی، ژاپنی یا کره‌ای دارای 40 نویسه هستند که علایق یا اقدامات کاربر را توصیف می‌کند.

url

string

یک URL HTTP، شامل پروتکل - حداکثر 2048 کاراکتر، که شامل محتوایی است که کاربران به آن علاقه دارند.

placeCategory

string ( int64 format)

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

app

string

نام بسته ای از برنامه های Android که کاربران نصب کرده اند مانند com.google.example.

CustomAudienceMemberType

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

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
KEYWORD کاربرانی که علایق یا اقداماتشان با یک کلمه کلیدی توصیف شده است.
URL کاربرانی که علایق مرتبط با محتوای وب سایت دارند.
PLACE_CATEGORY کاربرانی که از انواع مکان‌ها بازدید می‌کنند که با یک دسته مکان توصیف شده‌اند.
APP کاربرانی که اپلیکیشن موبایل نصب کرده اند.