CustomInterest

תחום עניין בהתאמה אישית. רשימה של משתמשים לפי תחום עניין.

ייצוג JSON
{
  "resourceName": string,
  "status": enum (CustomInterestStatus),
  "type": enum (CustomInterestType),
  "members": [
    {
      object (CustomInterestMember)
    }
  ],
  "id": string,
  "name": string,
  "description": string
}
שדות
resourceName

string

בלתי משתנה. שם המשאב של תחום העניין בהתאמה אישית. שמות משאבים של תחומי עניין מותאמים אישית מופיעים בתבנית הבאה:

customers/{customerId}/customInterests/{custom_interest_id}

status

enum (CustomInterestStatus)

הסטטוס של תחום העניין הזה בהתאמה אישית. מציין אם תחום העניין המותאם אישית מופעל או הוסר.

type

enum (CustomInterestType)

סוג האינטרס המותאם אישית, CUSTOM_AFFINITY או CUSTOM_INTENT. כברירת מחדל, הסוג מוגדר כ-CUSTOM_AFFINITY.

members[]

object (CustomInterestMember)

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

id

string (int64 format)

פלט בלבד. המזהה של תחום העניין בהתאמה אישית.

name

string

השם של תחום העניין בהתאמה אישית. הוא צריך להיות ייחודי בכל קהל בהתאמה אישית עם תחום עניין משותף. השדה הזה נדרש כדי ליצור פעולות.

description

string

תיאור של הקהל הזה בהתאמה אישית לפי תחומי עניין.

CustomInterestStatus

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

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

CustomInterestType

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

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

CustomInterestMember

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

ייצוג JSON
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
שדות
memberType

enum (CustomInterestMemberType)

הסוג של המשתמש בהתאמה אישית בתחום העניין, מילת המפתח או כתובת ה-URL.

parameter

string

טקסט מילת המפתח כאשר userType הוא KEYWORD או מחרוזת URL, כאשר memberType הוא URL.

CustomInterestMemberType

מספר הטיפוסים הטיפוסי שמוגבלים לתחומי העניין בהתאמה אישית.

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