Dados estruturados: v4 – Pedido de inserção

Esta versão do SDF foi desativada. Os usuários precisam migrar para a v9 do SDF para continuar usando arquivos de dados estruturados. Use esta documentação apenas ao 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 atuais	número inteiro	Não	É o valor do ID numérico do pedido de inserção. Se deixado em branco, um novo ID de pedido de inserção será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar um pedido de inserção, você pode usar um identificador personalizado para atribuir itens de linha a ele. 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 pelo DBM, e os objetos são associados (por exemplo, item de linha a 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 esta ordem de inserção.
Nome	Sim	string	Sim	O nome da entrada.
Carimbo de data/hora	Obrigatório ao editar entradas atuais	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 E/S	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 desta entrada. Formato da lista = (Categoria da taxa; Valor da taxa; Tipo de taxa; Faturado;). Categoria da taxa CPM Mídia Valor da taxa Ponto flutuante Pct como ponto 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 estão na tabela a seguir: Observação: a taxa de CPM 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 da taxa Tipo de taxa Opção de fatura 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 usado para gastar o valor de ritmo. Diário Mensal Voos
Taxa de ritmo	Sim	string	Sim	A taxa de aceleração desta 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 aceleração.
Frequência ativada	Sim	string	Sim	Ativa/desativa o limite de frequência com base em impressões no pedido de inserção. TRUE FALSO
Exposições de frequência	Obrigatório quando "Frequency Enabled" é "TRUE"	número inteiro	Sim	Um 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ência	Obrigatório quando "Frequency Enabled" é "TRUE"	string	Sim	Especifica a unidade de período para o limite de frequência. Minutos Horas Dias Semanas Meses Todo o período
Valor da frequência	Obrigatório quando "Frequency Enabled" é "TRUE"	número inteiro	Sim	Um número inteiro positivo para o período de tempo do tipo "Período de frequência", ou seja, o "y" em "Mostrar x impressões em um período de y".
Tipo de meta de performance	Sim	string	Sim	A unidade da meta para o 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 (Outro).
Medir DAR	Sim	string	Sim	Ativa/desativa a medição de público-alvo usando a Nielsen Digital Ad Ratings. TRUE FALSO
Medir canal do revendedor autorizado de distribuição	Obrigatório quando "Medir DAR" é "TRUE"	número inteiro	Sim	O canal a ser medido com a Nielsen Digital Ad Ratings. Format = 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 MM/DD/AAAA. Exemplo: "(100.50;01/01/2016;31/03/2016;);(200.00;01/04/2016;30/06/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, list	Sim	Lista de regiões geográficas a serem incluídas na segmentação. Formato da lista = (GeoLocation.id; GeoLocation.id;etc.).
Segmentação geográfica - Excluir	Não	string, list	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, list	Sim	Lista de idiomas a serem incluídos na segmentação. Formato da lista = (Language.id;Language.id;etc.).
Segmentação por idioma - Excluir	Não	string, list	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, list	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, list	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, list	Sim	Lista de navegadores a serem incluídos na segmentação. Formato da lista = (Browser.id;Browser.id;etc.).
Segmentação por navegador - Excluir	Não	string, list	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, list	Sim	Lista das 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 safety	Não	string	Sim	Escolha a configuração de sensibilidade para bloquear o inventário com base no assunto do conteúdo relacionado a ele. Não bloquear Usar a verificação da DoubleClick Usar predefinição personalizada
Configurações personalizadas de brand safety	Obrigatório quando a "Configuração personalizada de segurança da marca" é "Usar personalizada"	string, list	Sim	Se a configuração de sensibilidade de brand safety for "Usar personalizada", especifique a lista de classificadores de conteúdo padrão. Por exemplo, (Adulto;Bebidas alcoólicas;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
Etiquetas de verificação de terceiros	Não	string, list	Sim	Se "Serviços de verificação de terceiros" não for "Nenhum", especifique uma lista de rótulos compatíveis com o provedor selecionado.
Segmentação por canal: incluir	Não	string, list	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, list	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, list	Sim	Lista de sites a serem incluídos na segmentação. A lista pode incluir um conjunto de IDs de sites ou strings de URLs, se não forem encontrados na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).
Segmentação por site - Excluir	Não	string, list	Sim	Lista de sites a serem excluídos da segmentação. A lista pode incluir um conjunto de IDs de sites ou strings de URLs, se não forem encontrados na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).
Segmentação de apps – inclusão	Não	string, list	Sim	Lista 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 encontradas na tabela do Universal Site. Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação de apps - Excluir	Não	string, list	Sim	Lista 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 encontradas na tabela do Universal Site. Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação de coleta de apps – incluir	Não	string, list	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, list	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, list	Sim	Lista de categorias a serem incluídas na segmentação, dos IDs verticais do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).
Segmentação por categoria - Excluir	Não	string, list	Sim	Lista de categorias a serem excluídas na segmentação, de IDs verticais do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).
Segmentação por palavras-chave: inclusão	Não	string, list	Sim	Lista de strings de palavras-chave a serem incluídas na segmentação.
Segmentação por palavra-chave - Excluir	Não	string, list	Sim	Lista de strings de palavras-chave a serem excluídas na segmentação.
Segmentação por lista de palavras-chave - Excluir	Não	string, list	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 "Tipo" é "Display", "Vídeo" ou "Áudio"	string	Sim	Ative os 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 UserList 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 combinar grupos de públicos-alvo com "E" e "OU", 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 1 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 5 minutos de atualização OU lista 5 com todos os usuários). Os valores válidos de atualização 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: exclusão	Não	string, lista de listas de pares	Sim	Lista de públicos-alvo a serem excluídos na segmentação. Cada público-alvo é listado como um par de ID da UserList 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= (UserList.id; recency optional;); (UserList.id; recency optional;); Exemplo: "(1;1d;);(2;);". Valores de atualização válidos: 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 no mercado e de afinidade: incluir	Não	string, list	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, list	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, list	Sim	Lista de listas personalizadas para segmentação. 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, list	Sim	Lista de inventário a ser incluída na segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário - Excluir	Não	string, list	Sim	Lista de inventário a ser excluída da segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário - Segmentar novas trocas	Não	string	Sim	Configuração para segmentar novas trocas. Verdadeiro Falso
Segmentação por período do dia	Não	string, list	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=segunda-feira, 1=terça-feira, ..., 6=domingo 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"). Para entidades atuais, o fuso horário não será alterado.
Fuso horário da segmentação por período do dia	Obrigatório quando o "Segmentação por período do dia" está incluído.	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 "Tipo" é "Display", "Vídeo" ou "Áudio"	string, list	Sim	Lista de ambientes a serem segmentados. 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 na Web para computadores Vídeo para computadores no feed Vídeo da Web para dispositivos móveis Vídeo de 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 porcentagens de visibilidade prevista. As porcentagens são representadas como números de ponto flutuante. 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: incluir	Não	string	Sim	Segmentar posições de anúncio. Selecione um ou nenhum dos valores aceitáveis: Todos ATF BTF Desconhecido
Posição do anúncio de segmentação por visibilidade - Excluir	Não	string	Sim	Excluir posições de anúncio 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, list	Sim	Lista de posições de anúncios em vídeo a serem segmentadas. 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ídeo	Não	string, list	Sim	Lista 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
Segmentação demográfica por gênero	Não	string, list	Sim	Lista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis: Feminino Masculino Desconhecido
Idade da segmentação demográfica	Não	string, list	Sim	Segmentar por faixa etária do usuário. Especifique um intervalo de "De/Até" selecionando uma idade inicial e uma idade final e se você quer incluir idades desconhecidas (verdadeiro/falso). Confira a lista de idades aceitas "De/Até". 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 aceitos 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, list	Sim	Segmentar uma faixa de renda familiar. Especifique um intervalo de "de/para" selecionando uma única faixa de renda "Top_of_Range" e uma única faixa de renda "Bottom_of_Range", além de incluir ou não famílias com renda desconhecida (verdadeiro/falso). Confira a lista de intervalos aceitáveis de "Top_of_Range/Bottom_of_Range". Exemplo 1: para segmentar os 10% a 50% mais ricos das famílias 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 das famílias 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 por status parental	Sim	string, list	Sim	Lista de status parentais a serem segmentados. Selecione um ou mais valores aceitáveis. Com filhos Sem filhos Desconhecido
Segmentação por velocidade de conexão	Não	string	Sim	Segmentar uma velocidade de conexão específica. Selecione um dos valores aceitos: Todos 2G 3G DSL 4G
Segmentação por operadora – incluir	Não	string, list	Sim	Lista de ISPs ou operadoras a serem segmentadas. Formato da lista = {ISP.id; ISP.id;}
Segmentação por operadora - Excluir	Não	string, list	Sim	Lista de ISPs ou operadoras a serem excluídas. Formato da lista = {ISP.id; ISP.id;}