REST Resource: advertisers.campaigns

{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}

string

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

string ( int64 format)

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

string ( int64 format)

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

string

Необходимый. Отображаемое название кампании.

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

enum ( EntityStatus )

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

• Допустимые значения: ENTITY_STATUS_ACTIVE , ENTITY_STATUS_ARCHIVED и ENTITY_STATUS_PAUSED .
• Для метода campaigns.create ENTITY_STATUS_ARCHIVED не разрешен.

string ( Timestamp format)

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

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

object ( CampaignGoal )

Необходимый. Цель кампании.

object ( CampaignFlight )

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

object ( FrequencyCap )

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

object ( CampaignBudget )

Список бюджетов, доступных для этой кампании.

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

{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}

enum ( CampaignGoalType )

Необходимый. Тип цели кампании.

object ( PerformanceGoal )

Необходимый. Цель кампании.

Допустимые значения для performanceGoalType :

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_OTHER

{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}

string ( int64 format)

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

Сумма указана в микронах. Должно быть больше или равно 0. Например, 500000000 представляет собой 500 стандартных единиц валюты.

object ( DateRange )

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

• Указанные здесь даты не повлияют на показ. Они используются для генерации оповещений и предупреждений. Например, если дата окончания любого дочернего заказа на размещение выходит за пределы этих дат, в пользовательском интерфейсе отобразится предупреждение.
• startDate является обязательным и должен быть текущей датой или более поздней.
• endDate является необязательным. Если указано, это должна быть startDate или более поздняя.
• Любая указанная дата должна быть до 2037 года.

{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}

string ( int64 format)

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

Необходимо включать при обновлении или добавлении бюджетов в campaignBudgets . В противном случае будет создан и присвоен новый идентификатор.

string

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

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

enum ( BudgetUnit )

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

string ( int64 format)

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

Сумма указана в микронах. Должно быть больше 0. Например, 500000000 представляет 500 стандартных единиц валюты.

object ( DateRange )

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

И startDate , и endDate должны быть раньше 2037 года.

enum ( ExternalBudgetSource )

Необходимый. Внешний источник бюджета.

string

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

Если это поле установлено, а уровень детализации счета соответствующего профиля выставления счетов установлен на «Уровень бюджета», все показы, выполненные в рамках этого бюджета, будут включать этот идентификатор в счет.

Должно быть уникальным в рамках кампании.

string

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

Если это поле установлено, а уровень счета соответствующего профиля выставления счетов установлен на «Идентификатор группировки счетов бюджета», все externalBudgetId имеющие один и тот же invoiceGroupingId будут сгруппированы в одном счете.

object ( PrismaConfig )

Дополнительные метаданные для использования инструментом Mediaocean Prisma.

Требуется для бюджетов Mediaocean.

Применимо только к рекламодателям prismaEnabled .

{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}

enum ( PrismaType )

Необходимый. Тип Призма.

object ( PrismaCpeCode )

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

string

Необходимый. Организация выделила этот бюджет (DSP, сайт и т. д.).

{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}

string

Клиентский код Prisma.

string

Код продукта Prisma.

string

Оценочный код Prisma.