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)
  }
}
Поля
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)

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

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

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 )

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

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

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

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 : Чешская крона
  • DKK : датская крона
  • EGP : египетский фунт.
  • EUR : Евро
  • GBP : Британский фунт стерлингов.
  • HKD : Гонконгский доллар
  • HUF : Венгерский форинт.
  • IDR : Индонезийская рупия.
  • ILS : израильский шекель.
  • INR : Индийская рупия.
  • JPY : японская иена.
  • KRW : Южнокорейская вона.
  • MXN : мексиканские песо.
  • MYR : Малайзийский ринггит
  • NGN : нигерийская найра.
  • NOK : норвежская крона.
  • NZD : новозеландский доллар.
  • PEN : Перуанское Нуэво-Соль.
  • PLN : Польский злотый
  • RON : новый румынский лей
  • RUB : Российский рубль
  • SEK : шведская крона.
  • TRY : турецкая лира
  • TWD : новый тайваньский доллар.
  • USD : Доллар США
  • ZAR : Южноафриканский рэнд.

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

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

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 )

Конфигурация для рекламодателей, которые используют как Менеджер кампании 360 (CM360), так и сторонние серверы объявлений.

Третья сторонатолькоконфиг

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

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

boolean

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

CmHybridConfig

Настройки для рекламодателей, которые используют как Менеджер кампаний 360 (CM360), так и сторонние серверы объявлений.

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

string ( int64 format)

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

cmFloodlightConfigId

string ( int64 format)

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

cmAdvertiserIds[]

string ( int64 format)

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

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.

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

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

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

string ( int64 format)

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

obaComplianceDisabled

boolean

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

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

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

boolean

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

videoCreativeDataSharingAuthorized

boolean

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

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

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

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

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

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

BillingConfig рекламодателя

Платежные настройки рекламодателя.

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

string ( int64 format)

Идентификатор платежного профиля, присвоенного рекламодателю.

Методы

audit

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

create

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

delete

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

editAssignedTargetingOptions

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

get

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

list

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

listAssignedTargetingOptions

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

patch

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