> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral da API de anúncios

> Impulsione suas publicações transformando-as em anúncios do Facebook usando a API da Ayrshare.

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

## Introdução à API de anúncios

A API de anúncios da Ayrshare fornece acesso programático para criar, gerenciar e analisar anúncios em redes sociais.

Atualmente com suporte ao **Facebook**, a Facebook Ads API, também conhecida como Facebook Marketing API, permite transformar publicações existentes em anúncios pagos.
Isso inclui impulsionar publicações (transformar uma publicação em um anúncio), gerenciar anúncios, acompanhar o desempenho e analisar o gasto com anúncios.

Anúncios criados e atualizados via Ayrshare sempre podem ser encontrados no Gerenciador de Anúncios do Facebook.
A Ayrshare cuida de todas as configurações nos níveis de anúncio, conjunto de anúncios e campanha.
Nunca é necessário editar manualmente nenhuma dessas configurações diretamente no Gerenciador de Anúncios do Facebook.

<Note>
  1. Os recursos de anúncios exigem o complemento pago Ads, que pode ser habilitado na
     página Account do [painel web](https://app.ayrshare.com/account).

  2. O
     usuário deve ter [vinculado um método de
     pagamento](https://business.facebook.com/billing_hub/payment_settings/?placement=ads_manager)
     no Facebook (Meta) antes de criar um anúncio.

  3. Perfis de usuário vinculados a uma Página do Facebook antes de 1º de abril de 2025 devem ser
     revinculados para habilitar anúncios.
</Note>

Para mais informações, consulte nosso [guia da Facebook Ads API](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/).

## Fluxo de criação de um anúncio

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/ads/ads-flow.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=3e57ee2134ddc3bb0937acf5b3d31781" alt="Ads Flow" width="1596" height="437" data-path="images/apis/ads/ads-flow.webp" />

Impulsionar uma publicação no Facebook é uma forma rápida e simples de transformar uma de suas
publicações existentes em um anúncio. Aqui está uma visão geral de alto nível de como implementar isso em
sua plataforma:

<Steps>
  <Step title="Escolha a conta de anúncios do Facebook">
    Seu usuário escolherá a conta de anúncios do Facebook que já possui todos os detalhes de faturamento configurados.

    <Card title="Obter contas de anúncios do Facebook" href="/apis/ads/facebook/get-ad-accounts" horizontal />
  </Step>

  <Step title="Selecione a publicação">
    Selecione uma publicação da sua Página do Facebook. Pode ser uma foto, vídeo, atualização de status, etc.

    > **Dica:** Publicações com bom engajamento orgânico (curtidas, compartilhamentos, comentários) tendem a ter melhor desempenho quando impulsionadas.
  </Step>

  <Step title="Clique em “Impulsionar publicação”">
    Seu usuário clicará em um botão como "Impulsionar publicação" na sua plataforma para começar
    a configurar o anúncio.

    <Card title="Impulsionar uma publicação enviando-a para a plataforma de anúncios do Facebook" href="/apis/ads/facebook/boost-post" horizontal />
  </Step>

  <Step title="Defina o objetivo, a audiência, o orçamento e a duração">
    O usuário pode definir vários parâmetros.

    <ul className="custom-bullets">
      <li>
        Escolha a estratégia de objetivo para esta
        publicação impulsionada selecionando um objetivo.
      </li>

      <li>Personalize a audiência com base em idade, gênero,
      localização, interesses, etc.</li>
      <li>Escolha quanto gastar no total.</li>
      <li>Defina o
      período de tempo de exibição do anúncio.</li>
    </ul>
  </Step>

  <Step title="Revisar e impulsionar">
    Verifique todas as configurações. Se tudo estiver certo, o usuário clicará em um botão como **"Impulsionar publicação agora"**.
  </Step>

  <Step title="Revisão e lançamento do anúncio">
    O Facebook revisará o anúncio — isso geralmente leva de alguns minutos
    a algumas horas. Uma vez aprovada, a publicação impulsionada é veiculada e é executada de acordo
    com a configuração.
  </Step>

  <Step title="Acompanhe gastos e desempenho">
    Monitore o seguinte:

    * Alcance
    * Engajamento
    * Cliques
    * Gasto
    * Orçamento restante

    <Card title="Obter gasto e análises de anúncios do Facebook" href="/apis/ads/facebook/get-ad-history" horizontal />
  </Step>
</Steps>

## Boas práticas da API de anúncios

1. **Gestão de orçamento**: Comece com pequenos orçamentos de teste (por exemplo, US\$ 5-10/dia) para otimizar o desempenho antes de escalar.
2. **Duração do anúncio**: O Facebook exige um tempo mínimo de execução do anúncio de aproximadamente 30 horas entre as datas de início e término.
3. **Segmentação por interesses**: Escolha de 2 a 5 interesses relevantes para uma precisão ideal de segmentação.
4. **Diretrizes de criativo**: Use imagens de alta qualidade e mensagens concisas para melhorar as taxas de engajamento.
5. **Monitoramento de desempenho**: Verifique regularmente o desempenho do seu anúncio e ajuste a segmentação ou elementos criativos conforme necessário.

Para informações detalhadas sobre cada endpoint, incluindo parâmetros de requisição, formatos de resposta e exemplos, consulte as páginas de documentação de cada endpoint da API.