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.