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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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)

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

Universal Ad ID הוא חלק מהסטנדרט 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 למעקב של ספקי ניתוח נתונים או ספקי צד שלישי של טכנולוגיות פרסום.

כתובות ה-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 המקור לאירוח לא צוין או שהוא לא ידוע בגרסת ה-API הזו.
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)

הסטטוסים של בדיקת הקריאייטיב על ידי פלטפורמת ה-Exchange.

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)

פלטפורמת ה-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 התפקיד של הנכס לא צוין או שהוא לא ידוע בגרסת ה-API הזו.
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 בחנות האפליקציות של Apple.

מספר המזהה הזה מופיע בכתובת ה-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.
UNIVERSAL_AD_REGISTRY_OTHER משתמשים בספק מותאם אישית כדי לספק את Universal Ad ID.
UNIVERSAL_AD_REGISTRY_AD_ID משתמשים ב-Ad-ID כדי לספק את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_CLEARCAST צריך להשתמש ב-clearcast.co.uk כדי לספק את Universal Ad ID.
UNIVERSAL_AD_REGISTRY_DV360 משתמשים ב-Display & Video 360 כדי לספק את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_CM משתמשים ב-Campaign Manager 360 כדי לספק את Universal Ad ID.

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

חובה. כתובת ה-URL של דף הנחיתה של סמל ה-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

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