Postback: Grundlagen

Ein Postback ist ein effektives Tool, um die Datenübertragung zwischen Systemen zu automatisieren.

Wenn Du mit Catuik ein eigenes Conversion-Tracking-System nutzt, hinterlege die Webadresse Deines Servers (Postback-URL) in Catuik und erhalte sofort Daten zu allen Conversions. Catuik sendet die Daten über GET- oder POST-HTTP-Anfragen an Deinen Server. Ein Postback ermöglicht eine schnelle und präzise Datenerfassung. So kannst Du Deine Analysen verbessern und die Conversion-Rate Deiner Werbung steigern.

Postback hinzufügen

1. Öffne das Profilmenü → Postback.
2. Klicke auf Postback hinzufügen.

Du kannst mehrere Postback-URLs hinzufügen und für unterschiedliche Anforderungen konfigurieren.

3. Fülle auf der Seite Postback hinzufügen die Felder aus:
   • Postback-Name — gib einen Namen ein, der die übertragenen Daten beschreibt oder den Namen Deines Servers enthält.
   • HTTP-Methode — wähle die Methode aus, mit der Du die Daten empfangen möchtest.

Der wichtigste Unterschied zwischen GET und POST liegt darin, wie die Daten übertragen werden:

• GET sendet alle erfassten Daten als Teil der URL. Parameter und ihre Werte werden an das Ende des Links angehängt;
• POST überträgt die Daten im Request-Body und nicht in der URL.

• URL — gib die URL Deines Servers ein, an die die HTTP-Anfrage gesendet wird.
• Parameter — wähle die Tracking-Parameter aus, die an Deinen Server übertragen werden sollen, und gib die Bezeichnungen ein, die Du bereits in Deinem System verwendest.

4. Klicke auf Testen, um den Postback sofort zu prüfen.
   Beachte, dass beim Test nur geprüft wird, ob eine Antwort von Deinem Server eingeht, nicht jedoch der Antwortcode.
   • Wenn der Test erfolgreich ist, wird eine entsprechende Benachrichtigung angezeigt.
   • Wenn beim Test Fehler auftreten, prüfe, ob die Server-URL korrekt und erreichbar ist, oder wende Dich an den Support unter support@catuik.com.
5. Klicke oben rechts auf Speichern. Der Postback erscheint in der Liste auf der Seite Postback.

Verwalte Deine Postbacks auf der Seite Postback.

Um einen Postback zu aktivieren oder zu deaktivieren, verwende den Schalter Aktivieren.

Um einen Postback zu bearbeiten oder zu löschen, klicke in seiner Zeile auf das Drei-Punkte-Menü und wähle die gewünschte Aktion.

Request-Parameter

• id — eindeutige ID der Conversion.
• date — Datum der Conversion.
• subid — Kennzeichnung für detailliertes Tracking und die Analyse von Conversion-Quellen. Du kannst eine subid beim Erstellen eines Affiliate-Links über die API oder manuell hinzufügen.
• publisher_fee — Deine Provision.
• total_cart — Warenkorbsumme für CPA-Bestellungen.
• ip — IP-Adresse des Nutzers, der auf den Link geklickt hat.
• currency — Währung der Conversion.
• status — Status der Conversion. Drei Werte sind möglich:
  • pending — „Ausstehend“;
  • approved — „Genehmigt“;
  • declined — „Abgelehnt“.
• orders — Anzahl der vergüteten Conversions (Bestellungen oder bestellte Artikel, je nachdem, welche Daten der Marktplatz übermittelt).
• product_id — eindeutige Produkt-ID.
• product_sku — Artikelnummer (SKU) des Produkts.
• product_title — Produktname.
• campaign_id — ID der Werbekampagne, der die Conversion zugeordnet ist.
• payment_type — Vergütungsmodell:
  • cpa — Vergütung pro Bestellung,
  • cpc — Vergütung pro Klick unter Berücksichtigung der Verkäufe (verkaufsbasierter CPC),
  • cpmc — Vergütung für einen Klick vom Storefront zum Produkt (Storefront-CPC),
  • hcpa — Vergütung für Verkäufe plus eine feste Provision bei Erreichen des Klick-Schwellenwerts (Hybrid-CPA).
• marketplace — Name (Slug) des Marktplatzes, auf dem die Bestellung aufgegeben wurde. Folgende Werte sind möglich: admitad, iherb, allegro, joom.
• marketplace_store_id — ID des Verkäufer-Shops auf dem Marktplatz.
• marketplace_store_title — Name des Verkäufer-Shops auf dem Marktplatz.

Beispiel einer Anfrage

Du hast die folgenden Tracking-Parameter ausgewählt, die an Deinen Server übertragen werden: id, publisher_fee und status.

Eine GET-HTTP-Anfrage sieht so aus:

https://example.com/foo/bar?conversion_id=564b70fd-62f8-4a31-930a-64f31a7a5c10&amount=10.57&status=pending

Eine POST-HTTP-Anfrage sieht so aus:

{
  "conversion_id": "564b70fd-62f8-4a31-930a-64f31a7a5c10",
  "amount": 10.57,
  "status": "pending"
}