Dados estruturados: v4 – Pedido de inserção

Esta versão do SDF foi desativada. Os usuários precisam migrar para o SDF v7.1 para continuar usando arquivos de dados estruturados. Use esta documentação apenas quando se referir a arquivos gerados anteriormente.

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

Campo	Obrigatório	Tipo	Gravável	Descrição
ID do Io	Obrigatório apenas ao editar pedidos de inserção	número inteiro	Não	É o valor do ID numérico do pedido de inserção. Se deixado em branco, um novo ID do pedido de inserção será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar um novo pedido de inserção, você pode usar um identificador personalizado para atribuir itens de linha ao novo pedido de inserção. O formato do identificador personalizado é "ext[custom identifier]", por exemplo: ext123. Quando o arquivo é enviado e processado, todos os identificadores personalizados são substituídos por IDs atribuídos pela DBM, e os objetos são associados (por exemplo, o item de linha ao pedido de inserção) com base nos identificadores personalizados.
ID da campanha	Não	número inteiro	Não	É o valor do ID numérico da campanha. Você pode especificar um identificador personalizado (por exemplo, "ext[custom campaign identifier]") para uma campanha criada ao mesmo tempo que este pedido de inserção.
Nome	Sim	string	Sim	O nome da entrada.
Carimbo de data/hora	Obrigatório ao editar entradas existentes	número inteiro	Não	É o carimbo de data/hora da entrada. Ele é usado pelo sistema para verificar se a entrada não mudou entre o download e o upload.
Status	Sim	string	Sim	A configuração de status da entrada. Ativo Pausado Rascunho Arquivado Excluído
Tipo de io	Sim	string	Sim	O tipo do pedido de inserção. Só pode ser definido na criação. padrão
Taxas	Não	string, lista de listas	Sim	Todas as taxas da entrada. Formato da lista = (categoria de taxa; valor da taxa; tipo de taxa; faturado). Categoria da taxa CPM Mídia Valor da taxa Ponto flutuante Pct como flutuante Tipo de taxa (string, consulte a tabela de taxas) Faturado Verdadeiro Falso em branco Exemplo: "(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True);' Os valores aceitáveis são fornecidos na tabela a seguir: Observação: a taxa de CPM das taxas premium é reservada pelo sistema e é imutável. A cardinalidade da taxa premium é preservada em todas as mutações inserindo taxas de CPM padrão, se necessário. Categoria de taxa Tipo de taxa Opção faturada CPM/mídia Padrão Não permitido (deixe em branco) CPM/mídia Servidor de anúncios de terceiros Não permitido (deixe em branco) CPM/mídia DoubleVerify Permitido (verdadeiro/falso) CPM/mídia Adsafe Não permitido (deixe em branco) CPM/mídia Adxpose Não permitido (deixe em branco) CPM/mídia Vizu Não permitido (deixe em branco) CPM/mídia Aggregate Knowledge Não permitido (deixe em branco) CPM/mídia Teracent Não permitido (deixe em branco) CPM/mídia Evidon Não permitido (deixe em branco) CPM/mídia Taxa das agências negociadoras Não permitido (deixe em branco) CPM/mídia Adloox Permitido (verdadeiro/falso) CPM ShopLocal Obrigatório (verdadeiro) CPM TrustMetrics Não permitido (deixe em branco) CPM Vídeo da Integral Ad Science Permitido (verdadeiro/falso) CPM Vídeo da MOAT Não permitido (deixe em branco) Mídia Taxa do Bid Manager Obrigatório (verdadeiro) Mídia Dados de custo de mídia Não permitido (deixe em branco) CPM Taxas premium Não permitido (deixe em branco)
Código de integração	Não	string	Sim	Um código opcional para fins de rastreamento.
Detalhes	Não	string	Sim	Detalhes da entrada em formato de string.
Ritmo	Sim	string	Sim	O período de tempo usado para gastar o valor do ritmo. Diário Mensal Voos
Taxa de ritmo	Sim	string	Sim	A taxa de ritmo dessa entrada. Assim que possível Uniforme Adiante
Valor do ritmo	Sim	float	Sim	O valor a ser gasto por período definido pelo tipo de ritmo.
Frequência ativada	Sim	string	Sim	Ativa/desativa o limite de frequência com base na impressão no pedido de inserção. TRUE FALSO
Exposições de frequência	Obrigatório quando "Frequency Enabled" for "TRUE"	número inteiro	Sim	Um 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ência	Obrigatório quando "Frequency Enabled" for "TRUE"	string	Sim	Especifica a unidade de tempo do limite de frequência. Minutos Horas Dias Semanas Meses Todo o período
Valor da frequência	Obrigatório quando "Frequency Enabled" for "TRUE"	número inteiro	Sim	Um valor inteiro positivo para a duração do tipo "Período de frequência", ou seja, o "y" em "Mostrar x impressões no período y".
Tipo de meta de performance	Sim	string	Sim	A unidade de 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 % de visibilidade Nenhum Outro
Valor da meta de performance	Sim	string	Sim	O valor da meta em moeda (CPM, CPA, CPC, CPV, CPIAVC), porcentagem (% de visibilidade, CTR) ou como uma string (Outros).
Medir a DAR	Sim	string	Sim	Ativa/desativa a medição de público-alvo usando a Nielsen Digital Ad Ratings TRUE FALSO
Medir o canal de DAR	Obrigatório quando "Measure DAR" for "TRUE"	número inteiro	Sim	O canal a ser medido com a Nielsen Digital Ad Ratings. Formato = UniversalChannel.id
Tipo de orçamento	Sim	string	Sim	Especifica o tipo de orçamento em termos de um valor de "receita" para gastos (valor) ou um número de impressões (impressões) para compra. Valor Impressões
Segmentos de orçamento	Sim	string, lista de listas	Sim	Especifica 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 de moeda flutuante. As datas estão no formato DD/MM/AAAA. Exemplo: "(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);"
Alocação automática de orçamento	Sim	string	Sim	Ativa/desativa a alocação automática de orçamento TRUE FALSO
Segmentação geográfica: incluir	Não	string, lista	Sim	Lista de geografias a serem incluídas na segmentação. Formato da lista = (GeoLocation.id; GeoLocation.id; etc.).
Segmentação geográfica: excluir	Não	string, lista	Sim	Lista de geografias a serem excluídas da segmentação. Formato da lista = (GeoLocation.id;GeoLocation.id; etc.).
Segmentação por idioma: incluir	Não	string, lista	Sim	Lista de idiomas para incluir na segmentação. Formato da lista = (Language.id;Language.id;etc.).
Segmentação por idioma: excluir	Não	string, lista	Sim	Lista de idiomas a serem excluídos da segmentação. Formato da lista = (Language.id;Language.id;etc.).
Segmentação por dispositivo: incluir	Não	string, lista	Sim	Lista de dispositivos a serem incluídos na segmentação. Formato da lista = (DeviceCriteria.id;DeviceCriteria.id;etc.).
Segmentação por dispositivo: excluir	Não	string, lista	Sim	Lista de dispositivos a serem excluídos da segmentação. Formato da lista = (DeviceCriteria.id;DeviceCriteria.id;etc.).
Segmentação por navegador: incluir	Não	string, lista	Sim	Lista de navegador para incluir na segmentação. Formato da lista = (Browser.id;Browser.id;etc.).
Segmentação por navegador: excluir	Não	string, lista	Sim	Lista de navegadores a serem excluídos da segmentação. Formato da lista = (Browser.id;Browser.id;etc.).
Rótulos de brand safety	Não	string, lista	Sim	Lista das classificações de conteúdo digital a serem segmentadas. Formato da lista = (G; PG; etc.). G PG T MA ?
Configurações de sensibilidade de brand safety	Não	string	Sim	Escolha a configuração de sensibilidade para bloquear o inventário com base no objeto do conteúdo relacionado a ele. Não bloquear Usar a verificação da DoubleClick Usar personalizado
Configurações personalizadas de brand safety	Obrigatório quando a configuração personalizada de proteção de marca é "Usar personalizado"	string, lista	Sim	Se a configuração de sensibilidade à proteção de marca for "Usar personalizado", especifique a lista de classificadores de conteúdo padrão. Por exemplo, (Adulto;Álcool;Tabaco;etc.). Adulto Depreciativo Downloads e compartilhamento 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 terceiros	Não	string	Sim	provedor de serviços de verificação de terceiros. Nenhum Integral Ad Science DoubleVerify Adloox
Rótulos de verificação de terceiros	Não	string, lista	Sim	Se a opção "Serviços de verificação de terceiros" não for "Nenhum", especifique uma lista de rótulos aceitos pelo provedor selecionado.
Segmentação por canal: incluir	Não	string, lista	Sim	Lista de canais a serem incluídos na segmentação. Formato da lista = (UniversalChannel.id;UniversalChannel.id; etc.).
Segmentação por canal: excluir	Não	string, lista	Sim	Lista de canais a serem incluídos na segmentação. Formato da lista = (UniversalChannel.id;UniversalChannel.id; etc.).
Segmentação por site: incluir	Não	string, lista	Sim	Lista de sites a serem incluídos na segmentação. A lista pode incluir um conjunto de IDs de site ou strings de URLs, se não for encontrada na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).
Segmentação por site: excluir	Não	string, lista	Sim	Lista de sites a serem excluídos da segmentação. A lista pode incluir um conjunto de IDs de site ou strings de URLs, se não for encontrada na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).
Segmentação de apps: incluir	Não	string, lista	Sim	Lista de apps a serem incluídos na segmentação. A lista pode incluir um conjunto de IDs de site universal ou strings de pacotes de apps, se não forem encontrados na tabela de site universal. Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação por app: excluir	Não	string, lista	Sim	Lista de apps a serem excluídos da segmentação. A lista pode incluir um conjunto de IDs de site universal ou strings de pacotes de apps, se não forem encontrados na tabela de site universal. Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação por coleção de apps: incluir	Não	string, lista	Sim	Lista de coleções de apps a serem incluídas na segmentação. Formato da lista= ID da coleção de apps; ID da coleção de apps;
Segmentação por coleção de apps: excluir	Não	string, lista	Sim	Lista de coleções de apps a serem excluídas na segmentação. Formato da lista= ID da coleção de apps; ID da coleção de apps;
Segmentação por categoria: incluir	Não	string, lista	Sim	Lista de categorias a serem incluídas na segmentação, de IDs de categoria do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).
Segmentação por categoria: excluir	Não	string, lista	Sim	Lista de categorias a serem excluídas da segmentação, de IDs de categoria do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).
Segmentação por palavras-chave: incluir	Não	string, lista	Sim	Lista de strings de palavras-chave a serem incluídas na segmentação.
Segmentação por palavras-chave: excluir	Não	string, lista	Sim	Lista de strings de palavras-chave a serem excluídas da segmentação.
Segmentação por lista de palavras-chave: excluir	Não	string, lista	Sim	Lista de listas de palavras-chave negativas a serem excluídas na segmentação. Formato da lista= ID da lista de palavras-chave negativas; ID da lista de palavras-chave negativas;
Segmentação por público-alvo: Públicos-alvo semelhantes	Obrigatório quando "Type" for "Display", "Video" ou "Audio"	string	Sim	Ative públicos-alvo semelhantes para listas próprias segmentadas de forma positiva. TRUE FALSO
Segmentação por público-alvo: incluir	Não	string, lista de listas de pares	Sim	Lista de listas de público-alvo a serem incluídas na segmentação. Para listas de público-alvo próprias, cada público-alvo é listado como um par de ID da lista de usuários 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: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Segmentação por público-alvo: excluir	Não	string, lista de listas de pares	Sim	Lista de listas de público-alvo a serem excluídas na segmentação. Cada público-alvo é listado como um par de ID da lista de usuários e configuração de recência, se a lista de público-alvo for uma lista de público-alvo de 1ª parte. 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= (UserList.id; recency optional;) (UserList.id; recency optional;). Exemplo: "(1;1d;) (2;)". Os valores de recência válidos são: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Segmentação por afinidade e no mercado: incluir	Não	string, lista	Sim	Lista de listas de público-alvo de afinidade e/ou no mercado a serem incluídas. Formato da lista= ID da lista de usuários; ID da lista de usuários;
Segmentação por afinidade e no mercado: excluir	Não	string, lista	Sim	Lista de listas de público-alvo de afinidade e/ou no mercado a serem excluídas. Formato da lista= ID da lista de usuários; ID da lista de usuários;
Segmentação por afinidade personalizada	Não	string, lista	Sim	Lista de listas personalizadas para segmentar. Formato da lista= ID da lista de usuários; ID da lista de usuários;
Segmentação da origem de inventário: incluir	Não	string, lista	Sim	Lista de inventário a ser incluído na segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário: excluir	Não	string, lista	Sim	Lista de inventário a ser excluído da segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário: segmentar novas trocas	Não	string	Sim	A configuração para segmentar novas trocas. Verdadeiro Falso
Segmentação por período do dia	Não	string, lista	Sim	Lista de IDs, em que cada ID de período do dia é construído no seguinte formato: daypart_id = base_dayparting_id + days_since_monday * 10000 + start * 100 + end base_dayparting_id = 300000 days_since_monday: 0=Monday, 1=Tuesday, ..., 6=Sunday start: 0..95 (00:00--23:45) um número inteiro de 0 a 95, representando intervalos de 15 minutos end: 1..96 (00:15--24:00); um número inteiro de 0 a 95, representando intervalos de 15 minutos start < end Para novas entidades, os horários serão definidos no fuso horário dos seus usuários (ou seja, "Local"). O fuso horário não vai mudar para entidades já existentes.
Fuso horário da segmentação por período do dia	Obrigatório quando "Segmentação por período do dia" está incluída.	string	Sim	Fuso horário a ser usado para a segmentação por período do dia. Local Advertiser
Segmentação de ambiente	Obrigatório quando "Type" for "Display", "Video" ou "Audio"	string, lista	Sim	Lista de ambientes a serem segmentados. Formato da lista = (Web para computador, app para dispositivos móveis etc.). Para o 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ídeos: Vídeo da Web para computadores Jogo da Web para computadores In-Read para Web para computadores Web para computadores no feed Vídeo da Web para dispositivos móveis Vídeo do app para dispositivos móveis Intersticial em vídeo de app para dispositivos móveis Para áudio: Áudio da Web para computadores Áudio da Web para dispositivos móveis Áudio do app para dispositivos móveis
Segmentação de visibilidade do Active View	Não	string	Sim	Segmentar por porcentagens de visibilidade previstas. As porcentagens são representadas como números de ponto flutuante. Um dos valores {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Posição do anúncio da segmentação de visibilidade: incluir	Não	string	Sim	Segmentar posições de anúncios. Selecione um ou nenhum dos valores aceitáveis: Todos ATF BTF Desconhecido
Posição do anúncio da segmentação por visibilidade: excluir	Não	string	Sim	Excluir posições de anúncios na segmentação. Selecione um ou nenhum dos valores aceitáveis: ATF BTF Desconhecido
Segmentação pela posição do anúncio em vídeo	Não	string, lista	Sim	Lista de posições de anúncios em vídeo para segmentar. Selecione um ou mais dos valores aceitos: desconhecido Anúncio precedente Durante a exibição Anúncio final
Segmentação por tamanho do player de vídeo	Não	string, lista	Sim	Lista de tamanhos de player de anúncios em vídeo para segmentação. Selecione um ou mais dos valores aceitos: desconhecido pequeno grande HD
Segmentação demográfica: gênero	Não	string, lista	Sim	Lista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitos: Feminino Masculino Desconhecido
Segmentação demográfica por idade	Não	string, lista	Sim	Segmentar 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 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: renda familiar	Não	string, lista	Sim	Segmentar uma faixa de renda familiar. Especifique um intervalo de "de/até" selecionando um único intervalo de renda "Top_of_Range" e um único intervalo de renda "Bottom_of_Range" e se é necessário incluir domicílios com renda desconhecida (verdadeiro/falso). Consulte a lista de intervalos Top_of_Range/Bottom_of_Range aceitáveis. Exemplo 1: para segmentar os 10% a 50% mais ricos e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true; Exemplo 2: para segmentar apenas os 50% mais pobres e excluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true; Valores aceitáveis para Top_of_Range/Bottom_of_Range: 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 parental	Sim	string, lista	Sim	Lista de status parentais a segmentar. Selecione um ou mais dos valores aceitáveis. Com filhos Sem filhos Desconhecido
Segmentação por velocidade de conexão	Não	string	Sim	Segmentar para uma velocidade de conexão específica. Selecione um dos valores aceitáveis: Todos 2G 3G DSL 4G
Segmentação por operadora: incluir	Não	string, lista	Sim	Lista de ISPs ou operadoras a segmentar. Formato da lista = {ISP.id; ISP.id;}
Segmentação por operadora: excluir	Não	string, lista	Sim	Lista de ISPs ou operadoras a serem excluídos. Formato da lista = {ISP.id; ISP.id;}