Dados estruturados - v3.1 – Itens de linha

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

Consulte a visão geral para ver 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 existentes	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. Como opção, ao criar novos itens de linha, é possível usar um identificador personalizado para atribuir grupos de anúncios TrueView ao novo item de linha. 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, grupo de anúncios a item de linha) com base nos identificadores personalizados.
ID de pedido de inserção	Sim	número inteiro	Não	É o valor do ID numérico do pedido de inserção. É possível especificar um identificador personalizado (por exemplo, "ext[identificador de pedido de inserção personalizado]") para um pedido de inserção ao mesmo tempo que este item de linha.
Tipo	Sim	string	Sim	O tipo de entrada. Gravável apenas 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 para distinguir entre 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 existentes	número inteiro	Não	O carimbo de data/hora da entrada, 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 voo da entrada no formato MM/DD/AAAA HH:mm.
Tipo de orçamento	Sim	string	Sim	Especifica se o orçamento é baseado no valor monetário ou nas impressões. Se o pedido de inserção dessa entrada estiver habilitado para alocação automática de orçamento, você poderá defini-la como "Automática" para permitir que o DBM crie um 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" ou "Vídeo" ou "Áudio"	float	Sim	Um valor de orçamento positivo para o tipo de orçamento. Esse valor pode ser um número inteiro simples ou uma flutuação no valor de uma moeda. As moedas serão exibidas na moeda do anunciante em unidades padrão (não em 1/1.000.000 de unidade monetária). Se for "Automático" é definida na entrada e é possível especificar um valor mínimo a ser gasto (por exemplo, "gastar pelo menos" esse valor).
Ritmo	Sim	string	Sim	O período usado para gastar para o valor do ritmo. Diário Mensal Voos
Taxa de ritmo	Sim	string	Sim	A taxa de ritmo desta entrada. Assim que possível Uniforme Adiante
Valor do ritmo	Sim	float	Sim	É o valor a ser gasto pelo período definido pelo tipo de ritmo.
Frequência ativada	Sim	string	Sim	Ativa/desativa o limite de frequência baseado em impressão no item de linha. VERDADEIRO FALSO
Exposições de frequência	Obrigatório quando "Frequência ativada" é "VERDADEIRO"	número inteiro	Sim	Um 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ência	Obrigatório quando "Frequência ativada" é "VERDADEIRO"	string	Sim	Especifica a unidade do período para o limite de frequência. Para itens de linha TrueView, os períodos compatíveis são dias, semanas, meses. Minutos Horas Dias Semanas Meses Todo o período
Valor da frequência	Obrigatório quando "Frequência ativada" é "VERDADEIRO"	número inteiro	Sim	Um 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". Esse valor não é compatível com itens de linha TrueView.
Frequência de visualização de TrueView ativada	Obrigatório quando "Tipo" é "TrueView"	string	Sim	Ativa/desativa o limite de frequência com base em visualização no item de linha TrueView VERDADEIRO FALSO
Exposições de frequência de visualização de TrueView	Obrigatório quando a frequência de visualização de TrueView estiver ativada é "VERDADEIRO"	número inteiro	Sim	Um valor inteiro positivo para o número de visualizações de TrueView, ou seja, o x em "Exibir x visualizações durante o período"
Período de frequência de visualização de TrueView	Obrigatório quando a frequência de visualização de TrueView estiver ativada é "VERDADEIRO"	string	Sim	Especifica a unidade do período do limite de frequência baseado em visualização 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 o modelo de receita do parceiro para rastrear a margem de lucro das taxas de serviço. TGMC: marcação do custo de mídia total GMC: marcação do custo de mídia CPM: custo por mil impressões
Valor da receita do parceiro	Sim	float	Sim	Um valor flutuante positivo correspondente ao modelo de receita do parceiro.
Tipo de contagem de conversões	Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"	string	Sim	Escolha os tipos de conversões que serão contadas. Contar tudo Contagem pós-clique Contagem %
Contagem de conversões	Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"	float	Sim	Especifique o valor em "Contagem %" Tipo de contagem de conversões. Formate o % como um valor 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 de pós-visualização (em minutos) e uma janela de 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; 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 taxa Tipo de tarifa Opção com 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" ou "Vídeo" ou "Áudio"	string	Sim	Selecione uma das estratégias de lances aplicáveis: Minimizar: ao gastar todo o orçamento, minimize o CPA/CPC Maximizar: gastando todo o orçamento, maximize o valor da impressão ou a impressão de qualidade Superar: alcançar ou superar uma meta de CPA/CPC X Otimizar vCPM: otimizar para o lance de CPM visível de X Fixo: especificar um lance fixo de X
Valor de estratégia de lances	Obrigatório, a menos que seja "Tipo de estratégia de lances" é "Minimizar", "Maximizar" ou "Tipo" é "TrueView"	float	Sim	Para os tipos de estratégia de lances fixos, de otimização e de otimização, escolha um valor para o lance da meta. Observe que nenhum valor de estratégia de lances é necessário para o tipo de estratégia de lances "Minimizar". ou "Maximizar"
Unidade da estratégia de lances	Obrigatório quando "Tipo de estratégia de lances" é "Beat" ","Minimizar" ou "Maximizar"	string	Sim	Para os tipos de estratégia Beat, Minimizar ou Maximizar, selecione a unidade correspondente: CPA CPC valor/custo de impr. personalizado CIVA IVO_TEN AV_VIEWED INCREMENTAL_CONVERSIONS
A estratégia de lances não excede	Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"	float	Sim	Definir "não exceder" valor do CPM. Se 0, "não exceder" não está ativado. Só estará disponível se a estratégia de lances for "Minimizar", "Maximizar" ou "Beat".
Atribuições de criativos	Não	string, lista	Sim	Lista de IDs dos 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, lista	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, lista	Sim	Lista de regiões geográficas 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 a serem incluídos 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 navegadores a serem incluídos na segmentação. Formato da lista = (ID do navegador; ID do navegador; etc.).
Segmentação por navegador: excluir	Não	string, lista	Sim	Lista de navegadores a serem excluídos da segmentação. Formato da lista = (ID do navegador; ID do navegador; etc.).
Rótulos de brand safety	Não	string, lista	Sim	Lista 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 safety	Não	string	Sim	Escolha 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 safety	Obrigatório ao definir a "Configuração personalizada de brand safety" é "Usar personalizado"	string, lista	Sim	Se 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 terceiros	Não	string	Sim	Provedor terceirizado de serviços de verificação. 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 marcadores aceitos pelo provedor selecionado.
Segmentação de canal - Incluir	Não	string, lista	Sim	Lista de canais a serem incluídos na segmentação. Formato de lista = (UniversalChannel.id;UniversalChannel.id; etc.).
Segmentação de canal: excluir	Não	string, lista	Sim	Lista de canais a serem incluídos na segmentação. Formato de 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 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: 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 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: incluir	Não	string, lista	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 encontrados na tabela "Site universal". Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação por aplicativo: excluir	Não	string, lista	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 encontrados na tabela "Site universal". Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).
Segmentação por categoria: incluir	Não	string, lista	Sim	Lista 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: excluir	Não	string, lista	Sim	Lista 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 - 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 público-alvo: públicos-alvo semelhantes	Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"	string	Sim	Ative os públicos-alvo semelhantes para listas próprias segmentadas positivamente. VERDADEIRO FALSO
Segmentação por público-alvo – Incluir	Não	string, lista de pares	Sim	É 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: excluir	Não	string, lista de pares	Sim	Lista 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 - Incluir	Não	string, lista	Sim	É 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: excluir	Não	string, lista	Sim	É 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 afinidade personalizada	Não	string, lista	Sim	Lista 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: incluir	Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"	string, lista	Sim	Lista de inventários a serem incluídos 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ários a serem excluídos da segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação por período do dia	Não	string, lista	Sim	, 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.
Segmentação por ambiente	Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"	string, lista	Sim	Lista 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 View	Não	string	Sim	Porcentagem 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 - 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 com segmentação por visibilidade: excluir	Não	string	Sim	Exclua 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ídeo	Não	string, lista	Sim	Lista 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ídeo	Não	string, lista	Sim	Lista 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ênero	Não	string, lista	Sim	Lista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis: Feminino Masculino Desconhecido
Segmentação demográfica Idade	Não	string, lista	Sim	Segmentar 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 por velocidade de conexão	Não	string	Sim	Segmente 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 serem segmentadas. List format = {ISP.id; ISP.id;}
Segmentação por operadora: excluir	Não	string, lista	Sim	Lista de ISPs ou operadoras a serem excluídas. List format = {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 exibir anúncios em dispositivos móveis. Os ajustes aceitáveis são para a opção de ajuste de lance "Aumento": [0;900%]; e para "Diminuir": [0;90%] ou 100%.
Segmentação por exclusões de categoria do TrueView	Não	string, lista	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 sem classificação 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, lista	Sim	Listas de origens de inventário TrueView a serem incluídas Pesquisa do YouTube Vídeos do YouTube Parceiros de vídeo