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

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

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

CustomAudienceType

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

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

CustomAudienceMember

חבר בקהל בהתאמה אישית. חבר יכול להיות 'מילת מפתח', 'כתובת URL', 'PLACE_CATEGORY' או 'אפליקציה'. אפשר ליצור או להסיר חברים, אבל אי אפשר לשנות אותם.

ייצוג ב-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) שמכיל את סוגי החברים האפשריים בקהל בהתאמה אישית.

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