Skip to main content
POST
Impulsione uma publicação existente do Facebook para criar um anúncio. Este endpoint permite converter suas publicações orgânicas em anúncios pagos com parâmetros personalizados de segmentação, orçamento e agendamento.
  • Os valores de orçamento e lance devem ser especificados em USD com até duas casas decimais.
  • O anúncio deve ser veiculado por pelo menos 30 horas para atender ao requisito do Facebook.
  • Você pode usar o endpoint de interesses para encontrar IDs de interesses para segmentação.
  • O Facebook pode levar até 24 horas para revisar e aprovar publicações impulsionadas.
  • Se estiver usando fbPostId diretamente (em vez do postId da Ayrshare), certifique-se de que seja um ID de publicação válido do Facebook.
  • Se um impulsionamento falhar depois que o Facebook tiver criado a campanha (na etapa do criativo, do conjunto de anúncios ou do anúncio), tentamos excluir essa campanha. Se a exclusão também falhar, a campanha vazia permanece na sua conta de anúncios. Você pode encontrá-la e excluí-la no Gerenciador de Anúncios.

Objetivos do anúncio

Cada anúncio deve ter um objetivo. O objetivo determina como o anúncio será otimizado para exibição.
  • engagement: Este objetivo busca aumentar o engajamento, garantindo ao mesmo tempo que o anúncio alcance o maior número possível de usuários únicos. Equilibra a visibilidade com o engajamento, exibindo o anúncio para o maior número possível de pessoas diferentes que possam interagir com ele.
  • interactions: Projetado para impulsionar interações, como curtidas, comentários e compartilhamentos, no anúncio. O Facebook prioriza exibir o anúncio para usuários com maior probabilidade de interagir com ele.
  • awareness_views: Foca em aumentar o reconhecimento da marca maximizando o número de vezes que o anúncio é exibido. Prioriza mostrar o anúncio o maior número de vezes possível dentro do orçamento, independentemente do alcance único.
  • awareness_audience: Visa aumentar o reconhecimento da marca maximizando o número de pessoas únicas que veem o anúncio. Garante que o anúncio alcance o maior número possível de usuários diferentes e maximiza o tamanho da audiência única em vez de exibi-lo várias vezes para a mesma audiência.
  • traffic: Envia as pessoas para fora do Facebook, para um destino de sua escolha, como seu site, uma landing page ou uma publicação de vaga de emprego. O Facebook otimiza para cliques no link em vez de engajamento na plataforma. Este é o único objetivo que suporta um botão de callToAction.
Saiba mais sobre como integrar a Facebook Marketing API com a Ayrshare em nosso Guia de integração da Facebook Marketing API.

Parâmetros de cabeçalho

Parâmetros do corpo

string
obrigatório
O ID da conta de anúncios do Facebook na qual impulsionar a publicação. O ID da conta pode ser obtido no endpoint de contas de anúncios.
string
obrigatório
Nome do seu anúncio (aparece no Gerenciador de Anúncios do Facebook) com o formato {adName} - {postId or fbPostId} - {current date}.
number
obrigatório
Valor máximo do lance em USD. O lance mínimo é de US$ 1,00.
number
obrigatório
Orçamento diário em USD. O orçamento mínimo é de US$ 1,00.
string
obrigatório
O ID da publicação social do Facebook da publicação a ser impulsionada, que permite criar um anúncio a partir de uma publicação criada diretamente no Facebook. Este é o ID da publicação no Facebook, não da Ayrshare. Obrigatório se postId não estiver definido.
string
padrão:"engagement"
obrigatório
O objetivo do anúncio. Valores: engagement, interactions, awareness_views, awareness_audience e traffic. Consulte os detalhes dos objetivos de anúncio acima para mais informações.
object
obrigatório
Localizações de segmentação do anúncio com um objeto de arrays: countries, regions, cities.
string
obrigatório
O ID da publicação da Ayrshare da publicação a ser impulsionada. Obrigatório se fbPostId não estiver definido.
string
padrão:"active"
obrigatório
O status do anúncio. Valores: active e paused.Você pode alterar o status do anúncio posteriormente usando o endpoint de atualização de anúncio.
boolean
padrão:false
Controla o compartilhamento de orçamento no nível da campanha entre conjuntos de anúncios da Meta. A Meta agora exige este campo em todas as campanhas criadas sem um orçamento no nível da campanha, portanto a Ayrshare sempre o envia — usando false por padrão para compatibilidade retroativa.Defina como true para permitir que a Meta compartilhe até ~20% do orçamento de um conjunto de anúncios com outros conjuntos da mesma campanha para otimizar o desempenho geral. Consulte a referência do grupo de campanhas de anúncios da Meta para obter detalhes.
object
Adicione um botão de call-to-action, como Apply Now ou Shop Now, à publicação impulsionada. O botão abre a URL que você fornecer.
callToAction só é suportado com o objetivo de anúncio traffic. Enviá-lo com engagement, interactions, awareness_views ou awareness_audience retorna um 400 com code: 101 indicando os objetivos compatíveis. Anteriormente, o valor era aceito com qualquer objetivo e então silenciosamente ignorado, produzindo um anúncio sem botão.
callToAction.link fornece a URL de destino. Quando a Meta renderiza o call to action como um botão na publicação existente, as urlTags são anexadas ao link desse botão. goal: "traffic" sem um callToAction é permitido e cria um anúncio de tráfego sem botão.O callToAction que você envia é ecoado de volta na resposta do impulsionamento com type em maiúsculas — veja o exemplo Post Boosted with a Call to Action — e também é retornado no anúncio posteriormente pelo endpoint de anúncios impulsionados.
object
Acompanhe o anúncio usando um Facebook Pixel.
array
Adicione tags UTM à URL do anúncio.
Por exemplo, se a URL de link for https://www.mysite.com/my-post e as tags de URL adicionadas forem:utm_source=ayrshare, utm_medium=social e utm_campaign=ayrshare-social.A URL do anúncio será: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social.
array
A Meta exige que anunciantes em categorias especiais de anúncios identifiquem por conta própria a categoria de sua campanha.Se sua empresa está em uma dessas categorias, você deve selecionar a categoria apropriada ao impulsionar sua publicação.Os seguintes valores são suportados:
  • housing: Anúncios que promovem ou vinculam diretamente a uma oportunidade de moradia ou serviço relacionado, incluindo, mas não se limitando a, anúncios de venda ou aluguel de uma casa ou apartamento, seguro residencial, seguro hipotecário, empréstimos hipotecários, reparos habitacionais e serviços de home equity ou avaliação.
  • financial_product_services: Anúncios que promovem ou vinculam diretamente a uma oferta de produtos e serviços financeiros, incluindo crédito. financial_products_services é aceito como grafia equivalente, e credit é aceito como o antigo nome da Meta para esta categoria — os três chegam à Meta como a mesma categoria, então envie o que você já tiver.
  • employment: Anúncios que promovem ou vinculam diretamente a uma oportunidade de emprego, incluindo, mas não se limitando a, vagas de tempo parcial ou integral, estágios ou programas de certificação profissional. Anúncios relacionados que se enquadram nesta categoria incluem promoções de bolsas de emprego ou feiras, serviços de agregação ou anúncios que detalham benefícios que uma empresa possa oferecer, independentemente de uma oferta de emprego específica.
  • none: O padrão. Declara que a campanha não está em nenhuma categoria especial de anúncios. Enviá-lo explicitamente equivale a omitir specialAdCategories por completo, e é aceito para que um cliente que sempre envia o campo possa indicar “nenhuma categoria” sem precisar tratar esse caso à parte.
  • issues_elections_politics: Anúncios feitos por, em nome de, ou sobre um candidato a cargo público, uma figura política, um partido político ou que defendam o resultado de uma eleição para cargo público. Também inclui anúncios sobre qualquer eleição, referendo ou iniciativa de votação, incluindo campanhas eleitorais do tipo “Vá votar”. Anúncios regulamentados como publicidade política ou sobre questões sociais em qualquer lugar onde o anúncio esteja sendo veiculado. Se selecionar issues, elections ou politics, você deve selecionar o país onde deseja veicular esses anúncios. É necessário estar autorizado a veicular anúncios sobre questões sociais, eleições ou política no país especificado.
Os valores não diferenciam maiúsculas de minúsculas. Um valor não reconhecido é rejeitado com um 400 e code: 101 listando os valores aceitos. Anteriormente, um valor não reconhecido era silenciosamente descartado e a campanha era criada sem categoria, então um erro de digitação deixava um anúncio regulamentado em veiculação sem nenhuma categoria declarada.A lista de valores aceitos nessa mensagem de erro é escrita na forma em maiúsculas da Meta e também menciona as grafias alternativas acima, então ela aparece como NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT. São as mesmas cinco categorias listadas aqui — FINANCIAL_PRODUCT_SERVICES e CREDIT são os equivalentes de financial_product_services, não categorias extras. A mesma mensagem é retornada pelo endpoint de interesses.Repetir uma categoria, ou enviar duas grafias da mesma categoria, como ["credit", "financial_product_services"], é aceito e é reduzido a uma única categoria antes de chegar à Meta. Um valor vazio é rejeitado com um 400 e code: 101.Para encontrar IDs de interesses que a Meta permite para uma dessas categorias, passe o mesmo valor ao endpoint de interesses.A Meta também precisa saber os países em que um anúncio de categoria especial é veiculado. A Ayrshare os obtém de locations: os países que você listar, mais o país de cada região e cidade. Assim, um impulsionamento housing que segmenta uma cidade do Reino Unido é configurado para o Reino Unido, sem nada extra na sua solicitação. Sem locations, o anúncio é veiculado nos EUA e a campanha é configurada para os EUA.A Meta também define um raio mínimo ao redor de cada cidade para essas categorias. Uma cidade do Reino Unido com raio de 17 quilômetros foi rejeitada com #2909039, que exige pelo menos 25 quilômetros (15 milhas), então use 25 quilômetros ou mais.
A Meta exige que os anunciantes identifiquem por conta própria a categoria de sua campanha. A Meta utiliza revisores humanos e aprendizado de máquina para identificar esses tipos de anúncios. Se você nos enviar uma specialAdCategory incorreta, existe o risco de que seus anúncios sejam pausados até que a campanha seja ajustada.
string
Data e hora de término no formato ISO 8601 (deve ser pelo menos 30 horas após o início), por exemplo 2025-03-01T00:00:00Z.Se não for definida, o anúncio será veiculado indefinidamente e terá data de término ongoing.
object
Exclua localizações usando um objeto com arrays de countries, regions e cities.
string
padrão:"all"
O gênero da audiência. Valores: all, male, female.
array
Os interesses de segmentação do anúncio como um array de IDs de interesse do Facebook.
number
padrão:65
Idade máxima para segmentação do anúncio (padrão: 65).
number
padrão:18
Idade mínima para segmentação do anúncio (padrão: 18).
string
Data e hora de início no formato ISO 8601, por exemplo 2025-03-01T00:00:00Z.Se não for definida, o anúncio começará imediatamente.
string
O beneficiário do anúncio para conformidade com o Digital Services Act (DSA) para países da UE. Deve ser definido em conjunto com dsaPayor se qualquer um dos dois for fornecido. Consulte nosso guia do DSA para mais informações.
string
O pagador do anúncio para conformidade com o Digital Services Act (DSA) para países da UE. Deve ser definido em conjunto com dsaBeneficiary se qualquer um dos dois for fornecido.

Orçamentos de campanha

Para manter o orçamento na campanha em vez de no conjunto de anúncios, envie budget.level: "campaign" no formato aninhado. Assim, o conjunto de anúncios não tem orçamento próprio. Funciona com orçamentos diários e vitalícios.
  • budget.level: adSet (o padrão) ou campaign. Um orçamento de campanha não pode ser combinado com adSetBudgetSharingEnabled. Se você enviar os dois, a solicitação é rejeitada com um 400 e code: 101.
  • A resposta inclui budgetLevel: "campaign" para um orçamento de campanha. Um orçamento de conjunto de anúncios não retorna budgetLevel, então trate a ausência do campo como adSet.
  • No Histórico, budgetDaily mostra o orçamento diário da campanha para um anúncio com orçamento diário de campanha. Se vários anúncios compartilham um mesmo orçamento de campanha, cada um mostra todo o orçamento da campanha, e não a sua parcela. O Histórico não mostra orçamentos vitalícios, seja na campanha ou no conjunto de anúncios. Quando um orçamento vitalício de campanha é gasto, todo anúncio nessa campanha mostra deliveryStatus: "COMPLETED" após a próxima atualização noturna, inclusive um anúncio agendado ou em análise. Um anúncio rejeitado continua REJECTED.

Impulsionar em uma campanha ou conjunto de anúncios existente

Por padrão, cada impulsionamento cria sua própria campanha, seu próprio conjunto de anúncios e seu próprio anúncio. Para adicionar o impulsionamento a uma campanha ou a um conjunto de anúncios que você já executa na Meta, envie o formato aninhado com attachTo.
  • attachTo.campaignId: o impulsionamento cria um novo conjunto de anúncios e um novo anúncio dentro dessa campanha. Envie budget, targeting e bidAmount normalmente: eles se aplicam ao novo conjunto de anúncios.
  • attachTo.adSetId: o impulsionamento cria apenas o anúncio, dentro desse conjunto de anúncios. Envie também attachTo.campaignId, a campanha à qual o conjunto de anúncios pertence. Omita budget, targeting e platformOptions.facebook.bidAmount: o conjunto de anúncios mantém os seus próprios. Enviar qualquer um deles retorna um 400 com code: 101.
  • A campanha ou o conjunto de anúncios deve estar na conta de anúncios indicada por accountId e não pode pertencer aos impulsionamentos de outro usuário. Caso contrário, a solicitação retorna um 400. Um impulsionamento do Facebook também não pode ser anexado a uma campanha criada por um impulsionamento do Instagram, e vice-versa.
  • attachTo não pode ser combinado com budget.level: "campaign", specialAdCategories ou adSetBudgetSharingEnabled, que são definidos em uma nova campanha. Enviá-los retorna code: 101.
  • Pausar ou ativar o impulsionamento altera apenas o que o impulsionamento criou: o anúncio, e o conjunto de anúncios quando o impulsionamento o criou. A campanha ou o conjunto de anúncios que você indicou em attachTo mantém o próprio status. O anúncio só é veiculado enquanto a campanha e o conjunto de anúncios acima dele estiverem ativos. Isso também vale quando a Ayrshare pausa seus anúncios, por exemplo, quando um perfil é excluído.
  • Se o impulsionamento falhar, a campanha ou o conjunto de anúncios indicado em attachTo nunca é excluído.
  • Se o conjunto de anúncios ao qual você anexa estiver em uma campanha que detém o orçamento (um orçamento de campanha), o Histórico informa o impulsionamento como qualquer anúncio com orçamento de campanha: budgetDaily mostra todo o orçamento da campanha, e não a parcela do impulsionamento, e, quando um orçamento vitalício de campanha é gasto, todo anúncio que a Ayrshare acompanha nessa campanha mostra deliveryStatus: "COMPLETED" após a próxima atualização noturna, inclusive um anúncio agendado ou em análise. Um anúncio rejeitado continua REJECTED.