Dados estruturados - v3.1 – Itens de linha

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 item de linha	Obrigatório apenas ao editar itens de linha atuais	número inteiro	Não	É o valor do ID numérico do item de linha. Se deixado em branco, um novo item de linha será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar novos itens de linha, você pode usar um identificador personalizado para atribuir grupos de anúncios TrueView ao novo item de linha. 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, grupo de anúncios a item de linha) com base nos identificadores personalizados.
ID do Io	Sim	número inteiro	Não	É o valor do ID numérico do pedido de inserção. Você pode especificar um identificador personalizado (por exemplo, "ext[custom IO identifier]") para uma ordem de inserção criada ao mesmo tempo que este item de linha.
Tipo	Sim	string	Sim	O tipo de entrada. Só pode ser gravado durante a criação, não na edição. Display Vídeo TrueView Áudio
Subtipo	Sim	string	Sim	Campo obrigatório para itens de linha TrueView que distinguem os formatos TrueView padrão e de instalação de apps para dispositivos móveis. Simples Instalação de apps para dispositivos móveis
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
Data de início	Sim	string	Sim	Um carimbo de data/hora para a data de início do voo da entrada no formato MM/DD/AAAA HH:mm.
Data de término	Sim	string	Sim	Um carimbo de data/hora para a data de término do período de veiculação da entrada no formato MM/DD/AAAA HH:mm.
Tipo de orçamento	Sim	string	Sim	Especifica se o orçamento é baseado em moeda ou em impressões. Se o pedido de inserção dessa entrada estiver ativado para alocação automática de orçamento, defina como "Automático" para permitir que o DBM faça o orçamento automaticamente para essa entrada. Valor Impressões Ilimitado Automático Orçamento diário do TrueView
Valor do orçamento	Obrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio"	float	Sim	Um valor de orçamento positivo para o tipo de orçamento. Pode ser um valor inteiro simples de impressão ou um ponto flutuante para um valor de moeda. As moedas serão mostradas na moeda do anunciante em unidades padrão (não em 1/1.000.000 de uma unidade monetária). Se a alocação de orçamento "Automática" estiver definida na entrada, você poderá especificar um valor mínimo a ser gasto (por exemplo, "gaste pelo menos" esse valor).
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 item de linha. 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. Para itens de linha TrueView, os períodos aceitos são dias, semanas e meses. 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". Esse valor não é compatível com itens de linha TrueView.
Frequência de visualização do TrueView ativada	Obrigatório quando "Type" é "TrueView"	string	Sim	Ativa/desativa o limite de frequência com base em visualizações no item de linha TrueView. TRUE FALSO
Exposições de frequência de visualização do TrueView	Obrigatório quando "TrueView View Frequency Enabled" é "TRUE"	número inteiro	Sim	Um número inteiro positivo para o número de visualizações TrueView, ou seja, o x em "Mostrar x visualizações durante o período"
Período de frequência de visualização do TrueView	Obrigatório quando "TrueView View Frequency Enabled" é "TRUE"	string	Sim	Especifica a unidade de período para o limite de frequência baseado em visualizações do TrueView. Dias Semanas Meses
Modelo de receita do parceiro	Sim	string	Sim	Um modelo de receita do parceiro é um mecanismo que controla o cálculo da receita no Bid Manager. Use esse modelo para acompanhar o markup das taxas de serviço. TMCM - Total Media Cost Markup MCM: aumento do custo de mídia CPM: custo por mil impressões
Valor da receita do parceiro	Sim	float	Sim	Um valor de ponto flutuante positivo correspondente ao modelo de receita do parceiro.
Tipo de contagem de conversões	Obrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio"	string	Sim	Escolha os tipos de conversões que serão contabilizados. Contar tudo Contar pós-clique % da contagem
Porcentagem de contagem de conversões	Obrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio"	float	Sim	Especifique a porcentagem para o tipo de contagem de conversões "Contagem %". Formate a porcentagem como um ponto flutuante (3,123% = 3,123), com precisão limitada aos milhares (três casas decimais).
IDs de pixel de conversão	Não	string, lista de listas	Sim	Especifique os pixels de conversão como uma lista de listas. Cada pixel é especificado como um ID de pixel, uma janela pós-visualização (em minutos) e uma janela pós-clique (em minutos). Formato da lista = (Pixel.common_data.id; view_window_minutes; click_window_minutes;).
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.
Tipo de estratégia de lances	Obrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio"	string	Sim	Selecione uma das estratégias de lances aplicáveis: Minimizar: enquanto gasta todo o orçamento, minimize o CPA/CPC Maximizar: ao gastar todo o orçamento, maximize o valor de impressão ou a impressão de qualidade Superar: atingir ou superar uma meta de X CPA/CPC Otimizar vCPM: otimizar para lance de CPM visível de X Corrigido: especifique um lance fixo de X
Valor de estratégia de lances	Obrigatório, a menos que "Tipo de estratégia de lances" seja "Minimizar", "Maximizar" ou "Tipo" seja "TrueView"	float	Sim	Para os tipos de estratégia "Superar", "Otimizar VCPM" e "Fixa", escolha um valor para o lance de meta. Nenhum valor de estratégia de lances é necessário para os tipos "Minimizar" ou "Maximizar".
Unidade de estratégia de lances	Obrigatório quando o "Tipo de estratégia de lances" é "Superar" ,"Minimizar" ou "Maximizar"	string	Sim	Para os tipos de estratégia "Superar", "Minimizar" ou "Maximizar", selecione a unidade correspondente: CPA CPC valor/custo de impr. personalizado CIVA IVO_TEN AV_VIEWED INCREMENTAL_CONVERSIONS
Estratégia de lances "Não exceder"	Obrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio"	float	Sim	Defina um valor de CPM "não exceder". Se for 0, a opção "não exceder" não estará ativada. Isso só está disponível se a estratégia de lances for "Minimizar", "Maximizar" ou "Superar".
Atribuições de criativos	Não	string, list	Sim	Lista de IDs de criativos a serem atribuídos à entrada. Formato da lista = (Creative.common_data.id;Creative.common_data_id;etc.).
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 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 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	Obrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio"	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 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.
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 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;}
Opção de ajuste de lance para dispositivos móveis do TrueView	Não	string	Sim	"Aumentar" ou "Diminuir" Aumentar Diminuir
Porcentagem de ajuste de lance para dispositivos móveis do TrueView	Não	número inteiro	Sim	Ajuste de lance para aumentar as chances de veicular anúncios em dispositivos móveis. Os ajustes aceitáveis são para a opção "Aumentar": [0;900%]; e para "Diminuir": [0;90%] ou 100%
Segmentação por exclusões de categorias do TrueView	Não	string, list	Sim	Lista de categorias a serem excluídas. Formato da lista = Jogos; Tragédia e conflito; etc Vídeos incorporados Transmissões ao vivo Jogos Tragédia e conflito Problemas sociais delicados Famílias Todos os públicos-alvo Adolescentes mais jovens Adolescentes Adultos Ainda não classificado Conteúdo com conotação sexual Conteúdo sensacionalista e chocante Difamação e linguagem grosseira
Segmentação da origem de inventário TrueView	Não	string, list	Sim	Listas de origens de inventário TrueView a serem incluídas Pesquisa do YouTube Vídeos do YouTube Parceiros de vídeo