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.

טיפוסים בני מנייה (enums)
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

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

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

VideoVolumePercent

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

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

VideoDurationSeconds

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

טיפוסים בני מנייה (enums)
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

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

טיפוסים בני מנייה (enums)
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.