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)

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

CustomAudienceStatus

ערכים מספריים הכוללים סטטוסים אפשריים של קהלים בהתאמה אישית.

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

CustomAudienceType

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

טיפוסים בני מנייה (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

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

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