REST Resource: advertisers.creatives

משאב: קריאייטיב

קריאייטיב יחיד.

ייצוג ב-JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
שדות
name

string

פלט בלבד. שם המשאב של הקריאייטיב.
advertiserId

string (int64 format)

פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הקריאייטיב.
creativeId

string (int64 format)

פלט בלבד. המזהה הייחודי של הקריאייטיב. הוקצה על ידי המערכת.
cmPlacementId

string (int64 format)

פלט בלבד. המזהה הייחודי של מיקום המודעה ב-Campaign Manager 360 שמשויך לקריאייטיב. השדה הזה רלוונטי רק לנכסי קריאייטיב שמסונכרנים מ-Campaign Manager.
displayName

string

חובה. השם המוצג של הקריאייטיב.

הקידוד חייב להיות UTF-8, והגודל המקסימלי הוא 240 בייטים.
entityStatus

enum (EntityStatus)

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

הערכים הקבילים הם:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון של הקריאייטיב, שבוצע על ידי המשתמש או המערכת (למשל, בדיקת קריאייטיב). הוקצה על ידי המערכת.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
creativeType

enum (CreativeType)

חובה. אי אפשר לשנות אותו. סוג הקריאייטיב.
hostingSource

enum (HostingSource)

חובה. מציין איפה הקריאייטיב מתארח.
dynamic

boolean

פלט בלבד. השדה מציין אם הקריאייטיב הוא דינמי.
dimensions

object (Dimensions)

חובה. מאפיינים ראשיים של הקריאייטיב. ההגבלה הזו רלוונטית לכל סוגי הקריאייטיב. ערך ברירת המחדל של widthPixels ו-heightPixels הוא 0 כש-creativeType הוא אחד מהערכים הבאים:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

אופציונלי. מאפיינים נוספים. רלוונטי אם creativeType הוא אחד מהערכים הבאים:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

אם מציינים את השדה הזה, חובה לציין גם את widthPixels וגם את heightPixels, והערכים שלהם צריכים להיות גדולים מ-0 או שווים לו.
mediaDuration

string (Duration format)

פלט בלבד. משך המדיה של הקריאייטיב. רלוונטי אם creativeType הוא אחד מהערכים הבאים:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

פלט בלבד. רשימה של מאפייני הקריאייטיב שנוצרת על ידי המערכת.
reviewStatus

object (ReviewStatusInfo)

פלט בלבד. הסטטוס הנוכחי של תהליך בדיקת הקריאייטיב.
assets[]

object (AssetAssociation)

חובה. נכסים שמשויכים לקריאייטיב הזה.
exitEvents[]

object (ExitEvent)

חובה. אירועי יציאה של הקריאייטיב הזה. יציאה (נקראת גם תג קליק) היא כל אזור בקריאייטיב שמישהו יכול ללחוץ עליו או להקיש עליו כדי לפתוח דף נחיתה של מפרסם. כל נכס קריאייטיב חייב לכלול לפחות יציאה אחת. אפשר להוסיף יציאה לקריאייטיב באחת מהדרכים הבאות:

  • משתמשים באזור ההקשה של Google Web Designer.
  • מגדירים משתנה JavaScript בשם clickTag.
  • כדי לעקוב אחרי יציאות בפורמטים של מדיה עשירה, משתמשים ב-Enabler ‏ (Enabler.exit()).
timerEvents[]

object (TimerEvent)

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

object (CounterEvent)

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

string

אופציונלי. תג מעקב HTML של צד שלישי שיוצמד לתג הקריאייטיב.
integrationCode

string

אופציונלי. פרטי המזהה שמשמשים לקישור הקריאייטיב הזה למערכת חיצונית. הקידוד חייב להיות UTF-8, והאורך לא יכול להיות יותר מ-10,000 תווים.
notes

string

אופציונלי. הערות משתמש לגבי הקריאייטיב הזה. הקידוד חייב להיות UTF-8, והאורך לא יכול להיות יותר מ-20,000 תווים.
iasCampaignMonitoring

boolean

אופציונלי. מציין אם מופעל מעקב אחר קמפיינים של Integral Ad Science ‏ (IAS). כדי להפעיל את האפשרות הזו עבור הקריאייטיב, צריך לוודא שהערך של Advertiser.creative_config.ias_client_id הוגדר למספר הלקוח שלכם ב-IAS.
companionCreativeIds[]

string (int64 format)

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

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

קריאייטיבים שמכילים additional dimensions לא יכולים להיות קריאייטיבים נלווים.

השדה הזה נתמך רק בcreativeType הבאים:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

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

השדה הזה נתמך רק בcreativeType הבאים:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

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

חובה למלא את השדה הזה כשהערך של skippable הוא true.

השדה הזה נתמך רק בcreativeType הבאים:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

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

חובה למלא את השדה הזה כשהערך של skippable הוא true.

השדה הזה נתמך רק בcreativeType הבאים:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

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

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

השדה הזה נתמך רק בcreativeType הבאים:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

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

השדה הזה נתמך רק בcreativeType הבאים:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

פלט בלבד. קידוד מחדש של אודיו/וידאו.

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

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

השדה הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

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

כתובות ה-URL צריכות להתחיל ב-https: (אלא אם מדובר במלאי שטחים פרסומיים שלא נדרשת בו תאימות ל-SSL). אם משתמשים בפקודות מאקרו בכתובת ה-URL, צריך להשתמש רק בפקודות מאקרו שנתמכות על ידי Display & Video 360.

רק כתובות URL רגילות, ללא תגי IMG או SCRIPT.

אפשר לכתוב בשדה הזה רק ב-creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

אופציונלי. כתובת URL למדידה ב-JavaScript מספקי אימות נתמכים של צד שלישי (ComScore, ‏ DoubleVerify, ‏ IAS, ‏ Moat). אין תמיכה בתגי סקריפט של HTML.

אפשר לכתוב בשדה הזה רק ב-creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

אופציונלי. מודעת המעקב ב-Campaign Manager 360 שמשויכת לקריאייטיב.

אופציונלי עבור creativeType כשנוצר על ידי מפרסם שמשתמש גם ב-Campaign Manager 360 וגם בהצגת מודעות של צד שלישי:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

פלט בלבד במקרים אחרים.
obaIcon

object (ObaIcon)

אופציונלי. מציין את סמל ה-OBA של קריאייטיב וידאו.

השדה הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

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

חובה, ותקף רק לגבי נכסי קריאייטיב של תגי צד שלישי.

קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם הערכים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

אופציונלי. מציין שהקריאייטיב דורש MRAID (מערכת הגדרות ממשק של מודעות Rich Media לנייד).

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

אופציונלי, ותקף רק לגבי נכסי קריאייטיב של תגי צד שלישי.

קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם הערכים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

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

אופציונלי, ותקף רק לגבי נכסי קריאייטיב של תגי צד שלישי. קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם הערכים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

אופציונלי. מציין שהקריאייטיב ימתין לפינג חוזר לצורך שיוך.

הפרמטר הזה תקף רק כשמשתמשים במודעה למעקב ב-Campaign Manager 360 עם פרמטר של שרת מודעות של צד שלישי ופקודת המאקרו ${DC_DBM_TOKEN}.

אופציונלי, ותקף רק לקריאייטיבים של תגים של צד שלישי או לקריאייטיבים של תגי VAST של צד שלישי.

קריאייטיבים עם תגים של צד שלישי הם קריאייטיבים עם הערכים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

קריאייטיבים של תגי VAST של צד שלישי הם קריאייטיבים עם המאפיינים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

אופציונלי. מציין את כיוון ההרחבה של הקריאייטיב.

נדרש ותקף רק לקריאייטיבים מתרחבים של צד שלישי.

קריאייטיבים מתרחבים של צד שלישי הם קריאייטיבים עם מקור האירוח הבא:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

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

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

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

אופציונלי. כתובת ה-URL של תג VAST לקריאייטיב של תג VAST של צד שלישי.

חובה ובתוקף רק לגבי נכסי קריאייטיב של תגי VAST של צד שלישי.

קריאייטיבים של תגי VAST של צד שלישי הם קריאייטיבים עם המאפיינים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

פלט בלבד. מציין שהקריאייטיב של תג VAST של צד שלישי דורש VPAID (ממשק בין מודעות לבין נגן וידאו דיגיטלי).

פלט בלבד, ותקף רק לגבי נכסי קריאייטיב של תגי VAST של צד שלישי.

קריאייטיבים של תגי VAST של צד שלישי הם קריאייטיבים עם המאפיינים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

פלט בלבד. מציין שהקריאייטיב של תג VAST של צד שלישי דורש תמיכה בווידאו ב-HTML5.

פלט בלבד, ותקף רק לגבי נכסי קריאייטיב של תגי VAST של צד שלישי.

קריאייטיבים של תגי VAST של צד שלישי הם קריאייטיבים עם המאפיינים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

פלט בלבד. המזהים של פריטי הקמפיין שהקריאייטיב הזה משויך אליהם.

כדי לשייך קריאייטיב לפריט, משתמשים במקום זאת בLineItem.creative_ids.
mp3Audio

boolean

פלט בלבד. הערך מציין שקריאייטיב אודיו של צד שלישי תומך ב-MP3.

פלט בלבד, והוא תקף רק לגבי נכסי קריאייטיב של אודיו מצד שלישי.

קריאייטיבים של אודיו של צד שלישי הם קריאייטיבים עם המאפיינים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

פלט בלבד. מציין שהקריאייטיב של האודיו של הצד השלישי תומך ב-OGG.

פלט בלבד, והוא תקף רק לגבי נכסי קריאייטיב של אודיו מצד שלישי.

קריאייטיבים של אודיו של צד שלישי הם קריאייטיבים עם המאפיינים הבאים hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

בשילוב עם creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

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

טיפוסים בני מנייה (enum)
HOSTING_SOURCE_UNSPECIFIED מקור האירוח לא צוין או לא ידוע בגרסה הזו.
HOSTING_SOURCE_CM

קריאייטיב שסונכרן מ-Campaign Manager 360.

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

קריאייטיב שמתארח בשרת מודעות של צד שלישי (3PAS).

יש תמיכה בשיטות ליצירה ולעדכון של סוג האירוח הזה אם creativeType הוא אחד מהבאים:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

קריאייטיב שנוצר ב-DV360 ומאוחסן ב-Campaign Manager 360.

יש תמיכה בשיטות ליצירה ולעדכון של סוג האירוח הזה אם creativeType הוא אחד מהבאים:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

קריאייטיב של מדיה עשירה שנוצר ב-Studio ומאוחסן ב-Campaign Manager 360.

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

CreativeAttribute

מאפיינים אפשריים של קריאייטיב.

טיפוסים בני מנייה (enum)
CREATIVE_ATTRIBUTE_UNSPECIFIED מאפיין הקריאייטיב לא צוין או שהוא לא ידוע בגרסה הזו.
CREATIVE_ATTRIBUTE_VAST הקריאייטיב הוא קריאייטיב VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR הקריאייטיב הוא קריאייטיב ליניארי של VPAID.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR הקריאייטיב הוא קריאייטיב VPAID א-ליניארי.

ReviewStatusInfo

בודקים את הסטטוסים של הקריאייטיב.

ייצוג ב-JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
שדות
approvalStatus

enum (ApprovalStatus)

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

enum (ReviewStatus)

סטטוס הבדיקה של הקריאייטיב ודף הנחיתה.
contentAndPolicyReviewStatus

enum (ReviewStatus)

סטטוס בדיקת התוכן והמדיניות של הקריאייטיב.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

סטטוסי הבדיקה של הקריאייטיב בבורסה.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

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

סטטוס אישור

סוגים אפשריים של סטטוס אישור. זהו סיכום של creativeAndLandingPageReviewStatus ושל contentAndPolicyReviewStatus.

טיפוסים בני מנייה (enum)
APPROVAL_STATUS_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
APPROVAL_STATUS_PENDING_NOT_SERVABLE הקריאייטיב עדיין בבדיקה ולא ניתן להציג אותו.
APPROVAL_STATUS_PENDING_SERVABLE הקריאייטיב עבר בדיקה של הקריאייטיב ודף הנחיתה, והוא מוכן להצגה, אבל הוא בהמתנה לבדיקה נוספת של התוכן והמדיניות.
APPROVAL_STATUS_APPROVED_SERVABLE הבדיקה של הקריאייטיב ודף הנחיתה והבדיקה של התוכן והמדיניות אושרו. הקריאייטיב כשיר להצגה.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE יש בעיה בקריאייטיב שצריך לפתור לפני שאפשר יהיה להציג אותו.

ReviewStatus

סוגים אפשריים של סטטוס ביקורת.

טיפוסים בני מנייה (enum)
REVIEW_STATUS_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
REVIEW_STATUS_APPROVED הקריאייטיב אושר.
REVIEW_STATUS_REJECTED הקריאייטיב נדחה.
REVIEW_STATUS_PENDING הקריאייטיב בהמתנה לבדיקה.

ExchangeReviewStatus

סטטוס הבדיקה של הקריאייטיב ב-Exchange.

ייצוג ב-JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
שדות
exchange

enum (Exchange)

הבורסה שבודקת את הקריאייטיב.
status

enum (ReviewStatus)

הסטטוס של בדיקת הבורסה.

PublisherReviewStatus

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

ייצוג ב-JSON 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
שדות
publisherName

string

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

enum (ReviewStatus)

הסטטוס של בדיקת בעל התוכן הדיגיטלי.

AssetAssociation

שיוך נכסים לקריאייטיב.

ייצוג ב-JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
שדות
asset

object (Asset)

אופציונלי. הנכס המשויך.
role

enum (AssetRole)

אופציונלי. התפקיד של נכס הקריאייטיב הזה.

נכס

נכס יחיד.

ייצוג ב-JSON 
{
  "mediaId": string,
  "content": string
}
שדות
mediaId

string (int64 format)

מזהה המדיה של הנכס שהועלה. זהו מזהה ייחודי של הנכס. אפשר להעביר את המזהה הזה לקריאות אחרות ל-API, למשל creatives.create כדי לשייך את הנכס לנכס קריאייטיב.

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

string

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

AssetRole

התפקיד של נכס הקריאייטיב הזה.

טיפוסים בני מנייה (enum)
ASSET_ROLE_UNSPECIFIED התפקיד של הנכס לא צוין או לא ידוע בגרסה הזו.
ASSET_ROLE_MAIN הנכס הוא הנכס הראשי של הקריאייטיב.
ASSET_ROLE_BACKUP הנכס הוא נכס גיבוי של הקריאייטיב.
ASSET_ROLE_POLITE_LOAD הנכס הוא נכס שנטען בצורה חלקה של הקריאייטיב.
ASSET_ROLE_HEADLINE

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

המחרוזת content חייבת להיות מקודדת ב-UTF-8, והאורך שלה לא יכול להיות יותר מ-25 תווים.

התפקיד הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

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

הערך של content חייב להיות מקודד בתבנית UTF-8, והאורך שלו לא יכול להיות יותר מ-50 תווים.

התפקיד הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

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

המחרוזת content חייבת להיות מקודדת ב-UTF-8, והאורך שלה לא יכול להיות יותר מ-90 תווים.

התפקיד הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

טקסט ארוך בגוף מודעה מותאמת.

המחרוזת content חייבת להיות מקודדת בתבנית UTF-8, והאורך שלה לא יכול להיות יותר מ-150 תווים.

התפקיד הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

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

הערך של content חייב להיות מקודד ב-UTF-8, והאורך שלו לא יכול להיות יותר מ-30 תווים.

לדוגמה, אם כתובת דף הנחיתה היא 'http://www.example.com/page', כתובת ה-URL של הכיתוב יכולה להיות 'example.com'. הפרוטוקול (http://‎) הוא אופציונלי, אבל כתובת ה-URL לא יכולה להכיל רווחים או תווים מיוחדים.

התפקיד הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

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

המחרוזת content חייבת להיות בקידוד UTF-8, באורך של 15 תווים לכל היותר.

התפקיד הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

הטקסט שמזהה את המפרסם או את שם המותג.

המחרוזת content חייבת להיות מקודדת ב-UTF-8, והאורך שלה לא יכול להיות יותר מ-25 תווים.

התפקיד הזה נתמך רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

מחיר הרכישה של האפליקציה בחנות Google Play או ב-App Store ל-iOS (לדוגמה, ‎5.99$).

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

המחרוזת content חייבת להיות בקידוד UTF-8, באורך של 15 תווים לכל היותר.

הנכסים של התפקיד הזה הם לקריאה בלבד.
ASSET_ROLE_ANDROID_APP_ID

המזהה של אפליקציה ל-Android בחנות Google Play.

אפשר למצוא את המזהה הזה בכתובת ה-URL של האפליקציה בחנות Google Play אחרי 'id'. לדוגמה, בכתובת https://play.google.com/store/apps/details?id=com.company.appname המזהה הוא com.company.appname.

הנכסים של התפקיד הזה הם לקריאה בלבד.
ASSET_ROLE_IOS_APP_ID

המזהה של אפליקציה ל-iOS בחנות האפליקציות של אפל.

מספר המזהה הזה מופיע בכתובת ה-URL של האפליקציה ב-Apple App Store כמחרוזת המספרים שמופיעה מיד אחרי 'id'. לדוגמה, במזהה https://apps.apple.com/us/app/gmail-email-by-google/id422689480 הוא 422689480.

הנכסים של התפקיד הזה הם לקריאה בלבד.
ASSET_ROLE_RATING

הסיווג של אפליקציה בחנות Google Play או בחנות האפליקציות של iOS.

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

הנכסים של התפקיד הזה הם לקריאה בלבד.
ASSET_ROLE_ICON

הסמל של קריאייטיב.

התפקיד הזה נתמך ונדרש רק ב-creativeType הבאים:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

תמונת השער של קריאייטיב של סרטון מובנה.

התפקיד הזה נתמך ונדרש רק ב-creativeType הבאים:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

הצבע הראשי שבו רוצים להשתמש בקריאייטיב.

התפקיד הזה נתמך ונדרש רק ב-creativeType הבאים:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

הצבע המשני שבו רוצים להשתמש בקריאייטיב.

התפקיד הזה נתמך ונדרש רק ב-creativeType הבאים:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

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

התפקיד הזה נתמך ונדרש רק ב-creativeType הבאים:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

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

התפקיד הזה נתמך ונדרש רק ב-creativeType הבאים:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

אירוע היציאה של הקריאייטיב.

ייצוג ב-JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
שדות
type

enum (ExitEventType)

חובה. סוג אירוע היציאה.
url

string

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

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

אופציונלי. השם של תג הקליק של אירוע היציאה.

השם חייב להיות ייחודי בתוך קריאייטיב אחד.

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

string

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

ExitEventType

סוג אירוע היציאה.

טיפוסים בני מנייה (enum)
EXIT_EVENT_TYPE_UNSPECIFIED סוג אירוע היציאה לא צוין או לא ידוע בגרסה הזו.
EXIT_EVENT_TYPE_DEFAULT אירוע היציאה הוא ברירת המחדל.
EXIT_EVENT_TYPE_BACKUP אירוע היציאה הוא אירוע יציאה לגיבוי. יכולים להיות כמה אירועים של יציאה מגיבוי בקריאייטיב.

TimerEvent

אירוע טיימר של הקריאייטיב.

ייצוג ב-JSON 
{
  "name": string,
  "reportingName": string
}
שדות
name

string

חובה. השם של אירוע הטיימר.
reportingName

string

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

CounterEvent

אירוע נגדי של הקריאייטיב.

ייצוג ב-JSON 
{
  "name": string,
  "reportingName": string
}
שדות
name

string

חובה. שם אירוע המונה.
reportingName

string

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

AudioVideoOffset

האורך של קטע אודיו או סרטון שהופעלו.

ייצוג ב-JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
שדות
שדה איחוד offset. הערך של ההיסט. הערך offset יכול להיות רק אחד מהבאים:
percentage

string (int64 format)

אופציונלי. ההיסט באחוזים ממשך האודיו או הסרטון.
seconds

string (int64 format)

אופציונלי. ההיסט בשניות מתחילת האודיו או הווידאו.

UniversalAdId

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

ייצוג ב-JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
שדות
id

string

אופציונלי. המזהה הייחודי של הקריאייטיב.
registry

enum (UniversalAdRegistry)

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

UniversalAdRegistry

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

טיפוסים בני מנייה (enum)
UNIVERSAL_AD_REGISTRY_UNSPECIFIED מאגר המודעות האוניברסלי לא צוין או לא ידוע בגרסה הזו.
UNIVERSAL_AD_REGISTRY_OTHER אפשר להשתמש בספק בהתאמה אישית כדי לספק את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_AD_ID משתמשים במזהה המודעה כדי לספק את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_CLEARCAST צריך להשתמש ב-clearcast.co.uk כדי לספק את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_DV360 משתמשים ב-Display & Video 360 כדי לספק את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_CM משתמשים ב-Campaign Manager 360 כדי לספק את מזהה המודעה האוניברסלי.

ThirdPartyUrl

מעקב אחרי כתובות URL של צד שלישי כדי לעקוב אחרי אינטראקציות עם קריאייטיב של אודיו או וידאו.

ייצוג ב-JSON 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
שדות
type

enum (ThirdPartyUrlType)

אופציונלי. כתובת ה-URL למעקב צריכה לעקוב אחרי סוג האינטראקציה
url

string

אופציונלי. כתובת ה-URL למעקב שמשמשת למעקב אחר האינטראקציה.

צריך לספק כתובת URL עם נתיב אופציונלי או מחרוזת שאילתה, שמתחילה ב-https:. לדוגמה, https://www.example.com/path.

ThirdPartyUrlType

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

טיפוסים בני מנייה (enum)
THIRD_PARTY_URL_TYPE_UNSPECIFIED סוג כתובת ה-URL של הצד השלישי לא צוין או לא ידוע בגרסה הזו.
THIRD_PARTY_URL_TYPE_IMPRESSION המשתנה הזה משמש לספירת החשיפות של הקריאייטיב אחרי השלמת החיץ (באפרינג) של האודיו או הווידאו.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING המאפיין הזה משמש למעקב אחרי קליקים של משתמשים על האודיו או הווידאו.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START הפרמטר הזה משמש למעקב אחרי מספר הפעמים שמשתמש מתחיל להפעיל את האודיו או הסרטון.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE הנתון הזה משמש למעקב אחרי מספר הפעמים שקובץ האודיו או הסרטון מופעל עד להצגה של 25% ממנו.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT המשתנה הזה משמש למעקב אחרי מספר הפעמים שקובץ האודיו או הסרטון מופעל עד 50% מהאורך שלו.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE הפרמטר הזה משמש למעקב אחרי מספר הפעמים שבהן קובץ האודיו או הסרטון מופעל עד להצגה של 75% ממנו.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE הפרמטר הזה משמש למעקב אחרי מספר הפעמים שבהן קובץ האודיו או הסרטון מושמע עד הסוף.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE המשתנה הזה משמש למעקב אחרי מספר הפעמים שמשתמש השתיק את האודיו או הסרטון.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE הפרמטר הזה משמש למעקב אחרי מספר הפעמים שמשתמש משהה את האודיו או הסרטון.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND הפרמטר הזה משמש למעקב אחרי מספר הפעמים שמשתמש מפעיל מחדש את האודיו או הסרטון.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN משמש למעקב אחרי מספר הפעמים שבהן משתמש מרחיב את הנגן לגודל מסך מלא.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP המשתנה הזה משמש למעקב אחרי מספר הפעמים שמשתמש עוצר את האודיו או הווידאו.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM הקובץ משמש למעקב אחרי מספר הפעמים שמשתמש מבצע קליק בהתאמה אישית, כמו קליק על נקודה פעילה בסרטון.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP המאפיין משמש למעקב אחרי מספר הפעמים שבהן המשתמשים דילגו על האודיו או על הסרטון.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS המאפיין הזה משמש למעקב אחרי מספר הפעמים שבהן האודיו או הווידאו מופעלים עם היסט שנקבע על ידי progressOffset.

המרת קידוד

מייצג מידע על קובץ האודיו או הווידאו שעבר המרה.

ייצוג ב-JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
שדות
name

string

אופציונלי. השם של הקובץ שעבר המרה.
mimeType

string

אופציונלי. סוג ה-MIME של הקובץ שעבר המרה.
transcoded

boolean

אופציונלי. מציין אם הקידוד מחדש בוצע בהצלחה.
dimensions

object (Dimensions)

אופציונלי. המידות של הסרטון שהקידוד שלו הומר.
bitRateKbps

string (int64 format)

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

number

אופציונלי. קצב הפריימים של הסרטון שהקידוד שלו הומר, בפריימים לשנייה.
audioBitRateKbps

string (int64 format)

אופציונלי. קצב הביטים של זרם האודיו של הסרטון שהקידוד שלו הומר, או קצב הביטים של האודיו שהקידוד שלו הומר, בקילוביטים לשנייה.
audioSampleRateHz

string (int64 format)

אופציונלי. תדירות הדגימה של שידור האודיו של הסרטון שהקידוד שלו הומר, או תדירות הדגימה של האודיו שהקידוד שלו הומר, בהרץ.
fileSizeBytes

string (int64 format)

אופציונלי. גודל הקובץ שעבר המרה, בבייטים.

CmTrackingAd

מודעת מעקב ב-Campaign Manager 360.

ייצוג ב-JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
שדות
cmPlacementId

string (int64 format)

אופציונלי. מזהה מיקום המודעה של מודעת המעקב ב-Campaign Manager 360.
cmCreativeId

string (int64 format)

אופציונלי. מזהה הקריאייטיב של מודעת המעקב ב-Campaign Manager 360.
cmAdId

string (int64 format)

אופציונלי. מזהה המודעה של מודעת המעקב ב-Campaign Manager 360.

ObaIcon

סמל OBA לקריאייטיב

ייצוג ב-JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
שדות
resourceUrl

string

אופציונלי. כתובת ה-URL של משאב הסמל של OBA.
resourceMimeType

string

אופציונלי. סוג ה-MIME של משאב הסמל של OBA.
position

enum (ObaIconPosition)

אופציונלי. המיקום של סמל ה-OBA בקריאייטיב.
dimensions

object (Dimensions)

אופציונלי. המידות של סמל ה-OBA.
program

string

אופציונלי. התוכנית של סמל ה-OBA. לדוגמה: AdChoices.
landingPageUrl

string

חובה. כתובת דף הנחיתה של סמל ה-OBA.

מותרות רק כתובות URL של הדומיינים הבאים:

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

חובה. כתובת ה-URL למעקב קליקים אחר סמל ה-OBA.

מותרות רק כתובות URL של הדומיינים הבאים:

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

חובה. כתובת ה-URL למעקב אחר הצגת סמל OBA.

מותרות רק כתובות URL של הדומיינים הבאים:

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

המיקום של סמל ה-OBA בקריאייטיב.

טיפוסים בני מנייה (enum)
OBA_ICON_POSITION_UNSPECIFIED לא צוין מיקום לסמל OBA.
OBA_ICON_POSITION_UPPER_RIGHT בצד שמאל למעלה של הקריאייטיב.
OBA_ICON_POSITION_UPPER_LEFT בצד ימין למעלה של הקריאייטיב.
OBA_ICON_POSITION_LOWER_RIGHT בצד שמאל למטה של הקריאייטיב.
OBA_ICON_POSITION_LOWER_LEFT בצד ימין למטה של הקריאייטיב.

ExpandingDirection

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

טיפוסים בני מנייה (enum)
EXPANDING_DIRECTION_UNSPECIFIED לא צוין כיוון ההרחבה.
EXPANDING_DIRECTION_NONE לא מתרחב לשום כיוון.
EXPANDING_DIRECTION_UP הרחבה למעלה.
EXPANDING_DIRECTION_DOWN הרחבה כלפי מטה.
EXPANDING_DIRECTION_LEFT הרחבה ימינה.
EXPANDING_DIRECTION_RIGHT הרחבה ימינה.
EXPANDING_DIRECTION_UP_AND_LEFT הרחבה למעלה ולצד שמאל.
EXPANDING_DIRECTION_UP_AND_RIGHT מתרחבת למעלה ולצד שמאל.
EXPANDING_DIRECTION_DOWN_AND_LEFT החלון יורחב למטה ולצד שמאל.
EXPANDING_DIRECTION_DOWN_AND_RIGHT ההרחבה היא למטה ולצד שמאל.
EXPANDING_DIRECTION_UP_OR_DOWN הרחבה למעלה או למטה.
EXPANDING_DIRECTION_LEFT_OR_RIGHT הרחבה לצד ימין או לצד שמאל.
EXPANDING_DIRECTION_ANY_DIAGONAL יכולה להתרחב בכל כיוון אלכסוני.

Methods

create

 יצירת קריאייטיב חדש.

delete

 מחיקת קריאייטיב.

get

 מקבל קריאייטיב.

list

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

patch

 עדכון של קריאייטיב קיים.