REST Resource: exchanges.publishers

משאב: בעל תוכן דיגיטלי

מכיל בעל תוכן דיגיטלי יחיד.

ייצוג JSON 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
שדות
name

string

פלט בלבד. שם המסלול היחסי של בעל התוכן הדיגיטלי הזה. הערך צריך להיות בפורמט: exchanges/{seller_id}/publishers/{publisherId}‎. דוגמה: exchanges/1234/publishers/5678.
externalPublisherId

string

חובה. ‫[DEPRECATED] השדה הזה יוחלף בקרוב ב-externalPublisherIds[]. מזהה ייחודי של בעל האתר שסופק על ידי הבורסה. הערך הזה חייב להיות זהה למזהה בעל התוכן הדיגיטלי שנשלח בבקשות להצעות מחיר.

עד 100 תווים. התווים המותרים הם אלפאנומריים, קו תחתון, מקף ונקודה.
externalPublisherIds[]

string

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

עד 10 ערכים. עד 100 תווים לכל מזהה. התווים המותרים הם אלפאנומריים, קו תחתון, מקף ונקודה.
displayName

string

חובה. השם המוצג של בעל התוכן הדיגיטלי. הערך חייב להיות מקודד ב-UTF-8, והגודל המקסימלי שלו הוא 30 תווים.
status

enum (DiscoveryObjectStatus)

חובה. הסטטוס של בעל התוכן הדיגיטלי. בעלי תוכן דיגיטלי עם הסטטוס PAUSED (מושהה) או REMOVED (הוסר) לא מוצגים למפרסמים ב-DV360.
mediumCapability

enum (MediumCapability)

חובה. המדיה שבה בעל התוכן הדיגיטלי מתכנן להציג את המודעות שלו.
description

string

חובה. טקסט התיאור של המוציא לאור הזה. הערך חייב להיות מקודד בתבנית UTF-8, והגודל המקסימלי שלו הוא 1,000 תווים.
contactInfo[]

string

חובה. כתובות אימייל של אנשי קשר שאליהן המפרסמים יכולים לפנות כדי לתקשר עם בעל האתר. עד 10 אנשי קשר. כל איש קשר יכול להכיל עד 100 תווים. דוגמה: [US contact - John Smith: john.smith@abc.com].
commitmentCapability[]

enum (CommitmentCapability)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

פלט בלבד. כתובת ה-URL של הלוגו של המוציא לאור.
floorPrice

object (Money)

אופציונלי. מחיר המינימום של המו"ל הזה. המטבע של מחיר המינימום למשלוח חינם צריך להיות זהה למטבע של מחיר המוצר.
ceilingPrice

object (Money)

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

string

אופציונלי. תיאור כללי בטקסט חופשי. הערך חייב להיות מקודד בתבנית UTF-8, והגודל המקסימלי שלו הוא 200 תווים. התיאור יכול להיות של SOV (נתח חשיפה), CPD (עלות ליום) או נפח מובטח. דוגמה לתיאור: "עלות לאלף חשיפות, השפעה גבוהה, 69% בממוצע של שיעור הצפייה"
tvMetadata

object (TVMetadata)

אופציונלי. מטא-נתונים של מו"ל שמציע תכנים לטלוויזיה. חובה אם היכולת של המדיום כוללת טלוויזיה. לא רלוונטי אם היכולת הבינונית לא כוללת טלוויזיה.
urgOwners[]

enum (UnderRepresentedGroup)

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

MediumCapability

ספירת יכולות בינונית. ממשק הקצה של Marketplace (בתוך מודול מלאי שטחי הפרסום של DV360) כולל קטעים שונים של מלאי שטחי פרסום. "דיגיטל: כולל בעלי אתרים וחבילות מכרזים שמתפרסמים במלאי שטחי פרסום לרשת המדיה, במלאי שטחי פרסום של מודעות וידאו (כולל CTV ו-OTT) ובמלאי שטחי פרסום של מודעות אודיו". ‫"TV: זהו קטע ייעודי חדש שהשקנו כדי לגלות מלאי שטחי פרסום ב-CTV וב-OTT. ההגדרות של CTV ו-OTT הן כדלקמן: 'טלוויזיה מחוברת (CTV) כוללת את כל המכשירים שתואמים לתיאורים הבאים: – מכשירים מחוברים או מכשירי סטרימינג: מכשירים שמתחברים למסך טלוויזיה כדי להציג סטרימינג של וידאו (Roku,‏ Apple TV וכו') ‫– טלוויזיה חכמה: טלוויזיות עם חיבור אינטרנט משולב (Samsung Smart TV וכו') ‫– קונסולות משחקים: קונסולות משחקים שמחוברות לאינטרנט (Xbox‏, PlayStation‏, Wii וכו') – ממירים: מכשירים שמציגים תוכן מסורתי של כבלים ווידאו על פי דרישה (VOD)." ‫'Over the Top'‏ (OTT) הוא תוכן וידאו שדומה לתוכן שמשודר בטלוויזיה, שספק וידאו מעביר באינטרנט מחוץ לרשתות הסגורות של ספקי טלקום וספקי כבלים. אפשר לצפות בסרטוני OTT במחשב, בנייד, בטאבלט, וגם במכשירי CTV או STB (כל עוד התוכן מועבר באמצעות IP). ‫"Audio: This is a newly launched, dedicated section for audio inventory.‎" ‫"OOH: בעלי תוכן דיגיטלי מחוץ לבית".

טיפוסים בני מנייה (enum)
MEDIUM_CAPABILITY_UNSPECIFIED יכולת בינונית לא צוינה. הקלט לא תקין.
MEDIUM_CAPABILITY_DIGITAL יכולת בינונית בדיגיטל.
MEDIUM_CAPABILITY_TV טלוויזיה עם יכולות בינוניות.
MEDIUM_CAPABILITY_AUDIO אודיו עם יכולת בינונית.
MEDIUM_CAPABILITY_OOH יכולת בינונית מחוץ לבית.

CommitmentCapability

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

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

TVMetadata

מטא-נתונים לבעלי תוכן דיגיטלי שמציעים תוכן לטלוויזיה.

ייצוג JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
שדות
tvDeliveryType

enum (TVDeliveryType)

חובה. סוג הצגת המודעות בטלוויזיה.
topShows[]

string

אופציונלי. רשימה של שמות תוכניות הטלוויזיה המובילות שבבעלות בעל האפליקציה. גודל מקסימלי 10. הקידוד חייב להיות UTF-8.

TVDeliveryType

סוג הצגת מודעות בטלוויזיה (enum).

טיפוסים בני מנייה (enum)
TV_DELIVERY_TYPE_UNSPECIFIED לא צוין סוג השידור בטלוויזיה. הקלט לא תקין.
TV_DELIVERY_TYPE_CTV סוג הצגת הסרטונים בטלוויזיה הוא טלוויזיה מחוברת.
TV_DELIVERY_TYPE_LINEAR_TV סוג הצגת התוכן בטלוויזיה הוא טלוויזיה לינארית.

Methods

create

 יצירת חשבון חדש לבעל אפליקציה.

get

 מקבל את בעל האפליקציה.

list

 מציג רשימה של בעלי תוכן דיגיטלי.

patch

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