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)

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

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)

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

parameter

string

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

CustomInterestMemberType

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

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