So verwenden Sie den Offerwall-Link-Builder
Kopieren Sie Ihre App ID und Ihr Link-Hash-Salt aus Ihrem Dashboard unter Offerwalls, Ihre Offerwall, Integration. Geben Sie die Nutzer-ID eines Testkontos ein, ergänzen Sie Sub IDs, wenn Sie Platzierungen tracken, und der Builder zeigt den Hash, den vollständigen signierten Link sowie fertigen iframe- und Earn-Button-Code zum Einfügen. Nichts, was Sie eingeben, wird irgendwohin gesendet: Der Hash wird in Ihrem Browser mit der Web Crypto API berechnet.
Prüfen Sie damit Ihren eigenen Servercode. Wenn der Link, den Ihr Server für dieselbe Nutzer-ID erstellt, nicht mit dem hier übereinstimmt, liegt der Unterschied in Ihrem Code, nicht bei Moonetix.
So wird der Hash gebildet
hash = HMAC-SHA256(user_id, link_hash_salt), as lowercase hex
link = https://wall.moonetix.com/APP_ID?user_id=USER_ID&hash=HASH
Die Nutzer-ID ist die Nachricht und das Salt der Schlüssel. Sub IDs sind nicht Teil des Hashs, daher können Nutzer sie ändern: Verwenden Sie sie zum Tracking, nie für Gutschriften. Die Dokumentation zum Offerwall-Link zeigt denselben Code in PHP, Node.js und Python.
Behalten Sie das Salt auf Ihrem Server
Diese Seite ist ein Testwerkzeug. Erstellen Sie den Hash im Live-Betrieb auf Ihrem Server und senden Sie nur den fertigen Link an den Browser oder die App. Ein Salt in JavaScript, in einem App-Bundle oder in einem öffentlichen Repository erlaubt es jedem, Ihre Offerwall im Namen jedes beliebigen Nutzers zu öffnen. Falls ein Salt jemals in falsche Hände gerät, rotieren Sie es: Schlüssel und Link-Salt rotieren erklärt die sichere Reihenfolge.
Häufige Probleme
- Link not valid (403). Der Hash passt nicht zur Nutzer-ID. Prüfen Sie, ob Sie genau den Nutzer-ID-String hashen, den Sie in den Link einsetzen, und zwar mit dem Link-Hash-Salt, nicht mit dem Postback-Secret-Key.
- Zahlen oder Strings. Hashen Sie die Nutzer-ID als String.
42und042sind unterschiedliche Nutzer. - Kodierung. Hashen Sie die rohe Nutzer-ID und URL-kodieren Sie sie dann im Link. Hashen Sie nicht den kodierten Wert.
Häufig gestellte Fragen
Ist es sicher, mein Link-Hash-Salt hier einzugeben?
Die Seite sendet es nirgendwohin, aber eine Test-App oder ein Test-Salt ist trotzdem die bessere Gewohnheit. Legen Sie Ihr echtes Salt niemals in clientseitigen Code.
Welchen Hash verwendet der Moonetix-Offerwall-Link?
HMAC-SHA256 der Nutzer-ID, mit Ihrem Link-Hash-Salt als Schlüssel, als Hex in Kleinbuchstaben.
Ändern Sub IDs den Hash?
Nein. Sub IDs sind nicht Teil des Hashs. Sie können sie also hinzufügen oder ändern, ohne ihn neu zu erstellen.
Kann ich diesen Link in einer mobilen App verwenden?
Ja, in einer WebView oder im System-Browser, wenn Ihr Backend ihn erstellt. Für einen nativen Bildschirm verwenden Sie stattdessen das Android-, iOS-, Unity-, Flutter- oder React-Native-SDK mit einem Session-Token.