משאב: DataSegment
מגדיר מזהה לפלח של מלאי שטחי פרסום שאוצרים או מתכנני מדיה יכולים לטרגט בממשק המשתמש של העסקאות או של חבילות המכרזים. אוצרים בפלטפורמות חיצוניות אוצרים את מלאי שטחי הפרסום. -- Next ID: 9 --
| ייצוג ב-JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "state": enum ( |
| שדות | |
|---|---|
name |
לא ניתן לשינוי. מזהה. המזהה הייחודי של פלח הנתונים. מזהה החשבון תואם למזהה החשבון שבו נוצר הפלח. פורמט: |
createTime |
פלט בלבד. השעה שבה נוצר פלח הנתונים. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
updateTime |
פלט בלבד. המועד שבו פלח הנתונים עודכן לאחרונה. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
state |
פלט בלבד. מצב פלח הנתונים. |
| העמלה תחויב כשחשבונות אחרים ישתמשו בפלח הנתונים הזה. לדוגמה, כשחשבונות אחרים מוסיפים את פלח הנתונים הזה לעסקה או לחבילת מכרזים. אחרי שמגדירים את סוג העמלה של פלח הנתונים, אי אפשר לשנות אותו. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים: | |
cpmFee |
אופציונלי. עמלה קבועה שנגבית על כל אלף חשיפות. אחרי שמגדירים את קוד המטבע, אי אפשר לשנות אותו. |
millipercentOfMediaFee |
אופציונלי. העמלה תחויב כאחוז מעלות החשיפה, והיא מיוצגת באלפיות האחוז. לדוגמה, 1% מיוצג כ-1000. |
| סוף השדות שמוציאים זה את זה. | |
userListId |
אופציונלי. לא ניתן לשינוי. המזהה של רשימת המשתמשים שכלולה בפלח הנתונים הזה. אוצרי נתונים עם חשבון מקושר של שותף נתונים יכולים ליצור פלח נתונים שכולל רשימת משתמשים שבבעלות החשבון המקושר של שותף הנתונים. אפשר להעלות ולנהל רשימות משתמשים באמצעות Data Manager API. קישור של רשימת משתמשים לפלח נתונים מאפשר לכם להגדיר פלח של מלאי שטחי פרסום שמבוסס על קהל שאתם יוצרים. |
מדינה (State)
פלט בלבד. כדי לשנות את המצב, משתמשים בשיטה activate ו-deactivate.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATE_UNSPECIFIED |
ערך ברירת המחדל. |
ACTIVE |
פלח הנתונים פעיל. |
INACTIVE |
פלח הנתונים לא פעיל. |
SUSPENDED |
פלח הנתונים מושעה ואי אפשר להפעיל אותו. |
Methods |
|
|---|---|
|
מפעיל פלח נתונים. |
|
יוצרת פלח נתונים בבעלות האוצר שמופיע ברשימה. |
|
השבתה של פלח נתונים. |
|
הפונקציה מקבלת פלח נתונים לפי השם שלו. |
|
מציג את פלחי הנתונים שבבעלות האוצר. |
|
עדכון של פלח נתונים. |