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.