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

# Übersicht über die Ads-API

> Steigern Sie die Reichweite Ihrer Beiträge, indem Sie sie mit der API von Ayrshare in Facebook-Anzeigen umwandeln.

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} />

## Einführung in die Ads-API

Die Ayrshare Ads-API bietet programmatischen Zugriff, um Social-Media-Anzeigen zu erstellen, zu verwalten und zu analysieren.

Aktuell wird **Facebook** unterstützt. Die Facebook Ads API, auch bekannt als Facebook Marketing API, ermöglicht es Ihnen, bestehende Beiträge in bezahlte Anzeigen umzuwandeln.
Dazu gehören das Bewerben von Beiträgen (Umwandlung eines Beitrags in eine Anzeige), die Verwaltung von Anzeigen, das Verfolgen der Performance und die Analyse der Werbeausgaben.

Über Ayrshare erstellte und aktualisierte Anzeigen können jederzeit im Facebook Ads Manager eingesehen werden.
Ayrshare verwaltet alle Einstellungen auf Anzeigen-, Anzeigengruppen- und Kampagnenebene.
Es ist nie notwendig, Einstellungen manuell direkt im Facebook Ads Manager zu bearbeiten.

<Note>
  1. Die Ads-Funktionen erfordern das kostenpflichtige Ads-Add-on, das auf der
     Account-Seite des [Web-Dashboards](https://app.ayrshare.com/account) aktiviert werden kann.

  2. Der
     Nutzer muss vor der Erstellung einer Anzeige eine [Zahlungsmethode](https://business.facebook.com/billing_hub/payment_settings/?placement=ads_manager)
     bei Facebook (Meta) hinterlegt haben.

  3. User Profiles, die vor dem 1. April 2025 mit einer Facebook-Seite verknüpft wurden, müssen
     erneut verknüpft werden, um Anzeigen zu aktivieren.
</Note>

Weitere Informationen finden Sie in unserem [Facebook Ads API-Leitfaden](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/).

## Ablauf zum Erstellen einer Anzeige

<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" />

Das Bewerben eines Beitrags auf Facebook ist eine schnelle und einfache Möglichkeit, einen Ihrer
bestehenden Beiträge in eine Anzeige zu verwandeln. Hier ist ein grober Überblick über den Ablauf zur Implementierung in
Ihrer Plattform:

<Steps>
  <Step title="Wählen Sie das Facebook-Werbekonto aus">
    Ihr Nutzer wählt das Facebook-Werbekonto aus, in dem alle Abrechnungsdetails bereits konfiguriert sind.

    <Card title="Facebook-Werbekonten abrufen" href="/apis/ads/facebook/get-ad-accounts" horizontal />
  </Step>

  <Step title="Beitrag auswählen">
    Wählen Sie einen Beitrag von Ihrer Facebook-Seite aus. Es kann sich um ein Foto, ein Video, ein Statusupdate usw. handeln.

    > **Tipp:** Beiträge mit guter organischer Interaktion (Likes, Shares, Kommentare) erzielen in der Regel bessere Ergebnisse, wenn sie beworben werden.
  </Step>

  <Step title="Auf „Boost Post“ klicken">
    Ihr Nutzer klickt auf eine Schaltfläche wie „Boost Post“ in Ihrer Plattform, um mit der
    Einrichtung der Anzeige zu beginnen.

    <Card title="Einen Beitrag bewerben, indem er an die Werbeplattform von Facebook übermittelt wird" href="/apis/ads/facebook/boost-post" horizontal />
  </Step>

  <Step title="Ziel, Zielgruppe, Budget und Laufzeit festlegen">
    Der Nutzer kann eine Reihe von Parametern festlegen.

    <ul className="custom-bullets">
      <li>
        Wählen Sie die Zielstrategie für diesen
        beworbenen Beitrag durch Auswahl eines Ziels.
      </li>

      <li>Passen Sie die Zielgruppe basierend auf Alter, Geschlecht,
      Standort, Interessen usw. an.</li>
      <li>Legen Sie das Gesamtbudget fest.</li>
      <li>Legen Sie den
      Zeitraum für die Anzeigenschaltung fest.</li>
    </ul>
  </Step>

  <Step title="Überprüfen und bewerben">
    Überprüfen Sie alle Einstellungen. Wenn alles in Ordnung aussieht, klickt der Nutzer auf eine Schaltfläche wie **„Boost Post Now“**.
  </Step>

  <Step title="Anzeigenprüfung und -start">
    Facebook prüft die Anzeige – dies dauert in der Regel zwischen wenigen Minuten
    und einigen Stunden. Nach der Freigabe wird der beworbene Beitrag live geschaltet und gemäß
    den Einstellungen ausgespielt.
  </Step>

  <Step title="Ausgaben und Performance verfolgen">
    Überwachen Sie Folgendes:

    * Reichweite
    * Interaktion
    * Klicks
    * Ausgaben
    * Verbleibendes Budget

    <Card title="Facebook-Werbeausgaben und -Analysen abrufen" href="/apis/ads/facebook/get-ad-history" horizontal />
  </Step>
</Steps>

## Best Practices für die Ads-API

1. **Budgetverwaltung**: Beginnen Sie mit kleinen Testbudgets (z. B. 5–10 \$/Tag), um die Performance zu optimieren, bevor Sie skalieren.
2. **Anzeigenlaufzeit**: Facebook verlangt eine Mindestlaufzeit von etwa 30 Stunden zwischen Start- und Endzeit.
3. **Interessen-Targeting**: Wählen Sie 2–5 relevante Interessen für eine optimale Targeting-Genauigkeit.
4. **Kreativrichtlinien**: Verwenden Sie hochwertige Bilder und prägnante Botschaften, um die Interaktionsraten zu verbessern.
5. **Performance-Überwachung**: Prüfen Sie die Anzeigen-Performance regelmäßig und passen Sie Targeting oder kreative Elemente bei Bedarf an.

Ausführliche Informationen zu jedem Endpunkt, einschließlich Anfrageparametern, Antwortformaten und Beispielen, finden Sie in den Dokumentationsseiten der einzelnen API-Endpunkte.