S2S / ClickID-Tracking

    Cookieloses Tracking über eindeutige ClickIDs und serverseitige Postbacks — ideal für Mobile, Apps und maximale Tracking-Sicherheit.

    ClickID-Tracking: So funktioniert's

    Beim ClickID-Tracking erzeugt QUALITYCLICK für jeden Klick eine eindeutige ClickID und hängt sie an den ausgehenden Link an. Diese ID ersetzt die Cookie-basierte Zuordnung und ermöglicht cookieloses Tracking.

    Der Ablauf

    1
    Klick
    Partner-Link mit ClickID
    2
    Shop
    ClickID speichern
    3
    Bestellung
    Kunde kauft
    4
    Tracking-Pixel
    ClickID zurückmelden

    Schritt 1: Klickziele mit ClickID einrichten

    Alle Links unter Werbemittel → Klickziele müssen die ClickID als URL-Parameter enthalten. Verwenden Sie den Platzhalter <% CLICKID %>:

    Klickziel mit ClickID
    https://www.ihr-shop.de/landing?qc_clickid=<% CLICKID %>

    Optional können Sie auch die PartnerID mitgeben:

    Klickziel mit ClickID und PartnerID
    https://www.ihr-shop.de/landing?qc_clickid=<% CLICKID %>&qc_pid=<% PID %>

    Beim Klick erzeugt QUALITYCLICK eine eindeutige ID im Format QC423840809685489623456289367 (QC-Präfix + eindeutige Zeichenkette) und leitet den Besucher auf Ihren Shop weiter.

    💡Tipp
    Der Parametername qc_clickid ist eine Empfehlung — Sie können den Parameternamen frei wählen (z.B. clickid, affiliate_click etc.). Entscheidend ist, dass Ihr Shop den Wert korrekt entgegennimmt und speichert.

    Schritt 2: ClickID im Shop speichern

    Ihr Shop muss die ClickID aus dem URL-Parameter auslesen und bis zur Bestellbestätigung aufbewahren. Zwei Möglichkeiten:

    • Session-Cookie: Speichern Sie den Wert in einem eigenen Cookie oder in der Server-Session
    • URL-Parameter: Führen Sie den Wert von Seite zu Seite als URL-Parameter mit

    Schritt 3: ClickID an das Transaktionspixel zurückgeben

    Auf der Bestellabschlussseite übergeben Sie die gespeicherte ClickID an den Tracking-Pixel:

    Transaktionspixel mit ClickID
    https://partner.your-site.com/get_trans.cgi
      ?cpid=1
      &tid=ORD-2026-001
      &clickid=QC423840809685489623456289367
      &produkt=Sale
      &umsatz=95.50

    QUALITYCLICK löst über die ClickID automatisch alle Informationen des ursprünglichen Klicks auf: PartnerID, SubID, WerbemittelID, Referrer. So wird die Transaktion dem richtigen Partner zugeordnet — ohne Cookie.

    ⚠️Achtung
    Falls Sie die Parameter pid, subid oder wmid zusätzlich im Tracking-Pixel übergeben, überschreiben diese die Werte aus der ClickID. Übergeben Sie nur Parameter, die Sie tatsächlich mit Werten belegen können — im Zweifelsfall weglassen.

    Server-to-Server Tracking (S2S)

    Beim Server-to-Server Tracking wird die get_trans.cgi nicht vom Browser des Kunden aufgerufen (clientseitig), sondern von Ihrem Webserver (serverseitig). Der Aufruf ist technisch identisch — die gleiche URL mit den gleichen Parametern.

    Vorteile von S2S

    • Funktioniert auch wenn der Kunde JavaScript oder Bilder deaktiviert hat
    • Unabhängig von Browser-Einschränkungen (Ad-Blocker, Cookie-Blockierung)
    • Höhere Zuverlässigkeit bei langsamen Verbindungen oder wenn Kunden die Seite vorzeitig verlassen

    Empfohlene Strategie: Pixel + S2S als Fallback

    Wir empfehlen, beide Methoden parallel einzusetzen:

    1. Clientseitiger Pixel (JavaScript oder Grafik) auf der Bestellabschlussseite — erfasst die Transaktion sofort in Echtzeit
    2. Serverseitiger S2S-Call wenige Sekunden später — als Absicherung für Fälle, in denen der Client-Call fehlschlägt

    QUALITYCLICK erkennt Doppelungen automatisch anhand der TransaktionsID (tid) und legt die Transaktion nur einmal an.

    PHP-Beispiel: S2S-Call mit cURL

    PHP: Server-to-Server Call
    <?php
    // S2S Postback an QUALITYCLICK nach Bestellabschluss
    $params = [
        'cpid'     => 1,                              // Programm-ID
        'tid'      => 'ORD-2026-001',                  // Ihre Bestellnummer (eindeutig)
        'clickid'  => $_SESSION['qc_clickid'] ?? '',   // Gespeicherte ClickID
        'produkt'  => 'Sale',                          // Vergütungs-Produkt (exakte Schreibweise)
        'umsatz'   => 95.50,                           // Netto-Umsatz ohne MwSt./Versand
    ];
    $url = 'https://partner.your-site.com/get_trans.cgi?' . http_build_query($params);
    
    // Asynchroner Call (blockiert nicht den Seitenaufbau)
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 5);
    curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
    $response = curl_exec($ch);
    curl_close($ch);
    ?>

    cURL-Beispiel (Kommandozeile)

    cURL: Server-to-Server Call
    curl -s "https://partner.your-site.com/get_trans.cgi?\
    cpid=1&\
    tid=ORD-2026-001&\
    clickid=QC423840809685489623456289367&\
    produkt=Sale&\
    umsatz=95.50"
    💡Tipp
    Setzen Sie beim S2S-Call ein kurzes Timeout (3-5 Sekunden), damit die Bestellverarbeitung in Ihrem Shop nicht blockiert wird. Die Transaktion wird in QUALITYCLICK auch dann korrekt angelegt, wenn der Call nach dem Timeout abbricht — die Daten werden beim Empfang sofort verarbeitet.

    Zusätzliche Parameter

    nocheck — Cross-Selling erlauben

    Standardmäßig prüft QUALITYCLICK, ob der Partner für das übermittelte Vergütungsprodukt freigeschaltet ist. Ist er es nicht, wird die Transaktion verworfen.

    Mit dem Parameter nocheck=1 wird diese Prüfung übersprungen: Die Transaktion wird auch dann angelegt, wenn der Kunde ein anderes Produkt bestellt hat als das, was der Partner verlinkt hat.

    Pixel mit nocheck
    https://partner.your-site.com/get_trans.cgi
      ?cpid=1&tid=ORD-2026-001&clickid=QC...&nocheck=1

    Typischer Einsatz: Online-Shops mit breitem Sortiment, bei denen Partner ein bestimmtes Produkt bewerben, der Kunde aber ein anderes Produkt kauft (Cross-Selling).

    Tracking testen

    Nach der Einrichtung sollten Sie ausgiebig testen:

    1. Klicken Sie ein Werbemittel des Test-Partners (PartnerID 2) an
    2. Prüfen Sie, ob die ClickID korrekt im URL-Parameter ankommt
    3. Führen Sie eine Testbestellung durch
    4. Prüfen Sie unter Transaktionen → Bearbeiten, ob die Transaktion mit der richtigen PartnerID angelegt wurde
    5. Prüfen Sie unter Transaktionen → Protokoll, ob der Aufruf in den Logs erscheint

    Falls die Transaktion nicht erscheint, prüfen Sie das Transaktions-Log: Verworfene Transaktionen zeigen in der Spalte „gespeichert" einen Strich „-" statt einer Nummer.

    Noch Fragen?
    Unser Team hilft Ihnen bei der Integration – persönlich und kompetent.