O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.
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. |
| 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. |
| 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. |
| 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 | 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: | | 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.) |
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2026-06-02 UTC.
[null,null,["Última atualização 2026-06-02 UTC."],[],[]]