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)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}

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 )

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

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.

object ( YoutubeAndPartnersSettings )

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

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

enum ( LineItemFlightDateType )

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

object ( DateRange )

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

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

{
  "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 включительно.

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

string

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

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

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

enum ( Platform )

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

string

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

string

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

{
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementSettings": {
    object (YoutubeAndPartnersThirdPartyMeasurementSettings)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}

object ( YoutubeAndPartnersBiddingStrategy )

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

object ( FrequencyCap )

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

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

object ( YoutubeAndPartnersThirdPartyMeasurementSettings )

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

object ( YoutubeAndPartnersInventorySourceConfig )

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

enum ( YoutubeAndPartnersContentCategory )

Тип контента, на котором будет показываться реклама YouTube и партнеров.

enum ( YoutubeAndPartnersContentCategory )

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

object ( TargetFrequency )

Среднее количество раз, которое вы хотите, чтобы объявления из этой позиции показывались одному и тому же человеку за определенный период времени.

string ( int64 format)

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

string

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

string ( int64 format)

Идентификатор формы для привлечения потенциальных клиентов.

object ( VideoAdSequenceSettings )

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

{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}

object ( ThirdPartyVendorConfig )

Сторонние поставщики, измеряющие видимость.

Применимы следующие сторонние поставщики:

• THIRD_PARTY_VENDOR_MOAT
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_TELEMETRY
• THIRD_PARTY_VENDOR_MEETRICS

object ( ThirdPartyVendorConfig )

Сторонние поставщики, измеряющие безопасность бренда.

Применимы следующие сторонние поставщики:

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

object ( ThirdPartyVendorConfig )

Сторонние поставщики, измеряющие охват.

Применимы следующие сторонние поставщики:

• THIRD_PARTY_VENDOR_NIELSEN
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_KANTAR

object ( ThirdPartyVendorConfig )

Сторонние поставщики, измеряющие эффективность бренда.

Применимы следующие сторонние поставщики:

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}

enum ( ThirdPartyVendor )

Сторонний поставщик средств измерения.

string

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

{
  "includeYoutubeSearch": boolean,
  "includeYoutubeVideos": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

Настраивать ли таргетинг ресурсов на странице результатов поиска YouTube.

boolean

Следует ли нацеливаться на инвентарь каналов и видео на YouTube, а также видео YouTube, встроенных на другие сайты.

boolean

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

boolean

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

{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}

string ( int64 format)

Целевое количество раз, в среднем, реклама будет показана одному и тому же человеку в интервале времени, определяемом timeUnit и timeUnitCount .

enum ( TimeUnit )

Единица времени, в течение которой будет применяться целевая частота.

Применимы следующие единицы времени:

• TIME_UNIT_WEEKS

integer

Количество timeUnit , в течение которого будет длиться целевая частота.

В зависимости от значения timeUnit применяются следующие ограничения:

• TIME_UNIT_WEEKS – должно быть 1.

{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}

enum ( VideoAdSequenceMinimumDuration )

Минимальный интервал времени, прежде чем тот же пользователь снова увидит эту последовательность.

object ( VideoAdSequenceStep )

Шаги, из которых состоит последовательность.

{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}

string ( int64 format)

Идентификатор шага.

string ( int64 format)

Идентификатор соответствующей группы объявлений шага.

string ( int64 format)

Идентификатор предыдущего шага. Первый шаг не имеет предыдущего шага.

enum ( InteractionType )

Взаимодействие на предыдущем шаге, которое приведет зрителя к этому шагу. Первый шаг не имеет тип взаимодействия.