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,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
שדות
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)

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

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

כתובות ה-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 וגם בשרת להצגת מודעות על ידי צד שלישי (3PAS):

  • 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 (מערכת Mobile Rich Media Ad Interface Definitions).

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

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

קריאייטיבים של תגים של צד שלישי הם קריאייטיבים עם 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

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

הערך הזה תקף רק כשמשתמשים במודעת מעקב של 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
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

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

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)
    }
  ]
}
שדות
approvalStatus

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

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

object (ExchangeReviewStatus)

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

סטטוס אישור

סוגים אפשריים של סטטוס אישור. זהו סיכום של 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

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

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

enum (Exchange)

בורסת המודעות שבודקת את הקריאייטיב.
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 ב-App Store של אפל.

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

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

הדירוג של אפליקציה בחנות Google Play או ב-App Store של 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

אופציונלי. השם של ה-click tag של אירוע היציאה.

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

אם הקריאייטיב מכיל רק נכסי תמונות, אפשר להשאיר את השדה הזה ריק או לא מוגדר.
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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "percentage": string,
  "seconds": string
  // End of mutually exclusive fields.
}
שדות
ערך ההסטה. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
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 לא צוין או לא ידוע בגרסה הזו.
UNIVERSAL_AD_REGISTRY_OTHER משתמשים בספק מותאם אישית כדי לספק את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_AD_ID משתמשים ב-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

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

טיפוסים בני מנייה (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

אופציונלי. קצב הפריימים של הסרטון שהקידוד שלו הומר, ב-FPS.
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

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