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)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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). אם אתם משתמשים בפקודות מאקרו בכתובת האתר, השתמשו רק בפקודות מאקרו שנתמכות על ידי Display & וידאו 360

כתובות URL רגילות בלבד, ללא תגי JPG או 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 (מערכת הגדרות ממשק מודעות מדיה עשירה לנייד).

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

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

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

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

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

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

המספר המזהה הזה מופיע בכתובת ה-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

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 משתמשים במזהה מודעה כדי לציין את מזהה המודעה האוניברסלי.
UNIVERSAL_AD_REGISTRY_CLEARCAST צריך להשתמש ב-clearcast.co.uk כדי לספק את Universal Ad ID.
UNIVERSAL_AD_REGISTRY_DV360 שימוש ברשת המדיה וב- סרטון 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

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

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

string

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

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

string

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

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

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 ניתן להתרחב בכל כיוון אלכסון.

שיטות

create

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

delete

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

get

 יצירת קריאייטיב.

list

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

patch

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