Builds salvos

Um build salvo é um registro de uma configuração em andamento no uploader web. Ele guarda as escolhas que você fez até agora, incluindo a seleção de mídia, a estrutura da campanha, o texto e qualquer ajuste de segmentação do conjunto de anúncios, e dá a esse trabalho uma referência estável build_<hash>. O uploader web, a CLI e o MCP usam a mesma referência.

Um build não é um anúncio lançado nem um trabalho concluído. Você pode salvar um build parcial, passá-lo para outra superfície e continuar trabalhando antes de criar qualquer coisa.

Salvamento automático no uploader web

O uploader salva seu build atual em silêncio enquanto você trabalha. A referência do build aparece em dois lugares:

Na parte de baixo do painel Ad Configuration
No cabeçalho do editor de texto por anúncio e por conjunto de anúncios, ao lado de Reset All

Clique no ícone de copiar ao lado da referência para colocá-la na área de transferência. Depois você pode colá-la na CLI, em uma conversa com o MCP ou nas suas anotações, sem copiar a configuração inteira.

O salvamento automático mantém uma cópia de trabalho atualizada. Ele não lança anúncios nem substitui as etapas normais de prévia e criação.

Salvamentos automáticos e builds nomeados

Um salvamento automático é a cópia de trabalho atual, sem nome. Um build nomeado é um salvamento automático que você salvou de propósito com um nome útil, para que continue fácil de encontrar.

Depois que a conta tem pelo menos um build, um ícone Saved builds (uma pilha de arquivos) aparece ao lado do seletor de conta de anúncio em Account Selection. Clique nele para abrir Saved Builds, que lista todos os builds nomeados e seus salvamentos automáticos mais recentes daquela conta. De lá você pode:

Retomar um build com Resume
Copiar a referência do build com o ícone de copiar
Salvar um salvamento automático com um nome usando Save
Renomear um build nomeado com o ícone de lápis
Criar uma nova cópia de um build com Fork
Excluir um build com Delete

Janela Saved Builds listando um build nomeado e um salvamento automático, cada um com o horário Updated e os botões Resume, Fork e Delete, além dos ícones de copiar e renomear

Um selo Web only significa que o build pode ser concluído no uploader web, mas ainda não pode ser lançado pela CLI ou pelo MCP. Passe o mouse sobre o selo para ver o motivo.

Use um build nomeado para trabalhos que você quer retomar depois. Dar nome a um salvamento automático mantém esse trabalho como build salvo, em vez de deixá-lo no rodízio dos salvamentos automáticos recentes.

Retomar um build

Para retomar pelo app web, abra Saved Builds e selecione Resume. O uploader restaura a configuração salva nos controles da tela para você continuar editando.

Resume continua trabalhando no mesmo build, então os próximos salvamentos automáticos o atualizam no lugar. Selecione Fork quando quiser usar um build como modelo e manter o original intacto. Fork cria um novo rascunho sem nome, com a própria referência de build, e abre a cópia para você editar.

Você também pode abrir um build direto com este formato de URL:

https://adsuploader.com/dashboard/uploader?build=build_...

O uploader muda para a conta de anúncio dona do build antes de restaurá-lo. Se o build foi baseado em um API preset, o uploader seleciona esse preset de novo. Se foi baseado em um anúncio da Meta, o uploader recarrega esse anúncio de origem e depois aplica a configuração salva.

A URL direta é útil quando um agente devolve um build para você ou quando a aba original do uploader foi fechada.

Trabalhar com um agente de IA

Os editores de texto por anúncio e por conjunto de anúncios têm botões do Claude e do ChatGPT. Cada botão abre uma nova conversa com a referência do build atual e um prompt de edição via MCP já preenchidos. Descreva as mudanças de texto que você quer, e o agente pode buscar e atualizar esse mesmo build pelo MCP do Ads Uploader.

Se o build ainda estiver aberto no uploader, a página verifica atualizações externas quando você volta para a aba ou foca a janela, e também verifica de tempos em tempos enquanto a página está visível. Quando o servidor tem uma versão mais nova e você não tem edições locais pendentes, o uploader aplica a atualização automaticamente.

Clique no ícone de atualizar ao lado da referência do build quando quiser verificar na hora. O mesmo controle aparece no rodapé do Ad Configuration e no cabeçalho do editor de texto.

Se você tiver edições locais quando chegar uma atualização externa, o uploader não as sobrescreve. Ele mostra um banner, "This build was updated externally.", com Load changes e Keep mine:

Load changes aplica o build salvo mais recente.
Keep mine mantém seu trabalho local atual e descarta essa atualização.

Se a aba do uploader estiver fechada, peça ao agente a URL do build. Ele não precisa mandar a URL depois de atualizar um build que já está aberto.

Levar o trabalho entre a web, a CLI e o MCP

Os builds salvos são a ponte entre as três superfícies. Você pode começar com a mídia enviada e uma configuração de origem no app web, passar a referência build_... para um agente na CLI ou no MCP fazer uma mudança específica, e depois revisar o resultado na mesma aba do uploader ou por uma URL que você pediu.

A referência continua identificando o mesmo build enquanto ele passa de uma superfície para outra. Você não precisa recriar o preset, o anúncio de origem, as escolhas de mídia ou a configuração de texto a cada passagem.

Builds parciais e capacidade de lançamento

Um build pode ser útil antes de estar pronto para lançar. Você pode retomar e concluir um build parcial no uploader web mesmo quando a CLI ou o MCP o marcam como exclusivo da web.

Para um lançamento pela CLI ou pelo MCP, o build salvo precisa de uma configuração de origem utilizável, como um API preset ou um anúncio de origem, de mídia que possa ser encontrada na conta de anúncio dele e de uma configuração completa que o fluxo sem interface suporte. Se faltar alguma dessas partes, o build informa por que não pode ser lançado, para você voltar ao uploader web e concluí-lo.

Sempre veja a prévia antes de criar anúncios. Veja Configurar seus anúncios e Lançar seus anúncios para o fluxo na web, ou Configuração da CLI para o fluxo na linha de comando.

Identificadores de mídia de vídeo

Para vídeos, mediaItems[].mediaId precisa ser o ID numérico do vídeo no Facebook: use o videoId da resposta do upload, não o id interno. videoId é aceito como alias, e linkedAssets[] seguem a mesma regra. IDs internos de upload só são resolvidos ao salvar quando pertencem ao usuário autenticado e à conta selecionada. Sem um ID numérico ou um vínculo de lote, um vídeo não resolvido torna o build impossível de lançar.

Um item de vídeo canônico com um principal 4x5 e uma variante 9x16 vinculada:

{
  "mediaName": "X__H01.mp4",
  "mediaType": "video",
  "mediaId": "1805649190475379",
  "thumbnailHash": "PRIMARY_THUMBNAIL_HASH",
  "placementType": "portrait",
  "isGroupPrimary": true,
  "assetGroupId": "ag_1",
  "linkedAssets": [
    {
      "mediaName": "X__H01-9x16.mp4",
      "mediaType": "video",
      "mediaId": "1234567890",
      "thumbnailHash": "STORY_THUMBNAIL_HASH",
      "placementType": "story"
    }
  ]
}

Builds de parceria

Os builds salvos também guardam as configurações de parceria: referências de publicações importadas, identidades de criador e patrocinador, modo de cabeçalho, texto, aprimoramentos e configurações de publicação. Códigos de anúncio brutos nunca são guardados em um build nem mostrados na saída. Um código verificado pode ser reutilizado para a mesma marca e a mesma publicação, mas talvez você ainda precise de uma permissão renovada ou de um código novo no lançamento.

Builds completos de publicação existente do Instagram, e builds de parceria com mídia enviada (incluindo parceiros por linha e No Partner), podem ter prévia e lançamento pela web, pela CLI e pelo MCP. Builds legados de publicação do Facebook continuam exclusivos da web. Publicações importadas não podem ser misturadas com mídia enviada. Se um build importado tiver configurações que o editor web não consegue mostrar, o uploader web não vai sobrescrevê-lo; continue editando pela CLI ou pelo MCP. Para os campos de especificação de parceria, veja a Referência completa da CLI.

Observações sobre conta e acesso

Os builds salvos pertencem à conta de anúncio em que foram criados e não podem ser transferidos para outra conta. Um link direto pode mudar o uploader para a conta conectada correta, mas não muda a propriedade do build.

O acesso à CLI e ao MCP é exclusivo de usuários pagantes e não está disponível no teste grátis. O MCP usa os mesmos controles de acesso da CLI, então desativar o acesso à CLI também desativa o acesso ao MCP. Veja Configuração do MCP para instruções de conexão e autenticação.

Documentação