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.

Enums
WEB_TAG_TYPE_UNSPECIFIED مقدار نوع در این نسخه مشخص نشده است یا ناشناخته است.
WEB_TAG_TYPE_NONE بدون نوع برچسب
WEB_TAG_TYPE_IMAGE برچسب تصویر.
WEB_TAG_TYPE_DYNAMIC برچسب پویا

پنجره نگاه به عقب

مشخص می‌کند که چند روز از گذشته برای ثبت تبدیل باید بررسی شود.

نمایندگی 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 یا هر دو را مشخص کنید. اگر هر دو مشخص شده باشند، در صورتی که هر یک از الزامات برآورده شود، یک نمایش با معیارهای متریک مطابقت دارد (هر کدام که اول اتفاق بیفتد).

قابلیت مشاهده ویدیو درصد

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

Enums
VIEWABILITY_PERCENT_UNSPECIFIED مقدار در این نسخه مشخص نشده یا ناشناخته است.
VIEWABILITY_PERCENT_0 0% قابل مشاهده
VIEWABILITY_PERCENT_25 25% قابل مشاهده
VIEWABILITY_PERCENT_50 50% قابل مشاهده
VIEWABILITY_PERCENT_75 75% قابل مشاهده
VIEWABILITY_PERCENT_100 100% قابل مشاهده

حجم ویدیو درصد

مقادیر درصد احتمالی حجم پخش یک آگهی ویدیویی.

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