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.