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

# Descripción general de la API de Ads

> Impulsa tus publicaciones convirtiéndolas en anuncios de Facebook con la API de 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} />

## Introducción a la API de Ads

La API de Ads de Ayrshare proporciona acceso programático para crear, administrar y analizar anuncios en redes sociales.

Actualmente compatible con **Facebook**, la Facebook Ads API, también conocida como Facebook Marketing API, te permite transformar publicaciones existentes en anuncios pagos.
Esto incluye impulsar publicaciones (transformar una publicación en un anuncio), administrar anuncios, hacer seguimiento del rendimiento y analizar el gasto publicitario.

Los anuncios creados y actualizados a través de Ayrshare siempre pueden encontrarse en el Administrador de Anuncios de Facebook.
Ayrshare gestiona todas las configuraciones a nivel de anuncio, conjunto de anuncios y campaña.
Nunca es necesario editar manualmente ninguna configuración directamente en el Administrador de Anuncios de Facebook.

<Note>
  1. Las capacidades de Ads requieren el complemento de pago Ads, que se puede habilitar en la
     página Account del [panel web](https://app.ayrshare.com/account).

  2. El
     usuario debe haber [vinculado un método de
     pago](https://business.facebook.com/billing_hub/payment_settings/?placement=ads_manager)
     en Facebook (Meta) antes de crear un anuncio.

  3. Los perfiles de usuario vinculados con una página de Facebook antes del 1 de abril de 2025 deben
     volver a vincularse para habilitar los anuncios.
</Note>

Para más información, consulta nuestra [guía de la Facebook Ads API](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/).

## Flujo para crear un anuncio

<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="Flujo de anuncios" width="1596" height="437" data-path="images/apis/ads/ads-flow.webp" />

Impulsar una publicación en Facebook es una forma rápida y sencilla de convertir una de tus
publicaciones existentes en un anuncio. Aquí tienes un flujo de alto nivel de cómo implementarlo en
tu plataforma:

<Steps>
  <Step title="Elige la cuenta publicitaria de Facebook">
    Tu usuario elegirá la cuenta publicitaria de Facebook que ya tenga configurados todos los detalles de facturación.

    <Card title="Obtener cuentas publicitarias de Facebook" href="/apis/ads/facebook/get-ad-accounts" horizontal />
  </Step>

  <Step title="Selecciona la publicación">
    Selecciona una publicación de tu página de Facebook. Puede ser una foto, video, actualización de estado, etc.

    > **Sugerencia:** Las publicaciones con buena interacción orgánica (me gusta, compartidos, comentarios) tienden a rendir mejor cuando se impulsan.
  </Step>

  <Step title="Haz clic en «Impulsar publicación»">
    Tu usuario hará clic en un botón como "Impulsar publicación" en tu plataforma para comenzar
    a configurar el anuncio.

    <Card title="Impulsar una publicación enviándola a la plataforma de anuncios de Facebook" href="/apis/ads/facebook/boost-post" horizontal />
  </Step>

  <Step title="Establece el objetivo, audiencia, presupuesto y duración">
    El usuario puede configurar varios parámetros.

    <ul className="custom-bullets">
      <li>
        Elige la estrategia de objetivo para esta
        publicación impulsada seleccionando un goal.
      </li>

      <li>Personaliza la audiencia según edad, género,
      ubicación, intereses, etc.</li>
      <li>Elige cuánto gastar en total.</li>
      <li>Establece el
      período de tiempo para ejecutar el anuncio.</li>
    </ul>
  </Step>

  <Step title="Revisa e impulsa">
    Verifica todas las configuraciones. Si todo se ve bien, el usuario hará clic en un botón como el botón **"Impulsar publicación ahora"**.
  </Step>

  <Step title="Revisión y lanzamiento del anuncio">
    Facebook revisará el anuncio; esto normalmente toma desde unos minutos
    hasta unas horas. Una vez aprobado, la publicación impulsada se publica y se ejecuta según
    la configuración.
  </Step>

  <Step title="Realiza seguimiento del gasto y el rendimiento">
    Supervisa lo siguiente:

    * Alcance
    * Interacción
    * Clics
    * Gasto
    * Presupuesto restante

    <Card title="Obtener gasto publicitario y analíticas de Facebook" href="/apis/ads/facebook/get-ad-history" horizontal />
  </Step>
</Steps>

## Buenas prácticas de la API de Ads

1. **Gestión de presupuesto**: Comienza con presupuestos de prueba pequeños (por ejemplo, \$5-10/día) para optimizar el rendimiento antes de escalar.
2. **Duración del anuncio**: Facebook requiere un tiempo mínimo de ejecución del anuncio de aproximadamente 30 horas entre las horas de inicio y de finalización.
3. **Segmentación por intereses**: Elige de 2 a 5 intereses relevantes para una precisión de segmentación óptima.
4. **Directrices creativas**: Usa imágenes de alta calidad y mensajes concisos para mejorar las tasas de interacción.
5. **Monitoreo del rendimiento**: Revisa regularmente el rendimiento de tus anuncios y ajusta la segmentación o los elementos creativos según sea necesario.

Para obtener información detallada sobre cada endpoint, incluyendo parámetros de solicitud, formatos de respuesta y ejemplos, consulta las páginas de documentación de cada endpoint de la API.