- Recurso: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Plataforma
- Métodos
Recurso: LineItem
um único item de linha;
Representação JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Campos | |
---|---|
name |
Apenas saída. Nome do recurso do item de linha. |
advertiserId |
Apenas saída. O ID exclusivo do anunciante ao qual o item de linha pertence. |
campaignId |
Apenas saída. O ID exclusivo da campanha à qual o item de linha pertence. |
insertionOrderId |
Obrigatório. Imutável. É o ID exclusivo do pedido de inserção a que o item de linha pertence. |
lineItemId |
Apenas saída. O ID exclusivo do item de linha. Atribuído pelo sistema. |
displayName |
Obrigatório. Nome de exibição do item de linha. Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes. |
lineItemType |
Obrigatório. Imutável. Tipo do item de linha. |
entityStatus |
Obrigatório. Controla se o item de linha pode ou não gastar o orçamento e dar lances no inventário.
|
updateTime |
Apenas saída. É o carimbo de data/hora em que o item de linha foi atualizado pela última vez. Atribuído pelo sistema. Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
partnerCosts[] |
Os custos do parceiro associados ao item de linha. Se estiver ausente ou vazio no método |
flight |
Obrigatório. É o horário de início e de término do período de veiculação do item de linha. |
budget |
Obrigatório. A configuração de alocação do orçamento do item de linha. |
pacing |
Obrigatório. A configuração da velocidade de gastos do orçamento do item de linha. |
frequencyCap |
Obrigatório. As configurações do limite de frequência de impressões do item de linha. O campo |
partnerRevenueModel |
Obrigatório. A configuração do modelo de receita do parceiro do item de linha. |
conversionCounting |
A configuração do acompanhamento de conversões do item de linha. |
creativeIds[] |
Os IDs dos criativos associados ao item de linha. |
bidStrategy |
Obrigatório. Estratégia de lances do item de linha. |
integrationDetails |
Detalhes da integração do item de linha. |
inventorySourceIds[] |
Os códigos das origens de inventário particulares atribuídas ao item de linha. |
targetingExpansion |
São as configurações de segmentação otimizada do item de linha. Esta configuração só é aplicável a itens de linha de display, vídeo ou áudio que usam lances automáticos e segmentam listas de público-alvo qualificadas positivamente. |
warningMessages[] |
Apenas saída. Mensagens de aviso geradas pelo item de linha. Esses avisos não impedem que o item de linha seja salvo, mas alguns podem impedir que ele seja executado. |
mobileApp |
O app para dispositivos móveis promovido pelo item de linha. Aplicável apenas quando |
reservationType |
Apenas saída. Tipo de reserva do item de linha. |
excludeNewExchanges |
Define se novas trocas devem ser segmentadas automaticamente pelo item de linha. Esse campo é falso por padrão. |
LineItemType
Tipos possíveis de um item de linha.
O tipo do 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 é 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 gráficos, HTML5, nativos ou rich media. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
Anúncios de display que geram instalações para um app. |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
São os anúncios em vídeo vendidos com base no CPM em vários ambientes. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
Anúncios em vídeo que impulsionam instalações de um aplicativo. |
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 do app 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 RTB vendidos para uma variedade de ambientes. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
Anúncios over-the-top estão 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 . |
LineItemFlight
Configurações que controlam a duração ativa de um item de linha.
Representação JSON |
---|
{ "flightDateType": enum ( |
Campos | |
---|---|
flightDateType |
Obrigatório. É o tipo de período de veiculação do item de linha. |
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.
|
triggerId |
O ID do acionador manual associado ao item de linha.
Aviso:os itens de linha que usam acionadores manuais não são mais veiculados no Display & Video 360. Este campo vai ser desativado em 1o de agosto de 2023. Leia nosso anúncio de descontinuação de recursos para mais informações. |
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 é 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 pai. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
O item de linha usa o próprio período de veiculação personalizado. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
O item de linha usa um acionador. Aviso:os itens de linha que usam acionadores manuais não são mais veiculados no Display & Video 360. Esse valor vai ser desativado em 1o de agosto de 2023. Leia nosso anúncio de descontinuação de recursos para mais informações. |
LineItemBudget
Configurações que controlam como o orçamento é alocado.
Representação JSON |
---|
{ "budgetAllocationType": enum ( |
Campos | |
---|---|
budgetAllocationType |
Obrigatório. O tipo de alocação do orçamento.
|
budgetUnit |
Apenas saída. A unidade de orçamento especifica se o orçamento é baseado na moeda ou nas impressões. Esse valor é herdado do pedido de inserção pai. |
maxAmount |
O valor máximo do orçamento que o item de linha vai gastar. Precisa ser maior que 0. Quando
|
LineItemBudgetAllocationType
Tipos possíveis de alocação de orçamento.
Enums | |
---|---|
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED |
O valor do tipo não é 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 fixo de orçamento máximo é alocado para o item de linha. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
Nenhum limite de orçamento foi aplicado ao item de linha. |
PartnerRevenueModel
Configurações que controlam como a receita do parceiro é calculada.
Representação JSON |
---|
{
"markupType": enum ( |
Campos | |
---|---|
markupType |
Obrigatório. O tipo de marcação do modelo de receita do parceiro. |
markupAmount |
Obrigatório. O valor da marcação do modelo de receita do parceiro. Deve ser maior ou igual a 0.
|
PartnerRevenueModelMarkupType
Tipos de marcação possíveis do modelo de receita do parceiro.
Enums | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
O valor do tipo não é especificado ou é desconhecido nesta versão. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
Calcule 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 sobretaxa percentual do custo de mídia. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
Calcular a receita do parceiro com base em uma sobretaxa percentual do custo de mídia total, que inclui todos os custos do parceiro e custos de dados. |
ConversionCountingConfig
Configurações que controlam como as conversões são contadas.
Todas as conversões pós-clique serão contadas. Um valor percentual pode ser definido para a contagem de conversões pós-visualização.
Representação JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Campos | |
---|---|
postViewCountPercentageMillis |
A porcentagem de conversões pós-visualização a serem contabilizadas, em milissegundos (1/1.000 de uma porcentagem). Precisa estar entre 0 e 100.000, inclusive. Por exemplo, para acompanhar 50% das conversões pós-clique, defina um valor de 50.000. |
floodlightActivityConfigs[] |
As configurações de atividade do Floodlight usadas para rastrear conversões. O número de conversões contadas é a soma de todas as conversões contadas por todos os IDs de atividade do Floodlight especificados nesse campo. |
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 |
Obrigatório. O ID da atividade do Floodlight. |
postClickLookbackWindowDays |
Obrigatório. O número de dias após o clique em um anúncio em que uma conversão pode ser contada. O valor precisa estar entre 0 e 90. |
postViewLookbackWindowDays |
Obrigatório. O número de dias após a visualização de um anúncio em que uma conversão pode ser contada. O valor precisa estar entre 0 e 90. |
TargetingExpansionConfig
São as definições que controlam as configurações de segmentação otimizada do item de linha.
Representação JSON |
---|
{
"targetingExpansionLevel": enum ( |
Campos | |
---|---|
targetingExpansionLevel |
Obrigatório. Indica se a segmentação otimizada está ativada. Esse campo é compatível com os seguintes valores:
Se este campo for definido com qualquer outro valor, ele será definido automaticamente como
|
excludeFirstPartyAudience |
Indica se públicos-alvo próprios devem ser excluídos do uso na expansão de segmentação. O uso desse campo foi suspenso com o lançamento da segmentação otimizada. Esse campo é definido como |
TargetingExpansionLevel
Configuração de segmentação otimizada.
Enums | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
A configuração de segmentação otimizada não foi especificada ou é desconhecida nesta versão. |
NO_EXPANSION |
A segmentação otimizada está desativada. |
LEAST_EXPANSION |
A segmentação otimizada está ativada. |
SOME_EXPANSION |
Se usado, será definido automaticamente como |
BALANCED_EXPANSION |
Se usado, será definido automaticamente como |
MORE_EXPANSION |
Se usado, será definido automaticamente como |
MOST_EXPANSION |
Se usado, será definido automaticamente como |
LineItemWarningMessage
Mensagens de aviso geradas por um item de linha. Esses tipos de aviso não bloqueiam o salvamento de um item de linha, mas podem impedir a execução dele.
Enums | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Não especificado ou desconhecido. |
INVALID_FLIGHT_DATES |
Este item de linha tem um período de veiculação inválido. O item de linha não será executado. |
EXPIRED |
A data de término deste item de linha está no passado. |
PENDING_FLIGHT |
Este item de linha começará a ser exibido 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á executado. |
INVALID_INVENTORY_SOURCE |
Nenhuma origem de inventário ativa está sendo segmentada. O item de linha não será executado. |
APP_INVENTORY_INVALID_SITE_TARGETING |
A segmentação "Apps e URLs" deste item de linha não inclui apps para dispositivos móveis. Este tipo de 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á executado. |
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 com usuários de dispositivos móveis. O item de linha não será executado. |
NO_VALID_CREATIVE |
Este item de linha não tem criativos válidos. O item de linha não será executado. |
PARENT_INSERTION_ORDER_PAUSED |
O pedido de inserção deste item de linha foi pausado. O item de linha não será executado. |
PARENT_INSERTION_ORDER_EXPIRED |
O pedido de inserção deste item de linha tem a data de término definida no passado. O item de linha não será executado. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
Este item de linha não segmenta listas de públicos-alvo, e isso pode fazer com que seu orçamento seja gasto muito rapidamente. |
APP_INSTALL_NO_CONVERSION_PIXEL |
Este item de linha de instalação de app não tem pixels de conversão configurados. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
Este item de linha segmenta uma ou mais listas de usuários que não estão mais disponíveis. No futuro, isso impedirá que o item de linha seja veiculado. Por isso, considere remover essas listas da sua segmentação. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Este item de linha de instalação do aplicativo não tem uma estratégia de lances otimizada. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
As transações segmentadas por este item de linha aceitam tamanhos de criativo que não estão em uso. Isso pode limitar a exibição ou o desempenho do item de linha. |
NO_CREATIVE_FOR_TARGETED_DEALS |
O item de linha não tem criativos para as transações segmentadas. |
TARGETING_DEPRECATED_GEO_TARGET |
Este item de linha segmenta uma segmentação por área geográfica que foi descontinuada. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Este item de linha usa a configuração Atualize a integração da API para excluir diretamente todos os públicos-alvo próprios usando a segmentação por público-alvo antes de 25 de março de 2023 e considere a desativação do campo |
MobileApp
Um app para dispositivos móveis promovido por um item de linha de instalação de apps para dispositivos móveis.
Representação JSON |
---|
{
"appId": string,
"platform": enum ( |
Campos | |
---|---|
appId |
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 Os apps iOS são identificados por um ID de app de nove dígitos usado pela App Store da Apple, como |
platform |
Apenas saída. A plataforma do app. |
displayName |
Apenas saída. O nome do app. |
publisher |
Apenas saída. O editor do app. |
Plataforma
Possíveis plataformas de apps para dispositivos móveis.
Enums | |
---|---|
PLATFORM_UNSPECIFIED |
A plataforma não está especificada. |
IOS |
Plataforma iOS. |
ANDROID |
Plataforma Android. |
Métodos |
|
---|---|
|
edita em massa as opções de segmentação em um único item de linha; |
|
Lista as opções de segmentação atribuídas a um item de linha nos tipos de segmentação. |
|
Cria um novo item de linha. |
|
Exclui um item de linha. |
|
Cria um novo item de linha com configurações (incluindo segmentação) herdadas do pedido de inserção e ENTITY_STATUS_DRAFT entity_status . |
|
Recebe um item de linha. |
|
Lista os itens de linha em um anunciante. |
|
Atualiza um item de linha existente. |