Dados estruturados - v9.1 - Produto de mídia

Consulte a visão geral para uma explicação do formato.

CampoObrigatórioTipoGravávelDescrição
ID do produtoNãonúmero inteiroNãoÉ o valor do ID numérico do produto de mídia.
ID do planoNãonúmero inteiroNãoÉ o valor do ID numérico da proposta de mídia.
ID da campanhaNãonúmero inteiroNão
NomeSimstringSimO nome da entrada.
TipoNãostringNãoTipo do produto de mídia.
  • Display de leilão aberto
  • Áudio de leilão aberto
  • Vídeo de leilão aberto
  • Campanha para visualizações de vídeo
  • Alcance eficiente
  • TrueView in-stream do YouTube
  • TrueView Discovery do YouTube
  • Anúncio bumper TrueView do YouTube
  • Alcance do TrueView do YouTube
  • Áudio do YouTube
  • Vídeo bumper pulável de frequência desejada
  • Frequência desejada não pulável
  • Frequência desejada pulável
  • Bumper de frequência desejada
  • Bumper do Google Preferred
  • Short do Google Preferred
  • Google Preferred Long
  • In-stream não pulável de 30 segundos do Google Preferred
  • Shorts do YouTube do Google Preferred
  • Short de reserva padrão
  • Reserva padrão longa
  • In-stream não pulável
  • Privado (publisher)
  • Privada (origem de inventário)
  • Privada (negociação)
  • Geração de demanda
Data de inícioNãostringNãoA data de início do produto de mídia no formato MM/DD/AAAA HH:mm
Data de términoNãostringNãoA data de término do produto de mídia no formato MM/DD/AAAA HH:mm
OrçamentoNãofloatNãoUm valor de orçamento positivo para o produto de mídia. É sempre um ponto flutuante para um valor monetário, já que será sempre um orçamento monetário. As moedas serão mostradas na moeda do anunciante em unidades padrão (não em 1/1.000.000 de uma unidade monetária).
Frequência ativadaSimstringSim
Exposições de frequênciaObrigatório quando "Frequency Enabled" é "TRUE"número inteiroSimUm número inteiro positivo para a quantidade de impressões em um determinado valor de frequência, ou seja, o x em "Mostrar x impressões em um período y".
Período de frequênciaObrigatório quando "Frequency Enabled" é "TRUE"stringSim
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
  • Todo o período
Valor da frequênciaObrigatório quando "Frequency Enabled" é "TRUE"número inteiroSim
Segmentação geográfica: incluirNãostring, listSim

Lista de regiões geográficas a serem incluídas na segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_GEO_REGION.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por idioma: incluirNãostring, listSim

Lista de idiomas a serem incluídos na segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_LANGUAGE.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por idioma - ExcluirNãostring, listSim

Lista de idiomas a serem excluídos da segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_LANGUAGE.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por canal: incluirNãostring, listSim

Lista de canais a serem incluídos na segmentação.

Essa coluna usa IDs de recursos Channel da API Display & Video 360.

Formato da lista = (Channel.channelId; Channel.channelId; etc.).

Segmentação por canal - ExcluirNãostring, listSim

Lista de canais a serem excluídos da segmentação.

Essa coluna usa IDs de recursos Channel da API Display & Video 360.

Formato da lista = (Channel.channelId; Channel.channelId; etc.).

Segmentação por categoria – incluirNãostring, listSim

Lista de categorias a serem incluídas na segmentação. Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_CATEGORY.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por categoria - ExcluirNãostring, listSimLista de categorias a serem excluídas na segmentação. Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_CATEGORY.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por público-alvo: incluirNãostring, lista de listas de paresSim

Lista de públicos-alvo a serem incluídos na segmentação.

Essa coluna usa IDs de recursos FirstPartyAndPartnerAudience da API Display & Video 360.

Para listas de público-alvo próprias, cada público-alvo é listado como um par de FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId e configuração de tempo para retorno. Um par é (1;1d;), em que 1d é uma atualização de amostra que representa uma atualização de um dia. A atualização não está disponível para públicos-alvo de terceiros. Portanto, o formato da lista é (3;);(4;);. Para usar "E" e "OU" em grupos de públicos-alvo, siga este exemplo: para combinar pares com e sem atualização: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. Isso significa (lista 1 com um dia de atualização OU lista 2 com 365 dias de atualização) E (lista 3 sem uma atualização especificada OU lista 4 com cinco minutos de atualização OU lista 5 com todos os usuários).

Os valores de atualização válidos são:

  • todas
  • 1 m
  • 5min
  • 10min
  • 15min
  • 30min
  • 1h
  • 2h
  • 3h
  • 6h
  • 12h
  • 1 d
  • 2d
  • 3 dias
  • 5 d
  • 7d
  • 10d
  • 14d
  • 15d
  • 21d
  • 28d
  • 30d
  • 45d
  • 60d
  • 90d
  • 120d
  • 180d
  • 270d
  • 365d
Segmentação por público-alvo: exclusãoNãostring, lista de listas de paresSim

Lista de públicos-alvo a serem excluídos na segmentação.

Essa coluna usa IDs de recursos FirstPartyAndPartnerAudience da API Display & Video 360.

Cada público-alvo é listado como um par de FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId e configuração de tempo para retorno, se a lista de público-alvo for própria. Um par é (1;1d;), em que 1d é uma atualização de amostra que representa uma atualização de um dia. No entanto, para públicos-alvo de terceiros, a atualização não está disponível. Portanto, o formato da lista é (3;);(4;);.

Formato da lista = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)
Exemplo: "(1;1d;);(2;);".

Os valores de atualização válidos são:

  • todas
  • 1 m
  • 5min
  • 10min
  • 15min
  • 30min
  • 1h
  • 2h
  • 3h
  • 6h
  • 12h
  • 1 d
  • 2d
  • 3 dias
  • 5 d
  • 7d
  • 10d
  • 14d
  • 15d
  • 21d
  • 28d
  • 30d
  • 45d
  • 60d
  • 90d
  • 120d
  • 180d
  • 270d
  • 365d
Segmentação por público-alvo no mercado e de afinidade: incluirNãostring, listSim
Segmentação por afinidade e no mercado - ExcluirNãostring, listSim
Segmentação demográfica por gêneroNãostring, listSimLista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis:
  • Feminino
  • Masculino
  • Desconhecido
Idade da segmentação demográficaNãostring, listSimSegmentar por faixa etária do usuário. Especifique um intervalo de "De" e "Até" selecionando uma idade inicial e uma idade final e se você quer incluir idades desconhecidas (verdadeiro/falso). Confira a lista de idades "De/Até" aceitáveis.
Exemplo 1: para segmentar de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Até ; Incluir desconhecidas Verdadeiro/Falso} = 18;55;verdadeiro;
Exemplo 2: para segmentar apenas usuários com mais de 35 anos e excluir idades desconhecidas, especifique o seguinte = 35;+;falso;.
Valores aceitáveis para "De":
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

Valores aceitáveis para "Para":
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
Segmentação demográfica por status parentalSimstring, listSimLista de status parentais a serem segmentados. Selecione um ou mais dos valores aceitáveis.
  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação por dispositivo: incluirNãostring, listSim

Lista de dispositivos a serem incluídos na segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para os seguintes tipos de segmentação:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por tamanho do player de vídeoNãostring, listSimLista de tamanhos do player de anúncio em vídeo para segmentação. Selecione um ou mais dos valores aceitáveis:
  • desconhecido
  • pequeno
  • grande
  • HD
Privado: nome do vendedorNãostringNãoO nome do publisher em uma transação. Esse campo se aplica apenas a produtos de mídia particulares.
Privado - ID do pedidoNãostringNãoO ID do pedido de uma transação garantida. Esse campo se aplica apenas a produtos de mídia particulares.
Privada: ID da origem de inventárioNãostringNãoO ID do DBM da origem de inventário. Esse campo se aplica apenas a produtos de mídia particulares.