Dados estruturados: v7 – 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úncios bumper TrueView do YouTube
  • Alcance do TrueView do YouTube
  • Áudio do YouTube
  • Frequência desejada do bumper opcional
  • Frequência desejada não pulada
  • Frequência desejada que pode ser pulada
  • Bumper de frequência desejada
  • Anúncio bumper do Google Preferred
  • Short do Google Preferred
  • Google Preferred Long
  • Anúncios in-stream não puláveis de 30 segundos do Google Preferred
  • YouTube Shorts do Google Preferred
  • Reserva padrão
  • Reserva longa padrão
  • In-stream não pulável
  • Particular (editor)
  • Privada (origem de inventário)
  • Particular (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 DD/MM/AAAA HH:mm
OrçamentoNãofloatNãoUm valor de orçamento positivo para o produto de mídia. É sempre um número flutuante para um valor de moeda, já que sempre será um orçamento monetário. As moedas vão ser 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" for "TRUE"número inteiroSimUm valor inteiro positivo para o número de impressões em um determinado valor de frequência, ou seja, o x em "Mostrar x impressões no período y".
Período de frequênciaObrigatório quando "Frequency Enabled" for "TRUE"stringSim
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
  • Todo o período
Valor da frequênciaObrigatório quando "Frequency Enabled" for "TRUE"número inteiroSim
Segmentação geográfica: incluirNãostring, listaSim

Lista de localidades a serem incluídas na segmentação.

Essa coluna usa os IDs de recurso 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, listaSim

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

Essa coluna usa os IDs de recurso 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, listaSim

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

Essa coluna usa os IDs de recurso 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, listaSim

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

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

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

Segmentação por canal: excluirNãostring, listaSim

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

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

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

Segmentação por categoria: incluirNãostring, listaSim

Lista de categorias a serem incluídas na segmentação. Essa coluna usa os IDs de recurso 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, listaSimLista de categorias a serem excluídas da segmentação. Essa coluna usa os IDs de recurso 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 listas de público-alvo a serem incluídas na segmentação.

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

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

Os valores de recência válidos são:

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

Lista de listas de público-alvo a serem excluídas na segmentação.

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

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

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

Os valores de recência válidos são:

  • todas
  • 1 m
  • 5min
  • 10 min
  • 15min
  • 30min
  • 1h
  • 2h
  • 3h
  • 6h
  • 12h
  • 1 d
  • 2d
  • 3 dias
  • 5 d
  • 7d
  • 10 dias
  • 14d
  • 15d
  • 21d
  • 28d
  • 30d
  • 45 dias
  • 60 d
  • 90d
  • 120d
  • 180 dias
  • 270 dias
  • 365 dias
Segmentação por afinidade e no mercado: incluirNãostring, listaSim
Segmentação por afinidade e no mercado: excluirNãostring, listaSim
Segmentação demográfica: gêneroNãostring, listaSimLista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitos:
  • Feminino
  • Masculino
  • Desconhecido
Segmentação demográfica por idadeNãostring, listaSimSegmentar por faixa etária. Especifique um intervalo de "de/até" selecionando uma única idade de início e uma única idade de término e se deseja incluir idades desconhecidas (verdadeiro/falso). Consulte a lista de idades de início/término aceitáveis.
Exemplo 1: para segmentar pessoas de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Até ; Incluir idades desconhecidas Verdadeiro/Falso} = 18;55;true;
Exemplo 2: para segmentar apenas usuários com mais de 35 anos e excluir idades desconhecidas, especifique o seguinte = 35;+;false;.
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: status parentalSimstring, listaSimLista 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, listaSim

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

Essa coluna usa os 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, listaSimLista de tamanhos de player de anúncios em vídeo para segmentação. Selecione um ou mais dos valores aceitos:
  • desconhecido
  • pequeno
  • grande
  • HD
Particular - Nome do vendedorNãostringNãoO nome do editor em uma transação. Este campo se aplica apenas a produtos de mídia privada.
Privado: ID do pedidoNãostringNãoO ID do pedido de uma transação garantida. Este campo se aplica apenas a produtos de mídia privada.
Privado: ID da origem de inventárioNãostringNãoO ID do DBM da origem do inventário. Este campo se aplica apenas a produtos de mídia privada.