FORTGESCHRITTEN
DokuNach Land routen
Du druckst einen QR-Code, aber dein Publikum lebt in mehreren Ländern. Eine Geo-Regel schickt jeden Markt vom selben gedruckten Code an sein eigenes Ziel - einmal eingerichtet im Dashboard oder über die API, und änderbar, lange nachdem die Tinte trocken ist.
Ein Code, viele Märkte
Angenommen, dieselbe Verpackung geht nach Deutschland, Österreich und in den Rest der Welt. Ein deutscher Scan sollte im deutschen Shop landen; alle anderen gehören auf die internationale Seite. Pro Markt einen eigenen QR-Code zu drucken vervielfacht deine Druckauflagen - und eine falsch etikettierte Kiste schickt das falsche Publikum auf die falsche Seite, für die gesamte Lebensdauer dieser Kiste.
Ein Kilo-Link löst das Problem auf, weil der Code nie dein Ziel kodiert - er kodiert den Link, und der Link entscheidet. Geo-Regeln werden im Edge ausgewertet, innerhalb derselben rund 50 Millisekunden langen Weiterleitung, die den Besucher weiterschickt, sodass niemand wartet, während die Entscheidung fällt. Und weil die Regeln auf dem Link leben und nicht auf dem Papier, kannst du Märkte hinzufügen, zusammenlegen oder jeden von ihnen Jahre nach dem Druck neu ausrichten. Einmal drucken; für immer neu ausrichten.
Richte es im Dashboard ein
Die ganze Einrichtung ist ein Link und eine Regel pro Markt. Im Dashboard:
- Erstelle den Link mit deiner internationalen Seite als Ziel. Dieses Standardziel ist das Sicherheitsnetz - jeder Besucher, auf den keine Regel passt, landet hier, also mach es zu einer Seite, die für alle funktioniert.
- Öffne die Routing-Regeln des Links und wähle Regel hinzufügen.
- Füge pro Markt eine Geo-Regel hinzu: Wähle das Land - oder mehrere Länder, die sich ein Ziel teilen - und setze die URL, die diese Besucher bekommen sollen. Eine Geo-Regel kann auch auf eine Region oder eine Stadt passen, wenn ein ganzes Land zu grob ist.
Regeln werden in fester Reihenfolge ausgewertet - die erste Übereinstimmung gewinnt, Geo vor Gerät und A/B, und das Standardziel fängt alle anderen auf - und eine Änderung wirkt beim nächsten Scan. Die Mechanik, auch wie sich Regeln schichten, steht in der Anleitung zu Routing-Regeln. Eine ehrliche Notiz, bevor du baust: Targeting-Regeln sind eine Bezahlfunktion, durchgesetzt in der API genauso wie im Dashboard.
Zwei Aufrufe über die API
Kilo ist API-first - das Dashboard, das du gerade benutzt hast, ist ein Client derselben HTTP-API. Die Einrichtung fürs gedruckte Plakat sind zwei Aufrufe mit einem Schreib-Schlüssel. Zuerst erzeugst du den Link mit dem weltweiten Standardziel:
curl https://qr2r.com/api/links \
-H "Authorization: Bearer $KILO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "default_target": "https://example.com/global", "name": "Trade-fair poster" }'Die Antwort trägt den dauerhaften slug des Links. Dann hängst du pro Markt eine Geo-Regel an - Länder sind ISO-2-Codes, und das Anlegen liefert 201 mit der gespeicherten Regel:
curl https://qr2r.com/api/links/aA3k9/rules \
-H "Authorization: Bearer $KILO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "type": "geo", "condition": { "countries": ["DE", "AT"] }, "target_url": "https://example.com/de" }'Wiederhole den zweiten Aufruf für jeden Markt und nutze PUT /api/links/aA3k9, wann immer ein Ziel umzieht - der gedruckte Code ändert sich nie. Der vollständige Endpunkt-Durchgang, samt Auflisten, Umordnen und Löschen von Regeln, steht in Analyse und Regeln über die API. Wie das Dashboard setzt auch die API die Tarif-Schranke durch: Eine Geo-Regel auf einem Tarif ohne Targeting-Regeln wird mit 402 abgelehnt, nie stillschweigend angenommen.
Prüfe die Passung in der Analyse
Öffne die Analyse des Links und lies die Länder-Aufschlüsselung gegen deine Regeln. Hängt das Plakat in Wien, aber ein Drittel der Scans kommt weder aus Deutschland noch aus Österreich, ist entweder die Platzierungsgeschichte größer, als du dachtest, oder der Verkehr ist nicht, was er scheint - beides wert, es vor der nächsten Druckauflage zu wissen.
Für einen gedruckten Code gibt es ein schärferes Werkzeug: Pinne die Platzierung des Links - das Land oder die Region, wo der Code physisch lebt - und das Geo-Panel ergänzt eine Zeile im-Gebiet / außerhalb-des-Gebiets, gezählt nur auf als menschlich klassifiziertem Verkehr. Sie beantwortet die Passungsfrage auf einen Blick: Kommen die Scans von dort, wo das Papier wirklich ist?
Ehrliche Grenzen
Geolokalisierung auf Netzwerkebene ist auf Länderebene verlässlich und darunter ungefähr - eine Stadt kann zu einem Provider-Knoten ein paar Orte weiter auflösen, und Besucher im Roaming oder mit VPN können komplett im falschen Land erscheinen. Route Kampagnen damit; bitte sie nicht, Streitfälle zu entscheiden. Etwas Aktivität außerhalb des Gebiets ist normal.