REST Resource: advertisers.lineItems

Recurso: LineItem

Um único item de linha.

Representação JSON 
{
  "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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Campos
name

string

Apenas saída. O nome do recurso do item de linha.
advertiserId

string (int64 format)

Apenas saída. O ID exclusivo do anunciante a que o item de linha pertence.
campaignId

string (int64 format)

Apenas saída. O ID exclusivo da campanha a que o item de linha pertence.
insertionOrderId

string (int64 format)

Obrigatório. Imutável. O ID exclusivo do pedido de inserção a que o item de linha pertence.
lineItemId

string (int64 format)

Apenas saída. O ID exclusivo do item de linha. Atribuído pelo sistema.
displayName

string

Obrigatório. O nome de exibição do item de linha.

Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
lineItemType

enum (LineItemType)

Obrigatório. Imutável. O tipo do item de linha.
entityStatus

enum (EntityStatus)

Obrigatório. Controla se o item de linha pode gastar o orçamento e dar lances no inventário.

  • Para o método lineItems.create, apenas ENTITY_STATUS_DRAFT é permitido. Para ativar um item de linha, use o método lineItems.patch e atualize o status para ENTITY_STATUS_ACTIVE após a criação.
  • Um item de linha não pode ser alterado de volta para o status ENTITY_STATUS_DRAFT de nenhum outro status.
  • Se o pedido de inserção principal do item de linha não estiver ativo, o item não poderá gastar o orçamento, mesmo que o status dele seja ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora da última atualização do item de linha. Atribuído pelo sistema.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
partnerCosts[]

object (PartnerCost)

Os custos de parceiro associados ao item de linha.

Se estiver ausente ou vazio no método lineItems.create, o item de linha recém-criado vai herdar os custos do parceiro do pedido de inserção principal.
flight

object (LineItemFlight)

Obrigatório. O horário de início e término da veiculação do item de linha.
budget

object (LineItemBudget)

Obrigatório. A configuração de alocação de orçamento do item de linha.
pacing

object (Pacing)

Obrigatório. A configuração de velocidade de gasto do orçamento do item de linha.
frequencyCap

object (FrequencyCap)

Obrigatório. As configurações de limite de frequência de impressão do item de linha.

O campo maxImpressions nesse objeto de configurações precisa ser usado ao atribuir um limite restrito.
partnerRevenueModel

object (PartnerRevenueModel)

Obrigatório. A configuração do modelo de receita do parceiro do item de linha.
conversionCounting

object (ConversionCountingConfig)

A configuração de acompanhamento de conversões do item de linha.
creativeIds[]

string (int64 format)

Os IDs dos criativos associados ao item de linha.
bidStrategy

object (BiddingStrategy)

Obrigatório. A estratégia de lances do item de linha.
integrationDetails

object (IntegrationDetails)

Detalhes da integração do item de linha.
targetingExpansion

object (TargetingExpansionConfig)

As configurações de segmentação otimizada do item de linha.

Essa configuração só é aplicável a itens de linha de display, vídeo ou áudio que usam lances automáticos e segmentam positivamente listas de público-alvo qualificadas.
warningMessages[]

enum (LineItemWarningMessage)

Apenas saída. As mensagens de aviso geradas pelo item de linha. Esses avisos não impedem o salvamento do item de linha, mas alguns podem impedir a veiculação dele.
mobileApp

object (MobileApp)

O app para dispositivos móveis promovido pelo item de linha.

Isso só é aplicável quando lineItemType é LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL ou LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

Apenas saída. O tipo de reserva do item de linha.
excludeNewExchanges

boolean

Se as novas trocas devem ser excluídas da segmentação automática pelo item de linha. Por padrão, esse campo é "false".
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Apenas saída. Configurações específicas para itens de linha do YouTube e parceiros.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Indica se o item de linha vai veicular anúncios políticos da União Europeia.

Se containsEuPoliticalAds tiver sido definido como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING no anunciante principal, esse campo será atribuído como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, a menos que seja especificado de outra forma. Esse campo pode ser atualizado usando a interface, a API ou arquivos de dados estruturados.

LineItemType

Tipos possíveis de um item de linha.

O tipo de item de linha determina quais configurações e opções são aplicáveis, como o formato dos anúncios ou as opções de segmentação.

Enums
LINE_ITEM_TYPE_UNSPECIFIED

O valor do tipo não foi especificado ou é desconhecido nesta versão.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_DISPLAY_DEFAULT Anúncios de imagem, HTML5, nativos ou rich media.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Mostrar anúncios gráficos que geram instalações de um app.
LINE_ITEM_TYPE_VIDEO_DEFAULT Anúncios em vídeo vendidos com base no CPM para vários ambientes.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Anúncios em vídeo que geram instalações de um app.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Anúncios de display veiculados no inventário de apps para dispositivos móveis.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Anúncios em vídeo veiculados no inventário de apps para dispositivos móveis.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_AUDIO_DEFAULT Anúncios de áudio de RTB vendidos para vários ambientes.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Anúncios over-the-top presentes em pedidos de inserção OTT. Esse tipo só é aplicável a itens de linha com um pedido de inserção de insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Anúncios em vídeo do YouTube que promovem conversões.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Anúncios em vídeo do YouTube (até 15 segundos) que não podem ser pulados.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Anúncios em vídeo do YouTube que contam uma história em uma sequência específica usando uma combinação de formatos.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

Anúncios em áudio do YouTube.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Anúncios em vídeo do YouTube que otimizam o alcance de mais usuários únicos a um custo menor. Podem incluir anúncios bumper, in-stream puláveis ou uma combinação de tipos.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Anúncios em vídeo padrão do YouTube.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Anúncios em vídeo do YouTube para smart TV (até 15 segundos) que não podem ser pulados.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Anúncios em vídeo do YouTube para smart TVs que otimizam o alcance de mais usuários únicos a um custo menor. Podem incluir anúncios bumper, in-stream puláveis ou uma combinação de tipos.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Anúncios em vídeo default do YouTube em smart TVs. Inclua apenas o formato de anúncio in-stream.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

A meta desse tipo de item de linha é mostrar os anúncios do YouTube o número desejado de vezes para a mesma pessoa em um determinado período.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Anúncios em vídeo do YouTube que visam gerar mais visualizações com vários formatos de anúncio.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Anúncios de display veiculados no inventário de mídia digital out of home.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Anúncios em vídeo veiculados em inventário digital out of home.

Não é possível criar ou atualizar itens de linha desse tipo e a segmentação deles usando a API.

LineItemFlight

Configurações que controlam a duração ativa de um item de linha.

Representação JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Campos
flightDateType

enum (LineItemFlightDateType)

Obrigatório. O tipo de período de veiculação do item de linha.
dateRange

object (DateRange)

As datas de início e término do período de veiculação do item de linha. Eles são resolvidos em relação ao fuso horário do anunciante principal.

  • Obrigatório quando flightDateType é LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. Caso contrário, somente saída.
  • Ao criar um novo voo, startDate e endDate precisam estar no futuro.
  • Um voo atual com um startDate no passado tem um endDate mutável, mas um startDate imutável.
  • endDate precisa ser startDate ou mais recente, ambos antes de 2037.

LineItemFlightDateType

Tipos possíveis de períodos de veiculação de um item de linha.

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED O valor do tipo não foi especificado ou é desconhecido nesta versão.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED O período de veiculação do item de linha é herdado do pedido de inserção principal.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM O item de linha usa períodos de veiculação personalizados.

LineItemBudget

Configurações que controlam como o orçamento é alocado.

Representação JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Campos
budgetAllocationType

enum (LineItemBudgetAllocationType)

Obrigatório. O tipo de alocação de orçamento.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC só é aplicável quando a alocação automática de orçamento está ativada para o pedido de inserção principal.
budgetUnit

enum (BudgetUnit)

Apenas saída. A unidade de orçamento especifica se o orçamento é baseado em moeda ou em impressão. Esse valor é herdado da ordem de inserção principal.
maxAmount

string (int64 format)

O valor máximo do orçamento que o item de linha vai gastar. Precisa ser maior que 0.

Quando budgetAllocationType é:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC: esse campo é imutável e definido pelo sistema.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, se budgetUnit for:
    • BUDGET_UNIT_CURRENCY: este campo representa o valor máximo do orçamento a ser gasto, em micros da moeda do anunciante. Por exemplo, 1500000 representa 1,5 unidades padrão da moeda.
    • BUDGET_UNIT_IMPRESSIONS, este campo representa o número máximo de impressões a serem veiculadas.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, esse campo não é aplicável e será ignorado pelo sistema.

LineItemBudgetAllocationType

Tipos possíveis de alocação de orçamento.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED O valor do tipo não foi especificado ou é desconhecido nesta versão.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC A alocação automática de orçamento está ativada para o item de linha.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Um valor máximo fixo de orçamento é alocado para o item de linha.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Nenhum limite de orçamento é aplicado ao item de linha.

PartnerRevenueModel

Configurações que controlam como a receita do parceiro é calculada.

Representação JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Campos
markupType

enum (PartnerRevenueModelMarkupType)

Obrigatório. O tipo de margem do modelo de receita do parceiro.
markupAmount

string (int64 format)

Obrigatório. O valor da marcação do modelo de receita do parceiro. Deve ser maior ou igual a 0.

  • Quando o markupType é definido como PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, esse campo representa a marcação de CPM em micros da moeda do anunciante. Por exemplo, 1500000 representa 1,5 unidades padrão da moeda.
  • Quando o markupType é definido como PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, esse campo representa a porcentagem de markup do custo de mídia em milissegundos. Por exemplo, 100 representa 0,1% (decimal 0,001).
  • Quando o markupType é definido como PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, esse campo representa o acréscimo percentual do custo de mídia total em milissegundos. Por exemplo, 100 representa 0,1% (decimal 0,001).

PartnerRevenueModelMarkupType

Possíveis tipos de markup do modelo de receita do parceiro.

Enums
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED O valor do tipo não foi especificado ou é desconhecido nesta versão.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Calcular a receita do parceiro com base em um CPM fixo.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Calcular a receita do parceiro com base em uma porcentagem de sobretaxa do custo de mídia.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Calcule a receita do parceiro com base em uma porcentagem de sobretaxa do custo de mídia total, que inclui todos os custos de parceiro e de dados.

ConversionCountingConfig

Configurações que controlam como as conversões são contabilizadas.

Todas as conversões pós-clique serão contabilizadas. É possível definir um valor percentual para a contagem de conversões pós-visualização.

Representação JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
Campos
postViewCountPercentageMillis

string (int64 format)

A porcentagem de conversões pós-visualização a serem contadas, em milissegundos (1/1000 de um por cento). Precisa estar entre 0 e 100.000 (inclusive).

Por exemplo, para rastrear 50% das conversões pós-clique, defina um valor de 50.000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

As configurações de atividade do Floodlight usadas para rastrear conversões.

O número de conversões contabilizadas é a soma de todas as conversões contadas por todos os IDs de atividade do Floodlight especificados neste campo.

Esse campo não pode ser atualizado se um algoritmo de lances personalizados estiver atribuído ao item de linha. Se você definir esse campo e atribuir um algoritmo de lances personalizados na mesma solicitação, as atividades do Floodlight precisarão corresponder às usadas pelo algoritmo de lances personalizados.

TrackingFloodlightActivityConfig

Configurações que controlam o comportamento de uma única configuração de atividade do Floodlight.

Representação JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Campos
floodlightActivityId

string (int64 format)

Obrigatório. O ID da atividade do Floodlight.
postClickLookbackWindowDays

integer

Obrigatório. O número de dias após um clique em um anúncio em que uma conversão pode ser contabilizada. Precisa estar entre 0 e 90 (inclusive).
postViewLookbackWindowDays

integer

Obrigatório. O número de dias após a visualização de um anúncio em que uma conversão pode ser contabilizada. Precisa estar entre 0 e 90 (inclusive).

LineItemWarningMessage

As mensagens de aviso geradas por um item de linha. Esses tipos de avisos não impedem o salvamento de um item de linha, mas podem impedir a veiculação dele.

Enums
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Não especificado ou desconhecido.
INVALID_FLIGHT_DATES Este item de linha tem períodos de veiculação inválidos. O item de linha não será veiculado.
EXPIRED A data de término deste item de linha é anterior à atual.
PENDING_FLIGHT Este item de linha vai começar a ser veiculado no futuro.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Todas as trocas ativadas de parceiros são segmentadas negativamente. O item de linha não será veiculado.
INVALID_INVENTORY_SOURCE Nenhuma origem de inventário ativa está sendo segmentada. O item de linha não será veiculado.
APP_INVENTORY_INVALID_SITE_TARGETING A segmentação de "Aplicativos e URLs" deste item de linha não inclui apps para dispositivos móveis. O tipo deste item de linha exige que você inclua apps para dispositivos móveis na segmentação de canal, aplicativos ou lista de sites. O item de linha não será veiculado.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Este item de linha não segmenta usuários de dispositivos móveis. O tipo deste item de linha exige que você segmente uma lista de usuários com usuários de dispositivos móveis. O item de linha não será veiculado.
NO_VALID_CREATIVE Este item de linha não contém um criativo válido. O item de linha não será veiculado.
PARENT_INSERTION_ORDER_PAUSED O pedido de inserção deste item de linha foi pausado. O item de linha não será veiculado.
PARENT_INSERTION_ORDER_EXPIRED O pedido de inserção deste item de linha está com a data de término definida para o passado. O item de linha não será veiculado.

MobileApp

Um app para dispositivos móveis promovido por um item de linha de instalação de app para dispositivos móveis.

Representação JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Campos
appId

string

Obrigatório. O ID do app fornecido pela loja da plataforma.

Os apps Android são identificados pelo ID do pacote usado pela Play Store do Android, como com.google.android.gm.

Os apps iOS são identificados por um ID de nove dígitos usado pela App Store da Apple, como 422689480.
platform

enum (Platform)

Apenas saída. A plataforma do app.
displayName

string

Apenas saída. O nome do app.
publisher

string

Apenas saída. O publisher do app.

Plataforma

Plataformas possíveis de apps para dispositivos móveis.

Enums
PLATFORM_UNSPECIFIED A plataforma não foi especificada.
IOS plataforma iOS.
ANDROID Plataforma Android.

YoutubeAndPartnersSettings

Configurações para itens de linha do YouTube e parceiros.

Representação JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Campos
viewFrequencyCap

object (FrequencyCap)

As configurações de limite de frequência de visualização do item de linha.

O campo maxViews nesse objeto de configurações precisa ser usado ao atribuir um limite restrito.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Opcional. As configurações de medição de terceiros do item de linha.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Configurações que controlam os inventários do YouTube e de parceiros que o item de linha vai segmentar.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Apenas saída. O tipo de conteúdo em que os anúncios do YouTube e parceiros serão veiculados.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Apenas saída. A categoria de conteúdo que entra em vigor ao veicular o item de linha. Quando a categoria de conteúdo é definida no item de linha e no anunciante, a mais restrita entra em vigor ao veicular o item de linha.

Os novos itens de linha vão herdar apenas a configuração no nível do anunciante.
targetFrequency

object (TargetFrequency)

Opcional. O número médio de vezes que você quer que os anúncios desse item de linha sejam exibidos para a mesma pessoa em um determinado período.
linkedMerchantId

string (int64 format)

Opcional. O ID do comerciante vinculado ao item de linha do feed de produtos.
relatedVideoIds[]

string

Opcional. Os IDs dos vídeos aparecem abaixo do anúncio em vídeo principal quando ele é exibido no app YouTube em dispositivos móveis.
leadFormId

string (int64 format)

Opcional. O ID do formulário para gerar leads.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Opcional. As configurações relacionadas a VideoAdSequence.
videoAdInventoryControl

object (VideoAdInventoryControl)

Opcional. As configurações para controlar qual inventário é permitido para esse item de linha.

ThirdPartyMeasurementConfigs

Configurações que controlam quais fornecedores terceirizados estão medindo métricas específicas de itens de linha.

Representação JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Campos
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Os fornecedores terceirizados que medem a visibilidade.

Os seguintes fornecedores terceirizados são aplicáveis:

  • 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
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Os fornecedores terceirizados que medem o brand safety.

Os seguintes fornecedores terceirizados são aplicáveis:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Os fornecedores terceirizados que medem o alcance.

Os seguintes fornecedores terceirizados são aplicáveis:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Os fornecedores terceirizados que medem o Brand Lift.

Os seguintes fornecedores terceirizados são aplicáveis:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_NIELSEN

ThirdPartyVendorConfig

Configurações que controlam como os fornecedores de medição terceirizados são configurados.

Representação JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Campos
vendor

enum (ThirdPartyVendor)

O fornecedor de medição terceirizada.
placementId

string

O ID usado pela plataforma do fornecedor terceirizado para identificar o item de linha.

ThirdPartyVendor

Fornecedores que realizam medições de terceiros.

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED Fornecedor terceirizado desconhecido.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Telemetria.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.

YoutubeAndPartnersInventorySourceConfig

Configurações que controlam quais inventários relacionados ao YouTube o item de linha do YouTube e parceiros vai segmentar.

Representação JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Campos
includeYoutube

boolean

Opcional. Indica se o inventário no YouTube deve ser segmentado. Isso inclui pesquisas, canais e vídeos.
includeGoogleTv

boolean

Opcional. Se você quer segmentar o inventário em apps de vídeo disponíveis no Google TV.
includeYoutubeVideoPartners

boolean

Se você quer segmentar o inventário em um conjunto de sites e apps parceiros que seguem os mesmos padrões de brand safety do YouTube.

YoutubeAndPartnersContentCategory

Categorias de brand safety para conteúdo do YouTube e de parceiros.

Enums
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED A categoria de conteúdo não foi especificada ou é desconhecida nesta versão.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Uma categoria que consiste em uma ampla variedade de conteúdo adequado para a maioria das marcas. O conteúdo é baseado nas diretrizes de conteúdo adequado para publicidade do YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Uma categoria que inclui todo o conteúdo no YouTube e em parceiros de vídeo que atende aos padrões de monetização.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Uma categoria que consiste em uma faixa reduzida de conteúdo que atende a requisitos mais rigorosos, especialmente em relação a linguagem imprópria e sugestividade sexual.

TargetFrequency

Configuração que controla o número médio de vezes que os anúncios serão mostrados para a mesma pessoa em um determinado período.

Representação JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Campos
targetCount

string (int64 format)

O número de vezes que os anúncios serão mostrados para a mesma pessoa, em média, no período ditado por timeUnit e timeUnitCount.
timeUnit

enum (TimeUnit)

A unidade de tempo em que a frequência desejada será aplicada.

A seguinte unidade de tempo é aplicável:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

O número de timeUnit que a frequência desejada vai durar.

As seguintes restrições se aplicam com base no valor de timeUnit:

  • TIME_UNIT_WEEKS: precisa ser 1

VideoAdSequenceSettings

Configurações relacionadas a VideoAdSequence.

Representação JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Campos
minimumDuration

enum (VideoAdSequenceMinimumDuration)

O intervalo mínimo antes que o mesmo usuário veja essa sequência novamente.
steps[]

object (VideoAdSequenceStep)

As etapas de que a sequência consiste.

VideoAdSequenceMinimumDuration

O enum para o possível tempo de intervalo mínimo antes que o mesmo usuário veja a VideoAdSequence novamente.

Enums
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Não especificado ou desconhecido.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 dias.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 dias.

VideoAdSequenceStep

O detalhe de uma única etapa em uma VideoAdSequence.

Representação JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Campos
stepId

string (int64 format)

O ID da etapa.
adGroupId

string (int64 format)

O ID do grupo de anúncios correspondente da etapa.
previousStepId

string (int64 format)

O ID da etapa anterior. A primeira etapa não tem uma etapa anterior.
interactionType

enum (InteractionType)

A interação na etapa anterior que vai levar o espectador a esta etapa. A primeira etapa não tem interactionType.

InteractionType

Os tipos de interação em uma etapa.

Enums
INTERACTION_TYPE_UNSPECIFIED Não especificado ou desconhecido
INTERACTION_TYPE_PAID_VIEW Uma visualização paga.
INTERACTION_TYPE_SKIP Pulado pelo espectador.
INTERACTION_TYPE_IMPRESSION Uma impressão de anúncio (visualizada).
INTERACTION_TYPE_ENGAGED_IMPRESSION Uma impressão de anúncio que não foi pulada imediatamente pelo espectador, mas também não atingiu o evento faturável.

VideoAdInventoryControl

O controle de inventário de anúncios em vídeo usado em determinados tipos de itens de linha do YouTube.

Representação JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
Campos
allowInStream

boolean

Opcional. Se os anúncios podem ser veiculados no formato in-stream.
allowInFeed

boolean

Opcional. Se os anúncios podem ser veiculados no formato In-feed.
allowShorts

boolean

Opcional. Se os anúncios podem ser veiculados no formato Shorts.

Métodos

bulkEditAssignedTargetingOptions

 Edita em massa as opções de segmentação em vários itens de linha.

bulkListAssignedTargetingOptions

 Lista as opções de segmentação atribuídas a vários itens de linha em diferentes tipos de segmentação.

bulkUpdate

 Atualiza vários itens de linha.

create

 Cria um item de linha.

delete

 Exclui um item de linha.

duplicate

 Duplica um item de linha.

generateDefault

 Cria um item de linha com configurações (incluindo segmentação) herdadas do pedido de inserção e um ENTITY_STATUS_DRAFT entity_status.

get

 Recebe um item de linha.

list

 Lista os itens de linha de um anunciante.

patch

 Atualiza um item de linha existente.