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

# Phonexa-Integration einrichten

> Erfahren Sie, wie Sie Phonexa mit LanderLab verbinden, um Leads aus jeder Landingpage oder jedem Quiz-Funnel in Echtzeit direkt an Ihre Phonexa-Kampagnen zu senden.

> Verbinden Sie Phonexa mit Ihren Landingpages in LanderLab, um Lead-Daten in Echtzeit direkt an Ihre Phonexa-Kampagnen zu senden. Alles, was Sie brauchen, sind Ihre Publisher-API-Zugangsdaten aus der Phonexa-Plattform.

## Was ist Phonexa?

Phonexa ist eine All-in-one-Plattform für Performance-Marketing, die von Lead-Generatoren, Publishern und Werbetreibenden genutzt wird, um Lead-Verteilung, Call-Tracking, E-Mail-Marketing und mehr zu steuern. Das Produkt LMS Sync übernimmt das Lead-Posting und ermöglicht es Publishern, Leads in Echtzeit per HTTP POST an Phonexa-Kampagnen zu senden.

Wenn Sie Phonexa mit Ihrer Landingpage in LanderLab verbinden, wird jeder erfasste Lead über Ihre Publisher-API-Zugangsdaten automatisch an Ihre Phonexa-Kampagne gepostet. LanderLab übernimmt die API-Verbindung für Sie – Sie müssen also keinen eigenen Code schreiben und keine serverseitigen Integrationen manuell aufbauen.

<Note>
  Phonexa-Integrationen werden **nicht** global gespeichert. Jede Integration wird pro Landingpage konfiguriert. Sie müssen also für jede Landingpage, von der Sie Leads senden möchten, eine neue Phonexa-Verbindung einrichten.
</Note>

***

## So fügen Sie Phonexa hinzu

Die Phonexa-Einrichtung erfolgt über einen Assistenten mit 3 Schritten: Verbindung konfigurieren, Felder zuordnen und den finalen Payload prüfen, bevor die Verbindung hergestellt wird.

### Schritt 1: Die Verbindung konfigurieren

<Steps>
  <Step title="Öffnen Sie Ihre Landingpage">
    Gehen Sie zu **Landing Pages** und klicken Sie auf den **Namen der Landingpage**, der Sie die Phonexa-Integration hinzufügen möchten.
  </Step>

  <Step title="Öffnen Sie den Tab Integrations">
    Klicken Sie auf **Add Integration**, um das Integrationsfenster zu öffnen.
  </Step>

  <Step title="Wählen Sie die Phonexa-Integration aus">
    Suchen Sie in der Liste der verfügbaren Integrationen die **Phonexa integration** (gekennzeichnet mit „Send leads to Phonexa in real time“) und klicken Sie darauf. Der Konfigurationsassistent wird geöffnet.
  </Step>

  <Step title="Füllen Sie die Verbindungsdaten aus">
    Geben Sie die folgenden Angaben ein:

    | Feld             | Beschreibung                                                                                                                                          |
    | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Name**         | Eine Bezeichnung zur Identifikation dieser Integration (z. B. „Phonexa – Autokredite“). So erkennen Sie sie in der Integrationsliste leichter wieder. |
    | **API URL**      | Die URL des Posting-Endpunkts für Ihr Phonexa-Produkt (z. B. `api.phonexa.com/...`). Sie finden sie in Ihren Phonexa-Publisher-API-Spezifikationen.   |
    | **API ID**       | Ihre numerische Publisher API ID (z. B. `12345`). Dies ist die eindeutige Kennung Ihres Publisher-Kontos in Phonexa.                                  |
    | **API Password** | Das zu Ihrer Publisher API ID gehörende API-Passwort. Es wird in Phonexa festgelegt und verwaltet.                                                    |

    <Tip>
      Um Ihre **API URL**, **API ID** und Ihr **API Password** zu finden, melden Sie sich bei Ihrem Phonexa-Konto an und gehen Sie zu **LMS Sync**; öffnen Sie dort **Publisher Products API**. Wählen Sie das Produkt aus, an das Sie Leads senden möchten. Posting-URL, API ID und API Password sind allesamt im Abschnitt Lead Specs Ihrer API-Dokumentation aufgeführt. Sie finden sie außerdem in Ihrem Publisher-Profil unter den Einstellungen für den API Access.
    </Tip>
  </Step>

  <Step title="Klicken Sie auf Continue">
    Klicken Sie auf **Continue**, um zum Schritt der Feldzuordnung zu gelangen.
  </Step>
</Steps>

***

### Schritt 2: Felder zuordnen

In diesem Schritt wählen Sie aus, welche Datenfelder in die Anfrage aufgenommen werden und wie sie beim Senden an Phonexa benannt sein sollen.

<Steps>
  <Step title="Felder auswählen und konfigurieren">
    LanderLab bindet automatisch eine Reihe von LanderLab-Standardfeldern ein. Jedes Feld hat ein Kontrollkästchen zum Ein- oder Ausschließen sowie eine Spalte **Sent As**, in der Sie den Schlüssel passend zu den Erwartungen von Phonexa umbenennen können.

    Die LanderLab-Standardfelder sind:

    | Formularfeld               | Sent As (Standardschlüssel) | Beschreibung                                                            |
    | :------------------------- | :-------------------------- | :---------------------------------------------------------------------- |
    | **LL Lander URL**          | `ll_lander_url`             | Die vollständige URL der Landingpage, auf der sich der Besucher befand. |
    | **LL Visitor IP**          | `ll_visitor_ip`             | Die IP-Adresse des Besuchers.                                           |
    | **LL Visitor User Agent**  | `ll_visitor_user_agent`     | Informationen zu Browser und Gerät des Besuchers.                       |
    | **LL Submission Time UTC** | `ll_submission_time_utc`    | Datum und Uhrzeit der Lead-Übermittlung (in UTC).                       |
    | **LL Variant ID**          | `ll_variant_id`             | Die ID der A/B-Test-Variante, die dem Besucher angezeigt wurde.         |

    Aktivieren oder deaktivieren Sie Felder über die Kontrollkästchen. Bearbeiten Sie den Wert unter **Sent As**, damit er den Feldnamen in Ihren Phonexa-API-Spezifikationen entspricht.

    <Tip>
      Wenn Ihre Landingpage einen **Quiz-Funnel** oder ein **Formular** enthält, erscheinen alle von Ihnen hinzugefügten Formularfelder (etwa Name, E-Mail, Telefon, Adresse und beliebige eigene Eingaben) automatisch in dieser Feldliste neben den LanderLab-Standardfeldern. Sie können sie genauso aktivieren, deaktivieren oder umbenennen wie die Standardfelder. Achten Sie darauf, dass die Werte unter **Sent As** exakt den Feldnamen in Ihren Phonexa-API-Spezifikationen entsprechen. Phonexa lehnt Leads ab, die Felder im falschen Format oder ohne erforderliche Werte enthalten.
    </Tip>
  </Step>

  <Step title="Benutzerdefinierte Felder hinzufügen (optional)">
    Klicken Sie im Bereich **Additional fields** auf **+ Add field**, um zusätzliche Schlüssel-Wert-Paare in die Anfrage aufzunehmen. Das ist nützlich, um statische Werte wie Sub-IDs, Kennungen der Traffic-Quelle oder beliebige andere Parameter zu senden, die Ihre Phonexa-Kampagne benötigt.
  </Step>

  <Step title="Klicken Sie auf Continue">
    Klicken Sie auf **Continue**, um zum Prüfschritt zu gelangen.
  </Step>
</Steps>

***

### Schritt 3: Prüfen und verbinden

<Steps>
  <Step title="Prüfen Sie Ihre Phonexa-Integration">
    Der letzte Schritt zeigt eine vollständige Zusammenfassung dessen, was für jeden Lead an Phonexa gesendet wird. Sie sehen:

    * Den **Posting-Typ** und den Namen der Integration
    * Den Bereich **Konfiguration** mit Ihrer API URL, Ihrer API ID und Ihrem API Password
    * Den Bereich **Feldzuordnung** mit allen Feldern und ihren zugehörigen Template-Variablen (z. B. `{{LL Lander URL}}`, `{{LL Visitor IP}}`)

    Prüfen Sie alles sorgfältig, um sicherzustellen, dass Konfiguration und Feldnamen den Erwartungen Ihrer Phonexa-Kampagne entsprechen. Wenn etwas nicht stimmt, klicken Sie auf **Back**, um zu den vorherigen Schritten zurückzukehren.
  </Step>

  <Step title="Klicken Sie auf Connect Phonexa">
    Wenn alles korrekt aussieht, klicken Sie auf die Schaltfläche **Connect Phonexa**, um die Integration zu speichern und zu aktivieren.
  </Step>
</Steps>

***

## Wo Sie Ihre Phonexa-API-Zugangsdaten finden

Wenn Sie nicht sicher sind, wo Sie Ihre API URL, API ID und Ihr API Password finden, gehen Sie wie folgt vor:

1. Melden Sie sich bei Ihrem [Phonexa](https://app.phonexa.com)-Konto an.
2. Gehen Sie in der linken Seitenleiste zu **LMS Sync**.
3. Klicken Sie auf **Publisher Products API**.
4. Wählen Sie das Produkt aus, das Sie verbinden möchten.
5. Im Abschnitt **Lead Specs** finden Sie die **Posting-URL** (Ihre API URL), die **API ID** und das **API Password**.

Sie finden Ihre API ID und Ihr API Password auch in Ihrem Publisher-Profil unter den Einstellungen für den **API Access**. Klicken Sie neben dem Feld für das API Password auf die Schaltfläche **Show**, um den Wert anzuzeigen.

<Warning>
  Wenn Sie Ihr API Password in Phonexa ändern oder zurücksetzen, funktioniert das alte Passwort nicht mehr. Denken Sie daran, das Passwort in diesem Fall auch in LanderLab zu aktualisieren.
</Warning>

***

## Tipps zur Phonexa-Integration

* **Feldnamen exakt abgleichen** – Phonexa validiert alle eingehenden Felder anhand der API-Spezifikationen Ihres Produkts. Benennen Sie Felder über die Spalte **Sent As** in Schritt 2 so um, dass sie exakt den Feldnamen in Ihrer Phonexa-Dokumentation entsprechen.
* **Pflichtfelder prüfen** – Die API-Spezifikationen Ihres Phonexa-Produkts kennzeichnen eindeutig, welche Felder erforderlich sind. Leads, bei denen Pflichtfelder fehlen oder deren Werte im falschen Format vorliegen, werden abgelehnt.
* **Während der Einrichtung den Testmodus nutzen** – Phonexa unterstützt einen Testmodus, indem `testMode=1` in den Payload aufgenommen wird. Sie können dies zum Testen über den Bereich **Additional fields** in Schritt 2 als statisches Schlüssel-Wert-Paar hinzufügen. Entfernen Sie es vor dem Livegang wieder.