- משאב: CuratedPackage
- מדינה
- AccessControlSettings
- PackageTargeting
- DeviceType
- סביבה
- CreativeFormat
- AcceleratedMobilePageType
- AuthorizedSellerStatus
- NativeInventoryType
- OpenMeasurementType
- RestrictedCategory
- RewardedType
- PackageVideoTargeting
- VideoMimeType
- MaximumVideoAdDuration
- PositionType
- ContentDeliveryMethod
- VideoPlcmtTargeting
- SelectionType
- VideoPlcmtType
- PlaybackMethod
- VideoPlayerSizeTargeting
- StringTargetingDimension
- AdSize
- סוג
- CriteriaTargeting
- PackagePlacementTargeting
- PackagePublisherProvidedSignalsTargeting
- TaxonomyTargeting
- CurationFeeVisibility
- Methods
משאב: CuratedPackage
מייצג חבילה של מלאי שטחי פרסום שנאסף ומנוהל על ידי אוצר.
| ייצוג ב-JSON |
|---|
{ "name": string, "displayName": string, "description": string, "createTime": string, "updateTime": string, "floorPriceCpm": { object ( |
| שדות | |
|---|---|
name |
מזהה. שם המשאב הייחודי של החבילה שנבחרה. פורמט: |
displayName |
חובה. השם המוצג שהוקצה לחבילת התוכן על ידי האוצר. אפשר להשתמש בו כדי לסנן את התגובה של השיטה |
description |
אופציונלי. תיאור של החבילה שנאספה, שסופק על ידי האוצר. |
createTime |
פלט בלבד. חותמת הזמן של מועד היצירה של חבילת התוכן. אפשר להשתמש בו כדי לסנן את התגובה של השיטה הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
updateTime |
פלט בלבד. חותמת הזמן של העדכון האחרון של החבילה שנבחרה. אפשר להשתמש בו כדי לסנן את התגובה של השיטה הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
floorPriceCpm |
אופציונלי. העלות המינימלית לאלף חשיפות שהקונה צריך להציע כדי להשתתף במכרזים על מלאי שטחי הפרסום בחבילה שנבחרה. אפשר להשתמש בו כדי לסנן את התגובה של השיטה |
state |
פלט בלבד. המצב של החבילה שנבחרה. אפשר להשתמש בו כדי לסנן את התגובה של השיטה |
accessSettings |
חובה. הגדרות לשליטה בגישה לחבילה שנבחרה. הגישה לחבילה הזו מוגבלת ליוצר ולמתכנני המדיה שנכללים ברשימת ההיתרים. לקונים ולמגישי הצעות מחיר אין גישה ישירה למשאב הזה, והם לא יכולים להיכלל ברשימת ההיתרים שלו. |
targeting |
אופציונלי. קריטריונים לטירגוט של חבילת המוצרים שנבחרה. |
curationFeeVisibility |
אופציונלי. לא ניתן לשינוי. החשיפה של העמלה המשולבת על חבילת האוספים ועל פלחי הנתונים (העמלה הכוללת על האוספים). |
| העמלה ששולמה לאוצר על החבילה הזו. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים: | |
feeCpm |
אופציונלי. העמלה לאלף חשיפות שהאוצר גובה מהקונים שמשתמשים בחבילת האוצרות הזו. אפשר להשתמש בו כדי לסנן את התגובה של השיטה |
millipercentOfMediaFee |
אופציונלי. העמלה תחויב כאחוז מעלות החשיפה, והיא מיוצגת באלפיות האחוז. לדוגמה, 1% מיוצג כ-1000. |
| סוף השדות שמוציאים זה את זה. | |
מדינה (State)
המצב של החבילה שנבחרה.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATE_UNSPECIFIED |
ערך ברירת המחדל. |
ACTIVE |
החבילה שנבחרה פעילה. |
INACTIVE |
החבילה שנבחרה לא פעילה. |
AccessControlSettings
הגדרות לשליטה בגישה לחבילה שנבחרה.
| ייצוג ב-JSON |
|---|
{ "allowlistedMediaPlanners": [ string ] } |
| שדות | |
|---|---|
allowlistedMediaPlanners[] |
חובה. לא ניתן לשינוי. רשימת מתכנני המדיה שקיבלו גישה מפורשת לחבילה שנבחרה. אפשר למצוא את ה-Media Planners שעומדים בדרישות ב-method פורמט: |
PackageTargeting
קריטריונים לטירגוט של חבילות מותאמות אישית וחבילות מכרזים.
| ייצוג ב-JSON |
|---|
{ "includedDeviceTypes": [ enum ( |
| שדות | |
|---|---|
includedDeviceTypes[] |
אופציונלי. רשימת סוגי המכשירים שכלולים בטירגוט. אם לא מציינים ערך, הטירגוט יתבצע לכל סוגי המכשירים. |
includedEnvironment |
אופציונלי. הסביבה שרוצים לטרגט. אם לא מציינים סביבה, המערכת מטרגטת את כל הסביבות. |
includedCreativeFormat |
אופציונלי. פורמט הקריאייטיב לטירגוט. אם לא מגדירים את המדיניות, המערכת מטרגטת את כל סוגי תגי העיצוב של הקריאייטיב. |
includedAcceleratedMobilePageType |
אופציונלי. סוג דף ה-AMP המטורגט. אם לא מגדירים את האפשרות הזו, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לסטטוס ה-AMP. |
includedAuthorizedSellerStatuses[] |
אופציונלי. רשימת הסטטוסים של המפיצים המורשים שהוגדרו לטירגוט. אם השדה ריק, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לסטטוס של אתר המכירה. |
includedNativeInventoryTypes[] |
אופציונלי. סוגי המלאי המקוריים המטורגטים. אם השדה ריק, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לסוג מלאי שטחי הפרסום המותאם. |
includedOpenMeasurementTypes[] |
אופציונלי. רשימת סוגי המדידה הפתוחה המטורגטים. אם השדה ריק, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לתמיכה ב-Open Measurement. |
includedRestrictedCategories[] |
אופציונלי. רשימת הקטגוריות המוגבלות המטורגטות. אם לא תבחרו קטגוריות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לקטגוריות מוגבלות. |
includedRewardedType |
אופציונלי. סוג המודעה המתגמלת המטורגטת. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לסוג המודעה המתגמלת. |
videoTargeting |
אופציונלי. קריטריונים לטירגוט ספציפי של סרטונים. |
minimumPredictedViewabilityPercentage |
אופציונלי. אחוז הניראות המינימלי הצפוי שהוגדר כיעד. הערך הזה חייב להיות כפולה של 10 בין 10 ל-90 (כולל). לדוגמה, הערך 10 תקין, אבל הערכים 0, 15 ו-100 לא תקינים. ערך של 10 פירושו שההגדרה תתאים רק למיקומי מודעות שבהם אנחנו צופים שיעור ניראות של לפחות 10%. אם לא מגדירים ערך, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לניראות החזויה. |
languageTargeting |
אופציונלי. השפות לטירגוט. אם לא תגדירו שפה, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לשפה. רשימת קודי השפות הנתמכים מופיעה בכתובת https://developers.google.com/google-ads/api/data/codes-formats#languages. |
includedAdSizes[] |
אופציונלי. רשימת הגדלים של המודעות לטירגוט. אם המדיניות לא מוגדרת, מלאי שטחי הפרסום יטורגט בלי קשר לגודל המודעה. חבילות של מוצרים נבחרים תומכות בגדלים |
publisherTargeting |
אופציונלי. בעלי התוכן הדיגיטלי המטורגטים. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לבעל האתר. בעלי האפליקציות מזוהים לפי מזהה בעל האפליקציה שלהם מ-ads.txt או מ-app-ads.txt. פרטים נוספים זמינים בכתובות https://iabtechlab.com/ads-txt/ ו-https://iabtechlab.com/app-ads-txt/. |
minimumPredictedClickThroughRatePercentageMillis |
אופציונלי. שיעור הקליקים הצפוי המינימלי המטורגט, בטווח הערכים [10, 10000] (0.01% - 10%). הערך 50 מציין שההגדרה תתאים רק למיקומי מודעות שבהם אנחנו צופים שיעור קליקים של לפחות 0.05%. אם לא מגדירים ערך, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לשיעור הקליקים החזוי. |
verticalTargeting |
אופציונלי. הענפים שנכללים או מוחרגים, כפי שמוגדר בכתובת https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לענף. |
geoTargeting |
אופציונלי. מזהי הקריטריונים הגיאוגרפיים שצריך לכלול או להחריג, כפי שהם מוגדרים בכתובת https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. אם לא מגדירים את המאפיין הזה, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר למיקום הגיאוגרפי. |
includedDataSegments[] |
אופציונלי. פלחי הנתונים הפעילים לטירגוט. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לפלחי הנתונים. פורמט: |
placementTargeting |
אופציונלי. מידע על טירגוט לפי מיקום מודעה, למשל כתובת URL, אפליקציות לנייד. |
publisherProvidedSignalsTargeting |
אופציונלי. האותות שבעל התוכן הדיגיטלי סיפק לטירגוט. אם לא מגדירים את המדיניות, המערכת תטרגט מלאי שטחי פרסום בלי קשר לאותות שמספקים בעלי תוכן דיגיטלי. |
DeviceType
הסוג הכללי של המכשיר שאליו רוצים למקד.
| טיפוסים בני מנייה (enum) | |
|---|---|
DEVICE_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
DEVICE_TYPE_PERSONAL_COMPUTER |
מטרגט מחשבים ניידים או נייחים. |
DEVICE_TYPE_CONNECTED_TV |
טירגוט לטלוויזיות מחוברות: מכשירים שמשדרים תוכני טלוויזיה, כולל טלוויזיות חכמות, קונסולות משחקים וסטרימרים. |
DEVICE_TYPE_PHONE |
מטרגט מכשירים ניידים מתקדמים. |
DEVICE_TYPE_TABLET |
מטרגט מכשירי טאבלט. |
סביבה
הסביבה לטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
ENVIRONMENT_SITE |
מטרגט מלאי שטחי פרסום שמוצג באתר עם הכנסות מפרסום. |
ENVIRONMENT_APP |
מטרגט מלאי שטחי פרסום באפליקציה לנייד. |
CreativeFormat
פורמט הקריאייטיב שאפשר לטרגט.
| טיפוסים בני מנייה (enum) | |
|---|---|
CREATIVE_FORMAT_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
CREATIVE_FORMAT_DISPLAY |
מטרגט מיקומי מודעות בדף שמיועדים לנכסי קריאייטיב של מודעות לרשת המדיה ב-HTML. |
CREATIVE_FORMAT_VIDEO |
מטרגט מיקומי מודעות בדף שמיועדים לקריאייטיבים של מודעות וידאו. |
CREATIVE_FORMAT_AUDIO |
מטרגט מיקומי מודעות בדף שמיועדים לקריאייטיבים של אודיו. |
AcceleratedMobilePageType
סוג ההטמעה של Accelerated Mobile Pages (AMP) לטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP |
מטרגט מלאי שטחי פרסום בדפי אינטרנט רגילים שלא משתמשים במסגרת AMP. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP |
מטרגט מלאי שטחי פרסום בדפים שנוצרו באמצעות מסגרת הליבה של AMP ל-HTML. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY |
מטרגט מלאי שטחי פרסום בדפים שמשתמשים בפורמט סטורי ב-AMP (STAMP), שעבר אופטימיזציה לסיפורים חזותיים (למשל, חוויות במסך מלא שניתן ללחוץ עליהן). |
AuthorizedSellerStatus
מייצג את הקשר בין בעל האפליקציה לבין אתר המכירה, כפי שהוצהר בקובץ ads.txt או app-ads.txt.
| טיפוסים בני מנייה (enum) | |
|---|---|
AUTHORIZED_SELLER_STATUS_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
AUTHORIZED_SELLER_STATUS_DIRECT |
מטרגט מלאי שבו בית העסק מוגדר כ-DIRECT. הערך הזה מציין שבעל האתר (בעלי התוכן) שולט באופן ישיר בחשבון בית העסק ושיש לו חוזה עסקי ישיר עם מערכת הפרסום בחשבון הזה. |
AUTHORIZED_SELLER_STATUS_RESELLER |
מטרגט מלאי שטחי פרסום שבו בית העסק מוגדר כ-RESELLER. הערך הזה מציין שבעל האתר נתן לישות אחרת הרשאה להפעיל את חשבון בית העסק שצוין ולהפיץ את השטח שלו להצגת מודעות. |
NativeInventoryType
מייצג את סוג הרינדור של הקריאייטיב שנתמך במיקום מודעה בדף, במיוחד ביחס למודעות מותאמות.
| טיפוסים בני מנייה (enum) | |
|---|---|
NATIVE_INVENTORY_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
NATIVE_INVENTORY_TYPE_NATIVE_ONLY |
מטרגט מיקומי מודעות בדף שמקבלים ומציגים רק מודעות מותאמות. |
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER |
מטרגט מיקומי מודעות בדף שמקבלים ומציגים מודעות מותאמות או מודעות באנר. |
OpenMeasurementType
סוג ה-Open Measurement Interface Definition (OMID) לטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
OPEN_MEASUREMENT_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
OPEN_MEASUREMENT_TYPE_OMID_V1 |
מטרגט מלאי שטחי פרסום שתומך ב-Open Measurement Interface Definition (OMID) בגרסה 1. |
RestrictedCategory
מייצג את הקטגוריות הספציפיות של המודעות שהמדיניות מגבילה את הטרגוט שלהן.
| טיפוסים בני מנייה (enum) | |
|---|---|
RESTRICTED_CATEGORY_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
RESTRICTED_CATEGORY_ALCOHOL |
מטרגט מלאי שטחי פרסום שבעל התוכן הדיגיטלי מאפשר להציג בו מודעות לפרסום משקאות אלכוהוליים. |
RESTRICTED_CATEGORY_GAMBLING |
מטרגט מלאי שטחי פרסום שבו בעל התוכן הדיגיטלי מאפשר להציג מודעות בנושא הימורים. |
RewardedType
הגדרת קריטריונים לטירגוט על סמך השאלה אם מלאי שטחי הפרסום מציע למשתמש תגמול על צפייה במודעה.
| טיפוסים בני מנייה (enum) | |
|---|---|
REWARDED_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
REWARDED_TYPE_NON_REWARDED |
מטרגט מלאי שטחי פרסום שלא מציע למשתמש תגמול מפורש על צפייה במודעה או אינטראקציה איתה. |
REWARDED_TYPE_REWARDED |
מטרגט מלאי שטחי פרסום שמציע תגמול למשתמש בתמורה לצפייה במודעה או לאינטראקציה איתה. |
PackageVideoTargeting
קריטריונים לטירגוט ספציפי של סרטונים.
| ייצוג ב-JSON |
|---|
{ "includedMimeTypes": [ enum ( |
| שדות | |
|---|---|
includedMimeTypes[] |
אופציונלי. רשימת סוגי ה-MIME של הסרטונים המטורגטים, באמצעות מחרוזות של סוגי MIME שפורסמו על ידי IANA (https://www.iana.org/assignments/media-types/media-types.xhtml). אם השדה ריק, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לסוג ה-MIME של הסרטון. |
includedMaximumAdDurationTargeting |
אופציונלי. משך הזמן המקסימלי של מודעת הווידאו המטורגטת. אם לא מגדירים את האפשרות הזו, המערכת תטרגט מלאי שטחי פרסום בלי קשר למשך המקסימלי של מודעות הווידאו. |
includedPositionTypes[] |
אופציונלי. סוגי המיקומים המטורגטים של מודעות הווידאו. אם השדה ריק, המלאי יטורגט בלי קשר לסוג המיקום של מודעת הווידאו. |
includedContentDeliveryMethod |
אופציונלי. שיטת הצגת המודעות המטורגטת בסרטון. אם לא מגדירים את המאפיין הזה, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לשיטת הצגת הסרטונים. |
plcmtTargeting |
אופציונלי. סוגי מיקומי המודעות בסרטונים שמטורגטים. אם המדיניות לא מוגדרת, המלאי יטורגט בלי קשר לסוג מיקום המודעה בסרטון. |
includedPlaybackMethods[] |
אופציונלי. רשימת השיטות המטורגטות להפעלת סרטונים. אם השדה ריק, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לשיטת ההפעלה של הסרטון. |
minimumPredictedCompletionRatePercentage |
אופציונלי. אחוז היעד המינימלי של שיעור ההשלמה החזוי. הערך הזה חייב להיות כפולה של 10 בין 10 ל-90 (כולל). לדוגמה, הערך 10 תקין, אבל הערכים 0, 15 ו-100 לא תקינים. הערך 10 מציין שההגדרה תתאים רק למיקומי מודעות שבהם אנחנו צופים שיעור השלמה של 10% לפחות. אם לא מגדירים ערך, המערכת תטרגט מלאי שטחי פרסום בלי קשר לשיעור ההשלמה החזוי. |
includedPlayerSizeTargeting |
אופציונלי. הגודל המטורגט של נגן הווידאו. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לגודל של נגן הווידאו. |
VideoMimeType
סוגי ה-MIME של הסרטונים לטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
VIDEO_MIME_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
VIDEO_MIME_TYPE_THREEGPP |
פורמט קונטיינר 3GPP שמשמש בטלפונים מדור 3. |
VIDEO_MIME_TYPE_APPLICATION_MPEGURL |
HLS/M3U8 |
VIDEO_MIME_TYPE_MP4 |
קובץ MPEG-4, בדרך כלל עם קודק H.264. |
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH |
DASH. |
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT |
JavaScript (משמש למודעות VPAID). |
VIDEO_MIME_TYPE_WEBM |
מאגר WebM בהנחה שמשתמשים בקודק VP9. |
MaximumVideoAdDuration
הגבול העליון של משך הזמן של נכס הקריאייטיב של מודעת הווידאו לטירגוט. ערכי ה-enum מגדירים קטגוריות, ובחירת ערך פירושה שאורך הקריאייטיב חייב להיות קצר מהזמן שצוין או שווה לו.
| טיפוסים בני מנייה (enum) | |
|---|---|
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS |
ההגדרה הזו רלוונטית למודעות וידאו באורך של עד 15 שניות (0 < אורך <= 15 שניות). |
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS |
ההגדרה הזו רלוונטית למודעות וידאו באורך של עד 20 שניות (0 < משך <= 20 שניות). |
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS |
ההגדרה חלה על מודעות וידאו באורך של עד 30 שניות (0 < אורך <= 30 שניות). |
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS |
ההגדרה הזו רלוונטית למודעות וידאו באורך של עד 60 שניות (0 < אורך <= 60 שניות). |
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS |
ההגדרה חלה על מודעות וידאו באורך של עד 90 שניות (0 < משך זמן <= 90 שניות). |
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS |
ההגדרה חלה על מודעות וידאו באורך של עד 120 שניות (0 < משך זמן <= 120 שניות). |
PositionType
המיקום של המודעה בסרטון שאפשר לטרגט.
| טיפוסים בני מנייה (enum) | |
|---|---|
POSITION_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
POSITION_TYPE_MIDROLL |
המודעה מוצגת באמצע תוכן הווידאו. |
POSITION_TYPE_POSTROLL |
המודעה מופעלת אחרי תוכן הווידאו. |
POSITION_TYPE_PREROLL |
המודעה מוצגת לפני קטע וידאו. |
ContentDeliveryMethod
קריטריונים לטירגוט שמבוססים על שיטת ההצגה של קטע וידאו.
| טיפוסים בני מנייה (enum) | |
|---|---|
CONTENT_DELIVERY_METHOD_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
CONTENT_DELIVERY_METHOD_STREAMING |
מטרגט קטע וידאו שמשודר בשידור חי. |
CONTENT_DELIVERY_METHOD_PROGRESSIVE |
מטרגט קטע וידאו שמועבר באופן הדרגתי לפי דרישות ההפעלה של הלקוח. |
VideoPlcmtTargeting
מגדיר קריטריונים לטירגוט על סמך סוג המיקום של מודעת הווידאו, שלרוב תואם לשדה plcmt של IAB OpenRTB.
| ייצוג ב-JSON |
|---|
{ "selectionType": enum ( |
| שדות | |
|---|---|
selectionType |
חובה. סוג הבחירה של רשימת מיקומי המודעות בסרטונים. |
videoPlcmtTypes[] |
חובה. רשימת סוגי מיקומי המודעות בסרטונים שמטורגטים. אם השדה ריק, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לסוג מיקום המודעה בסרטון. |
SelectionType
טיפוסים בני מנייה (enum) עבור סוגי הבחירה האפשריים שבהם משתמשים מאפייני הטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
SELECTION_TYPE_UNSPECIFIED |
סוג הבחירה לא צוין. אין להשתמש בהם. |
SELECTION_TYPE_INCLUDE |
הערכים במאפיין הטירגוט נכללים. |
SELECTION_TYPE_EXCLUDE |
הערכים במאפיין הטירגוט מוחרגים. |
VideoPlcmtType
מייצג את סוג מיקום המודעה בסרטון, בהתאם לתקנים של OpenRTB.
| טיפוסים בני מנייה (enum) | |
|---|---|
VIDEO_PLCMT_TYPE_UNSPECIFIED |
ערך ברירת המחדל. אין להשתמש בו במפרטי טירגוט. |
INSTREAM |
מודעות לפני הסרטון (pre-roll), מודעות באמצע הסרטון (mid-roll) ומודעות בסוף הסרטון (post-roll) שמופעלות לפני, במהלך או אחרי קטע הווידאו בסטרימינג שהצרכן ביקש. מודעות וידאו In-stream חייבות להיות מוגדרות כ"סאונד מופעל" כברירת מחדל כשהנגן מתחיל לפעול, או שכוונת המשתמש לצפות בקטע וידאו צריכה להיות ברורה ומפורשת. יכול להיות שיהיה תוכן אחר מסביב לנגן, אבל קטע הווידאו צריך להיות מוקד הביקור של המשתמש. הוא צריך להישאר התוכן הראשי בדף ונגן הווידאו היחיד שמוצג ויכול להשמיע אודיו בזמן ההפעלה. אם הנגן הופך לנגן צף או במיקום קבוע, בקשות להצגת מודעות צריכות להעביר במדויק את גודל הנגן המעודכן. |
ACCOMPANYING_CONTENT |
מודעות לפני הסרטון (pre-roll), מודעות באמצע הסרטון (mid-roll) ומודעות בסוף הסרטון (post-roll) שמופעלות לפני, במהלך או אחרי קטע וידאו בסטרימינג. נגן הווידאו נטען ומופעל לפני, בין או אחרי פסקאות של טקסט או תוכן גרפי, ומתחיל לפעול רק כשהוא נכנס לאזור התצוגה. ההפעלה של תוכן נלווה צריכה להתחיל רק אחרי שהוא נכנס לאזור התצוגה. הוא יכול להפוך לנגן צף או לנגן במיקום קבוע שזז בהתאם לגלילה, כשהמשתמש גולל את הדף. |
INTERSTITIAL |
מודעות וידאו שמופעלות בלי קטע וידאו. במהלך ההפעלה, הוא חייב להיות המוקד העיקרי בדף ולתפוס את רוב אזור התצוגה, ואי אפשר לגלול אותו אל מחוץ לתצוגה. המודעות האלה יכולות להופיע במיקומים כמו סרטונים בתוך האפליקציה או מצגות. |
NO_CONTENT |
מודעות וידאו שמופעלות בלי קטע וידאו בסטרימינג. המיקומים האלה יכולים להיות במצגות, בפידים מותאמים, בתוך התוכן או במיקומים צפים או קבועים. |
PlaybackMethod
שיטת ההפעלה לטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
PLAYBACK_METHOD_UNSPECIFIED |
שיטת הפעלת הסרטון לא צוינה. אין להשתמש בהם. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON |
ההפעלה מתחילה באופן אוטומטי כשהדף או התוכן נטענים. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF |
ההפעלה מתחילה באופן אוטומטי כשהדף או התוכן נטענים, אבל בלי סאונד. |
PLAYBACK_METHOD_CLICK_TO_PLAY |
ההפעלה מתחילה בעקבות פעולה של המשתמש (למשל, לחיצה על כפתור הפעלה). |
VideoPlayerSizeTargeting
מייצג את הגודל של נגן הווידאו שאפשר לטרגט. צריך להגדיר ערכים שאינם אפס גם לרוחב וגם לגובה.
| ייצוג ב-JSON |
|---|
{ "minimumWidth": string, "minimumHeight": string } |
| שדות | |
|---|---|
minimumWidth |
חובה. הרוחב המינימלי של נגן הווידאו בפיקסלים. |
minimumHeight |
חובה. הגובה המינימלי של נגן הווידאו בפיקסלים. |
StringTargetingDimension
טירגוט כללי עם ערכי מחרוזת.
| ייצוג ב-JSON |
|---|
{
"selectionType": enum ( |
| שדות | |
|---|---|
selectionType |
חובה. איך לטרגט את הפריטים ברשימה הזו. |
values[] |
חובה. הערכים שצוינו. |
AdSize
מייצג את הגודל של מיקום מודעה יחיד בדף או של קריאייטיב.
| ייצוג ב-JSON |
|---|
{
"width": string,
"height": string,
"type": enum ( |
| שדות | |
|---|---|
width |
רוחב מיקום המודעה בדף בפיקסלים. השדה הזה יופיע רק כשסוג המידה הוא |
height |
גובה מיקום המודעה בדף בפיקסלים. השדה הזה יופיע רק כשסוג המידה הוא |
type |
הסוג של גודל מיקום המודעה בדף. |
סוג
מייצג סוגים שונים של גדלים של מיקומי מודעות בדף או של קריאייטיבים.
| טיפוסים בני מנייה (enum) | |
|---|---|
TYPE_UNSPECIFIED |
פלייסהולדר לסוג גודל לא מוגדר. |
PIXEL |
מיקום מודעה בדף עם גודל שצוין לפי גובה ורוחב בפיקסלים. |
INTERSTITIAL |
גודל מיוחד לתיאור מיקום של מודעת מעברון בדף. |
NATIVE |
מודעות מותאמות (לנייד) שמוצגות על ידי בעל התוכן הדיגיטלי. |
FLUID |
גודל גמיש (גודל רספונסיבי) יכול להשתנות באופן אוטומטי בהתאם לשינויים בסביבה החיצונית. |
CriteriaTargeting
טירגוט כללי משמש לטירגוט מאפיינים שמכילים רשימה של מזהים מספריים שנכללים ומוחרגים. אי אפשר לסנן את זה באמצעות תחביר של סינון רשימה.
| ייצוג ב-JSON |
|---|
{ "targetedCriteriaIds": [ string ], "excludedCriteriaIds": [ string ] } |
| שדות | |
|---|---|
targetedCriteriaIds[] |
רשימה של מזהים מספריים שצריך לכלול. |
excludedCriteriaIds[] |
רשימה של מזהים מספריים שצריך להחריג. |
PackagePlacementTargeting
מייצג טירגוט שקובע איפה המודעות יכולות להופיע, למשל באתרים או באפליקציות מסוימות לנייד. סוגים שונים של טירגוט לפי מיקום מודעה יקושרו באמצעות האופרטור הלוגי OR.
| ייצוג ב-JSON |
|---|
{ "uriTargeting": { object ( |
| שדות | |
|---|---|
uriTargeting |
אופציונלי. רשימת כתובות ה-URL המטורגטות או המוחרגות. הדומיינים צריכים להיות ללא http/https (לדוגמה, google.com), ויכולים להכיל עד 5 נתיבים לכל כתובת URL. |
mobileAppTargeting |
אופציונלי. רשימת מזהי האפליקציות לנייד שהוחרגו או שנוספו לטירגוט, שנמצאות בבעלות של בעלי האפליקציות. בשלב הזה, רק אפליקציות ל-Android ול-Apple נתמכות. מזהה האפליקציה ל-Android, לדוגמה com.google.android.apps.maps, מופיע בכתובת ה-URL של חנות Google Play. מזהה האפליקציה ל-iOS (שהוא מספר) מופיע בסוף כתובת ה-URL של חנות iTunes. אפליקציות לנייד של צד ראשון נכללות או מוחרגות. |
includedMobileAppCategoryTargeting[] |
אופציונלי. רשימת קטגוריות האפליקציות לנייד שמטורגטות. |
PackagePublisherProvidedSignalsTargeting
מייצג טירגוט לגבי אותות שמספקים בעלי תוכן דיגיטלי. סוגים שונים של אותות שמספקים בעלי תוכן דיגיטלי יקושרו באמצעות האופרטור הלוגי OR.
| ייצוג ב-JSON |
|---|
{ "audienceTargeting": { object ( |
| שדות | |
|---|---|
audienceTargeting |
אופציונלי. רשימת המזהים של הקהלים המטורגטים או המוחרגים. מבוסס על גרסה 1.1 של הטקסונומיה של קהל IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv) |
contentTargeting |
אופציונלי. רשימת מזהי Content ID מטורגטים או מוחרגים. מבוסס על טקסונומיית התוכן של IAB, גרסה 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) |
videoAndAudioSignalsTargeting |
אופציונלי. רשימת המזהים של אותות הווידאו והאודיו המטורגטים והמוחרגים. אלה אותות נוספים שנתמכים על ידי אותות שמספקים בעלי תוכן דיגיטלי. |
TaxonomyTargeting
מגדיר קריטריונים לטירגוט כדי לטפל במרחב מזהי הטקסונומיה של הקהל והתוכן של IAB.
| ייצוג ב-JSON |
|---|
{ "targetedTaxonomyIds": [ string ], "excludedTaxonomyIds": [ string ] } |
| שדות | |
|---|---|
targetedTaxonomyIds[] |
אופציונלי. רשימת המזהים של טקסונומיית התוכן המטורגט. |
excludedTaxonomyIds[] |
אופציונלי. רשימת המזהים של טקסונומיות התוכן שהוחרגו. |
CurationFeeVisibility
החשיפה של העמלה המשולבת על חבילת האוספים ועל פלחי הנתונים (העמלה הכוללת על האוספים). יוצר החבילה תמיד יכול לראות את העמלות.
| טיפוסים בני מנייה (enum) | |
|---|---|
CURATION_FEE_VISIBILITY_UNSPECIFIED |
לא צוין אם עמלת האוצרות הכוללת גלויה. |
DISCLOSED |
כל הקונים יכולים לראות את העמלה הכוללת על האוצרות. זה ערך ברירת המחדל אם לא מגדירים ערך אחר. |
NON_DISCLOSED |
לא כל הקונים יכולים לראות את העמלה הכוללת על בחירת המיקום. |
Methods |
|
|---|---|
|
מפעילה חבילת תוכן קיימת. |
|
יוצרת חבילה חדשה של תוכן שנבחר. |
|
השבתה של חבילת תוכן קיימת. |
|
מקבלת חבילה שנבחרה לפי שם המשאב שלה. |
|
הצגת רשימה של חבילות שנאספו על ידי האוצר שצוין. |
|
עדכון של חבילת תוכן קיימת. |