REST Resource: advertisers.creatives

{
  "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
}

string

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

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

string

Необходимый. Отображаемое название объявления.

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

enum ( EntityStatus )

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

Принятые значения:

• ENTITY_STATUS_ACTIVE
• ENTITY_STATUS_ARCHIVED
• ENTITY_STATUS_PAUSED

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

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

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

enum ( CreativeType )

Необходимый. Неизменяемый. Тип объявления.

enum ( HostingSource )

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

boolean

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

object ( Dimensions )

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

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_NATIVE_VIDEO

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.

string ( Duration format)

Только вывод. Медиа-продолжительность объявления. Применимо, когда creativeType является одним из:

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_NATIVE_VIDEO
• CREATIVE_TYPE_PUBLISHER_HOSTED

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

enum ( CreativeAttribute )

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

object ( ReviewStatusInfo )

Только вывод. Текущий статус процесса проверки объявлений.

object ( AssetAssociation )

Необходимый. Объекты, связанные с этим креативом.

object ( ExitEvent )

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

• Используйте область касания Google Web Designer.
• Определите переменную JavaScript под названием «clickTag».
• Используйте активатор (Enabler.exit()) для отслеживания выходов в мультимедийных форматах.

object ( TimerEvent )

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

object ( CounterEvent )

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

string

Сторонний HTML-тег отслеживания, который будет добавлен к тегу объявления.

string

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

string

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

boolean

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

string ( int64 format)

Идентификаторы сопутствующих креативов для видеокреатива.

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

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

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

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

boolean

Может ли пользователь пропустить видеокреатив.

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

• CREATIVE_TYPE_VIDEO

object ( AudioVideoOffset )

Время воспроизведения видео до появления кнопки пропуска.

Это поле является обязательным, если skippable имеет значение true.

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

• CREATIVE_TYPE_VIDEO

object ( AudioVideoOffset )

Время воспроизведения видео до подсчета просмотров.

Это поле является обязательным, если skippable имеет значение true.

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

• CREATIVE_TYPE_VIDEO

object ( UniversalAdId )

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

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

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

• CREATIVE_TYPE_VIDEO

object ( ThirdPartyUrl )

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

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

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_NATIVE_VIDEO

object ( Transcode )

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

Дисплей и Видео 360 перекодирует основной ресурс в несколько альтернативных версий, которые используют разные форматы файлов или имеют разные свойства (разрешение, скорость передачи звука и скорость передачи видео), каждая из которых предназначена для определенных видеопроигрывателей или полос пропускания.

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

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

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_NATIVE_VIDEO
• CREATIVE_TYPE_AUDIO

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

string

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

Это поле доступно для записи только в следующем creativeType :

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE
• CREATIVE_TYPE_NATIVE_VIDEO

object ( CmTrackingAd )

Отслеживающее объявление Менеджера кампании 360, связанное с креативом.

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

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE

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

object ( ObaIcon )

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

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

• CREATIVE_TYPE_VIDEO

string

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

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

Креативы со сторонними тегами – это креативы со следующим hostingSource :

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

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

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

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

Креативы со сторонними тегами – это креативы со следующим hostingSource :

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

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

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

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_EXPANDABLE

boolean

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

Действительно только при использовании отслеживающего объявления Менеджера кампании 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

enum ( ExpandingDirection )

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

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

Сторонние расширяемые креативы – это креативы со следующим источником хостинга:

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_EXPANDABLE

boolean

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

Необязательно и действует только для сторонних расширяемых объявлений. Сторонние расширяемые креативы – это креативы со следующим источником хостинга:

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_EXPANDABLE

string

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

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

Сторонние креативы с тегом VAST – это креативы со следующим hostingSource :

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

boolean

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

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

Сторонние креативы с тегом VAST – это креативы со следующим hostingSource :

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_VIDEO

boolean

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

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

Сторонние креативы с тегом VAST – это креативы со следующим hostingSource :

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_VIDEO

string ( int64 format)

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

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

boolean

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

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

Сторонние аудиокреативы – это креативы со следующим hostingSource :

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_AUDIO

boolean

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

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

Сторонние аудиокреативы – это креативы со следующим hostingSource :

• HOSTING_SOURCE_THIRD_PARTY

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

• CREATIVE_TYPE_AUDIO

{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}

enum ( ApprovalStatus )

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

enum ( ReviewStatus )

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

enum ( ReviewStatus )

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

object ( ExchangeReviewStatus )

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

object ( PublisherReviewStatus )

Статусы проверки издателем креатива.

{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}

enum ( Exchange )

Биржа рассматривает креатив.

enum ( ReviewStatus )

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

{
  "publisherName": string,
  "status": enum (ReviewStatus)
}

string

Издатель проверяет креатив.

enum ( ReviewStatus )

Статус обзора издателя.

{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}

object ( Asset )

Соответствующий актив.

enum ( AssetRole )

Роль этого актива для креатива.

{
  "mediaId": string,
  "content": string
}

string ( int64 format)

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

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

string

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

{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}

enum ( ExitEventType )

Необходимый. Тип выходного события.

string

Необходимый. URL перехода по клику события выхода. Это необходимо, если type :

• EXIT_EVENT_TYPE_DEFAULT
• EXIT_EVENT_TYPE_BACKUP

string

Имя тега клика события выхода.

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

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

string

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

{
  "name": string,
  "reportingName": string
}

string

Необходимый. Имя события таймера.

string

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

{
  "name": string,
  "reportingName": string
}

string

Необходимый. Имя встречного события.

string

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

{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}

string ( int64 format)

Смещение в процентах от продолжительности аудио или видео.

string ( int64 format)

Смещение в секундах от начала аудио или видео.

{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}

string

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

enum ( UniversalAdRegistry )

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

{
  "type": enum (ThirdPartyUrlType),
  "url": string
}

enum ( ThirdPartyUrlType )

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

string

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

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

{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}

string

Имя перекодированного файла.

string

MIME-тип перекодированного файла.

boolean

Указывает, прошло ли перекодирование успешно.

object ( Dimensions )

Размеры перекодированного видео.

string ( int64 format)

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

number

Частота кадров перекодированного видео в кадрах в секунду.

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}

string ( int64 format)

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

string ( int64 format)

Идентификатор объявления Менеджера кампании 360, отслеживающего рекламу.

string ( int64 format)

Идентификатор объявления Менеджера кампании 360, отслеживающего рекламу.

{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}

string

URL-адрес ресурса значка поведенческой рекламы.

string

Тип MIME ресурса значка поведенческой рекламы.

enum ( ObaIconPosition )

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

object ( Dimensions )

Размеры значка поведенческой рекламы.

string

Программа иконки OBA. Например: «Выбор рекламы».

string

Необходимый. URL целевой страницы со значком поведенческой рекламы.

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

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

string

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

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

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

string

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

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

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