Leitfaden für Ziele und Conversions


Ziele Übersicht

Was ist ein Ziel?

Ein Ziel ist eine Ziel-URL, zu der Ihr Traffic weitergeleitet wird, nachdem er durch Kampagnen-Flows und Filter geleitet wurde. Jedes Ziel stellt eine finale Landingpage, ein Angebot oder eine andere Kampagne in Ihrem Traffic-Verteilungssystem dar.

Ziele sind die Endpunkte in Ihrem Traffic-Flow:

Hauptfunktionen


Ziele erstellen und verwalten

Ein neues Ziel erstellen

  1. Navigieren Sie zur Seite Ziele im Hauptmenü
  2. Klicken Sie auf die Schaltfläche Ziel hinzufügen
  3. Füllen Sie die Zieldetails aus:
    • Name: Beschreibender Name für das Ziel (z.B. "Angebot A - Desktop")
    • Zieltyp: Wählen Sie zwischen:
      • URL: Externe Ziel-URL
      • Kampagne: Weiterleitung zu einer anderen Kampagne (Kampagnen-Verkettung)
    • URL (für URL-Typ): Die Ziel-URL
    • Kampagne (für Kampagnen-Typ): Wählen Sie die Kampagne für die Weiterleitung
    • Redirect-Typ: Wie die Weiterleitung ausgeführt wird (siehe Redirect-Typen)
    • Beschreibung (optional): Notizen zu diesem Ziel

Funktionen der Zielliste

Die Ziele-Seite bietet:

Ziele bearbeiten

  1. Klicken Sie auf eine Zielzeile, um die Detailseite zu öffnen
  2. Klicken Sie auf die Schaltfläche Bearbeiten
  3. Ändern Sie die Zieldetails
  4. Klicken Sie auf Speichern, um die Änderungen anzuwenden

Ziele löschen

  1. Klicken Sie in der Zielliste auf das Lösch-Symbol (Papierkorb) neben dem Ziel
  2. Bestätigen Sie die Löschung
  3. Hinweis: Ziele, die aktiven Flows zugewiesen sind, sollten vor der Löschung neu zugewiesen werden

Ziel-URL Makros

Ziel-URLs unterstützen dynamische Makros (Platzhalter), die automatisch durch tatsächliche Werte ersetzt werden, wenn Traffic weitergeleitet wird.

Verfügbare Makros

Makro Beschreibung Beispielwert
{click_id} Eindeutige Klick-Kennung 86f72615f9f2c70d6d0
{campaign_id} Kampagnen-ID 123
{flow_id} Flow-ID 456
{target_id} Ziel-ID 789
{country} Ländercode des Besuchers (ISO 2-stellig) US
{device} Gerätetyp desktop, mobile, tablet
{os} Betriebssystem Windows, iOS, Android
{browser} Browser-Name Chrome, Safari, Firefox
{language} Browser-Sprache en, es, fr
{ip} IP-Adresse des Besuchers 192.168.1.1
{timestamp} Aktueller Unix-Zeitstempel 1701234567890
{random} Zufallszahl (0-999999) 456789
{date} Aktuelles Datum (JJJJ-MM-TT) 2025-12-11
{time} Aktuelle Zeit (HH:MM:SS) 14:30:45

Makros in Ziel-URLs verwenden

Beispiel 1: Basis-Tracking

https://example.com/offer?click={click_id}&country={country}

Ergebnis:

https://example.com/offer?click=86f72615f9f2c70d6d0&country=US

Beispiel 2: Erweitertes Tracking

https://partner.com/track?cid={campaign_id}&clid={click_id}&device={device}&os={os}×tamp={timestamp}

Ergebnis:

https://partner.com/track?cid=123&clid=86f72615f9f2c70d6d0&device=mobile&os=iOS×tamp=1701234567890

Beispiel 3: Benutzerdefinierte Parameter

https://offers.com/page?subid={click_id}&geo={country}&ua={device}&source=tds

Ergebnis:

https://offers.com/page?subid=86f72615f9f2c70d6d0&geo=FR&ua=desktop&source=tds

Wichtige Hinweise


Redirect-Typen erklärt

Simple TDS unterstützt mehrere Redirect-Methoden, um verschiedene Anwendungsfälle zu berücksichtigen und verschiedene Tracking-Einschränkungen zu umgehen.

1. HTTP 302 Redirect (Standard)

Typ: http

Beschreibung: Standard serverseitige HTTP-Weiterleitung mit 302-Statuscode.

Vorteile:

Nachteile:

Am besten für: Allgemeine Nutzung, die meisten Angebote, schnelle Weiterleitungen

Beispielantwort:

HTTP/1.1 302 Found
Location: https://example.com/offer?click_id=123

2. Meta Refresh Redirect

Typ: meta

Beschreibung: HTML-Seite mit Meta-Refresh-Tag, das nach dem Laden der Seite weiterleitet.

Vorteile:

Nachteile:

Am besten für: Angebote, die Referrer-Tracking erfordern, Umgehung bestimmter Einschränkungen

Beispiel HTML:

<!DOCTYPE html>
<html>
<head>
    <meta http-equiv="refresh" content="0;url=https://example.com/offer?click_id=123">
</head>
<body>Weiterleitung...</body>
</html>

3. JavaScript Redirect

Typ: js

Beschreibung: JavaScript-basierte Weiterleitung mit window.location.

Vorteile:

Nachteile:

Am besten für: Moderne Browser, tracking-intensive Kampagnen

Beispiel HTML:

<!DOCTYPE html>
<html>
<head>
    <script>
        window.location.href = 'https://example.com/offer?click_id=123';
    </script>
</head>
<body>Weiterleitung...</body>
</html>

4. Blank Referrer Redirect

Typ: blank_referrer

Beschreibung: Öffnet Ziel in neuem Fenster/Tab mit leerem Referrer, schließt dann das Original.

Vorteile:

Nachteile:

Am besten für: Angebote, die Referrer ablehnen, datenschutzorientierte Weiterleitungen

5. cURL Redirect

Typ: curl

Beschreibung: Lädt die Zielseite serverseitig und zeigt sie direkt an.

Vorteile:

Nachteile:

Am besten für: Erweiterte Anwendungsfälle, Content-Proxying

6. Double Meta Redirect

Typ: double_meta

Beschreibung: Zweistufige Meta-Refresh-Weiterleitung für maximale Referrer-Manipulation.

Vorteile:

Nachteile:

Am besten für: Sehr restriktive Angebote, erweiterte Tracking-Anforderungen

7. Form Submit Redirect

Typ: form_submit

Beschreibung: Verwendet ein automatisch abgesendetes HTML-Formular zur Weiterleitung.

Vorteile:

Nachteile:

Am besten für: Angebote, die POST-Daten erfordern, spezielle Tracking-Szenarien

8. iFrame Redirect

Typ: iframe

Beschreibung: Zeigt Zielseite innerhalb eines iFrames an.

Vorteile:

Nachteile:

Am besten für: Content-Anzeige, Seiten die iFrame-Einbettung erlauben


Gewichtungsverteilung der Ziele

Wenn mehrere Ziele einem einzelnen Flow zugewiesen sind, verwendet das System gewichtsbasierte Verteilung, um den Traffic proportional aufzuteilen.

Wie Gewichtungen funktionieren

Gewichtungen sind relative Zahlen, die den Prozentsatz des Traffics bestimmen, den jedes Ziel erhält. Das System berechnet den Prozentsatz basierend auf dem Gesamtgewicht.

Formel:

Ziel-Prozentsatz = (Zielgewicht / Gesamtgewicht) × 100

Gewichtungsbeispiele

Beispiel 1: Gleichmäßige Verteilung

Ziel Gewicht Traffic %
Ziel A 100 33,3%
Ziel B 100 33,3%
Ziel C 100 33,3%
Gesamt 300 100%

Beispiel 2: Gewichtete Verteilung

Ziel Gewicht Traffic %
Ziel A 50 25%
Ziel B 100 50%
Ziel C 50 25%
Gesamt 200 100%

Beispiel 3: Benutzerdefinierte Verteilung

Ziel Gewicht Traffic %
Ziel A (Beste Leistung) 70 70%
Ziel B (Test) 20 20%
Ziel C (Backup) 10 10%
Gesamt 100 100%

Best Practices

  1. Beginnen Sie mit gleichen Gewichtungen (jeweils 100) und passen Sie basierend auf der Leistung an
  2. Verwenden Sie runde Zahlen für einfachere Berechnung (10, 50, 100)
  3. Testen Sie neue Ziele mit niedrigen Gewichtungen (10-20) bevor Sie hochskalieren
  4. Überwachen Sie Conversions und passen Sie Gewichtungen an, um ROI zu maximieren
  5. Setzen Sie Backup-Ziele mit niedrigen Gewichtungen (5-10) als Fallback

Gewichtungs-Auswahl-Algorithmus

Das System verwendet gewichtete Zufallsauswahl:

  1. Berechnet kumulative Gewichtsbereiche für jedes Ziel
  2. Generiert eine Zufallszahl zwischen 0 und Gesamtgewicht
  3. Wählt das Ziel, dessen Bereich die Zufallszahl enthält
  4. Nur aktive Ziele nehmen an der Auswahl teil

Ziele zu Flows zuweisen

Ziele werden Flows über die Seite Flow-Details zugewiesen. Jede Zuweisung erstellt eine FlowTarget-Beziehung mit einem Gewichtswert.

Schritte zum Zuweisen von Zielen

  1. Navigieren Sie zu Kampagnen und wählen Sie Ihre Kampagne
  2. Klicken Sie auf einen Flow, um die Flow-Detailseite zu öffnen
  3. Scrollen Sie zum Abschnitt Ziele
  4. Klicken Sie auf Ziel hinzufügen oder Ziel zuweisen
  5. Wählen Sie ein Ziel aus dem Dropdown
  6. Setzen Sie den Wert für Gewicht (Standard: 100)
  7. Klicken Sie auf Speichern

Flow-Ziel-Zuweisungen verwalten

Exit-Flow-Ziele

Flows können als Exit Flow markiert werden. Dies sind spezielle Flows, die verwendet werden, wenn kein regulärer Flow mit den Besucher-Filtern übereinstimmt:


Conversions Übersicht

Was ist eine Conversion?

Eine Conversion tritt ein, wenn ein Besucher, der durch Ihr TDS geklickt hat, eine gewünschte Aktion auf der Zielseite abschließt, wie zum Beispiel:

Conversion-Datenstruktur

Jeder Conversion-Datensatz enthält:


Conversion-Tracking Methoden

Simple TDS unterstützt drei Methoden für das Tracking von Conversions. Alle Methoden werden über die /c/-Endpunkte aufgerufen (nicht /api/).

Methode 1: Postback-URL (Server-zu-Server)

Am besten für: CPA-Netzwerke, Affiliate-Plattformen, automatisiertes Tracking

Endpunkt: GET /c/postback

URL-Format:

https://ihredomain.com/c/postback?click_id={click_id}&conversion_type={conversion_type}&conversion_value={conversion_value}&external_id={external_id}

Parameter:

Parameter Erforderlich Beschreibung Beispiel
click_id Ja* Eindeutige Klick-Kennung 86f72615f9f2c70d6d0
campaign_id Ja* Kampagnen-ID (wenn click_id nicht verfügbar) 123
conversion_type Nein Typ/Kategorie der Conversion lead, sale, registration
conversion_value Nein Geldwert oder benutzerdefinierter Wert 100.50
external_id Nein Transaktions-/Bestell-ID des Partners order_12345

*Entweder click_id oder campaign_id muss angegeben werden.

Beispielnutzung:

https://ihredomain.com/c/postback?click_id=86f72615f9f2c70d6d0&conversion_type=sale&conversion_value=49.99&external_id=order_12345

Antwort:

{
  "success": true,
  "conversion_id": 456
}

Einrichtungsanleitung:

  1. Gehen Sie zur Seite Conversions
  2. Wählen Sie Ihre Kampagne
  3. Kopieren Sie die Postback-URL vom Postback-Tab
  4. Ersetzen Sie Platzhalter durch die Makros Ihres Partners:
    • Ersetzen Sie {click_id} durch das Click-ID-Makro des Partners
    • Ersetzen Sie {conversion_type} durch einen festen Wert oder Partner-Makro
    • Ersetzen Sie {conversion_value} durch das Auszahlungs-Makro des Partners
    • Ersetzen Sie {external_id} durch das Transaktions-ID-Makro des Partners
  5. Fügen Sie die URL zu den Postback-Einstellungen Ihres Partners hinzu

Partner-Makro-Beispiel (Generisch):

https://ihredomain.com/c/postback?click_id=[CLICK_ID]&conversion_type=lead&conversion_value=[PAYOUT]&external_id=[TRANSACTION_ID]

Methode 2: Pixel-Tracking (Image-Tag)

Am besten für: Dankesseiten, Bestätigungsseiten, clientseitiges Tracking

Endpunkt: GET /c/pixel.gif

HTML-Code:

<img src="https://ihredomain.com/c/pixel.gif?click_id={click_id}&conversion_type={conversion_type}&conversion_value={conversion_value}&external_id={external_id}" width="1" height="1" style="display:none" />

Parameter: Gleich wie Postback-URL

Beispielnutzung:

<!-- Basis-Pixel -->
<img src="https://ihredomain.com/c/pixel.gif?click_id=86f72615f9f2c70d6d0&conversion_type=lead" width="1" height="1" style="display:none" />

<!-- Mit Wert -->
<img src="https://ihredomain.com/c/pixel.gif?click_id=86f72615f9f2c70d6d0&conversion_type=sale&conversion_value=99.99" width="1" height="1" style="display:none" />

Einrichtungsanleitung:

  1. Gehen Sie zur Seite Conversions
  2. Wählen Sie Ihre Kampagne
  3. Kopieren Sie den Pixel-Code vom Pixel-Tab
  4. Ersetzen Sie {click_id} durch den tatsächlichen click_id-Wert oder JavaScript-Variable
  5. Fügen Sie den Code auf Ihrer Dankes-/Bestätigungsseite ein (vor dem </body>-Tag)

Dynamischer Pixel mit JavaScript:

<script>
(function() {
    // Extrahiere click_id aus URL
    const urlParams = new URLSearchParams(window.location.search);
    const click_id = urlParams.get('click_id');

    // Erstelle und füge Pixel ein
    if (click_id) {
        let img = new Image();
        img.src = "https://ihredomain.com/c/pixel.gif?click_id=" + click_id + "&conversion_type=lead&conversion_value=50";
        document.body.appendChild(img);
    }
})();
</script>

Methode 3: JavaScript-Tracking

Am besten für: SPAs, dynamische Seiten, erweiterte Tracking-Szenarien

Endpunkt: GET /c/postback (via fetch/AJAX)

JavaScript-Code:

<script>
(function() {
    // Extrahiere click_id aus URL
    const urlParams = new URLSearchParams(window.location.search);
    const click_id = urlParams.get('click_id');

    // Sende Conversion via fetch
    if (click_id) {
        const url = "https://ihredomain.com/c/postback?click_id=" + click_id + "&conversion_type=lead&conversion_value=50&external_id=order123";
        fetch(url, {method: 'GET'})
            .then(response => response.json())
            .then(data => console.log('Conversion getrackt:', data))
            .catch(error => console.error('Tracking-Fehler:', error));
    }
})();
</script>

Einrichtungsanleitung:

  1. Gehen Sie zur Seite Conversions
  2. Wählen Sie Ihre Kampagne
  3. Kopieren Sie den Code vom Tab JavaScript-Pixel
  4. Ersetzen Sie Platzhalter durch tatsächliche Werte oder JavaScript-Variablen
  5. Fügen Sie den Code auf Ihrer Conversion-Seite ein

S2S Upstream Postback (Traffic-Quelle Relay)

Wenn Traffic von einer bezahlten Quelle (RTB Panda, ClickBaza usw.) eintrifft, fügt die Quelle ihre eigene Click-ID in die URL ein. Wenn eine Conversion in TDS erfasst wird, leitet die S2S Postback URL-Einstellung der Kampagne das Conversion-Event automatisch zurück an die Traffic-Quelle weiter.

Dies wird pro Kampagne unter Kampagneneinstellungen → S2S Postback URL konfiguriert. Vollständige Details im Kampagnenverwaltungshandbuch.

Makro-Referenz

MakroBeschreibung
{clickid}Click-ID der Traffic-Quelle (aus ?clickid= in der Traffic-URL)
{payout}Conversion-Betrag vom Offer
{status}Conversion-Typ (confirmed, lead, sale…)
{tds_click_id}Interne TDS Click-UUID

Jeder Query-Parameter aus der originalen Traffic-URL ist als Makro mit seinem genauen Namen in geschweiften Klammern verfügbar.


Conversion-Typen und -Werte

Conversion-Typen

Conversion-Typen kategorisieren verschiedene Conversion-Ereignisse. Häufige Typen:

Conversion-Typ festlegen:

?conversion_type=lead
?conversion_type=sale
?conversion_type=custom_event_name

Conversion-Werte

Der Conversion-Wert ist ein numerisches Feld zum Tracking von Geldwerten oder benutzerdefinierten Metriken.

Beispiele:

Conversion-Wert festlegen:

?conversion_value=49.99
?conversion_value=100

Externe ID

Die externe ID verknüpft Ihre Conversion mit einer Transaktions-, Bestell- oder Lead-ID eines Partners.

Anwendungsfälle:

Externe ID festlegen:

?external_id=order_12345
?external_id=txn_abc123
?external_id=lead_98765

Conversion-Daten anzeigen

Conversions-Seite

Die Seite Conversions bietet Tools zum Generieren von Tracking-Codes:

  1. Navigieren Sie zu Conversions im Hauptmenü
  2. Kampagne auswählen: Wählen Sie, für welche Kampagne Tracking generiert werden soll
  3. Tabs anzeigen:
    • Postback: Server-zu-Server-URL
    • Pixel: HTML-Image-Tag-Code
    • JavaScript-Pixel: JS-basierter Tracking-Code
    • Anleitung: Detaillierte Einrichtungsanleitung
  4. Code kopieren: Auf Kopier-Symbol klicken, um Tracking-Code zu kopieren
  5. Anpassen: Platzhalter durch tatsächliche Werte ersetzen

Statistiken-Seite

Conversion-Daten auf der Seite Statistiken anzeigen:

  1. Navigieren Sie zu Statistiken
  2. Zeitraum auswählen
  3. Conversion-Metriken anzeigen:
    • Conversion-Anzahl: Gesamtzahl der Conversions
    • Conversion-Wert: Summe aller Conversion-Werte
    • Conversion-Rate: (Conversions / Klicks) × 100%
    • EPC (Earnings Per Click): Gesamtwert / Gesamtklicks
  4. Filtern nach:
    • Kampagne
    • Flow
    • Ziel
    • Zeitraum
    • Land, Gerät, etc.

Analytics-Funktionen


Best Practices Zusammenfassung

Zielverwaltung

  1. Verwenden Sie beschreibende Namen: "US Desktop - Angebot A" statt "Ziel 1"
  2. Testen Sie Redirect-Typen: Verschiedene Angebote funktionieren besser mit verschiedenen Methoden
  3. Überwachen Sie die Leistung: Prüfen Sie regelmäßig, welche Ziele am besten konvertieren
  4. Aktualisieren Sie inaktive Ziele: Deaktivieren oder löschen Sie Ziele, die nicht mehr funktionieren
  5. Verwenden Sie URL-Makros: Fügen Sie immer {click_id} für Conversion-Tracking hinzu

Conversion-Tracking

  1. Übergeben Sie immer click_id: Wesentlich für genaue Zuordnung
  2. Verwenden Sie Postback wenn möglich: Zuverlässiger als Pixel
  3. Testen Sie Tracking: Überprüfen Sie, ob Conversions korrekt erfasst werden
  4. Fügen Sie external_id hinzu: Hilft bei Abstimmung und Betrugserkennung
  5. Setzen Sie Conversion-Typen: Erleichtert Reporting und Analyse
  6. Überwachen Sie Datenqualität: Prüfen Sie auf doppelte oder ungültige Conversions

Traffic-Optimierung

  1. Beginnen Sie mit gleichen Gewichtungen: Dann basierend auf Daten optimieren
  2. A/B-Test-Ziele: Leistung mit verschiedenen Gewichtungen vergleichen
  3. Verwenden Sie Exit-Flows: Monetarisieren Sie allen Traffic, auch nicht übereinstimmenden
  4. Tracking nach Conversion-Wert: Nicht nur nach Conversion-Anzahl
  5. Passen Sie regelmäßig an: Optimieren Sie basierend auf aktueller Leistung

Fehlerbehebung

Zielprobleme

Problem: Ziel-URL funktioniert nicht

Problem: Makros werden nicht ersetzt

Problem: Weiterleitung findet nicht statt

Conversion-Tracking-Probleme

Problem: Conversions werden nicht erfasst

Problem: Doppelte Conversions

Problem: Fehlende Conversion-Daten


Zusammenfassung

Für weitere Informationen siehe: