REST Resource: advertisers.creatives

Ресурс: Креативный

Один креативный человек.

JSON-представление 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean,
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
Поля
name

string

Только для вывода. Название ресурса креатива.

advertiserId

string ( int64 format)

Только для вывода. Уникальный идентификатор рекламодателя, которому принадлежит рекламный материал.

creativeId

string ( int64 format)

Только для вывода. Уникальный идентификатор креатива. Присваивается системой.

cmPlacementId

string ( int64 format)

Только для вывода. Уникальный идентификатор размещения Campaign Manager 360, связанного с креативом. Это поле применимо только для креативов, синхронизированных из Campaign Manager.

displayName

string

Обязательно. Отображаемое название рекламного объявления.

Должен быть закодирован в UTF-8, максимальный размер — 240 байт.

entityStatus

enum ( EntityStatus )

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

Допустимые значения:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string ( Timestamp format)

Только для вывода. Отметка времени последнего обновления креатива, выполненного пользователем или системой (например, в ходе проверки креатива). Присваивается системой.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

createTime

string ( Timestamp format)

Только для вывода. Отметка времени создания креатива. Присваивается системой.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

creativeType

enum ( CreativeType )

Обязательный. Неизменяемый. Тип творческого объекта.

hostingSource

enum ( HostingSource )

Обязательно. Указывает, где размещено рекламное объявление.

dynamic

boolean

Только для вывода. Указывает, является ли креатив динамическим.

dimensions

object ( Dimensions )

Обязательно. Основные размеры креатива. Применимо ко всем типам креативов. Значения widthPixels и heightPixels по умолчанию равны 0 если creativeType имеет одно из следующих значений:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object ( Dimensions )

Необязательно. Дополнительные параметры. Применяется, если creativeType имеет одно из следующих значений:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Если это поле указано, поля widthPixels и heightPixels являются обязательными и должны быть больше или равны 0.

mediaDuration

string ( Duration format)

Только для вывода. Длительность показа рекламного ролика. Применимо, если creativeType имеет одно из следующих значений:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Длительность в секундах, содержащая до девяти знаков после запятой, заканчивающаяся на « s ». Пример: "3.5s" .

creativeAttributes[]

enum ( CreativeAttribute )

Только выходные данные. Список атрибутов креатива, сгенерированного системой.

reviewStatus

object ( ReviewStatusInfo )

Только выходные данные. Текущее состояние процесса проверки креативного материала.

assets[]

object ( AssetAssociation )

Обязательно. Материалы, связанные с этим креативом.

exitEvents[]

object ( ExitEvent )

Обязательно. События выхода для этого креатива. Выход (также известный как тег клика) — это любая область в вашем креативе, на которую пользователь может нажать или коснуться, чтобы открыть целевую страницу рекламодателя. Каждый креатив должен включать как минимум один выход. Вы можете добавить выход в свой креатив любым из следующих способов:

  • Воспользуйтесь областью ввода в Google Веб-дизайне.
  • Определите переменную JavaScript с именем "clickTag".
  • Используйте Enabler (Enabler.exit()) для отслеживания выходов в мультимедийных форматах.
timerEvents[]

object ( TimerEvent )

Необязательно. Пользовательские события таймера для мультимедийного креатива. Таймеры отслеживают время, в течение которого пользователь просматривает и взаимодействует с указанной частью мультимедийного креатива. Креатив может иметь несколько событий таймера, каждое из которых отсчитывается независимо. Оставьте это поле пустым или незаданным для креативов, содержащих только графические ресурсы.

counterEvents[]

object ( CounterEvent )

Необязательно. Счетчик событий для мультимедийного креатива. Счетчики отслеживают количество взаимодействий пользователя с любой частью мультимедийного креатива определенным образом (наведение курсора, отведение курсора, щелчки, касания, загрузка данных, ввод с клавиатуры и т. д.). Любое событие, которое может быть зафиксировано в креативе, может быть записано в качестве счетчика. Оставьте это поле пустым или незаданным для креативов, содержащих только графические ресурсы.

appendedTag

string

Необязательно. К тегу креатива будет добавлен сторонний HTML-тег отслеживания.

integrationCode

string

Необязательно. Идентификационная информация, используемая для связи данного рекламного материала с внешней системой. Должна быть закодирована в UTF-8 и иметь длину не более 10 000 символов.

notes

string

Необязательно. Примечания пользователя к этому креативу. Должен быть закодирован в UTF-8 и иметь длину не более 20 000 символов.

iasCampaignMonitoring

boolean

Необязательный параметр. Указывает, включен ли мониторинг кампаний Integral Ad Science (IAS). Чтобы включить его для креатива, убедитесь, что в параметре Advertiser.creative_config.ias_client_id указано ваше имя клиента IAS.

companionCreativeIds[]

string ( int64 format)

Необязательно. Идентификаторы сопутствующих элементов для видеоролика.

Вы можете назначить существующие рекламные материалы (с изображениями или HTML5-ресурсами) для показа вокруг видеоплеера издателя. Сопутствующие элементы отображаются вокруг видеоплеера во время воспроизведения видео и остаются на месте после его завершения.

Креативы, обладающие additional dimensions не могут быть сопутствующими креативами.

Это поле поддерживается только для следующих creativeType :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Необязательно. Позволяет пользователю пропустить рекламный ролик.

Это поле поддерживается только для следующих creativeType :

  • CREATIVE_TYPE_VIDEO
skipOffset

object ( AudioVideoOffset )

Необязательно. Время воспроизведения видео до появления кнопки «Пропустить».

Это поле обязательно для заполнения, если skippable равно true.

Это поле поддерживается только для следующих creativeType :

  • CREATIVE_TYPE_VIDEO
progressOffset

object ( AudioVideoOffset )

Необязательно. Время воспроизведения видео до того, как оно начнет засчитываться как просмотр.

Это поле обязательно для заполнения, если skippable равно true.

Это поле поддерживается только для следующих creativeType :

  • CREATIVE_TYPE_VIDEO
universalAdId

object ( UniversalAdId )

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

Универсальный идентификатор объявления (Universal Ad ID) является частью стандарта VAST 4.0. Его можно изменить после создания креатива.

Это поле поддерживается только для следующих creativeType :

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object ( ThirdPartyUrl )

Необязательно. Отслеживание URL-адресов от сторонних сервисов для отслеживания взаимодействий с видеороликом.

Это поле поддерживается только для следующих creativeType :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object ( Transcode )

Только вывод. Транскодирование аудио/видео.

Display & Video 360 преобразует основной ресурс в ряд альтернативных версий, использующих различные форматы файлов или имеющих разные свойства (разрешение, битрейт звука и битрейт видео), каждая из которых предназначена для конкретных видеоплееров или полос пропускания.

Эти функции перекодирования предоставляют системе издателя больше возможностей для выбора при каждом показе вашего видео и гарантируют, что соответствующий файл будет показан в зависимости от скорости соединения и размера экрана зрителя.

Это поле поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Необязательно. URL-адреса отслеживания для поставщиков аналитических услуг или сторонних поставщиков рекламных технологий.

URL-адреса должны начинаться с https: (за исключением инвентаря, для которого не требуется SSL-соединение). Если вы используете макросы в URL-адресе, используйте только макросы, поддерживаемые Display & Video 360.

Только стандартные URL-адреса, без тегов IMG или SCRIPT.

В это поле можно записывать данные только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Необязательно. URL-адрес для измерения с помощью JavaScript от поддерживаемых сторонних поставщиков услуг проверки (ComScore, DoubleVerify, IAS, Moat). HTML-теги <script> не поддерживаются.

В это поле можно записывать данные только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object ( CmTrackingAd )

Необязательно. Объявление для отслеживания Campaign Manager 360, связанное с креативом.

Необязательно для следующего creativeType при создании рекламодателем, использующим как Campaign Manager 360, так и сторонние сервисы показа рекламы:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Вывод только в остальных случаях.

obaIcon

object ( ObaIcon )

Необязательно. Задает значок OBA для рекламного ролика.

Это поле поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

Необязательно. Оригинальный сторонний тег, использованный для оформления.

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

Креативы, созданные сторонними тегами, — это креативы, использующие следующий hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Необязательно. Указывает на то, что для данного рекламного материала требуется MRAID (система определения интерфейса мультимедийной рекламы для мобильных устройств).

Установите этот параметр, если в интерактивности рекламного материала используются жесты мобильных устройств, такие как свайп или касание.

Необязательно и действительно только для креативов с тегами от сторонних разработчиков.

Креативы, созданные сторонними тегами, — это креативы, использующие следующий hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Необязательно. Указывает на то, что для корректного отображения рекламного материала используется HTML5.

Необязательно и действительно только для креативов с тегами сторонних разработчиков. Креативы с тегами сторонних разработчиков — это креативы, использующие следующие hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

Необязательно. Указывает, что для указания авторства рекламный материал будет ожидать ответа.

Действительно только при использовании рекламного объявления с отслеживанием в Campaign Manager 360, содержащего параметр стороннего рекламного сервера и макрос ${DC_DBM_TOKEN}.

Необязательно и действительно только для креативов с тегами сторонних разработчиков или креативов с тегами VAST сторонних разработчиков.

Креативы, созданные сторонними тегами, — это креативы, использующие следующий hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Креативы, созданные сторонними разработчиками с использованием VAST-тегов, имеют следующий hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum ( ExpandingDirection )

Необязательно. Указывает направление развития креативной концепции.

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

Расширяемые сторонние рекламные материалы — это материалы, размещенные на следующих хостинговых ресурсах:

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

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

Необязательно и применимо только для расширяемых креативов сторонних разработчиков. Расширяемые креативы сторонних разработчиков — это креативы, размещенные на следующих хостинговых ресурсах:

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Необязательно. URL-адрес VAST-тега для креатива VAST-тега стороннего разработчика.

Обязательный параметр, действительный только для креативов с VAST-тегами от сторонних разработчиков.

Креативы, созданные сторонними разработчиками с использованием VAST-тегов, имеют следующий hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Только для вывода. Указывает, что для использования стороннего рекламного тега VAST требуется VPAID (интерфейс цифрового видеоплеера и рекламы).

Только для вывода и только для креативов с VAST-тегами от сторонних разработчиков.

Креативы, созданные сторонними разработчиками с использованием VAST-тегов, имеют следующий hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Только для вывода. Указывает, что для использования стороннего тега VAST требуется поддержка HTML5-видео.

Только для вывода и только для креативов с VAST-тегами от сторонних разработчиков.

Креативы, созданные сторонними разработчиками с использованием VAST-тегов, имеют следующий hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string ( int64 format)

Только для вывода. Идентификаторы позиций, с которыми связан данный креатив.

Чтобы связать креатив с позицией товара, используйте LineItem.creative_ids .

mp3Audio

boolean

Только вывод. Указывает на то, что сторонний аудиоредактор поддерживает формат MP3.

Только для вывода и только для сторонних создателей аудиоконтента.

Сторонние создатели аудиоконтента — это создатели контента, использующие следующие hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Только вывод. Указывает на то, что сторонний аудиоинтерфейс Creative поддерживает формат OGG.

Только для вывода и только для сторонних создателей аудиоконтента.

Сторонние создатели аудиоконтента — это создатели контента, использующие следующие hostingSource :

  • HOSTING_SOURCE_THIRD_PARTY

в сочетании со следующим creativeType :

  • CREATIVE_TYPE_AUDIO
syntheticContentAttestationStatus

enum ( SyntheticContentAttestationStatus )

Необязательно. Добавлять ли метку к созданному или отредактированному с помощью ИИ изображению при показе в регионах с местными правилами маркировки с использованием ИИ.

HostingSource

Возможные источники размещения рекламного материала. Указывает, где создан и размещен рекламный материал.

Перечисления
HOSTING_SOURCE_UNSPECIFIED В данной версии источник хостинга не указан или неизвестен.
HOSTING_SOURCE_CM

Креативный контент, синхронизированный из Campaign Manager 360.

Методы создания и обновления не поддерживаются для данного типа хостинга.

HOSTING_SOURCE_THIRD_PARTY

Рекламный ролик размещен на стороннем рекламном сервере (3PAS).

Для данного типа хостинга поддерживаются методы создания и обновления, если creativeType соответствует одному из следующих значений:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Креативный контент, созданный в DV360 и размещенный на платформе Campaign Manager 360.

Для данного типа хостинга поддерживаются методы создания и обновления, если creativeType соответствует одному из следующих значений:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

Мультимедийный креатив, созданный в Studio и размещенный на платформе Campaign Manager 360.

Методы создания и обновления не поддерживаются для данного типа хостинга.

CreativeAttribute

Возможные качества творческого человека.

Перечисления
CREATIVE_ATTRIBUTE_UNSPECIFIED В данной версии атрибут "творческий" не указан или неизвестен.
CREATIVE_ATTRIBUTE_VAST Творческий процесс — это ОГРОМНЫЙ творческий процесс.
CREATIVE_ATTRIBUTE_VPAID_LINEAR Это линейный рекламный креатив с оплатой по факту использования (VPAID).
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR Данный креатив представляет собой нелинейный VPAID-креатив.

ReviewStatusInfo

Просмотрите статусы выполнения креативного проекта.

JSON-представление 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
Поля
approvalStatus

enum ( ApprovalStatus )

Представляет собой базовое подтверждение, необходимое для начала показа рекламного материала. Сводка значений creativeAndLandingPageReviewStatus и contentAndPolicyReviewStatus .

creativeAndLandingPageReviewStatus

enum ( ReviewStatus )

Статус проверки креатива и целевой страницы.

contentAndPolicyReviewStatus

enum ( ReviewStatus )

Статус проверки содержания и политики для данного творческого проекта.

exchangeReviewStatuses[]

object ( ExchangeReviewStatus )

Обмен статусами проверки креатива.

Статус одобрения

Возможные типы статуса утверждения. Это сводка статусов creativeAndLandingPageReviewStatus и contentAndPolicyReviewStatus .

Перечисления
APPROVAL_STATUS_UNSPECIFIED В данной версии тип значения не указан или неизвестен.
APPROVAL_STATUS_PENDING_NOT_SERVABLE Креативный проект все еще находится на стадии рассмотрения и не готов к реализации.
APPROVAL_STATUS_PENDING_SERVABLE Рекламный материал прошел проверку на соответствие требованиям к креативу и целевой странице и готов к показу, но ожидает дополнительной проверки контента и политики.
APPROVAL_STATUS_APPROVED_SERVABLE Проверка креатива и целевой страницы, а также контента и политики одобрена. Креативный контент пригоден для показа.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE В рекламном материале есть проблема, которую необходимо исправить, прежде чем его можно будет использовать.

Статус отзыва

Возможные типы статуса проверки.

Перечисления
REVIEW_STATUS_UNSPECIFIED В данной версии тип значения не указан или неизвестен.
REVIEW_STATUS_APPROVED Рекламный текст одобрен.
REVIEW_STATUS_REJECTED Креативный проект отклонен.
REVIEW_STATUS_PENDING Креативный проект находится на стадии проверки.

ExchangeReviewStatus

Статус проверки креатива в рамках обмена информацией.

JSON-представление 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
Поля
exchange

enum ( Exchange )

Обмен мнениями по поводу креативной идеи.

status

enum ( ReviewStatus )

Статус проверки биржи.

Ассоциация активов

Объединение активов для творческих людей.

JSON-представление 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Поля
asset

object ( Asset )

Необязательно. Соответствующий актив.

role

enum ( AssetRole )

Необязательно. Роль этого ресурса в творческом процессе.

Объект

Один актив.

JSON-представление 
{
  "mediaId": string,
  "content": string
}
Поля
mediaId

string ( int64 format)

Идентификатор медиафайла загруженного ресурса. Это уникальный идентификатор ресурса. Этот идентификатор можно передавать в другие вызовы API, например, creatives.create , чтобы связать ресурс с креативом.

Пространство идентификаторов медиафайлов обновлено 5 апреля 2023 года . Чтобы обновить идентификаторы медиафайлов, кэшированные до 5 апреля 2023 года, получите новый идентификатор медиафайла из связанных творческих ресурсов или повторно загрузите ресурс.

content

string

Содержимое ресурса. Для загруженных ресурсов содержимое представляет собой путь к файлу.

AssetRole

Роль этого ресурса в творческом процессе.

Перечисления
ASSET_ROLE_UNSPECIFIED В данной версии роль актива не указана или неизвестна.
ASSET_ROLE_MAIN Главный актив творческого процесса — это его ценность.
ASSET_ROLE_BACKUP Данный ресурс является резервной копией оригинального изображения.
ASSET_ROLE_POLITE_LOAD Данный ресурс является ресурсом для корректной загрузки в рамках креативного оформления.
ASSET_ROLE_HEADLINE

Заголовок, созданный с использованием нативных креативных материалов.

content должно быть закодировано в UTF-8 и иметь длину не более 25 символов.

Данная роль поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

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

content должно быть закодировано в UTF-8 и иметь длину не более 50 символов.

Данная роль поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Основной текст креативного текста, созданного на родном языке.

content должно быть закодировано в UTF-8 и иметь длину не более 90 символов.

Данная роль поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Длинный основной текст креативного материала, созданного носителем языка.

content должно быть закодировано в UTF-8 и иметь длину не более 150 символов.

Данная роль поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Краткая, понятная версия URL целевой страницы для отображения в рекламном материале. Этот URL дает пользователям представление о том, куда они попадут после перехода по ссылке на рекламный материал.

content должно быть закодировано в UTF-8 и иметь длину не более 30 символов.

Например, если URL целевой страницы — 'http://www.example.com/page', то URL заголовка может быть 'example.com'. Протокол (http://) необязателен, но URL не может содержать пробелов или специальных символов.

Данная роль поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Текст, используемый для кнопки призыва к действию в нативном креативе.

content должно быть закодировано в UTF-8 и иметь длину не более 15 символов.

Данная роль поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Текст, идентифицирующий рекламодателя или торговую марку.

content должно быть закодировано в UTF-8 и иметь длину не более 25 символов.

Данная роль поддерживается только в следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Цена покупки вашего приложения в магазине Google Play или магазине приложений iOS (например, 5,99 долларов США).

Обратите внимание, что это значение не синхронизируется автоматически с фактическим значением, указанным в магазине. Оно всегда будет тем, которое будет предоставлено при сохранении креатива.

content должно быть закодировано в UTF-8 и иметь длину не более 15 символов.

Ресурсы, относящиеся к этой роли, доступны только для чтения.

ASSET_ROLE_ANDROID_APP_ID

Идентификатор приложения Android в магазине Google Play.

Этот идентификатор можно найти в URL-адресе приложения в Google Play Store после слова «id». Например, в https://play.google.com/store/apps/details?id=com.company.appname идентификатор — com.company.appname.

Ресурсы, относящиеся к этой роли, доступны только для чтения.

ASSET_ROLE_IOS_APP_ID

Идентификатор iOS-приложения в магазине приложений Apple.

Этот идентификационный номер можно найти в URL-адресе Apple App Store в виде строки цифр, следующей непосредственно за "id". Например, в https://apps.apple.com/us/app/gmail-email-by-google/id422689480 идентификатор равен 422689480.

Ресурсы, относящиеся к этой роли, доступны только для чтения.

ASSET_ROLE_RATING

Рейтинг приложения в магазине Google Play или магазине приложений iOS.

Обратите внимание, что это значение не синхронизируется автоматически с фактическим рейтингом в магазине. Оно всегда будет соответствовать значению, указанному при сохранении креатива.

Ресурсы, относящиеся к этой роли, доступны только для чтения.

ASSET_ROLE_ICON

Икона творческого человека.

Данная роль поддерживается и требуется только для следующих creativeType :

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Изображение обложки рекламного видеоролика.

Данная роль поддерживается и требуется только для следующих creativeType :

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

Основной цвет, который следует использовать в креативных проектах.

Данная роль поддерживается и требуется только для следующих creativeType :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

Акцентный цвет, который следует использовать в креативном проекте.

Данная роль поддерживается и требуется только для следующих creativeType :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

Необходимо ли в рекламном материале использовать графическое изображение?

Данная роль поддерживается и требуется только для следующих creativeType :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

Можно ли применять улучшения ресурсов к творческому процессу?

Данная роль поддерживается и требуется только для следующих creativeType :

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

Завершающее событие творческого процесса.

JSON-представление 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Поля
type

enum ( ExitEventType )

Обязательно. Тип события завершения.

url

string

Обязательно. URL-адрес события выхода. Это обязательно, если type :

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Необязательно. Название тега клика для события выхода.

Название должно быть уникальным в рамках одного креативного проекта.

Оставьте это поле пустым или незаполненным, если в креативах используются только графические ресурсы.

reportingName

string

Необязательно. Название, используемое для идентификации этого события в отчетах. Оставьте это поле пустым или незаданным, если отчет содержит только графические материалы.

ExitEventType

Тип события завершения.

Перечисления
EXIT_EVENT_TYPE_UNSPECIFIED В данной версии тип события завершения не указан или неизвестен.
EXIT_EVENT_TYPE_DEFAULT Событие выхода — это событие по умолчанию.
EXIT_EVENT_TYPE_BACKUP Событие выхода является резервным событием выхода. В креативе может быть несколько резервных событий выхода.

TimerEvent

Таймер события в процессе создания контента.

JSON-представление 
{
  "name": string,
  "reportingName": string
}
Поля
name

string

Обязательно. Название события таймера.

reportingName

string

Обязательно. Имя, используемое для идентификации этого события таймера в отчетах.

Контрсобытие

Контрмероприятие творчества.

JSON-представление 
{
  "name": string,
  "reportingName": string
}
Поля
name

string

Обязательно. Название события счетчика.

reportingName

string

Обязательно. Название, используемое для идентификации этого события счетчика в отчетах.

Смещение аудио-видео

Длительность воспроизведения аудио- или видеофайла.

JSON-представление 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
Поля
offset поля объединения. Значение смещения. offset может принимать только одно из следующих значений:
percentage

string ( int64 format)

Необязательно. Смещение в процентах от длительности аудио- или видеозаписи.

seconds

string ( int64 format)

Необязательно. Смещение в секундах от начала аудио- или видеозаписи.

UniversalAdId

Уникальный идентификатор, предоставляемый реестром и присутствующий на всех платформах. Это часть стандарта VAST 4.0.

JSON-представление 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
Поля
id

string

Необязательно. Уникальный идентификатор креатива.

registry

enum ( UniversalAdRegistry )

Необязательно. Реестр предоставляет уникальные идентификаторы для креативных проектов.

UniversalAdRegistry

Реестр предоставляет уникальные идентификаторы креативов в рамках универсального рекламного идентификатора (Universal Ad ID).

Перечисления
UNIVERSAL_AD_REGISTRY_UNSPECIFIED В данной версии реестр универсальной рекламы не указан или неизвестен.
UNIVERSAL_AD_REGISTRY_OTHER Используйте собственный поставщик услуг для указания универсального идентификатора объявления.
UNIVERSAL_AD_REGISTRY_AD_ID Используйте Ad-ID для указания универсального идентификатора объявления.
UNIVERSAL_AD_REGISTRY_CLEARCAST Используйте clearcast.co.uk для указания универсального идентификатора объявления.
UNIVERSAL_AD_REGISTRY_DV360 Используйте Display & Video 360 для указания универсального идентификатора объявления.
UNIVERSAL_AD_REGISTRY_CM Используйте Campaign Manager 360 для указания универсального идентификатора объявления.

ThirdPartyUrl

Отслеживание URL-адресов от третьих лиц для отслеживания взаимодействий с аудио- или видеоконтентом.

JSON-представление 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Поля
type

enum ( ThirdPartyUrlType )

Необязательно. Тип взаимодействия необходимо отслеживать с помощью URL-адреса отслеживания.

url

string

Необязательно. URL-адрес отслеживания, используемый для отслеживания взаимодействия.

Укажите URL-адрес с необязательным путем или строкой запроса, начинающейся с https: . Например, https://www.example.com/path

ThirdPartyUrlType

Тип взаимодействия необходимо отслеживать с помощью URL-адреса отслеживания стороннего сервиса.

Перечисления
THIRD_PARTY_URL_TYPE_UNSPECIFIED В данной версии тип стороннего URL-адреса не указан или неизвестен.
THIRD_PARTY_URL_TYPE_IMPRESSION Используется для подсчета показов рекламного ролика после завершения буферизации аудио или видео.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Используется для отслеживания кликов пользователя по аудио- или видеофайлам.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Используется для отслеживания количества запусков аудио- или видеофайлов пользователем.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Используется для отслеживания количества воспроизведений аудио- или видеоматериала на протяжении 25% его продолжительности.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Используется для отслеживания количества воспроизведений аудио- или видеоматериала до достижения 50% его продолжительности.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Используется для отслеживания количества воспроизведений аудио- или видеоматериала до достижения 75% его продолжительности.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Используется для отслеживания количества воспроизведений аудио- или видеоматериала до конца.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Используется для отслеживания количества раз, когда пользователь отключает звук или видео.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Используется для отслеживания количества раз, когда пользователь ставит аудио или видео на паузу.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Используется для отслеживания количества повторных воспроизведений аудио- или видеофайлов пользователем.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Используется для отслеживания количества раз, когда пользователь разворачивает плеер на весь экран.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Используется для отслеживания количества остановок воспроизведения аудио или видео пользователем.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Используется для отслеживания количества кликов пользователя, например, кликов по интерактивной точке видео.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Используется для отслеживания количества пропусков аудио- или видеоматериала.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Используется для отслеживания количества воспроизведений аудио или видео до смещения, определяемого параметром progressOffset .

Транскодирование

Представляет информацию о преобразованном аудио- или видеофайле.

JSON-представление 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
Поля
name

string

Необязательно. Название перекодированного файла.

mimeType

string

Необязательный параметр. MIME-тип перекодированного файла.

transcoded

boolean

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

dimensions

object ( Dimensions )

Необязательно. Размеры перекодированного видео.

bitRateKbps

string ( int64 format)

Необязательно. Битрейт транскодированного видео в килобитах в секунду.

frameRate

number

Необязательно. Частота кадров перекодированного видео в кадрах в секунду.

audioBitRateKbps

string ( int64 format)

Необязательно. Битрейт аудиопотока транскодированного видео или битрейт транскодированного аудио в килобитах в секунду.

audioSampleRateHz

string ( int64 format)

Необязательно. Частота дискретизации аудиопотока транскодированного видео или частота дискретизации транскодированного аудио в герцах.

fileSizeBytes

string ( int64 format)

Необязательный параметр. Размер перекодированного файла в байтах.

CmTrackingAd

Рекламное объявление, отслеживающее действия в рамках системы Campaign Manager 360.

JSON-представление 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Поля
cmPlacementId

string ( int64 format)

Необязательно. Идентификатор размещения рекламного объявления, отслеживаемого менеджером кампаний 360.

cmCreativeId

string ( int64 format)

Необязательно. Идентификатор креатива рекламного объявления, отслеживаемого менеджером кампаний 360.

cmAdId

string ( int64 format)

Необязательно. Идентификатор объявления, отслеживаемого менеджером кампаний 360.

ОбаИкон

Иконка OBA для креатива

JSON-представление 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
Поля
resourceUrl

string

Необязательно. URL ресурса значка OBA.

resourceMimeType

string

Необязательный параметр. MIME-тип ресурса значка OBA.

position

enum ( ObaIconPosition )

Необязательно. Положение значка OBA на креативе.

dimensions

object ( Dimensions )

Необязательно. Размеры значка OBA.

program

string

Необязательно. Программа, указанная на значке OBA. Например: «AdChoices».

landingPageUrl

string

Обязательно. URL целевой страницы значка OBA.

Разрешается использовать только URL-адреса следующих доменов:

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

Обязательно. URL-адрес отслеживания кликов значка OBA.

Разрешается использовать только URL-адреса следующих доменов:

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

Обязательно. URL-адрес отслеживания просмотров значка OBA.

Разрешается использовать только URL-адреса следующих доменов:

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

Положение значка OBA на рекламном материале.

Перечисления
OBA_ICON_POSITION_UNSPECIFIED Положение значка OBA не указано.
OBA_ICON_POSITION_UPPER_RIGHT В правом верхнем углу рекламного изображения.
OBA_ICON_POSITION_UPPER_LEFT В верхнем левом углу рекламного изображения.
OBA_ICON_POSITION_LOWER_RIGHT В правом нижнем углу рекламного изображения.
OBA_ICON_POSITION_LOWER_LEFT В левом нижнем углу рекламного изображения.

РасширениеНаправления

Расширяющееся направление развития сторонних креативных решений.

Перечисления
EXPANDING_DIRECTION_UNSPECIFIED Направление расширения не указано.
EXPANDING_DIRECTION_NONE Не расширяется ни в каком направлении.
EXPANDING_DIRECTION_UP Расширяется вверх.
EXPANDING_DIRECTION_DOWN Расширяется вниз.
EXPANDING_DIRECTION_LEFT Расширяется влево.
EXPANDING_DIRECTION_RIGHT Расширяется вправо.
EXPANDING_DIRECTION_UP_AND_LEFT Расширяется вверх и влево.
EXPANDING_DIRECTION_UP_AND_RIGHT Расширяется вверх и вправо.
EXPANDING_DIRECTION_DOWN_AND_LEFT Расширяется вниз и влево.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Расширяется вниз и вправо.
EXPANDING_DIRECTION_UP_OR_DOWN Расширяется либо вверх, либо вниз.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Расширяется либо влево, либо вправо.
EXPANDING_DIRECTION_ANY_DIAGONAL Может расширяться в любом диагональном направлении.

Методы

create

 Создаёт новый креатив.

delete

 Удаляет рекламный текст.

get

 Проявляет креативность.

list

 Содержит списки рекламных материалов в рекламном объявлении.

patch

 Обновляет существующий рекламный материал.