Dados estruturados: v5.2: 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
Tipo de pedido de inserçãoSimstringSimO tipo de pedido de inserção. Configurável apenas na criação.
  • padrão
Resultado faturávelSimstringSimResultado faturável.

A compra com base em resultados foi descontinuada. "Impressão" é o único valor válido.

  • Impressã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 Display & Video 360; Falso); (Mídia; 13; Padrão; Verdadeiro);'
Os valores aceitáveis são fornecidos na tabela a seguir:

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ídiaRede de Display e Taxa do Video 360Obrigatório (verdadeiro)
MídiaDados de custo de mídiaNã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
  • CPE
  • CVR de cliques
  • CVR de impressões
  • VCPM
  • VTR
  • Tx. conclusão de áudio
  • Tx. conclusão de vídeo
  • CPCL
  • CPCV
  • TOS10
  • Maximizar o ritmo
  • Valor de impressão personalizada em relação ao custo
  • Nenhum
  • Outro
Valor da meta de desempenhoSimstringSimO valor da meta em moeda (CPM, CPA, CPC, CPV, CPIAVC, CPE, VCPM), porcentagem (% de visibilidade, CTR, CVR de cliques, CVR das impressões, VTR, resposta automática de áudio, taxa de conversão de vídeo, CPCL, CPCA, TOS10), sem unidade (valor / custo de impressão personalizada) ou como uma string (outro). Se o tipo de meta fornecido for "Ritmo máximo" ou "Nenhum" essa coluna será ignorada.
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.).
Classificação de conteúdo digital: excluirNãostring, listaSimLista das classificações de conteúdo digital a serem excluídas. 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 do Campaign Manager
  • 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"stringSimAtivar Públicos-alvo semelhantes para listas próprias segmentadas positivamente.

Esse campo foi descontinuado. O valor dessa coluna sempre será FALSE. Se você definir esta coluna como TRUE durante o upload, o valor será redefinido como FALSE.
  • 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: opções do vendedor autorizadoObrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"stringSimConfiguração para segmentar vendedores diretos autorizados, vendedores diretos e revendedores autorizados ou vendedor autorizado + desconhecido. "Direto autorizado" significa que apenas vendedores autorizados serão segmentados. "Vendedores diretos e revendedores autorizados" significa segmentar vendedores e vendedores autorizados. "Editor autorizado e não participante" significa que ele segmentará vendedores autorizados, revendedores e vendedores desconhecidos.
  • Vendedores diretos autorizados
  • Vendedores diretos e revendedores autorizados
  • Editor autorizado e não participante
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 ambienteNãostring, listaSimLista de ambientes para segmentar. Selecione um ou mais valores aceitáveis. A opção "Web não otimizada" não pode ser selecionado sem selecionar "Web".
  • Web
  • Web não otimizada
  • App
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}
Segmentação por posicionamento: exibição na telaNãostring, listaSimSegmentação de posições de anúncios de display na tela. Selecione um ou mais dos valores aceitáveis:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posicionamento: vídeo na telaNãostring, listaSimSegmentação por posições de anúncios em vídeo na tela. Selecione um ou mais dos valores aceitáveis:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posicionamento: mostrar posição no conteúdoNãostring, listaSimPosições do conteúdo do anúncio gráfico a serem segmentadas. Selecione um ou mais dos valores aceitáveis:
  • No artigo
  • In-feed
  • No banner
  • Intersticial
  • Desconhecido
Segmentação por posicionamento: posição do vídeo no conteúdoNãostring, listaSimPosições do conteúdo do anúncio em vídeo a serem segmentadas. Selecione um ou mais dos valores aceitáveis:
  • No artigo
  • In-feed
  • No banner
  • Intersticial
  • Out-stream desconhecido
  • Início da exibição
  • Anúncio intermediário
  • Fim da exibição
  • In-stream desconhecido
Segmentação por posicionamento: posição do áudio no conteúdoNãostring, listaSimPosições do conteúdo do anúncio em áudio a serem segmentadas. Selecione um ou mais dos valores aceitáveis:
  • Início da exibição
  • Anúncio intermediário
  • Fim da exibição
  • Desconhecido
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;}
Otimização do pedido de inserçãoSimstringSimAtiva/desativa a otimização de pedidos de inserção
  • VERDADEIRO
  • FALSO
Unidade da estratégia de lancesObrigatório quando a "Otimização do pedido de inserção" é "True"stringSimSelecione a unidade da estratégia de lances para otimizar os lances:
  • CPA
  • CPC
  • valor/custo de impr. personalizado
  • CIVA
  • IVO_TEN
  • AV_VIEWED
  • INCREMENTAL_CONVERSIONS
A estratégia de lances não excedeObrigatório quando a "Otimização do pedido de inserção" é "True"floatSimDefinir "não exceder" valor do CPM. Se 0, "não exceder" não está ativado.
Aplicar preço mínimo às ofertasObrigatório quando a "Otimização do pedido de inserção" é "True"stringSimDefine se as transações devem ser priorizadas em vez do inventário de leilão aberto.
  • VERDADEIRO
  • FALSO
ID do algoritmoObrigatório quando a "Unidade de estratégia de lances" impr. personalizadas valor/custo .número inteiroSimEsse ID de algoritmo correspondente precisa ser usado quando a unidade de estratégia de lances está definida como impr. personalizadas. ou custo.