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

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

advertiser Id

string ( int64 format)

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

partner Id

string ( int64 format)

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

display Name

string

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

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

entity Status

enum ( EntityStatus )

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

  • Допустимые значения: ENTITY_STATUS_ACTIVE , ENTITY_STATUS_PAUSED и ENTITY_STATUS_SCHEDULED_FOR_DELETION .
  • Если установлено значение ENTITY_STATUS_SCHEDULED_FOR_DELETION , рекламодатель будет удален через 30 дней с момента, когда его удаление было первоначально запланировано.
update Time

string ( Timestamp format)

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

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

general Config

object ( AdvertiserGeneralConfig )

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

ad Server Config

object ( AdvertiserAdServerConfig )

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

creative Config

object ( AdvertiserCreativeConfig )

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

data Access Config

object ( AdvertiserDataAccessConfig )

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

integration Details

object ( IntegrationDetails )

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

serving Config

object ( AdvertiserTargetingConfig )

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

prisma Enabled

boolean

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

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

billing Config

object ( AdvertiserBillingConfig )

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

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

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

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

string

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

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

time Zone

string

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

Дополнительную информацию см. по адресу: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones .

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

currency Code

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 может быть только одним из следующих:
third Party Only Config

object ( ThirdPartyOnlyConfig )

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

cm Hybrid Config

object ( CmHybridConfig )

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

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

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

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

boolean

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

CmHybridConfig

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

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

string ( int64 format)

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

cm Floodlight Config Id

string ( int64 format)

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

cm Advertiser Ids[]

string ( int64 format)

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

cm Syncable Site Ids[]

string ( int64 format)

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

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

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

dv360 To Cm Data Sharing Enabled

boolean

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

dv360 To Cm Cost Reporting Enabled

boolean

Указывать, отправлять ли отчет о стоимости DV360 в CM360.

cm Floodlight Linking Authorized

boolean

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

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

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

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

string ( int64 format)

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

oba Compliance Disabled

boolean

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

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

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

boolean

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

video Creative Data Sharing Authorized

boolean

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

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

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

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

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

object ( AdvertiserSdfConfig )

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

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

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

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

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

boolean

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

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

sdf Config

object ( SdfConfig )

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

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

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

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

boolean

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

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

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

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

string ( int64 format)

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

Методы

audit

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

create

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

delete

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

edit Assigned Targeting Options

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

get

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

list

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

list Assigned Targeting Options

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

patch

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