UserList

רשימת משתמשים. זוהי רשימה של משתמשים שהלקוח עשוי לטרגט.

ייצוג JSON 
{
  "resourceName": string,
  "membershipStatus": enum (UserListMembershipStatus),
  "sizeRangeForDisplay": enum (UserListSizeRange),
  "sizeRangeForSearch": enum (UserListSizeRange),
  "type": enum (UserListType),
  "closingReason": enum (UserListClosingReason),
  "accessReason": enum (AccessReason),
  "accountUserListStatus": enum (UserListAccessStatus),
  "id": string,
  "readOnly": boolean,
  "name": string,
  "description": string,
  "integrationCode": string,
  "membershipLifeSpan": string,
  "sizeForDisplay": string,
  "sizeForSearch": string,
  "eligibleForSearch": boolean,
  "eligibleForDisplay": boolean,
  "matchRatePercentage": integer,

  // Union field user_list can be only one of the following:
  "crmBasedUserList": {
    object (CrmBasedUserListInfo)
  },
  "similarUserList": {
    object (SimilarUserListInfo)
  },
  "ruleBasedUserList": {
    object (RuleBasedUserListInfo)
  },
  "logicalUserList": {
    object (LogicalUserListInfo)
  },
  "basicUserList": {
    object (BasicUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
שדות
resourceName

string

בלתי משתנה. שם המשאב של רשימת המשתמשים. שמות המשאבים של רשימות משתמשים מופיעים בצורה הבאה:

customers/{customerId}/userLists/{userListId}
membershipStatus

enum (UserListMembershipStatus)

סטטוס החבֵרוּת של רשימת המשתמשים הזו. מציין אם רשימת המשתמשים פתוחה או פעילה. רק רשימות פתוחות של משתמשים יכולות לצבור יותר משתמשים שניתן לטרגט אליהן.
sizeRangeForDisplay

enum (UserListSizeRange)

פלט בלבד. טווח גודל במונחים של מספר המשתמשים ב-UserList, ברשת המדיה של Google.

השדה הזה הוא לקריאה בלבד.
type

enum (UserListType)

פלט בלבד. סוג הרשימה הזו.

השדה הזה הוא לקריאה בלבד.
closingReason

enum (UserListClosingReason)

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

enum (AccessReason)

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

השדה הזה הוא לקריאה בלבד.
accountUserListStatus

enum (UserListAccessStatus)

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

string (int64 format)

פלט בלבד. המזהה של רשימת המשתמשים.
readOnly

boolean

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

השדה הזה הוא לקריאה בלבד.
name

string

השם של רשימת המשתמשים הזו. בהתאם ל-accessReason שלו, יכול להיות ששם רשימת המשתמשים לא יהיה ייחודי (לדוגמה, אם accessReason=SHARED)
description

string

התיאור של רשימת המשתמשים הזו.
integrationCode

string

מזהה ממערכת חיצונית. אתרי מכירה שמשתמשים ברשימות משתמשים כדי לאמת מזהים במערכות שלהם.
membershipLifeSpan

string (int64 format)

מספר הימים שבהם קובץ cookie של משתמש נשאר ברשימה מאז הפעם האחרונה שהוא נוסף לרשימה. השדה הזה חייב להיות בין 0 ל-540, כולל. עם זאת, ברשימות משתמשים שמבוססות על ניהול קשרי לקוחות (CRM), אפשר להגדיר את השדה הזה ל-10,000 כך שאין תאריך תפוגה.

המערכת מתעלמת מהשדה הזה כשמדובר בסוגים logicUserList ובסוג rulebasedUserList. החברות ברשימות מהסוגים האלה תלויה בכללים שהוגדרו ברשימות.
sizeForDisplay

string (int64 format)

פלט בלבד. המספר המשוער של משתמשים ברשימת המשתמשים הזו, ברשת המדיה של Google. הערך הזה הוא null אם מספר המשתמשים עדיין לא נקבע.

השדה הזה הוא לקריאה בלבד.
eligibleForDisplay

boolean

פלט בלבד. מציין שרשימת המשתמשים הזו כשירה לרשת המדיה של Google.

השדה הזה הוא לקריאה בלבד.
matchRatePercentage

integer

פלט בלבד. מציין את אחוז הלקוחות לטירגוט ברשימות התאמה ללקוחות. הטווח של השדה הזה הוא [0-100]. הערך הזה יהיה null בסוגים אחרים של רשימות, או במקרים שבהם לא ניתן לחשב את אחוז הלקוחות לטירגוט.

השדה הזה הוא לקריאה בלבד.

שדה איחוד user_list. רשימת המשתמשים.

יש להגדיר בדיוק ערך אחד. user_list יכול להיות רק אחד מהבאים:
crmBasedUserList

object (CrmBasedUserListInfo)

רשימת משתמשים של משתמשים במערכת לניהול קשרי לקוחות (CRM) שסופקה על ידי המפרסם.
similarUserList

object (SimilarUserListInfo)

פלט בלבד. רשימת משתמשים שדומה למשתמשים מרשימת משתמשים אחרת. הרשימות האלה מוגדרות לקריאה בלבד ונוצרות באופן אוטומטי על ידי Google.
ruleBasedUserList

object (RuleBasedUserListInfo)

רשימת משתמשים שנוצרה על ידי כלל.
logicalUserList

object (LogicalUserListInfo)

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

object (BasicUserListInfo)

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

UserListMembershipStatus

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

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

UserListSizeRange

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
LESS_THAN_FIVE_HUNDRED רשימת המשתמשים מכילה פחות מ-500 משתמשים.
LESS_THAN_ONE_THOUSAND מספר המשתמשים ברשימת המשתמשים נע בין 500 ל-1,000.
ONE_THOUSAND_TO_TEN_THOUSAND מספר המשתמשים ברשימת המשתמשים נע בין 1000 ל-10,000.
TEN_THOUSAND_TO_FIFTY_THOUSAND מספר המשתמשים ברשימת המשתמשים נע בין 10,000 ל-50,000.
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND מספר המשתמשים ברשימת המשתמשים נע בין 50,000 ל-100,000.
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND רשימת המשתמשים כוללת מספר משתמשים בטווח של 100,000 עד 300,000.
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND רשימת המשתמשים כוללת מספר משתמשים בטווח של 300,000 עד 500,000.
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION רשימת המשתמשים כוללת מספר משתמשים בטווח של 500,000 עד מיליון.
ONE_MILLION_TO_TWO_MILLION ברשימת המשתמשים יש מספר משתמשים בטווח של 1 עד 2 מיליון משתמשים.
TWO_MILLION_TO_THREE_MILLION ברשימת המשתמשים יש מספר משתמשים בטווח של 2 עד 3 מיליון משתמשים.
THREE_MILLION_TO_FIVE_MILLION ברשימת המשתמשים יש מספר משתמשים בטווח של 3 עד 5 מיליון.
FIVE_MILLION_TO_TEN_MILLION ברשימת המשתמשים יש מספר משתמשים בטווח של 5 עד 10 מיליון.
TEN_MILLION_TO_TWENTY_MILLION ברשימת המשתמשים יש מספר משתמשים בטווח של 10 עד 20 מיליון.
TWENTY_MILLION_TO_THIRTY_MILLION ברשימת המשתמשים יש מספר משתמשים בטווח של 20 עד 30 מיליון.
THIRTY_MILLION_TO_FIFTY_MILLION ברשימת המשתמשים יש מספר משתמשים בטווח של 30 עד 50 מיליון.
OVER_FIFTY_MILLION רשימת המשתמשים מכילה יותר מ-50 מיליון משתמשים.

UserListType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
REMARKETING רשימת המשתמשים מיוצגת כאוסף של סוגי המרות.
LOGICAL רשימת משתמשים מיוצגת כשילוב של רשימות/תחומי עניין אחרים של משתמשים.
EXTERNAL_REMARKETING רשימת המשתמשים נוצרה בפלטפורמת Google Ad Manager.
RULE_BASED רשימת משתמשים שמשויכת לכלל.
SIMILAR רשימת משתמשים עם משתמשים שדומים למשתמשים ברשימת משתמשים אחרת.
CRM_BASED רשימת משתמשים של נתונים מאינטראקציה ישירה במערכת לניהול קשרי לקוחות (CRM) שסופקו על ידי המפרסם, בצורה של אימיילים או בפורמטים אחרים.

UserListClosingReason

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

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

AccessReason

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
OWNED המשאב נמצא בבעלות המשתמש.
SHARED המשאב משותף עם המשתמש.
LICENSED המשאב קיבל רישיון למשתמש.
SUBSCRIBED המשתמש נרשם למשאב.
AFFILIATED המשאב נגיש למשתמש.

UserListAccessStatus

רשימת המשתמשים מכילה סטטוסים אפשריים של גישה לרשימת משתמשים.

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

CrmBasedUserListInfo

רשימת משתמשים של משתמשים במערכת לניהול קשרי לקוחות (CRM) שסופקה על ידי המפרסם.

ייצוג JSON 
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
שדות
uploadKeyType

enum (CustomerMatchUploadKeyType)

סוג מפתח תואם של הרשימה. סוגי נתונים מעורבים אינם מותרים באותה רשימה. השדה הזה נדרש לפעולת ADD.
dataSourceType

enum (UserListCrmDataSourceType)

מקור הנתונים של הרשימה. ערך ברירת המחדל הוא FIRST_PARTY. רק לקוחות ברשימת ההיתרים יכולים ליצור רשימות CRM ממקורות צד שלישי.
appId

string

מחרוזת שמזהה באופן ייחודי אפליקציה לנייד שממנה נאספו הנתונים. ב-iOS, מחרוזת המזהה היא מחרוזת בת 9 ספרות שמופיעה בסוף כתובת ה-URL ב-App Store (לדוגמה, '476943146' אם מזינים את המחרוזת 'Flood-It! '. 2" שהקישור ל-App Store הוא http://itunes.apple.com/us/app/flood-it!-2/id476943146). ב-Android, מחרוזת המזהה היא שם החבילה של האפליקציה (לדוגמה, 'com.labpixies.colordrips' בשדה 'Color Drips' שמופיע בקישור ל-Google Play https://play.google.com/store/apps/details?id=com.labpixies.colordrips). נדרשת כשיוצרים CrmמבוססUserList לצורך העלאת מזהי פרסום בנייד.

CustomerMatchUploadKeyType

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

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

UserListCrmDataSourceType

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
FIRST_PARTY הנתונים שאתם מעלים הם נתונים מאינטראקציה ישירה (First-Party).
THIRD_PARTY_CREDIT_BUREAU הנתונים שהועלו מגיעים מסוכנות אשראי של צד שלישי.
THIRD_PARTY_VOTER_FILE הנתונים שהועלו מגיעים מקובץ מצביע של צד שלישי.

SimilarUserListInfo

רשימת משתמשים דומה היא רשימה של משתמשים שדומים למשתמשים מרשימת משתמשים אחרת. הרשימות האלה מוגדרות לקריאה בלבד ונוצרות על ידי Google באופן אוטומטי.

ייצוג JSON 
{
  "seedUserList": string
}
שדות
seedUserList

string

רשימת משתמשים מהמקור שממנו הרשימה הזו נגזרת.

RuleBasedUserListInfo

ייצוג של רשימת משתמשים שנוצרה על ידי כלל.

ייצוג JSON 
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
שדות
prepopulationStatus

enum (UserListPrepopulationStatus)

הסטטוס של אכלוס מראש. אם השדה לא מוגדר, ברירת המחדל שלו היא 'ללא'. המשמעות היא שהמשתמשים הקודמים לא יילקחו בחשבון. אם המדיניות מוגדרת כ-REQUESTED, מבקרים שביקרו באתר או משתמשים בעבר באפליקציה שתואמים להגדרת הרשימה ייכללו ברשימה (פועלים ברשת המדיה בלבד). הפעולה הזו תגרום רק להוספה של משתמשים קודמים ב-30 הימים האחרונים, בהתאם למשך החברות של הרשימה ולתאריך שבו התג של הרימרקטינג נוסף. הסטטוס יעודכן ל'FINISHED' לאחר עיבוד הבקשה, או ל'נכשל' אם הבקשה נכשלה.
flexibleRuleUserList

object (FlexibleRuleUserListInfo)

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

UserListPrepopulationStatus

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

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

FlexibleRuleUserListInfo

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

ייצוג JSON 
{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}
שדות
inclusiveRuleOperator

enum (UserListFlexibleRuleOperator)

אופרטור שמגדיר איך משלבים אופרנדים כוללים.
inclusiveOperands[]

object (FlexibleRuleOperandInfo)

כללים שמייצגים משתמשים שצריכים להיכלל ברשימת המשתמשים. הם נמצאים בצד שמאל של האופרטור AND_NOT ומחוברים יחד באמצעות AND/OR, כפי שצוין על ידי IncludeRuleOperator.
exclusiveOperands[]

object (FlexibleRuleOperandInfo)

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

UserListFlexibleRuleOperator

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

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

FlexibleRuleOperandInfo

כלל גמיש שעוטף את הכלל המשותף וחלון מבט לאחור.

ייצוג JSON 
{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}
שדות
rule

object (UserListRuleInfo)

רשימה של קבוצות פריטים של כללים שמגדירות את הכלל. קבוצות של פריטים של כללים מקובצות יחד.
lookbackWindowDays

string (int64 format)

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

UserListRuleInfo

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

ייצוג JSON 
{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}
שדות
ruleType

enum (UserListRuleType)

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

ברירת המחדל היא OR של AND (צורה רגילה בעלת הבחנה). כלומר, המערכת תחבר בין פריטים של כללים באמצעות AND, בתוך קבוצות של פריטים בכללים, והקבוצות עצמן ייכללו ב-OR יחד.

OR של AND הוא הסוג הנתמך היחיד עבור FlexibleRuleUserList.
ruleItemGroups[]

object (UserListRuleItemGroupInfo)

רשימה של קבוצות פריטים של כללים שמגדירות את הכלל. קבוצות של פריטים של כללים מקובצות יחד לפי ruleType.

UserListRuleType

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

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

UserListRuleItemGroupInfo

קבוצה של פריטים לפי כללים.

ייצוג JSON 
{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}
שדות
ruleItems[]

object (UserListRuleItemInfo)

פריטים של כללים שיקובצו יחד לפי ruleType.

UserListRuleItemInfo

פריט כלל אטומי.

ייצוג JSON 
{
  "name": string,

  // Union field rule_item can be only one of the following:
  "numberRuleItem": {
    object (UserListNumberRuleItemInfo)
  },
  "stringRuleItem": {
    object (UserListStringRuleItemInfo)
  },
  "dateRuleItem": {
    object (UserListDateRuleItemInfo)
  }
  // End of list of possible types for union field rule_item.
}
שדות
name

string

שם המשתנה של הכלל. הוא צריך להיות תואם לשם המפתח התואם שהופעל על ידי הפיקסל. שם חייב להתחיל באותיות US-ascii, או קו תחתון או קוד UTF8 שגדול מ-127, והוא צריך לכלול אותיות, ספרות או קו תחתון (US-ascii), או קוד UTF8 שגדול מ-127. באתרים יש שתי כתובות URL מובנות (name = 'url__') וכתובת URL של גורם מפנה (name = 'ref_url__'). צריך לאכלס את השדה הזה כשיוצרים פריט כלל חדש.
שדה איחוד rule_item. פריט כלל אטומי. rule_item יכול להיות רק אחד מהבאים:
numberRuleItem

object (UserListNumberRuleItemInfo)

פריט כלל אטומי שמורכב מפעולת מספר.
stringRuleItem

object (UserListStringRuleItemInfo)

פריט כלל אטומי שמורכב מפעולת מחרוזת.
dateRuleItem

object (UserListDateRuleItemInfo)

פריט של כלל אטומי שמורכב מפעולת תאריך.

UserListNumberRuleItemInfo

פריט כלל שמורכב מפעולת מספר.

ייצוג JSON 
{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}
שדות
operator

enum (UserListNumberRuleItemOperator)

אופרטור להשוואת מספרים. חובה למלא את השדה הזה, ויש למלא אותו כשיוצרים פריט חדש של כלל מספרי.
value

number

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

UserListNumberRuleItemOperator

טיפוס (Enum) שמתאר אופרטורים אפשריים של פריטים ברשימת משתמשים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
GREATER_THAN גדול מ-.
GREATER_THAN_OR_EQUAL גדול מ- או שווה ל-.
EQUALS שווה.
NOT_EQUALS לא שווה ל-.
LESS_THAN פחות מ-.
LESS_THAN_OR_EQUAL פחות מ- או שווה ל-.

UserListStringRuleItemInfo

פריט כלל שמורכב מפעולת מחרוזת.

ייצוג JSON 
{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}
שדות
operator

enum (UserListStringRuleItemOperator)

אופרטור השוואת מחרוזות. זהו שדה חובה ויש לאכלס אותו כשיוצרים פריט כלל מחרוזת חדש.
value

string

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

UserListStringRuleItemOperator

טיפוס (Enum) שמתאר אופרטורים אפשריים של פריטים במחרוזת של רשימת משתמשים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
CONTAINS מכיל.
EQUALS שווה.
STARTS_WITH מתחיל ב-.
ENDS_WITH מסתיים ב-.
NOT_EQUALS לא שווה ל-.
NOT_CONTAINS לא מכיל.
NOT_STARTS_WITH לא מתחיל ב.
NOT_ENDS_WITH לא מסתיים ב-.

UserListDateRuleItemInfo

פריט כלל שמורכב מפעולת תאריך.

ייצוג JSON 
{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}
שדות
operator

enum (UserListDateRuleItemOperator)

אופרטור השוואת תאריכים. זהו שדה חובה ויש לאכלס אותו כשיוצרים פריט חדש של כלל תאריכים.
value

string

מחרוזת שמייצגת את ערך התאריך להשוואה עם משתנה הכלל. פורמט התאריך הנתמך הוא YYYY-MM-DD. הזמנים מדווחים באזור הזמן של הלקוח.
offsetInDays

string (int64 format)

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

UserListDateRuleItemOperator

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

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
EQUALS שווה.
NOT_EQUALS לא שווה.
BEFORE לפני.
AFTER אחרי.

LogicalUserListInfo

רשימת משתמשים שהיא שילוב מותאם אישית של רשימות משתמשים.

ייצוג JSON 
{
  "rules": [
    {
      object (UserListLogicalRuleInfo)
    }
  ]
}
שדות
rules[]

object (UserListLogicalRuleInfo)

כללים לוגיים לרשימות שמגדירים את רשימת המשתמשים הזו. הכללים מוגדרים כאופרטור לוגי (ALL/ANY/NONE) ורשימה של רשימות משתמשים. כאשר מתבצעת הערכה של כל הכללים, מתבצעת פעולת AND.

נדרשת כדי ליצור רשימת משתמשים לוגית.

UserListLogicalRuleInfo

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

ייצוג JSON 
{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}
שדות
operator

enum (UserListLogicalRuleOperator)

האופרטור הלוגי של הכלל.
ruleOperands[]

object (LogicalUserListOperandInfo)

רשימת האופרנדים של הכלל.

UserListLogicalRuleOperator

מספרים לציון אופרטורים לוגיים של רשימת משתמשים אפשריים.

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

LogicalUserListOperandInfo

אופרנד של רשימת משתמשים לוגית שמורכבת מרשימת משתמשים.

ייצוג JSON 
{
  "userList": string
}
שדות
userList

string

שם המשאב של רשימת משתמשים כאופרנד.

BasicUserListInfo

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

ייצוג JSON 
{
  "actions": [
    {
      object (UserListActionInfo)
    }
  ]
}
שדות
actions[]

object (UserListActionInfo)

פעולות שמשויכות לרשימת המשתמשים הזו.

UserListActionInfo

סוג פעולה שמשמש ליצירת רשימות משתמשים לרימרקטינג.

ייצוג JSON 
{

  // Union field user_list_action can be only one of the following:
  "conversionAction": string,
  "remarketingAction": string
  // End of list of possible types for union field user_list_action.
}
שדות
שדה איחוד user_list_action. סוגי משנה של פעולה ברשימת משתמשים. user_list_action יכול להיות רק אחד מהבאים:
conversionAction

string

פעולת המרה שלא נוצרה מרימרקטינג.
remarketingAction

string

פעולת רימרקטינג.