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)

רשימת החברים בקהל בהתאמה אישית שמהם מורכב הקהל בהתאמה אישית. אפשר להוסיף חברים במהלך יצירת 'קהל בהתאמה אישית'. אם חברים מוצגים בפעולת UPDATE, החברים הקיימים יבוטלו.

CustomAudienceStatus

טיפוסים בני מנייה (enum) הכוללים סטטוסים אפשריים של קהלים מותאמים אישית.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED סטטוס מופעל – קהל בהתאמה אישית מופעל וניתן לטרגט אותו.
REMOVED סטטוס הוסר – קהל בהתאמה אישית הוסר ולא ניתן להשתמש בו לטירגוט.

CustomAudienceType

טיפוסים בני מנייה (enum) הכוללים סוגי קהלים אפשריים בהתאמה אישית.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
AUTO מערכת Google Ads תבחר באופן אוטומטי את הפרשנות הטובה ביותר בזמן הצגת המודעות.
INTEREST התאמה למשתמשים לפי תחומי העניין שלהם.
PURCHASE_INTENT התאמת המשתמשים לפי נושאים שהם מחפשים עליהם מידע או מוצרים שהם שוקלים לקנות.
SEARCH התאמה למשתמשים לפי מה שהם חיפשו בחיפוש Google.

CustomAudienceMember

חבר בקהל בהתאמה אישית. חבר יכול להיות KEYWORD, כתובת אתר, 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, כלולה בפרוטוקול — עד 2,048 תווים, שכוללת תוכן שהמשתמשים מעוניינים בו.
placeCategory

string (int64 format)

סוג מקום שמתואר על ידי קטגוריית המקומות שבהם משתמשים מבקרים.
app

string

שם חבילה של אפליקציות ל-Android שהמשתמשים התקינו, כמו com.google.example.

CustomAudienceMemberType

טיפוסים בני מנייה (enum) הכוללים סוגי חברים אפשריים בקהל בהתאמה אישית.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
KEYWORD משתמשים שתחומי העניין או הפעולות שלהם מתוארים על ידי מילת מפתח.
URL משתמשים שיש להם תחומי עניין הקשורים לתוכן האתר.
PLACE_CATEGORY משתמשים שמבקרים בסוגי מקומות המתוארים לפי קטגוריית מקומות.
APP משתמשים שהתקינו אפליקציה לנייד.