Use o upload parcial de arquivos de dados estruturados para simplificar o gerenciamento de SDFs, incluir mais recursos e reduzir o tempo de upload ao enviar SDFs de itens de linha. Confira nosso novo guia para começar hoje mesmo.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Dados estruturados - v10 - Campanha
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Consulte a visão geral para uma explicação do formato.
Campo
Obrigatório
Tipo
Gravável
Descrição
ID da campanha
Obrigatório apenas ao editar campanhas atuais
número inteiro
Não
É o valor do ID numérico da campanha. Se deixado em branco, um novo ID de campanha será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar uma campanha, você pode usar um identificador personalizado para atribuir pedidos de inserção a ela. O formato do identificador personalizado é "ext[identificador personalizado]", 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, pedido de inserção à campanha) com base nos identificadores personalizados.
Código do anunciante
Sim
número inteiro
Não
É o valor do ID numérico do anunciante. Precisa ser um ID de anunciante válido
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
Arquivado
Meta da campanha
Sim
string
Sim
Selecione uma das metas de campanha aplicáveis:
Aumentar o reconhecimento da minha marca ou do meu produto
Impulsionar ação on-line ou visitas
Impulsionar as vendas off-line ou na loja
Aumentar instalações ou engajamentos do aplicativo
KPI da meta da campanha
Sim
string
Sim
Selecione um dos KPIs de meta da campanha aplicáveis:
CPM
Porcentagem visível
Custo por impressão audível e visível na conclusão (CPIAVC, na sigla em inglês)
CPA
CPC
CTR
Outro
Valor do KPI da meta da campanha
Sim
float
Sim
Um número positivo para o KPI da meta da campanha. Para os KPIs de meta da campanha "Porcentagem visível" e "CTR", insira o valor desse campo em porcentagem. Por exemplo, 80% seria inserido como "80". Para o KPI "Outro", este campo é uma breve descrição do objetivo.
Tipos de criativo
Sim
string, list
Sim
Lista de tipos de criativos que você espera usar.
Display
Vídeo
Áudio
Orçamento da campanha
Não
float
Sim
Um valor de orçamento positivo para a campanha. É sempre um ponto flutuante para um valor monetário, já que será sempre um orçamento monetário. 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).
Data de início da campanha
Sim
string
Sim
A data de início da campanha no formato MM/DD/AAAA HH:mm
Data de término da campanha
Não
string
Sim
A data de término da campanha no formato MM/DD/AAAA HH:mm
Frequência ativada
Sim
string
Sim
Ativa/desativa o limite de frequência com base em impressões na campanha.
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 durante o 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
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".
Os períodos de tempo do limite de frequência precisam ser de 30 dias ou menos.
Segmentos de orçamento da campanha
Não
string, lista de listas
Sim
O conjunto de segmentos de orçamento da campanha. Formato da lista = (ID; Nome; Tipo; Valor; Data de início; Data de término; Origem do orçamento externo; ID do orçamento externo; ID do agrupamento de faturas; Código do cliente do Prisma; Código do produto do Prisma; Código da estimativa do Prisma; Tipo do Prisma; Fornecedor;).
Exemplo: "(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)", em que ID e data de término não são fornecidos. Os valores aceitáveis estão na tabela a seguir:
Nome da coluna
Obrigatório
Descrição
ID
Não
O ID exclusivo do segmento de orçamento da campanha. Isso precisa ser fornecido ao editar um segmento de orçamento. Se deixado em branco, o segmento de orçamento será gravado como novo.
Nome
Sim
O nome de exibição do segmento de orçamento da campanha.
Tipo
Sim
O tipo do valor do orçamento. Os valores aceitáveis são:
Valor
Impressões
Valor
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).
Data de início
Não
Um carimbo de data/hora para a data de início do voo do segmento de orçamento no formato MM/DD/AAAA HH:mm. Uma data de início não definida é representada por um valor de campo em branco.
Data de término
Não
Um carimbo de data/hora para a data de término do período de veiculação do segmento de orçamento no formato MM/DD/AAAA HH:mm. Uma data de término não definida é representada por um valor de campo em branco.
Origem do orçamento externo
Sim
A origem do segmento de orçamento. Os valores aceitáveis são:
Nenhum
Mediaocean
ID do orçamento externo
Apenas para segmentos de orçamento da Mediaocean
Se definido, todas as impressões veiculadas em relação a esse segmento de orçamento vão incluir esse ID na fatura se o cliente tiver ativado o faturamento no nível do segmento de orçamento.
ID do agrupamento de faturas
Não
Se definido, todos os segmentos de orçamento com o mesmo ID de orçamento externo e ID de agrupamento de faturas serão agregados em uma única fatura se o cliente tiver ativado o faturamento no nível do segmento de orçamento.
Código do cliente do Prisma
Apenas para segmentos de orçamento da Mediaocean
Só pode ser definido para segmentos de orçamento da Mediaocean. A central de pagamentos do Google permite pesquisar e filtrar esse campo.
Código do produto do Prisma
Apenas para segmentos de orçamento da Mediaocean
Só pode ser definido para segmentos de orçamento da Mediaocean. A central de pagamentos do Google permite pesquisar e filtrar esse campo.
Código da estimativa do Prisma
Apenas para segmentos de orçamento da Mediaocean
Só pode ser definido para segmentos de orçamento da Mediaocean. A central de pagamentos do Google permite pesquisar e filtrar esse campo.
Tipo do Prisma
Apenas para segmentos de orçamento da Mediaocean
Só pode ser definido para segmentos de orçamento do Mediaocean. O tipo Prisma do segmento. Os valores aceitáveis são:
Display
Pesquisar
Vídeo
Áudio
Social
Fee
Fornecedor do Prisma
Apenas para segmentos de orçamento da Mediaocean
Só pode ser definido para segmentos de orçamento do Mediaocean. A entidade alocada a esse orçamento (DSP, site etc.)
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-06-02 UTC."],[],[]]