REST Resource: advertisers

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

string

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

string ( int64 format)

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

string ( int64 format)

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

string

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

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

enum ( EntityStatus )

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

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

string ( Timestamp format)

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

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

object ( AdvertiserGeneralConfig )

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

object ( AdvertiserAdServerConfig )

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

object ( AdvertiserCreativeConfig )

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

object ( AdvertiserDataAccessConfig )

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

object ( IntegrationDetails )

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

object ( AdvertiserTargetingConfig )

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

boolean

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

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

object ( AdvertiserBillingConfig )

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

{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}

string

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

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

string

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

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

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

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 : Южноафриканский рэнд.

{

  // 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.
}

object ( ThirdPartyOnlyConfig )

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

object ( CmHybridConfig )

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

{
  "pixelOrderIdReportingEnabled": boolean
}

boolean

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

{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

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

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

boolean

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

boolean

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

boolean

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

{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}

string ( int64 format)

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

boolean

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

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

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

boolean

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

boolean

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

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

{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}

object ( AdvertiserSdfConfig )

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

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

{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}

boolean

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

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

object ( SdfConfig )

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

• Требуется, если overridePartnerSdfConfig имеет true .
• Вывод только в том случае, если overridePartnerSdfConfig имеет значение false .

{
  "exemptTvFromViewabilityTargeting": boolean
}

boolean

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

{
  "billingProfileId": string
}

string ( int64 format)

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

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