REST Resource: floodlightGroups

משאב: FloodlightGroup

קבוצת Floodlight אחת.

ייצוג ב-JSON 
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
שדות
name

string

פלט בלבד. שם המשאב של קבוצת Floodlight.
floodlightGroupId

string (int64 format)

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

string

חובה. השם המוצג של קבוצת Floodlight.
webTagType

enum (WebTagType)

חובה. סוג תג האינטרנט שהופעל לקבוצת Floodlight.
lookbackWindow

object (LookbackWindow)

חובה. חלון המבט לאחור של קבוצת Floodlight. נדרשים גם clickDays וגם impressionDays. הערכים הקבילים בשני המקרים הם 0 עד 90, כולל.
customVariables

object (Struct format)

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

אסור להשתמש במשתני Floodlight מותאמים אישית כדי להעביר נתונים שניתן להשתמש בהם או לזהות אותם כפרטים אישיים מזהים (PII).

לדוגמה: customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

הערכים הקבילים למפתחות הם 'U1' עד 'U100', כולל. ערכי המחרוזת צריכים להיות באורך של עד 64 תווים, ולא יכולים לכלול את התווים הבאים: "<>.
activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

ההגדרה של מדד הניראות של סרטונים ב-Active View לקבוצת Floodlight.

WebTagType

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

טיפוסים בני מנייה (enum)
WEB_TAG_TYPE_UNSPECIFIED ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו.
WEB_TAG_TYPE_NONE אין סוג תג.
WEB_TAG_TYPE_IMAGE תג תמונה.
WEB_TAG_TYPE_DYNAMIC תג דינמי.

LookbackWindow

ההגדרה קובעת כמה ימים לחזור אחורה כדי לקבוע אם לתעד המרה.

ייצוג ב-JSON 
{
  "clickDays": integer,
  "impressionDays": integer
}
שדות
clickDays

integer

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

integer

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

ActiveViewVideoViewabilityMetricConfig

הגדרה של מדדי ניראות מותאמים אישית של סרטונים ב-Active View.

ייצוג ב-JSON 
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
שדות
displayName

string

חובה. השם המוצג של המדד המותאם אישית.
minimumViewability

enum (VideoViewabilityPercent)

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

enum (VideoVolumePercent)

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

enum (VideoDurationSeconds)

משך הזמן המינימלי שבו הסרטון צריך להיות גלוי (בשניות) כדי שהחשיפה תתועד.

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

enum (VideoDurationQuartile)

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

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

VideoViewabilityPercent

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

טיפוסים בני מנייה (enum)
VIEWABILITY_PERCENT_UNSPECIFIED הערך לא צוין או שהוא לא ידוע בגרסה הזו.
VIEWABILITY_PERCENT_0 0% ניראות.
VIEWABILITY_PERCENT_25 25% ניתנות לצפייה.
VIEWABILITY_PERCENT_50 50% ניתנות לצפייה.
VIEWABILITY_PERCENT_75 75% ניתנות לצפייה.
VIEWABILITY_PERCENT_100 ניתן לצפייה ב-100%.

VideoVolumePercent

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

טיפוסים בני מנייה (enum)
VIDEO_VOLUME_PERCENT_UNSPECIFIED הערך לא צוין או שהוא לא ידוע בגרסה הזו.
VIDEO_VOLUME_PERCENT_0 עוצמת הקול היא 0%.
VIDEO_VOLUME_PERCENT_10 עוצמת הקול היא 10%.

VideoDurationSeconds

ערכים אפשריים בשניות של משך הזמן שבו מודעת וידאו גלויה.

טיפוסים בני מנייה (enum)
VIDEO_DURATION_UNSPECIFIED הערך לא צוין או שהוא לא ידוע בגרסה הזו.
VIDEO_DURATION_SECONDS_NONE לא הוגדר ערך משך.
VIDEO_DURATION_SECONDS_0 0 שניות.
VIDEO_DURATION_SECONDS_1 שנייה אחת.
VIDEO_DURATION_SECONDS_2 ‫2 שניות.
VIDEO_DURATION_SECONDS_3 ‫3 שניות.
VIDEO_DURATION_SECONDS_4 ‫4 שניות.
VIDEO_DURATION_SECONDS_5 ‫5 שניות.
VIDEO_DURATION_SECONDS_6 6 שניות.
VIDEO_DURATION_SECONDS_7 7 שניות.
VIDEO_DURATION_SECONDS_8 ‫8 שניות.
VIDEO_DURATION_SECONDS_9 9 שניות.
VIDEO_DURATION_SECONDS_10 10 שניות.
VIDEO_DURATION_SECONDS_11 11 שניות.
VIDEO_DURATION_SECONDS_12 12 שניות.
VIDEO_DURATION_SECONDS_13 13 שניות.
VIDEO_DURATION_SECONDS_14 ‫14 שניות.
VIDEO_DURATION_SECONDS_15 15 שניות.
VIDEO_DURATION_SECONDS_30 30 שניות.
VIDEO_DURATION_SECONDS_45 ‫45 שניות.
VIDEO_DURATION_SECONDS_60 ‫60 שניות.

VideoDurationQuartile

ערכים אפשריים של רבעון משך הזמן הגלוי של מודעת וידאו.

טיפוסים בני מנייה (enum)
VIDEO_DURATION_QUARTILE_UNSPECIFIED הערך לא צוין או שהוא לא ידוע בגרסה הזו.
VIDEO_DURATION_QUARTILE_NONE אין ערך רביעון.
VIDEO_DURATION_QUARTILE_FIRST רבעון ראשון.
VIDEO_DURATION_QUARTILE_SECOND רבעון שני (נקודת אמצע).
VIDEO_DURATION_QUARTILE_THIRD רבעון שלישי.
VIDEO_DURATION_QUARTILE_FOURTH רבעון רביעי (השלמה).

Methods

get

 קבלת קבוצת Floodlight.

patch

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