Facebook Ads
Impulsionar publicação
Impulsione uma publicação enviando-a para a plataforma de anúncios do Facebook
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
fbPostIddiretamente (em vez dopostIdda 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.
Parâmetros de cabeçalho
Parâmetros do corpo
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.
Nome do seu anúncio (aparece no Gerenciador de Anúncios do Facebook) com o formato
{adName} - {postId or fbPostId} - {current date}.Valor máximo do lance em USD. O lance mínimo é de US$ 1,00.
Orçamento diário em USD. O orçamento mínimo é de US$ 1,00.
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.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.Localizações de segmentação do anúncio com um objeto de arrays:
countries, regions, cities.O ID da publicação da Ayrshare da publicação a ser impulsionada. Obrigatório se
fbPostId não estiver definido.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.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.Acompanhe o anúncio usando um Facebook Pixel.
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.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.
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.Exclua localizações usando um objeto com arrays de
countries, regions e cities.O gênero da audiência. Valores:
all, male, female.Os interesses de segmentação do anúncio como um array de IDs de
interesse do Facebook.
Idade máxima para segmentação do anúncio (padrão: 65).
Idade mínima para segmentação do anúncio (padrão: 18).
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.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.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.