REST Resource: advertisers.lineItems

{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}

string

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

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

string ( int64 format)

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

string

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

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

enum ( LineItemType )

Необходимый. Неизменяемый. Тип позиции.

enum ( EntityStatus )

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

• Для метода lineItems.create разрешен только ENTITY_STATUS_DRAFT . Чтобы активировать позицию, используйте метод lineItems.patch и обновите статус до ENTITY_STATUS_ACTIVE после создания.
• Статус позиции нельзя вернуть обратно в статус ENTITY_STATUS_DRAFT из любого другого статуса.
• Если родительский заказ на размещение позиции не активен, позиция не сможет израсходовать свой бюджет, даже если ее собственный статус – ENTITY_STATUS_ACTIVE .

string ( Timestamp format)

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

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

object ( PartnerCost )

Расходы партнера, связанные с кампанией.

Если метод lineItems.create отсутствует или пуст, вновь созданная позиция унаследует партнерские расходы от родительского заказа на размещение.

object ( LineItemFlight )

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

object ( LineItemBudget )

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

object ( Pacing )

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

object ( FrequencyCap )

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

Поле maxImpressions в этом объекте настроек необходимо использовать при назначении ограниченного ограничения.

object ( PartnerRevenueModel )

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

object ( ConversionCountingConfig )

Настройка отслеживания конверсий позиции.

string ( int64 format)

Идентификаторы объявлений, связанных с позицией.

object ( BiddingStrategy )

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

object ( IntegrationDetails )

Подробности интеграции позиции.

string ( int64 format)

Идентификаторы источников частного инвентаря, назначенных позиции.

object ( TargetingExpansionConfig )

Оптимизированные настройки таргетинга позиции.

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

enum ( LineItemWarningMessage )

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

object ( MobileApp )

Мобильное приложение, рекламируемое позицией.

Это применимо только в том случае, если lineItemType имеет значение LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL или LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL .

enum ( ReservationType )

Только вывод. Тип резервирования позиции.

boolean

Следует ли исключить новые биржи из автоматического таргетинга позиции. По умолчанию это поле имеет значение false.

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}

enum ( LineItemFlightDateType )

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

object ( DateRange )

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

• Требуется, если flightDateType имеет значение LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM . Вывод только иначе.
• При создании нового рейса и startDate , и endDate должны находиться в будущем.
• Существующий рейс с startDate в прошлом имеет изменяемый endDate но неизменяемый startDate .
• endDate должна быть startDate или позже, оба до 2037 года.

string ( int64 format)

Идентификатор ручного триггера, связанного с кампанией.

• Требуется, если flightDateType имеет значение LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER . Не должно быть установлено иначе.
• Если этот параметр установлен, даты истечения позиции наследуются из родительского заказа на размещение.
• Активные позиции будут расходовать средства, когда выбранный триггер активируется в пределах сроков действия родительского заказа на размещение.

Предупреждение. Позиции, использующие ручные триггеры, больше не отображаются в Display & Video 360. Действие этого поля будет прекращено 1 августа 2023 г. Для получения дополнительной информации прочтите наше объявление об прекращении поддержки функции .

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

enum ( LineItemBudgetAllocationType )

Необходимый. Тип распределения бюджета.

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

enum ( BudgetUnit )

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

string ( int64 format)

Максимальная сумма бюджета, которую потратит позиция. Должно быть больше 0.

Когда budgetAllocationType имеет значение:

• LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC , это поле неизменяемо и устанавливается системой.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED , если budgetUnit :
  • BUDGET_UNIT_CURRENCY , это поле представляет максимальную сумму бюджета, которую можно потратить, в микро валютах рекламодателя. Например, 1500000 представляет собой 1,5 стандартных единицы валюты.
  • BUDGET_UNIT_IMPRESSIONS , в этом поле указано максимальное количество показов.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED это поле неприменимо и будет игнорироваться системой.

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum ( PartnerRevenueModelMarkupType )

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

string ( int64 format)

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

• Если markupType установлено значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM , это поле представляет наценку за тысячу показов в микронах валюты рекламодателя. Например, 1500000 представляет собой 1,5 стандартных единицы валюты.
• Если markupType установлено значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP , это поле представляет процентную надбавку к стоимости рекламы в миллисекундах. Например, 100 представляет собой 0,1% (десятичное 0,001).
• Если для markupType установлено значение PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP , это поле представляет общую процентную надбавку к стоимости рекламы в миллисах. Например, 100 представляет собой 0,1% (десятичное 0,001).

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string ( int64 format)

Процент учитываемых конверсий после просмотра, в миллисах (1/1000 процента). Должно быть от 0 до 100 000 включительно.

Например, чтобы отслеживать 50 % конверсий после клика, установите значение 50 000.

object ( TrackingFloodlightActivityConfig )

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

Количество подсчитанных конверсий представляет собой сумму всех конверсий, подсчитанных всеми идентификаторами действий Floodlight, указанными в этом поле.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string ( int64 format)

Необходимый. Идентификатор действия Floodlight.

integer

Необходимый. Количество дней после клика по объявлению, в течение которых может быть засчитана конверсия. Должно быть от 0 до 90 включительно.

integer

Необходимый. Количество дней после просмотра объявления, в течение которых может быть засчитана конверсия. Должно быть от 0 до 90 включительно.

{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}

enum ( TargetingExpansionLevel )

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

Это поле поддерживает следующие значения:

• NO_EXPANSION : оптимизированный таргетинг отключен.
• LEAST_EXPANSION : включен оптимизированный таргетинг.

Если в этом поле установлено любое другое значение, ему автоматически будет присвоено значение LEAST_EXPANSION .

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

boolean

Исключить ли собственные аудитории из использования при расширении таргетинга.

Это поле устарело с запуском оптимизированного таргетинга .

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

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

string

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

Приложения Android идентифицируются по идентификатору пакета, используемому в магазине Android Play, например com.google.android.gm .

Приложения iOS идентифицируются по девятизначному идентификатору приложения, используемому магазином приложений Apple, например 422689480 .

enum ( Platform )

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

string

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

string

Только вывод. Издатель приложения.