Dados estruturados: v4.1: pedido de inserção

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

CampoObrigatórioTipoGravávelDescrição
ID de pedido de inserçãoObrigatório apenas ao editar pedidos de inserção existentesnúmero inteiroNãoÉ o valor do ID numérico do pedido de inserção. Se o campo for deixado em branco, um novo ID de pedido de inserção será criado e um ID exclusivo será atribuído. Como opção, ao criar um novo pedido de inserção, é possível usar um identificador personalizado para atribuir itens de linha a ele. O formato do identificador personalizado é "ext[identificador personalizado]", por exemplo, ext123. Quando o arquivo for enviado e processado, todos os identificadores personalizados serão substituídos por IDs atribuídos pelo DBM, e os objetos serão associados (por exemplo, do item de linha a um pedido de inserção) com base nos identificadores personalizados.
ID da campanhaNãonúmero inteiroNãoÉ o valor do ID numérico da campanha. É possível especificar um identificador personalizado (por exemplo, "ext[identificador de campanha personalizado]") para uma campanha criada ao mesmo tempo que este pedido de inserção.
NomeSimstringSimO nome da entrada.
Carimbo de data/horaObrigatório ao editar entradas existentesnúmero inteiroNãoO carimbo de data/hora da entrada, usado pelo sistema para verificar se a entrada não mudou entre o download e o upload.
StatusSimstringSimA configuração de status da entrada.
  • Ativo
  • Pausado
  • Rascunho
  • Arquivado
  • Excluído
Tipo de pedido de inserçãoSimstringSimO tipo de pedido de inserção. Configurável apenas na criação.
  • padrão
TaxasNãostring, lista de listasSimTodas as taxas desta entrada. Formato da lista = (categoria da taxa; valor da taxa; tipo de taxa; faturada;).
  • Categoria da taxa
    • CPM
    • Mídia
  • Valor da taxa
    • Ponto flutuante
    • Parcela como ponto flutuante
  • Tipo de taxa
    • (string, consulte a tabela em taxas)
  • Faturado
    • Verdadeiro
    • Falso
    • em branco

Exemplo '(CPM; 2; Taxa do Bid Manager; Falso) ; (Mídia; 13; Padrão; Verdadeiro);'
Os valores aceitáveis são fornecidos na tabela a seguir:

Observação: a taxa de CPM de taxas premium é reservada pelo sistema e não pode ser alterada. A cardinalidade da taxa premium é preservada entre as mutações, inserindo taxas de CPM padrão, se necessário.

Categoria da taxaTipo de tarifaOpção com fatura
CPM/mídiaPadrãoNão permitido (deixe em branco)
CPM/mídiaServidor de anúncios de terceirosNão permitido (deixe em branco)
CPM/mídiaDoubleVerifyPermitido (verdadeiro/falso)
CPM/mídiaAdsafeNão permitido (deixe em branco)
CPM/mídiaAdxposeNão permitido (deixe em branco)
CPM/mídiaVizuNão permitido (deixe em branco)
CPM/mídiaAggregate KnowledgeNão permitido (deixe em branco)
CPM/mídiaTeracentNão permitido (deixe em branco)
CPM/mídiaEvidonNão permitido (deixe em branco)
CPM/mídiaTaxa das agências negociadorasNão permitido (deixe em branco)
CPM/mídiaAdlooxPermitido (verdadeiro/falso)
CPMShopLocalObrigatório (verdadeiro)
CPMTrustMetricsNão permitido (deixe em branco)
CPMVídeo da Integral Ad SciencePermitido (verdadeiro/falso)
CPMVídeo da MOATNão permitido (deixe em branco)
MídiaTaxa do Bid ManagerObrigatório (verdadeiro)
MídiaDados de custo de mídiaNão permitido (deixe em branco)
CPMTaxas premiumNão permitido (deixe em branco)
Código de integraçãoNãostringSimUm código opcional para fins de rastreamento.
DetalhesNãostringSimDetalhes da entrada em formato de string.
RitmoSimstringSimO período usado para gastar para o valor do ritmo.
  • Diário
  • Mensal
  • Voos
Taxa de ritmoSimstringSimA taxa de ritmo desta entrada.
  • Assim que possível
  • Uniforme
  • Adiante
Valor do ritmoSimfloatSimÉ o valor a ser gasto pelo período definido pelo tipo de ritmo.
Frequência ativadaSimstringSimAtiva/desativa o limite de frequência baseado em impressão no pedido de inserção.
  • VERDADEIRO
  • FALSO
Exposições de frequênciaObrigatório quando "Frequência ativada" é "VERDADEIRO"número inteiroSimUm valor inteiro positivo para o número de impressões em determinado valor de frequência, ou seja, o x em "Exibir x impressões ao longo de y".
Período de frequênciaObrigatório quando "Frequência ativada" é "VERDADEIRO"stringSimEspecifica a unidade do período para o limite de frequência.
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
  • Todo o período
Valor da frequênciaObrigatório quando "Frequência ativada" é "VERDADEIRO"número inteiroSimUm valor inteiro positivo para a duração do tipo de período de frequência, ou seja, o y em "Exibir x impressões ao longo de y".
Tipo de meta de desempenhoSimstringSimA unidade da meta do pedido de inserção
  • CPM
  • CPA
  • CPC
  • CPV
  • Custo por impressão audível e visível na conclusão (CPIAVC, na sigla em inglês)
  • CTR
  • Porcentagem de visibilidade
  • Nenhum
  • Outro
Valor da meta de desempenhoSimstringSimO valor da meta em moeda (CPM, CPA, CPC, CPV, CPIAVC), porcentagem (% de visibilidade, CTR) ou como uma string (Outro).
Medir o revendedor autorizado de distribuiçãoSimstringSimAtiva/desativa a medição de público-alvo usando a Nielsen Digital Ad Ratings
  • VERDADEIRO
  • FALSO
Medir canal de revendedor autorizado de distribuiçãoObrigatório ao "Medir dados de revendedor autorizado de distribuição" é "VERDADEIRO"número inteiroSimÉ o canal a ser medido com a Nielsen Digital Ad Ratings. Formato = UniversalChannel.id
Tipo de orçamentoSimstringSimEspecifica o tipo de orçamento em termos de um valor de "receita" para gastar (valor) ou um número de impressões (impressões) para comprar.
  • Valor
  • Impressões
Segmentos de orçamentoSimstring, lista de listasSimEspecifica os segmentos de orçamento específicos. Formato da lista = (orçamento, data de início, data de término). O orçamento está no formato flutuante de moeda. As datas estão no formato MM/DD/AAAA. Exemplo: "(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);"
Alocação automática de orçamentoSimstringSimAtiva/desativa a alocação automática de orçamento
  • VERDADEIRO
  • FALSO
Segmentação geográfica - IncluirNãostring, listaSimLista de regiões geográficas a serem incluídas na segmentação. Formato da lista = (GeoLocation.id; GeoLocation.id; etc.).
Segmentação geográfica: excluirNãostring, listaSimLista de regiões geográficas a serem excluídas da segmentação. Formato da lista = (GeoLocation.id;GeoLocation.id; etc.).
Segmentação por idioma: incluirNãostring, listaSimLista de idiomas a serem incluídos na segmentação. Formato da lista = (Language.id;Language.id;etc.).
Segmentação por idioma: excluirNãostring, listaSimLista de idiomas a serem excluídos da segmentação. Formato da lista = (Language.id;Language.id;etc.).
Segmentação por dispositivo: incluirNãostring, listaSimLista de dispositivos a serem incluídos na segmentação. Formato da lista = (DeviceCriteria.id;DeviceCriteria.id;etc.).
Segmentação por dispositivo: excluirNãostring, listaSimLista de dispositivos a serem excluídos da segmentação. Formato da lista = (DeviceCriteria.id;DeviceCriteria.id;etc.).
Segmentação por navegador: incluirNãostring, listaSimLista de navegadores a serem incluídos na segmentação. Formato da lista = (ID do navegador; ID do navegador; etc.).
Segmentação por navegador: excluirNãostring, listaSimLista de navegadores a serem excluídos da segmentação. Formato da lista = (ID do navegador; ID do navegador; etc.).
Rótulos de brand safetyNãostring, listaSimLista de classificações de conteúdo digital a serem segmentadas. Formato da lista = (G;PG; etc.).
  • G
  • PG
  • T
  • MA
  • ?
Configuração de sensibilidade de brand safetyNãostringSimEscolha a configuração de sensibilidade para bloquear inventário com base no conteúdo relacionado.
  • Não bloquear
  • Usar a Verificação da DoubleClick
  • Usar personalizado
Configurações personalizadas de brand safetyObrigatório ao definir a "Configuração personalizada de brand safety" é "Usar personalizado"string, listaSimSe a configuração de sensibilidade de brand safety for "Usar personalizado", especifique a lista de classificadores de conteúdo padrão. Por exemplo, (Adulto; Álcool; Tabaco etc.).
  • Adulto
  • Depreciativo
  • Downloads e Compartilhando
  • Armas
  • Jogos de azar
  • Violência
  • Sugestivo
  • Linguagem obscena
  • Bebidas alcoólicas
  • Drogas
  • Tabaco
  • Política
  • Religião
  • Tragédia
  • Acidentes de transporte
  • Problemas sociais sensíveis
  • Chocante
Serviços de verificação de terceirosNãostringSimProvedor terceirizado de serviços de verificação.
  • Nenhum
  • Integral Ad Science
  • DoubleVerify
  • Adloox
Rótulos de verificação de terceirosNãostring, listaSimSe a opção "Serviços de verificação de terceiros" não for "Nenhum", especifique uma lista de marcadores aceitos pelo provedor selecionado.
Segmentação de canal - IncluirNãostring, listaSimLista de canais a serem incluídos na segmentação. Formato de lista = (UniversalChannel.id;UniversalChannel.id; etc.).
Segmentação de canal: excluirNãostring, listaSimLista de canais a serem incluídos na segmentação. Formato de lista = (UniversalChannel.id;UniversalChannel.id; etc.).
Segmentação por site - IncluirNãostring, listaSimLista de sites a serem incluídos na segmentação. A lista pode incluir um conjunto de IDs de sites ou strings de URLs caso elas não sejam encontradas na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).
Segmentação por site: excluirNãostring, listaSimLista de sites a serem excluídos da segmentação. A lista pode incluir um conjunto de IDs de sites ou strings de URLs caso elas não sejam encontradas na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).
Segmentação por aplicativo: incluirNãostring, listaSimLista de apps a serem incluídos na segmentação. A lista pode incluir um conjunto de IDs do UniversalSite ou strings de pacotes de apps se não forem encontrados na tabela "Site universal". Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação por aplicativo: excluirNãostring, listaSimLista de apps a serem excluídos da segmentação. A lista pode incluir um conjunto de IDs do UniversalSite ou strings de pacotes de apps se não forem encontrados na tabela "Site universal". Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação por coleção de apps: incluirNãostring, listaSimLista de coleções de apps a serem incluídas na segmentação. List format= ID da coleção do app ID da coleção de apps
Segmentação por coleção de apps: excluirNãostring, listaSimLista de coleções de apps a serem excluídas da segmentação. List format= ID da coleção do app ID da coleção de apps
Segmentação por categoria: incluirNãostring, listaSimLista de categorias a serem incluídas na segmentação, de códigos de indústrias do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).
Segmentação por categoria: excluirNãostring, listaSimLista de categorias a serem excluídas da segmentação, dos códigos de indústrias do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).
Segmentação por palavra-chave - IncluirNãostring, listaSimLista de strings de palavras-chave a serem incluídas na segmentação.
Segmentação por palavras-chave: excluirNãostring, listaSimLista de strings de palavras-chave a serem excluídas da segmentação.
Segmentação da lista de palavras-chave: excluirNãostring, listaSimLista de listas de palavras-chave negativas a serem excluídas da segmentação. List format= ID da lista de palavras-chave negativas ID da lista de palavras-chave negativas
Segmentação por público-alvo: públicos-alvo semelhantesObrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"stringSim Ative os públicos-alvo semelhantes para listas próprias segmentadas positivamente.
  • VERDADEIRO
  • FALSO
Segmentação por público-alvo – IncluirNãostring, lista de paresSimÉ uma lista de listas de público-alvo a serem incluídas na segmentação. Para listas de público-alvo próprio, cada público-alvo é listado como um par de ID da PCollection e de configuração de tempo para retorno. Um par é (1;1d;), em que 1d é uma amostra de tempo para retorno que representa um dia de tempo para retorno. O tempo para retorno não está disponível para públicos-alvo de terceiros, portanto, o formato da lista é (3;);(4;);. Para "AND" e "OR" grupos de públicos-alvo, siga este exemplo: Para combinar pares com e sem tempo para retorno: " ((1;1d;);(2;365d;);((3;);(4;5m;);(5;all;;").

Segmentação por público-alvo: excluirNãostring, lista de paresSimLista de listas de público-alvo a serem excluídas da segmentação. Se a lista de público-alvo for própria, cada público-alvo será listado como um par de ID da lista de usuários e uma configuração de tempo para retorno. Um par é (1;1d;), em que 1d é uma amostra de tempo para retorno que representa um dia de tempo para retorno. No entanto, para públicos-alvo de terceiros, o tempo para retorno não está disponível, portanto, o formato da lista é (3;);(4;);. List format= (PCollection.id; recency opcional;);


Afinidade e Segmentação no mercado - IncluirNãostring, listaSimÉ uma lista de públicos-alvo no mercado e/ou afinidade para incluir. List format= ID da lista de usuários ID da lista de usuários
Afinidade e Segmentação no mercado: excluirNãostring, listaSimÉ uma lista de públicos-alvo de afinidade e/ou no mercado a serem excluídos. List format= ID da lista de usuários ID da lista de usuários
Segmentação por lista personalizadaNãostring, listaSimLista de listas personalizadas para segmentação. List format= ID da lista de usuários ID da lista de usuários
Segmentação da origem de inventário – somente vendedor autorizadoObrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"stringSimConfiguração para segmentar apenas vendedor autorizado, vendedor e revendedores autorizados ou vendedor autorizado + desconhecido. "Direto autorizado" significa que apenas vendedores autorizados serão segmentados. VERDADEIRO significa segmentar os vendedores e revendedores autorizados. FALSO significa que ele segmentará vendedores autorizados, revendedores e vendedores desconhecidos.
  • VERDADEIRO
  • FALSO
  • Direto autorizado
Segmentação da origem de inventário: incluirNãostring, listaSimLista de inventários a serem incluídos na segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário: excluirNãostring, listaSimLista de inventários a serem excluídos da segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário: segmentar novas trocasNãostringSimConfiguração para segmentar novas trocas.
  • Verdadeiro
  • Falso
Segmentação por período do diaNãostring, listaSim, em que cada um desses IDs é criado com o formato:
daypart_id = base_daypart







Um número inteiro de 0 a 95, representando slots de 15 minutos
start < end
Para novas entidades, os horários serão definidos no fuso horário dos usuários (por exemplo, "Local"). No caso das entidades atuais, o fuso horário não será alterado.
Fuso horário de segmentação por período do diaObrigatório quando "Segmentação por período do dia" está incluído.stringSimFuso horário a ser usado para segmentação por período do dia.
  • Local
  • Advertiser
Segmentação por ambienteObrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"string, listaSimLista de ambientes para segmentar. Formato da lista = (Web para computadores, App para dispositivos móveis etc.).
Para ambiente de exibição:
  • Web para computadores
  • Web para dispositivos móveis
  • App para dispositivos móveis
  • Intersticial de app para dispositivos móveis
  • Web para computadores em dispositivos móveis
Para vídeo:
  • Vídeo da Web para computadores
  • Jogo da Web para computadores
  • In-Read da Web para computadores
  • In-feed da Web para computadores
  • Vídeo da Web para dispositivos móveis
  • Vídeo de app para dispositivos móveis
  • Intersticial em vídeo do app para dispositivos móveis
Para áudio:
  • Áudio da Web para computadores
  • Áudio da Web para dispositivos móveis
  • Áudio de app para dispositivos móveis
Segmentação de visibilidade do Active ViewNãostringSimPorcentagem de visibilidade prevista desejada. As porcentagens são representadas como flutuações. Um de {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Posição do anúncio de segmentação por visibilidade - IncluirNãostringSimSegmentar posições de anúncio. Selecione um ou nenhum dos valores aceitáveis:
  • Todos
  • ATF
  • BTF
  • Desconhecido
Posição do anúncio com segmentação por visibilidade: excluirNãostringSimExclua posições de anúncio na segmentação. Selecione um ou nenhum dos valores aceitáveis:
  • ATF
  • BTF
  • Desconhecido
Segmentação por posição do anúncio em vídeoNãostring, listaSimLista de posições de anúncios em vídeo para segmentar. Selecione um ou mais dos valores aceitáveis:
  • desconhecido
  • Anúncio precedente
  • Durante a exibição
  • Anúncio final
Segmentação por tamanho do player de vídeoNãostring, listaSimLista de tamanhos do player de anúncios em vídeo a serem segmentados. Selecione um ou mais dos valores aceitáveis:
  • desconhecido
  • pequeno
  • grande
  • HD
Segmentação demográfica por gêneroNãostring, listaSimLista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis:
  • Feminino
  • Masculino
  • Desconhecido
Segmentação demográfica IdadeNãostring, listaSimSegmentar a faixa etária do usuário. Especifique um intervalo de/para selecionando uma única idade "De" e uma única idade "Para" e se você quer incluir idades desconhecidas como verdadeiro/falso. Veja a lista de faixas etárias "De/Até" aceitáveis.
Exemplo 1: para segmentar de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Para ; Incluir Verdadeiro/Falso desconhecido} = 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 por renda familiarNãostring, listaSimSegmente uma faixa de renda familiar. Especifique um intervalo de/para selecionando uma faixa de renda Top_of_Range e uma única faixa de renda Bottom_of_Range e se deseja incluir famílias com renda desconhecida como verdadeiro/falso. Veja a lista de intervalos Top_of_Range/Bottom_of_Range aceitáveis.
Exemplo 1: para segmentar os 10% a 50% das famílias com maior renda e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Incluir desconhecido Verdadeiro/Falso} = Principais 10%;41-50%;true;
Exemplo 2: para segmentar apenas os 50% com menor renda das famílias e excluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Incluir Verdadeiro/Falso desconhecidos} = Menores 50%;Menores 50%;verdadeiro;
Valores aceitáveis para Top_do_Intervalo/Inferior_do_Intervalo:
  • Os 10% com maior renda
  • De 11% a 20%
  • De 21% a 30%
  • De 31% a 40%
  • De 41% a 50%
  • Os 50% com menor renda

Segmentação demográfica: status parentalSimstring, listaSimLista de status parentais a serem segmentados. Selecione um ou mais valores aceitáveis.
  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação por velocidade de conexãoNãostringSimSegmente uma velocidade de conexão específica. Selecione um dos valores aceitáveis:
  • Todos
  • 2G
  • 3G
  • DSL
  • 4G
Segmentação por operadora: incluirNãostring, listaSimLista de ISPs ou operadoras a serem segmentadas. List format = {ISP.id; ISP.id;}
Segmentação por operadora: excluirNãostring, listaSimLista de ISPs ou operadoras a serem excluídas. List format = {ISP.id; ISP.id;}