Keitaro-Integrationsleitfaden

Um das Server-zu-Server-Conversion-Tracking (S2S) für das Blockchain-Ads-Netzwerk mit Keitaro einzurichten, konfigurieren Sie Blockchain-Ads zur Generierung einer Postback-URL (wo Keitaro Conversion-Daten sendet) und integrieren diese dann als benutzerdefinierte Traffic-Quelle in Keitaro. Dies stellt sicher, dass Keitaro die {clickid} aus eingehendem Traffic erfasst und Postbacks mit übereinstimmenden Klick-IDs, Umsätzen und weiteren Details an Blockchain-Ads zurücksendet.

Schritt 1: S2S-Conversion-Event in Blockchain-Ads erstellen

1. Melden Sie sich in Ihrem Blockchain-Ads HUB-Dashboard an.
2. Navigieren Sie zu Advertising > Tracking > Create Conversion > Server to Server.
3. Folgen Sie den Anweisungen auf dem Bildschirm, um das Event einzurichten:
   
   • Benennen Sie das Conversion-Event (z.B. "Lead" oder "Sale").
   • Geben Sie den Event-Typ an (z.B. lead, purchase) und gegebenenfalls Umsatzfelder.
   • Dies generiert eine eindeutige Tracker-ID für Ihr Event und eine Postback-URL im folgenden Format:

GET https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={transaction_value}

• {clickid}: Platzhalter für die eindeutige Klick-ID (Blockchain-Ads ordnet diese dem ursprünglichen Klick zu).
• trackerid: Ihre feste Event-ID (ändern Sie diese nicht).
• {transaction_value}: Optionaler Platzhalter für Umsatz-/Auszahlungsbetrag (weglassen, wenn Sie keine Umsätze tracken).

Kopieren Sie diese vollständige Postback-URL—Sie benötigen sie in Keitaro.

4. Speichern Sie das Event. Hinweis: Beim Erstellen von Kampagnen in Blockchain-Ads setzen Sie Ihre Ziel-URL auf Ihre Keitaro-Kampagnen-URL (z.B. https://your-keitaro-domain.com/campaign123?clickid={clickid}). Blockchain-Ads fügt den tatsächlichen Klick-ID-Wert automatisch hinzu.

Schritt 2: Blockchain-Ads als benutzerdefinierte Traffic-Quelle in Keitaro hinzufügen

1. Melden Sie sich in Ihrem Keitaro-Dashboard an.
2. Gehen Sie zu Traffic Sources > Create.
3. Suchen Sie im Feld "From template" nach "Blockchain-Ads"—falls keine Vorlage existiert, wählen Sie Custom oder lassen Sie es leer, um manuell zu erstellen.
4. Füllen Sie die grundlegenden Details aus:
   
   • Name: "Blockchain-Ads".
   • Click ID Parameter: Setzen Sie diesen auf clickid (dies teilt Keitaro mit, den eingehenden ?clickid=xxx-Wert aus Blockchain-Ads-Traffic zu erfassen und intern als externe ID für Postbacks zu speichern).
5. Im Parametervorlagen-Bereich (falls aufgefordert):
   
   • Fügen Sie eine Zeile für die Klick-ID hinzu:
     
     • Spalte 1 (Alias): Leer lassen oder auf "External ID" für Reporting setzen.
     • Spalte 2 (Parameter name): clickid.
     • Spalte 3 (Macro): Leer lassen (da Blockchain-Ads den tatsächlichen Wert direkt anfügt).
   • Fügen Sie bei Bedarf weitere Parameter hinzu (z.B. für Kampagnen-ID oder subIDs aus Blockchain-Ads-Makros).
6. Im S2S Postback-Feld:
   
   • Fügen Sie die Postback-URL aus Schritt 1 ein.
   • Ersetzen Sie Blockchain-Ads-Platzhalter durch Keitaro-Äquivalente:
     
     • {clickid} → {external_id} (übergibt die erfasste Klick-ID).
   • Beispiel einer umgewandelten URL:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

Wenn Sie nur bestimmte Conversion-Status senden möchten (z.B. genehmigte Leads), verwenden Sie das Dropdown-Menü "Send only statuses", um diese auszuwählen (z.B. "Lead", "Sale").

7. Klicken Sie auf Create, um die Traffic-Quelle zu speichern.
8. (Optional) Wenn Sie mehrere Kampagnen haben, aktivieren Sie Update in campaigns, um dies auf bestehende anzuwenden.

Schritt 3: Eine Kampagne in Keitaro einrichten und testen

1. Gehen Sie zu Campaigns > Create (oder bearbeiten Sie eine bestehende).
2. Wählen Sie Blockchain-Ads als Traffic Source.
3. Erstellen Sie Ihren Flow: Fügen Sie Streams, Landing Pages und Angebote hinzu. Für Conversions:
   
   • Wenn Sie Affiliate-Angebote verwenden, richten Sie Postbacks vom Affiliate-Netzwerk zu Keitaro ein (unter Affiliate Networks).
   • Definieren Sie Conversion-Regeln (z.B. S2S-Postback vom Angebot, Pixel-Auslösung oder benutzerdefinierte Events).
4. Generieren und kopieren Sie Ihre Keitaro-Kampagnen-URL (sie sieht aus wie https://your-domain.com/abc?clickid={external_id}—fügen Sie dies als Ziel in Ihrer Blockchain-Ads-Kampagne ein).
5. Testen:
   
   • Starten Sie eine Testkampagne in Blockchain-Ads, die auf die Keitaro-URL zeigt.
   • Simulieren Sie einen Klick und eine Conversion (z.B. über ein Testangebot).
   • Überprüfen Sie Keitaro-Berichte (Reports > Conversions) auf erfasste Klicks/Conversions.
   • Verifizieren Sie im Blockchain-Ads-Tracking, dass Postbacks ankommen (übereinstimmende Klick-IDs und Umsätze).
   • Verwenden Sie bei Bedarf Tools wie Postman, um manuell einen Test-Postback auszulösen.

Tipps und Fehlerbehebung

• Platzhalter in Keitaro: Verwenden Sie {external_id} für clickid, {revenue} für Beträge und {status} für Event-Typen (z.B. ordnen Sie "lead" einem Status zu). Für nicht-kodierte Werte verwenden Sie das Präfix _ (z.B. {_external_id}).
• Umsatz/Währung: Wenn Conversions unterschiedliche Währungen haben, verwenden Sie {revenue:USD} zur Konvertierung.
• Fehler: Stellen Sie sicher, dass HTTPS für Postbacks verwendet wird. Wenn keine Daten fließen, überprüfen Sie URL-Kodierung, Firewall-Blockierungen oder nicht übereinstimmende Tracker-ID. Keitaro protokolliert Postback-Versuche in Logs > Postbacks.
• Erweitert: Für mehrere Events erstellen Sie separate Conversion-Events in Blockchain-Ads und fügen mehrere Postback-URLs in Keitaro hinzu (eine pro Status).

Diese Einrichtung ermöglicht eine genaue Attribution ohne Cookies. Weitere Details zu Keitaro finden Sie in deren Dokumentation unter docs.keitaro.io