REST Resource: curators.curatedPackages

משאב: CuratedPackage

מייצג חבילה של מלאי שטחי פרסום שנאסף ומנוהל על ידי אוצר.

ייצוג ב-JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
שדות
name

string

מזהה. שם המשאב הייחודי של החבילה שנבחרה. פורמט: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

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

description

string

אופציונלי. תיאור של החבילה שנאספה, שסופק על ידי האוצר.

createTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של מועד היצירה של חבילת התוכן. אפשר להשתמש בו כדי לסנן את התגובה של השיטה curatedPackages.list.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

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

state

enum (State)

פלט בלבד. המצב של החבילה שנבחרה. אפשר להשתמש בו כדי לסנן את התגובה של השיטה curatedPackages.list.

accessSettings

object (AccessControlSettings)

חובה. הגדרות לשליטה בגישה לחבילה שנבחרה.

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

targeting

object (PackageTargeting)

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

curationFeeVisibility

enum (CurationFeeVisibility)

אופציונלי. לא ניתן לשינוי. החשיפה של העמלה המשולבת על חבילת האוספים ועל פלחי הנתונים (העמלה הכוללת על האוספים).

העמלה ששולמה לאוצר על החבילה הזו. ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
feeCpm

object (Money)

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

millipercentOfMediaFee

string (int64 format)

אופציונלי. העמלה תחויב כאחוז מעלות החשיפה, והיא מיוצגת באלפיות האחוז. לדוגמה, 1% מיוצג כ-1000.

סוף השדות שמוציאים זה את זה.

מדינה (State)

המצב של החבילה שנבחרה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל.
ACTIVE החבילה שנבחרה פעילה.
INACTIVE החבילה שנבחרה לא פעילה.

AccessControlSettings

הגדרות לשליטה בגישה לחבילה שנבחרה.

ייצוג ב-JSON
{
  "allowlistedMediaPlanners": [
    string
  ]
}
שדות
allowlistedMediaPlanners[]

string

חובה. לא ניתן לשינוי. רשימת מתכנני המדיה שקיבלו גישה מפורשת לחבילה שנבחרה. אפשר למצוא את ה-Media Planners שעומדים בדרישות ב-method‏ mediaPlanners.list. בשלב הזה, אפשר להוסיף לרשימת ההיתרים רק Media Planner אחד.

פורמט: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

קריטריונים לטירגוט של חבילות מותאמות אישית וחבילות מכרזים.

ייצוג ב-JSON
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
שדות
includedDeviceTypes[]

enum (DeviceType)

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

includedEnvironment

enum (Environment)

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

includedCreativeFormat

enum (CreativeFormat)

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

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

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

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

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

includedNativeInventoryTypes[]

enum (NativeInventoryType)

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

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

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

includedRestrictedCategories[]

enum (RestrictedCategory)

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

includedRewardedType

enum (RewardedType)

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

videoTargeting

object (PackageVideoTargeting)

אופציונלי. קריטריונים לטירגוט ספציפי של סרטונים.

minimumPredictedViewabilityPercentage

string (int64 format)

אופציונלי. אחוז הניראות המינימלי הצפוי שהוגדר כיעד.

הערך הזה חייב להיות כפולה של 10 בין 10 ל-90 (כולל). לדוגמה, הערך 10 תקין, אבל הערכים 0, 15 ו-100 לא תקינים. ערך של 10 פירושו שההגדרה תתאים רק למיקומי מודעות שבהם אנחנו צופים שיעור ניראות של לפחות 10%.

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

languageTargeting

object (StringTargetingDimension)

אופציונלי. השפות לטירגוט. אם לא תגדירו שפה, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לשפה. רשימת קודי השפות הנתמכים מופיעה בכתובת https://developers.google.com/google-ads/api/data/codes-formats#languages.

includedAdSizes[]

object (AdSize)

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

חבילות של מוצרים נבחרים תומכות בגדלים PIXEL ו-INTERSTITIAL של מודעות.

publisherTargeting

object (StringTargetingDimension)

אופציונלי. בעלי התוכן הדיגיטלי המטורגטים. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לבעל האתר. בעלי האפליקציות מזוהים לפי מזהה בעל האפליקציה שלהם מ-ads.txt או מ-app-ads.txt. פרטים נוספים זמינים בכתובות https://iabtechlab.com/ads-txt/ ו-https://iabtechlab.com/app-ads-txt/.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

אופציונלי. שיעור הקליקים הצפוי המינימלי המטורגט, בטווח הערכים [10, 10000] (0.01% - 10%). הערך 50 מציין שההגדרה תתאים רק למיקומי מודעות שבהם אנחנו צופים שיעור קליקים של לפחות 0.05%.

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

verticalTargeting

object (CriteriaTargeting)

אופציונלי. הענפים שנכללים או מוחרגים, כפי שמוגדר בכתובת https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לענף.

geoTargeting

object (CriteriaTargeting)

אופציונלי. מזהי הקריטריונים הגיאוגרפיים שצריך לכלול או להחריג, כפי שהם מוגדרים בכתובת https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. אם לא מגדירים את המאפיין הזה, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר למיקום הגיאוגרפי.

includedDataSegments[]

string

אופציונלי. פלחי הנתונים הפעילים לטירגוט. אם לא מגדירים את המדיניות, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לפלחי הנתונים. פורמט: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

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

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

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

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 (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
שדות
includedMimeTypes[]

enum (VideoMimeType)

אופציונלי. רשימת סוגי ה-MIME של הסרטונים המטורגטים, באמצעות מחרוזות של סוגי MIME שפורסמו על ידי IANA‏ (https://www.iana.org/assignments/media-types/media-types.xhtml). אם השדה ריק, המערכת תטרגט את מלאי שטחי הפרסום בלי קשר לסוג ה-MIME של הסרטון.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

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

includedPositionTypes[]

enum (PositionType)

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

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

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

plcmtTargeting

object (VideoPlcmtTargeting)

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

includedPlaybackMethods[]

enum (PlaybackMethod)

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

minimumPredictedCompletionRatePercentage

string (int64 format)

אופציונלי. אחוז היעד המינימלי של שיעור ההשלמה החזוי.

הערך הזה חייב להיות כפולה של 10 בין 10 ל-90 (כולל). לדוגמה, הערך 10 תקין, אבל הערכים 0, 15 ו-100 לא תקינים. הערך 10 מציין שההגדרה תתאים רק למיקומי מודעות שבהם אנחנו צופים שיעור השלמה של 10% לפחות.

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

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

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

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": [
    enum (VideoPlcmtType)
  ]
}
שדות
selectionType

enum (SelectionType)

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

videoPlcmtTypes[]

enum (VideoPlcmtType)

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

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

string (int64 format)

חובה. הרוחב המינימלי של נגן הווידאו בפיקסלים.

minimumHeight

string (int64 format)

חובה. הגובה המינימלי של נגן הווידאו בפיקסלים.

StringTargetingDimension

טירגוט כללי עם ערכי מחרוזת.

ייצוג ב-JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
שדות
selectionType

enum (SelectionType)

חובה. איך לטרגט את הפריטים ברשימה הזו.

values[]

string

חובה. הערכים שצוינו.

AdSize

מייצג את הגודל של מיקום מודעה יחיד בדף או של קריאייטיב.

ייצוג ב-JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
שדות
width

string (int64 format)

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

height

string (int64 format)

גובה מיקום המודעה בדף בפיקסלים. השדה הזה יופיע רק כשסוג המידה הוא PIXEL.

type

enum (Type)

הסוג של גודל מיקום המודעה בדף.

סוג

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

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED פלייסהולדר לסוג גודל לא מוגדר.
PIXEL מיקום מודעה בדף עם גודל שצוין לפי גובה ורוחב בפיקסלים.
INTERSTITIAL גודל מיוחד לתיאור מיקום של מודעת מעברון בדף.
NATIVE מודעות מותאמות (לנייד) שמוצגות על ידי בעל התוכן הדיגיטלי.
FLUID גודל גמיש (גודל רספונסיבי) יכול להשתנות באופן אוטומטי בהתאם לשינויים בסביבה החיצונית.

CriteriaTargeting

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

ייצוג ב-JSON
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
שדות
targetedCriteriaIds[]

string (int64 format)

רשימה של מזהים מספריים שצריך לכלול.

excludedCriteriaIds[]

string (int64 format)

רשימה של מזהים מספריים שצריך להחריג.

PackagePlacementTargeting

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

ייצוג ב-JSON
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
שדות
uriTargeting

object (StringTargetingDimension)

אופציונלי. רשימת כתובות ה-URL המטורגטות או המוחרגות. הדומיינים צריכים להיות ללא http/https (לדוגמה, google.com), ויכולים להכיל עד 5 נתיבים לכל כתובת URL.

mobileAppTargeting

object (StringTargetingDimension)

אופציונלי. רשימת מזהי האפליקציות לנייד שהוחרגו או שנוספו לטירגוט, שנמצאות בבעלות של בעלי האפליקציות. בשלב הזה, רק אפליקציות ל-Android ול-Apple נתמכות.

מזהה האפליקציה ל-Android, לדוגמה com.google.android.apps.maps, מופיע בכתובת ה-URL של חנות Google Play. מזהה האפליקציה ל-iOS (שהוא מספר) מופיע בסוף כתובת ה-URL של חנות iTunes. אפליקציות לנייד של צד ראשון נכללות או מוחרגות.

includedMobileAppCategoryTargeting[]

string (int64 format)

אופציונלי. רשימת קטגוריות האפליקציות לנייד שמטורגטות.

PackagePublisherProvidedSignalsTargeting

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

ייצוג ב-JSON
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
שדות
audienceTargeting

object (TaxonomyTargeting)

אופציונלי. רשימת המזהים של הקהלים המטורגטים או המוחרגים. מבוסס על גרסה 1.1 של הטקסונומיה של קהל IAB‏ (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

אופציונלי. רשימת מזהי Content ID מטורגטים או מוחרגים. מבוסס על טקסונומיית התוכן של IAB, גרסה 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

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

TaxonomyTargeting

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

ייצוג ב-JSON
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
שדות
targetedTaxonomyIds[]

string

אופציונלי. רשימת המזהים של טקסונומיית התוכן המטורגט.

excludedTaxonomyIds[]

string

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

CurationFeeVisibility

החשיפה של העמלה המשולבת על חבילת האוספים ועל פלחי הנתונים (העמלה הכוללת על האוספים). יוצר החבילה תמיד יכול לראות את העמלות.

טיפוסים בני מנייה (enum)
CURATION_FEE_VISIBILITY_UNSPECIFIED לא צוין אם עמלת האוצרות הכוללת גלויה.
DISCLOSED כל הקונים יכולים לראות את העמלה הכוללת על האוצרות. זה ערך ברירת המחדל אם לא מגדירים ערך אחר.
NON_DISCLOSED לא כל הקונים יכולים לראות את העמלה הכוללת על בחירת המיקום.

Methods

activate

מפעילה חבילת תוכן קיימת.

create

יוצרת חבילה חדשה של תוכן שנבחר.

deactivate

השבתה של חבילת תוכן קיימת.

get

מקבלת חבילה שנבחרה לפי שם המשאב שלה.

list

הצגת רשימה של חבילות שנאספו על ידי האוצר שצוין.

patch

עדכון של חבילת תוכן קיימת.