Pular para o conteúdo principal
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.

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.
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

accountId
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.
adName
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}.
bidAmount
number
obrigatório
Valor máximo do lance em USD. O lance mínimo é de US$ 1,00.
budget
number
obrigatório
Orçamento diário em USD. O orçamento mínimo é de US$ 1,00.
fbPostId
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.
goal
string
padrão:"engagement"
obrigatório
O objetivo do anúncio. Valores: engagement, interactions, awareness_views e awareness_audience. Consulte os detalhes dos objetivos de anúncio acima para mais informações.
locations
object
obrigatório
Localizações de segmentação do anúncio com um objeto de arrays: countries, regions, cities.
postId
string
obrigatório
O ID da publicação da Ayrshare da publicação a ser impulsionada. Obrigatório se fbPostId não estiver definido.
status
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.
adSetBudgetSharingEnabled
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.
tracking
object
Acompanhe o anúncio usando um Facebook Pixel.
urlTags
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.
specialAdCategories
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.
  • 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.
  • 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.
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.
endDate
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.
excludedLocations
object
Exclua localizações usando um objeto com arrays de countries, regions e cities.
gender
string
padrão:"all"
O gênero da audiência. Valores: all, male, female.
interests
array
Os interesses de segmentação do anúncio como um array de IDs de interesse do Facebook.
maxAge
number
padrão:65
Idade máxima para segmentação do anúncio (padrão: 65).
minAge
number
padrão:18
Idade mínima para segmentação do anúncio (padrão: 18).
startDate
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.
dsaBeneficiary
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.
dsaPayor
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.