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.

floodlight Group Id

string ( int64 format)

Только вывод. Уникальный идентификатор группы Floodlight. Назначается системой.

display Name

string

Необходимый. Отображаемое имя группы Floodlight.

web Tag Type

enum ( WebTagType )

Необходимый. Тип веб-тега, включенный для группы Floodlight.

lookback Window

object ( LookbackWindow )

Необходимый. Окно ретроспективного анализа для группы Floodlight. Обязательны как clickDays , так и impressionDays . Допустимые значения для обоих — от 0 до 90 включительно.

custom Variables

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 символов и не могут содержать следующие символы: "<> .

active View Config

object ( ActiveViewVideoViewabilityMetricConfig )

Конфигурация показателя видимости видео Active View для группы Floodlight.

Тип веб-тега

Возможные типы веб-тегов для группы Floodlight.

Перечисления
WEB_TAG_TYPE_UNSPECIFIED Значение типа не указано или неизвестно в этой версии.
WEB_TAG_TYPE_NONE Нет типа тега.
WEB_TAG_TYPE_IMAGE Тег изображения.
WEB_TAG_TYPE_DYNAMIC Динамический тег.

Окно ретроспективного просмотра

Указывает, на сколько дней в прошлое следует обращать внимание при определении необходимости записи конверсии.

JSON-представление 
{
  "clickDays": integer,
  "impressionDays": integer
}
Поля
click Days

integer

Окно ретроспективного анализа в днях с момента последнего нажатия пользователем одного из ваших объявлений.

impression Days

integer

Окно ретроспективного анализа в днях с момента последнего просмотра пользователем одного из ваших объявлений.

ActiveViewVideoViewabilityMetricConfig

Конфигурация пользовательских показателей видимости видео Active View.

JSON-представление 
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Поля
display Name

string

Необходимый. Отображаемое имя специальной метрики.

minimum Viewability

enum ( VideoViewabilityPercent )

Необходимый. Минимальный процент пикселей видеообъявления, видимых на экране, для регистрации показа.

minimum Volume

enum ( VideoVolumePercent )

Необходимый. Минимальный процент объема видеорекламы, необходимый для регистрации показа.

minimum Duration

enum ( VideoDurationSeconds )

Минимальная длительность видимого видео (в секундах), необходимая для регистрации показа.

Вы должны указать minimumDuration , minimumQuartile или и то, и другое. Если указаны оба требования, показ соответствует критериям метрики, если выполняется любое из требований (в зависимости от того, что произойдет раньше).

minimum Quartile

enum ( VideoDurationQuartile )

Минимальная длительность видимого видео, определяемая на основе квартилей видео, для регистрации показа.

Вы должны указать minimumDuration , minimumQuartile или и то, и другое. Если указаны оба требования, показ соответствует критериям метрики, если выполняется любое из требований (в зависимости от того, что произойдет раньше).

Процент видимости видео

Возможные процентные значения видимых пикселей видеорекламы.

Перечисления
VIEWABILITY_PERCENT_UNSPECIFIED В этой версии значение не указано или неизвестно.
VIEWABILITY_PERCENT_0 0% видимых.
VIEWABILITY_PERCENT_25 25% просмотров.
VIEWABILITY_PERCENT_50 50% просмотров.
VIEWABILITY_PERCENT_75 75% просмотров.
VIEWABILITY_PERCENT_100 100% видимость.

ВидеообъемПроцент

Возможные процентные значения громкости воспроизведения видеорекламы.

Перечисления
VIDEO_VOLUME_PERCENT_UNSPECIFIED В этой версии значение не указано или неизвестно.
VIDEO_VOLUME_PERCENT_0 0% объема.
VIDEO_VOLUME_PERCENT_10 10% объема.

ВидеоПродолжительностьСекунды

Возможные значения в секундах видимой продолжительности видеорекламы.

Перечисления
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 секунд.

ВидеоПродолжительностьКвартиль

Возможные квартильные значения видимой продолжительности видеорекламы.

Перечисления
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.