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 קיימת.