Diese interaktive Anleitung zeigt die verfügbaren Kampagnentypen, die Platzierung von Werbemitteln durch Affiliates und die sichere Einrichtung von Tracking und Conversions. Folgen Sie den Schritten der Reihe nach.
Wählen Sie das Kampagnenziel, das zu Ihrem Shop passt. Die technische Einrichtung hängt vom Ziel ab.
Erstellen Sie eine Produktkampagne für ein Produkt oder Angebot, eine Bannerkampagne für Bildmaterial oder eine Social-Ads-Kampagne für teilbare Werbung. Geben Sie die tatsächliche Produktseite und nicht nur die Startseite an.
Klick: MUNK erfasst den Tracking-Klick. Verkauf: Ihr Shop sendet nach endgültiger Zahlungsbestätigung eine serverseitige Conversion. Registrierung: Nach bestätigter Registrierung wird eine Conversion mit Betrag 0 gesendet. Verkäufe und Registrierungen erfordern eine verifizierte Website- und API-Integration.
Laden Sie ein Banner oder Produktbild hoch und ergänzen Sie Titel, Beschreibung und Bedingungen. Affiliates verwenden ihren persönlichen MUNK-Link als Klickziel. Platzieren Sie Ihren API-Schlüssel niemals in Werbemitteln, HTML oder einem Link.
Öffnen Sie Website- und API-Verifizierung im Dashboard. Wählen Sie die HTML-Datei- oder Meta-Tag-Methode, hinterlegen Sie den eindeutigen Nachweis auf Ihrer Domain und lassen Sie die Website von MUNK prüfen.
Website verifizieren →Erstellen Sie unter API-Schlüssel einen Schlüssel mit dem Scope conversion:write. Kopieren Sie ihn sofort und speichern Sie ihn als Geheimnis auf Ihrem Shopserver, beispielsweise als Umgebungsvariable oder in einer Datei außerhalb des öffentlichen Webroots. MUNK kann den vollständigen Schlüssel später nicht erneut anzeigen.
API keys →Die Landingpage speichert munk_click_id serverseitig in Sitzung, Warenkorb oder Bestellung. Das Bestell-Backend sendet erst nach endgültiger Zahlungsbestätigung einen signierten Postback an MUNK. Für Registrierungen verwenden Sie den Hook für bestätigte Registrierungen. Nicht in Browser-JavaScript einbauen.
Testen Sie mit einer eigenen Kampagne, einem Testklick und einer Testbestellung. Prüfen Sie, ob die Click-ID mit der Bestellung verknüpft bleibt, die API HTTP 201 zurückgibt und die Conversion als In Prüfung erscheint. Lassen Sie die Bestellung administrativ prüfen.
Dies sind Beispielansichten von Anzeigenformaten, die ein Affiliate auf seiner Website platzieren kann. Das endgültige Design hängt von der Affiliate-Website ab. Klickziel ist immer der persönliche MUNK-Trackinglink des Affiliates.
Beispielplatzierung: Bannerbereich
Kabelloser Klang mit klarer Wiedergabe, langer Akkulaufzeit und kompaktem Ladecase.
Angebot ansehen ↗Beispielplatzierung: Inhalt / mobiler Feed
Beispielplatzierung: editorial text block
Social Ads creative + personal MUNK tracking link
ⓘ Affiliate-Link: Der Websitebetreiber kann eine Provision erhalten, wenn Sie über diesen Link kaufen.
API-Schlüssel, HMAC-Signatur und Postback-Code gehören ausschließlich in das serverseitige Backend. Niemals in Browser, Quelltext, öffentliches Repository, Bild oder Affiliate-Link.
API-Schlüssel, HMAC-Signatur und Postback-Code gehören ausschließlich in das serverseitige Backend. Niemals in Browser, Quelltext, öffentliches Repository, Bild oder Affiliate-Link.
Bevorzugen Sie Umgebungsvariablen des Hostings. Wenn Sie eine Konfigurationsdatei verwenden, legen Sie diese außerhalb von public_html, www oder httpdocs ab und beschränken Sie die Leserechte.
MUNK_API_KEY=munk_YOUR_PRIVATE_API_KEYDer Besucher kommt über den MUNK-Link mit munk_click_id an. Prüfen Sie das Format und speichern Sie den Wert serverseitig. Verknüpfen Sie ihn möglichst mit Warenkorb/Bestellung, damit er beim Checkout nicht verloren geht.
<?php
if (session_status() !== PHP_SESSION_ACTIVE) {
session_start();
}
$clickId = (string) ($_GET['munk_click_id'] ?? '');
if (preg_match('/^[a-f0-9]{32}$/', $clickId)) {
$_SESSION['munk_click_id'] = $clickId;
}Das Beispiel zeigt den Kern der Signierung. Integrieren Sie dies in den Bestellstatus-Hook Ihres Shops. Der genaue Hook hängt von Ihrer Shopsoftware ab. Niemals bei fehlgeschlagener, stornierter oder nur angelegter Bestellung senden.
<?php
$apiKey = getenv('MUNK_API_KEY');
$timestamp = (string) time();
$payload = json_encode([
'click_id' => $storedClickId, // stored server-side
'conversion_ref' => $uniqueOrderId, // unique order ID
'conversion_type' => 'sale', // or 'registration'
'gross_amount' => $verifiedTotal // registration: 0
], JSON_UNESCAPED_SLASHES);
$signature = hash_hmac('sha256', $timestamp . '.' . $payload, $apiKey);
$ch = curl_init('/api/v1/conversion.php');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-Munk-Key: ' . $apiKey,
'X-Munk-Timestamp: ' . $timestamp,
'X-Munk-Signature: ' . $signature
]
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($response === false) { error_log('MUNK postback transport failed'); }
curl_close($ch);
// Store the result; retry with the SAME conversion_ref on timeout.POST /api/v1/conversion.phpHeaders: X-Munk-Key, X-Munk-Timestamp, X-Munk-Signature · Scope: conversion:write · HMAC-SHA256 of timestamp.raw_json_body
201 201 — empfangen; Conversion ist In Prüfung. Noch keine endgültige Provision.
401 401 — API-Schlüssel, Zeitstempel und HMAC-Signatur prüfen.
404 404 — Click-ID nicht gefunden oder gehört nicht zu Ihrem Werbekonto.
409 409 — Kampagne nicht geeignet, Budget nicht verfügbar oder doppelte Bestellreferenz.
422 422 — Felder und Conversion-Typ prüfen.
429 429 — API-Limit erreicht; später mit derselben eindeutigen Bestellreferenz erneut versuchen.
API-Schlüssel nur im Backend; niemals in HTML oder JavaScript.
HTTPS verwenden und die 32-stellige Click-ID validieren.
Click-ID serverseitig speichern und Umsatzangaben aus dem Browser nicht vertrauen.
Eine stabile, eindeutige Bestellreferenz verwenden und doppelte Postbacks verhindern.
Nur nach Zahlungsbestätigung oder bestätigter Registrierung senden.
Niemals API-Schlüssel, Signaturen oder vollständige Kundendaten protokollieren.
Einen offengelegten Schlüssel sofort widerrufen und einen neuen erstellen.
Ein API-Postback ist eine Meldung Ihres Shopservers. Ohne unabhängige Zahlungsanbieter-Anbindung kann MUNK nicht selbstständig beweisen, dass Geld eingegangen ist. Conversions werden daher zunächst als In Prüfung gespeichert. Die Kampagnenvergütung bestimmt die Affiliate-Provision; gross_amount ist eine Bestellinformation und legt die Provision nicht automatisch fest.
Domain verifiziert, API getestet und eine Testbestellung geprüft? Dann können Sie Ihre Kampagne zur Prüfung einreichen.