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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

מזהה מודעה אוניברסלי הוא חלק מתקן 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 רגילות בלבד, ללא תגי 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

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

HostingSource

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

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

תכונות אפשריות של קריאייטיב.

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

ReviewStatusInfo

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

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

enum (ApprovalStatus)

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

enum (ReviewStatus)

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

enum (ReviewStatus)

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

object (ExchangeReviewStatus)

החלפת סטטוסים של ביקורות של הקריאייטיב.
publisherReviewStatuses[]

object (PublisherReviewStatus)

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

ApprovalStatus

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

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

ReviewStatus

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

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

סטטוס הבדיקה של ההחלפה.

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

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

טיפוסים בני מנייה (enums)
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 או בחנות האפליקציות ל-iOS (לדוגמה, 25.96 ש"ח).

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

הקוד 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

חובה. כתובת ה-URL לקליק של אירוע היציאה. נדרש כאשר type הוא:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

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

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

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

string

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

ExitEventType

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

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

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

טיפוסים בני מנייה (enums)
UNIVERSAL_AD_REGISTRY_UNSPECIFIED מרשם המודעות האוניברסלי לא צוין או שאינו ידוע בגרסה הזו.
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

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

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

קצב העברת הקידוד של הסרטון שהקידוד שלו הומר, בקילובייט (KB) לשנייה.
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 בקריאייטיב.

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

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

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

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