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)

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

ניתן לכתוב בשדה הזה רק ב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

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

המדיניות תקפה רק כשמשתמשים במודעת מעקב של 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 (לדוגמה, 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

חובה. כתובת ה-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

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