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

# Meta Ads mit anny verbinden

> Miss Seitenaufrufe und Buchungen deiner anny-Buchungsseite als Conversions in Meta Ads und optimiere deine Kampagnen.

[Meta Ads](https://www.facebook.com/business/ads) ist die Werbeplattform von Facebook und Instagram. Das **Meta Pixel** ist ein kleines Skript, das misst, was Besucher:innen auf deiner Buchungsseite tun. Mit der Integration bindet anny dein Meta Pixel automatisch auf deinen öffentlichen anny-Buchungs- und Shop-Seiten ein und meldet Buchungen als Conversions an Meta.

Mit Meta Ads kannst du in anny:

* Seitenaufrufe und Buchungen deiner anny-Buchungsseite direkt an Meta melden
* Abgeschlossene Buchungen als **Kauf**-Conversion mit Bestellwert an Meta übergeben
* Deine Meta-Kampagnen auf tatsächliche Buchungen optimieren und den Werbeerfolg messen

Besonders sinnvoll ist die Integration, wenn du über Facebook- oder Instagram-Anzeigen Besucher:innen auf deine anny-Buchungsseite bringst und wissen willst, welche Anzeigen zu echten Buchungen führen.

<Info>
  Die Meta-Ads-Integration ist Teil der Marketing-Integrationen und benötigt einen entsprechenden Plan. Prüfe deinen Plan oder frage das anny-Team, falls die Integration bei dir nicht auswählbar ist.
</Info>

## Typische Anwendungsfälle

| Anwendungsfall                     | Beschreibung                                                                                                                                                                      |
| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kampagnen auf Buchungen optimieren | **Meta lernt, welche Anzeigen zu Buchungen führen.** anny meldet jede abgeschlossene Buchung als Kauf-Conversion, sodass Meta dein Budget auf die erfolgreichsten Anzeigen lenkt. |
| Werbeerfolg messen                 | **Du siehst im Events Manager, wie viele Buchungen aus Anzeigen entstehen.** Seitenaufruf, Checkout-Start und Kauf landen als Ereignisse in deinem Meta-Konto.                    |
| Attribution absichern              | **Die Offline Conversion API meldet Käufe zusätzlich server-seitig.** So gehen Conversions auch dann nicht verloren, wenn ein Browser das Pixel blockiert.                        |

## Wie die Meta-Ads-Verbindung funktioniert

Die Verbindung besteht aus zwei Bausteinen, die du unabhängig voneinander nutzen kannst.

**Meta Pixel im Browser.** Du trägst deine **Pixel ID** ein und aktivierst die Integration. Danach lädt anny das Meta-Pixel-Skript auf deinen öffentlichen anny-Buchungs- und Shop-Seiten und meldet Ereignisse direkt aus dem Browser deiner Besucher:innen an Meta. Für diesen Baustein genügt die Pixel ID.

**Offline Conversion API.** Zusätzlich kannst du einen **Access token** hinterlegen und **Autorisieren**. Damit sendet anny Kauf-Conversions zusätzlich direkt vom anny-Server an Meta, unabhängig vom Browser. Das verbessert die Attribution. Dieser Baustein meldet nur den **Kauf** und feuert nur für Besucher:innen, die über eine Meta-Anzeige auf deine Buchungsseite kamen.

Worauf anny **zugreift**: anny sendet Ereignisse an dein Meta-Konto, das über Pixel ID und Access token bestimmt ist. Worauf anny **nicht** zugreift: anny liest keine Daten aus deinem Meta-Werbekonto und ändert dort nichts. Es werden nur Ereignisse gesendet.

Welche Daten anny beim Kauf an Meta übergibt:

| Daten                              | Zweck                                       |
| :--------------------------------- | :------------------------------------------ |
| Meta-Klick-Kennung der Besucher:in | Ordnet die Buchung der richtigen Anzeige zu |
| Bestellwert (netto) und Währung    | Misst den Umsatz der Conversion             |
| Bestellnummer und Zeitpunkt        | Identifiziert die Buchung eindeutig         |

anny übergibt für die Conversion keine Namen und keine E-Mail-Adressen an Meta.

**Cookie-Zustimmung:** Das Meta Pixel lädt im Browser erst, wenn Besucher:innen im Cookie-Banner **Marketing** akzeptieren. Ohne diese Zustimmung sendet anny keine Browser-Ereignisse. Widerrufen Besucher:innen die Zustimmung während der Sitzung, stoppt anny das Tracking sofort.

## Meta Ads verbinden

### Voraussetzungen

Bevor du Meta Ads verbindest, stelle sicher, dass du Folgendes hast:

* Ein Meta-Business-Konto mit einem eingerichteten Meta Pixel und Zugriff auf die **Pixel ID** (Meta: Events Manager → Datensätze → Pixel auswählen → Pixel ID)
* Für die Offline Conversion API zusätzlich einen **Access token** (Meta: Events Manager → Tag auswählen → Einstellungen → Conversion API → Zugriffstoken generieren)
* Ein aktives Cookie-Banner auf deiner anny-Buchungsseite, damit Besucher:innen dem Marketing-Tracking zustimmen können
* Admin-Rechte in deinem anny Account

### Verbindung einrichten

<Steps>
  <Step title="Pixel ID eintragen">
    Öffne aus der Menüleiste die **Integrationen** und gehe zu **Meta Ads**. Trage im Panel **Meta Pixel** deine **Pixel ID** ein.
  </Step>

  <Step title="Offline Conversion API einrichten (optional)">
    Möchtest du Käufe zusätzlich server-seitig melden, trage im Panel **Offline Conversion API** deinen **Access token** ein und klicke auf **Autorisieren**. Ohne diesen Schritt läuft nur das Meta Pixel im Browser.
  </Step>

  <Step title="Integration aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts. anny bindet das Pixel danach auf deinen öffentlichen Buchungs- und Shop-Seiten ein.
  </Step>
</Steps>

Sobald die Integration aktiv ist und Besucher:innen Marketing-Cookies akzeptieren, meldet anny Seitenaufrufe und Buchungen automatisch an Meta.

<Tip>
  Prüfe die Verbindung im Meta Events Manager: Öffne deine anny-Buchungsseite, akzeptiere die Marketing-Cookies und lege eine Testbuchung an. Kurz darauf sollten die Ereignisse **PageView** und **Purchase** in Meta erscheinen.
</Tip>

### Einstellungen & Optionen

Diese Ereignisse meldet anny an Meta:

| Ereignis           | Meta-Event       | Wann es ausgelöst wird                                                                        |
| :----------------- | :--------------- | :-------------------------------------------------------------------------------------------- |
| Seitenaufruf       | PageView         | Eine Besucher:in öffnet eine anny-Buchungs- oder Shop-Seite.                                  |
| In den Warenkorb   | AddToCart        | Eine Leistung wird zur Buchung ausgewählt.                                                    |
| Checkout gestartet | InitiateCheckout | Die Besucher:in beginnt den Checkout.                                                         |
| Kauf               | Purchase         | Die Buchung wird abgeschlossen. anny übergibt Bestellwert (netto), Währung und Bestellnummer. |

Seitenaufruf, In den Warenkorb und Checkout gestartet laufen ausschließlich über das Meta Pixel im Browser. Der Kauf wird zusätzlich über die Offline Conversion API gemeldet, falls du einen Access token hinterlegt hast.

## Einschränkungen

Die Meta-Ads-Integration unterstützt nicht:

* **Tracking auf externen Seiten:** anny bindet das Pixel nur auf deinen anny-Buchungs- und Shop-Seiten ein, nicht auf deiner eigenen Website oder anderen Seiten.
* **Auslesen von Meta-Daten:** anny sendet nur Ereignisse an Meta. Kampagnen, Zielgruppen oder Statistiken aus deinem Werbekonto werden nicht in anny angezeigt.
* **Eigene Ereignisdefinitionen:** Es werden die festen Ereignisse Seitenaufruf, In den Warenkorb, Checkout gestartet und Kauf gesendet. Zusätzliche oder umbenannte Ereignisse sind nicht möglich.
* **Tracking ohne Cookie-Zustimmung:** Ohne akzeptierte Marketing-Cookies lädt das Meta Pixel im Browser nicht.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, bindet anny das Meta Pixel nicht mehr auf deinen Buchungsseiten ein und sendet keine neuen Conversions mehr an Meta. Bereits an Meta übermittelte Ereignisse bleiben in deinem Meta-Konto erhalten. Beim Löschen entfernt anny deine gespeicherte Pixel ID und den Access token; weitere Schritte sind nicht erforderlich.
</Warning>

Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

<AccordionGroup>
  <Accordion title="Brauche ich für das Tracking einen Access token?">
    Nein. Für das Meta Pixel im Browser genügt die **Pixel ID**. Der **Access token** ist nur nötig, wenn du zusätzlich die **Offline Conversion API** nutzen willst, die Käufe server-seitig an Meta meldet.
  </Accordion>

  <Accordion title="Werden Buchungen auch ohne Cookie-Zustimmung erfasst?">
    Das Meta Pixel im Browser lädt nur, wenn Besucher:innen im Cookie-Banner **Marketing** akzeptieren. Ohne Zustimmung sendet anny aus dem Browser keine Ereignisse an Meta.
  </Accordion>

  <Accordion title="Auf welchen Seiten läuft das Meta Pixel?">
    Auf deinen öffentlichen anny-Buchungs- und Shop-Seiten, zum Beispiel Ressourcen-, Service-, Paket- und Checkout-Seiten. anny bindet das Pixel nicht auf deiner eigenen Website ein.
  </Accordion>

  <Accordion title="Welchen Wert meldet die Kauf-Conversion?">
    anny übergibt den **Nettobetrag** der Buchung, die **Währung** und die **Bestellnummer**. Namen oder E-Mail-Adressen werden für die Conversion nicht an Meta gesendet.
  </Accordion>

  <Accordion title="Wo finde ich meine Pixel ID und den Access token?">
    Die **Pixel ID** findest du im Meta Events Manager unter Datensätze im gewählten Pixel. Den **Access token** erzeugst du im Events Manager unter den Einstellungen deines Tags im Bereich Conversion API.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Im Meta Events Manager kommen keine Ereignisse an">
    Meist ist die Integration nicht aktiv oder Besucher:innen haben keine Marketing-Cookies akzeptiert. Prüfe, ob der **Toggle** aktiv ist, ob die **Pixel ID** korrekt eingetragen ist und ob auf deiner Buchungsseite die Marketing-Cookies akzeptiert wurden.
  </Accordion>

  <Accordion title="Der Access token lässt sich nicht speichern">
    Der Access token lässt sich nur bei deaktivierter Integration setzen. Deaktiviere die Integration zuerst über den **Toggle**, trage dann den Access token ein und klicke auf **Autorisieren**. Aktiviere die Integration danach wieder.
  </Accordion>

  <Accordion title="Server-seitige Conversions fehlen trotz eingerichtetem Access token">
    Die Offline Conversion API meldet nur den **Kauf** und nur für Besucher:innen, die über eine Meta-Anzeige auf deine Buchungsseite kamen. Prüfe, ob der Access token gültig und nicht abgelaufen ist und ob die Buchung tatsächlich aus einem Anzeigenklick stammt.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Meta Ads ist eine Marketing-/Tracking-Integration (Meta Pixel + Conversions API), KEINE Smart-Lock- oder Kalender-Integration. anny sendet nur Ereignisse an Meta und liest keine Daten aus dem Meta-Werbekonto zurück. Kein Import von Kampagnen, Zielgruppen oder Statistiken.
>
> **Zwei unabhängige Bausteine:** (1) Meta Pixel im Browser: braucht nur die Pixel ID; lädt `fbevents.js` auf den öffentlichen anny-Buchungs-/Shop-Seiten (app-shop: Ressourcen-, Service-, Plan-, Paket-, Explore-, Checkout-Seiten), nicht in der Admin-Oberfläche und nicht auf externen Websites. Feuert PageView, AddToCart, InitiateCheckout, Purchase. (2) Offline Conversion API (Metas Conversions API/CAPI): braucht zusätzlich den Access token; sendet server-seitig nur das Ereignis Purchase.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → **Meta Ads**. Panel „Meta Pixel" mit Feld „Pixel ID"; Panel „Offline Conversion API" mit Feld „Access token" + Button „Autorisieren". Pixel ID und Access token sind im aktiven Zustand gesperrt; zum Ändern zuerst über den Toggle deaktivieren. Aktivieren/Deaktivieren: Toggle oben rechts; Löschen: drei Punkte → Löschen.
>
> **Quirks:** (1) Cookie-Consent steuert NUR das Browser-Pixel (Marketing-Zustimmung nötig, Widerruf stoppt sofort). Die server-seitige CAPI-Conversion sendet unabhängig von der Browser-Zustimmung. (2) Die server-seitige Purchase-Conversion feuert nur, wenn zur Buchung eine Meta-Klick-ID (fbc aus fbclid oder fbp) vorliegt, also nur für Besucher:innen aus einem Meta-Anzeigenklick. (3) Purchase-Wert = Nettobetrag; zusätzlich Währung und Bestellnummer; keine Namen/E-Mails. (4) Ungültige Pixel ID (unerlaubte Zeichen) verhindert die Aktivierung mit Fehlermeldung. (5) Fehlgeschlagene server-seitige Conversions werden bei Server-/Ratenlimit-Fehlern bis zu dreimal mit wachsendem Abstand wiederholt, bei inhaltlichen Fehlern nicht.
>
> **Beziehungen:** Gehört zur Kategorie Marketing-Integrationen gemeinsam mit Google Ads, TikTok Ads und LinkedIn Ads (gleiche Feature-/Plan-Gruppe, gleiche Cookie-Consent-Logik). Die Klick-ID-Erfassung (fbclid, \_fbp, UTM-Parameter) teilt sich die technische Grundlage mit dem UTM-Tracking, siehe Artikel „utm-tracking". Cookie-Consent siehe Artikel „datenschutz". Plan-Verfügbarkeit über das Marketing-Feature; konkrete Plan-Stufe liegt in der Datenbank und ist im Code nicht final verifizierbar.
