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

שיטות

get

 אחזור קבוצה ב-Floodlight.

patch

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