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» است. مقادیر رشته باید کمتر از ۶۴ نویسه باشد و نمی‌تواند حاوی نویسه‌های زیر باشد: "<>.
activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

پیکربندی سنجه رؤیت‌پذیری ویدیو Active View برای گروه Floodlight.

WebTagType

انواع ممکن برچسب‌های وب برای گروه Floodlight.

شمارشی‌ها
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

مقادیر درصدی احتمالی پیکسل‌های قابل‌مشاهده آگهی ویدیویی.

شمارشی‌ها
VIEWABILITY_PERCENT_UNSPECIFIED مقدار در این نسخه مشخص نشده یا ناشناخته است.
VIEWABILITY_PERCENT_0 ٪۰ قابل‌مشاهده.
VIEWABILITY_PERCENT_25 ‫٪۲۵ قابل‌مشاهده.
VIEWABILITY_PERCENT_50 ‫٪۵۰ قابل‌مشاهده.
VIEWABILITY_PERCENT_75 ‫۷۵٪ قابل‌مشاهده.
VIEWABILITY_PERCENT_100 ‫٪۱۰۰ قابل‌مشاهده.

VideoVolumePercent

مقادیر درصدی احتمالی برای میزان صدای بازپخش آگهی ویدیویی.

شمارشی‌ها
VIDEO_VOLUME_PERCENT_UNSPECIFIED مقدار در این نسخه مشخص نشده یا ناشناخته است.
VIDEO_VOLUME_PERCENT_0 میزان صدا ۰٪.
VIDEO_VOLUME_PERCENT_10 میزان صدا ۱۰٪.

VideoDurationSeconds

مقادیر ممکن برحسب ثانیه برای مدت‌زمان قابل‌مشاهده آگهی ویدیویی.

شمارشی‌ها
VIDEO_DURATION_UNSPECIFIED مقدار در این نسخه مشخص نشده یا ناشناخته است.
VIDEO_DURATION_SECONDS_NONE مقدار مدت وجود ندارد.
VIDEO_DURATION_SECONDS_0 ۰ ثانیه.
VIDEO_DURATION_SECONDS_1 ۱ ثانیه.
VIDEO_DURATION_SECONDS_2 ‫۲ ثانیه.
VIDEO_DURATION_SECONDS_3 ‫۳ ثانیه.
VIDEO_DURATION_SECONDS_4 ‫۴ ثانیه.
VIDEO_DURATION_SECONDS_5 ‫۵ ثانیه.
VIDEO_DURATION_SECONDS_6 ‫۶ ثانیه.
VIDEO_DURATION_SECONDS_7 ‫۷ ثانیه.
VIDEO_DURATION_SECONDS_8 ‫۸ ثانیه.
VIDEO_DURATION_SECONDS_9 ‫۹ ثانیه.
VIDEO_DURATION_SECONDS_10 ‫۱۰ ثانیه.
VIDEO_DURATION_SECONDS_11 ‫۱۱ ثانیه.
VIDEO_DURATION_SECONDS_12 ‫۱۲ ثانیه.
VIDEO_DURATION_SECONDS_13 ‫۱۳ ثانیه.
VIDEO_DURATION_SECONDS_14 ‫۱۴ ثانیه.
VIDEO_DURATION_SECONDS_15 ‫۱۵ ثانیه.
VIDEO_DURATION_SECONDS_30 ‫۳۰ ثانیه.
VIDEO_DURATION_SECONDS_45 ‫۴۵ ثانیه.
VIDEO_DURATION_SECONDS_60 ‫۶۰ ثانیه.

VideoDurationQuartile

مقادیر چارک احتمالی مدت زمان قابل مشاهده آگهی ویدیویی.

شمارشی‌ها
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 موجود را به‌روز می‌کند.