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.

Тип веб-тега

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

Перечисления
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 или и то, и другое. Если указаны оба требования, показ соответствует критериям метрики, если соблюдено любое из требований (в зависимости от того, что произойдет раньше).

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

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

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