REST Resource: advertisers

Ресурс: Рекламодатель

Один рекламодатель в Display & Video 360 (DV360).

JSON-представление 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Поля
name

string

Только вывод. Имя ресурса рекламодателя.

advertiserId

string ( int64 format)

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

partnerId

string ( int64 format)

Обязательно. Неизменяемо. Уникальный идентификатор партнёра, которому принадлежит рекламодатель.

displayName

string

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

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

entityStatus

enum ( EntityStatus )

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

  • Допустимые значения: ENTITY_STATUS_ACTIVE , ENTITY_STATUS_PAUSED и ENTITY_STATUS_SCHEDULED_FOR_DELETION .
  • Если установлено значение ENTITY_STATUS_SCHEDULED_FOR_DELETION , рекламодатель будет удален через 30 дней с момента первого запланированного удаления.
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" .

generalConfig

object ( AdvertiserGeneralConfig )

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

adServerConfig

object ( AdvertiserAdServerConfig )

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

creativeConfig

object ( AdvertiserCreativeConfig )

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

dataAccessConfig

object ( AdvertiserDataAccessConfig )

Настройки, контролирующие доступ к данным рекламодателя.

integrationDetails

object ( IntegrationDetails )

Интеграционные данные рекламодателя. В настоящее время к рекламодателю применим только integrationCode . Другие поля IntegrationDetails не поддерживаются и будут проигнорированы, если указаны.

servingConfig

object ( AdvertiserTargetingConfig )

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

prismaEnabled

boolean

Включена ли интеграция с Mediaocean (Prisma). Включая её, вы соглашаетесь со следующим:

От имени своей компании я уполномочиваю Mediaocean (Prisma) отправлять планы сегментов бюджета в Google, а также уполномочиваю Google отправлять соответствующие отчеты и счета-фактуры из DV360 в Mediaocean для целей планирования бюджета, выставления счетов и сверки для этого рекламодателя.

billingConfig

object ( AdvertiserBillingConfig )

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

containsEuPoliticalAds

enum ( EuPoliticalAdvertisingStatus )

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

Если это поле установлено как DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING , то произойдет следующее:

  • Любые новые позиции, созданные для этого рекламодателя, будут иметь статус DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING если не указано иное.
  • Любые существующие позиции этого рекламодателя, не имеющие установленного значения, будут обновлены до DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING в течение дня.

AdvertiserGeneralConfig

Общие настройки рекламодателя.

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

string

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

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

timeZone

string

Только вывод. Стандартное имя базы данных TZ для часового пояса рекламодателя. Например, America/New_York .

Подробнее см. на сайте: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

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

currencyCode

string

Обязательно. Неизменяемо. Валюта рекламодателя в формате ISO 4217.

Принятые коды и валюты, которые они представляют:

Код валюты: Название валюты

  • ARS : аргентинское песо
  • AUD : австралийский доллар
  • BRL : Бразильский реал
  • CAD : канадский доллар
  • CHF : швейцарский франк
  • CLP : чилийское песо
  • CNY : китайский юань
  • COP : Колумбийское песо
  • CZK : Czech Koruna
  • DKK : Danish Krone
  • EGP : Египетский фунт
  • EUR : евро
  • GBP : Британский фунт
  • HKD : гонконгский доллар
  • HUF : венгерский форинт
  • IDR : индонезийская рупия
  • ILS : израильский шекель
  • INR : индийская рупия
  • JPY : японская иена
  • KRW : южнокорейская вона
  • MXN : мексиканские песо
  • MYR : Малайзийский ринггит
  • NGN : нигерийская найра
  • NOK : норвежская крона
  • NZD : новозеландский доллар
  • PEN : Перуанский Новый Соль
  • PLN : польский злотый
  • RON : Новый румынский лей
  • RUB : Российский рубль
  • SEK : Шведская крона
  • TRY : турецкая лира
  • TWD : Новый тайваньский доллар
  • USD : доллар США
  • ZAR : южноафриканский рэнд

Конфигурация рекламодателя/сервера рекламы

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

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

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Поля
Поле ad_server_config_scheme обязательно. ad_server_config_scheme может быть только одним из следующих:
thirdPartyOnlyConfig

object ( ThirdPartyOnlyConfig )

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

cmHybridConfig

object ( CmHybridConfig )

Конфигурация для рекламодателей, использующих как Campaign Manager 360 (CM360), так и сторонние рекламные серверы.

ThirdPartyOnlyConfig

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

JSON-представление 
{
  "pixelOrderIdReportingEnabled": boolean
}
Поля
pixelOrderIdReportingEnabled

boolean

Включена ли передача идентификатора заказа для пикселей. Это значение нельзя изменить после установки значения true .

CmHybridConfig

Настройки для рекламодателей, использующих как Campaign Manager 360 (CM360), так и сторонние рекламные серверы.

JSON-представление 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Поля
cmAccountId

string ( int64 format)

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

cmFloodlightConfigId

string ( int64 format)

Обязательно. Неизменяемо. Идентификатор конфигурации CM360 Floodlight, связанный с рекламодателем DV360.

cmAdvertiserIds[]

string ( int64 format)

Только вывод. Набор идентификаторов рекламодателей CM360, использующих конфигурацию CM360 Floodlight.

cmSyncableSiteIds[]

string ( int64 format)

Список сайтов CM360, места размещения которых будут синхронизированы с DV360 в качестве креативов.

Если метод advertisers.create отсутствует или пуст, система автоматически создаст сайт CM360.

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

dv360ToCmDataSharingEnabled

boolean

Включать ли данные DV360 в отчеты о передаче данных CM360.

dv360ToCmCostReportingEnabled

boolean

Следует ли сообщать стоимость DV360 в CM360.

cmFloodlightLinkingAuthorized

boolean

Обязательно. Неизменяемо. Устанавливая для этого поля значение true , вы от имени своей компании разрешаете передачу информации из данной конфигурации Floodlight этому рекламодателю Display & Video 360.

AdvertiserCreativeConfig

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

JSON-представление 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Поля
iasClientId

string ( int64 format)

Идентификатор для настройки мониторинга кампании, предоставляемый Integral Ad Service (IAS). Система DV360 добавит тег IAS «Campaign Monitor», содержащий этот идентификатор, к тегу креатива.

obaComplianceDisabled

boolean

Следует ли отключить функцию Google «Об этой рекламе», которая добавляет к вашим объявлениям значок (для обозначения рекламы) и информацию о взаимодействии с «Об этой рекламе» для поведенческой онлайн-рекламы (OBA) и соблюдения нормативных требований. Функция «Об этой рекламе» предоставляет пользователям больший контроль над рекламой, которую они видят, и помогает объяснить, почему они видят вашу рекламу. Подробнее .

Если вы решите установить для этого поля значение true , обратите внимание, что реклама, показываемая через Display & Video 360, должна соответствовать следующим требованиям:

  • Соблюдайте требования поведенческой онлайн-рекламы (OBA) в соответствии с вашим контрактом с Google Marketing Platform.
  • В Европейской экономической зоне (ЕЭЗ) необходимо включить информацию о прозрачности и механизм, позволяющий пользователям сообщать о противозаконном контенте в рекламе. При использовании альтернативного решения для маркировки рекламы, прозрачности и сообщения о противозаконном контенте необходимо убедиться, что оно включает необходимую информацию о прозрачности и механизм пометки противозаконного контента, а также уведомлять Google о любых жалобах на противозаконный контент, используя соответствующую форму .
dynamicCreativeEnabled

boolean

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

videoCreativeDataSharingAuthorized

boolean

Устанавливая для этого поля значение true , вы от имени своей компании разрешаете Google использовать видеокреативы, связанные с этим рекламодателем Display & Video 360, для предоставления отчетов и функций, связанных с телевизионными кампаниями рекламодателя.

Применимо только в том случае, если у рекламодателя имеется конфигурация CM360 hybrid .

AdvertiserDataAccessConfig

Настройки, контролирующие доступ к данным рекламодателя.

JSON-представление 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Поля
sdfConfig

object ( AdvertiserSdfConfig )

Настройки структурированных файлов данных (SDF) для рекламодателя.

Если не указано иное, используются настройки SDF родительского партнера.

РекламодательSdfConfig

Настройки структурированных файлов данных (SDF) рекламодателя.

JSON-представление 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Поля
overridePartnerSdfConfig

boolean

Переопределяет ли этот рекламодатель конфигурацию SDF своего родительского партнера.

По умолчанию рекламодатель наследует конфигурацию SDF от родительского партнёра. Чтобы переопределить конфигурацию партнёра, установите для этого поля значение true и укажите новую конфигурацию в sdfConfig .

sdfConfig

object ( SdfConfig )

Конфигурация SDF для рекламодателя.

Конфигурация таргетинга рекламодателя

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

JSON-представление 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Поля
exemptTvFromViewabilityTargeting

boolean

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

AdvertiserBillingConfig

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

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

string ( int64 format)

Обязательно. Идентификатор платёжного профиля, назначенного рекламодателю.

Методы

audit

 Проводит аудит рекламодателя.

create

 Создает нового рекламодателя.

delete

 Удаляет рекламодателя.

editAssignedTargetingOptions

 Редактирует параметры таргетинга для одного рекламодателя.

get

 Находит рекламодателя.

list

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

listAssignedTargetingOptions

 Перечисляет назначенные рекламодателю параметры таргетинга по типам таргетинга.

patch

 Обновляет существующего рекламодателя.