Admitad Teleport
Konfigurationsanleitung für Teleport API
Admitad Teleport
Konfigurationsanleitung
für Teleport API
Ziel
Installation
Geo Einstellungen
Fehler
A/B-Tests
Support
1 | ZIEL
Mit diesem Tool könnt Ihr Admitad aus der Redirect-Kette von Eurem Werbemittel zum Advertiser herauslösen. Dadurch vermeidet man Adblocking durch Browser und Erweiterungen. Ihr seid damit auf Änderungen der Datenschutzrichtlinien schon jetzt am Besten vorbereitet. Auf der Website von Admitad Teleport erfahrt Ihr mehr über die Vorteile des Tools.

Es ist für Werbemittel gedacht, in denen der Affiliate-Link ad.admitad.com nicht in Form eines Content-Links, sondern als Redirect vorliegt. Das Tool funktioniert in etwa folgendermaßen:
2 | INSTALLATION
1
Man identifiziert, welche Affiliate-Links von Admitad umgewandelt werden müssen. Beispiellink: https://ad.admitad.com/g/1e8d114494b7e165239416525dc3e8/;
Zusätzlich zu ad.admitad.com werden auch alle anderen Tracking-Domains von Admitad unterstützt, mit Ausnahme von abgekürzten Links (short-URLs) (zum Beispiel fas.st oder ali.ski);
2
Ersetze den Teil l „/g/“ des Links durch „/tpt/“: https://ad.admitad.com/tpt/1e8d114494b7e165239416525dc3e8/;
3
Für Programme mit länderspezifischen Einstellungen den country_code eingeben (siehe Abschnitt „Geoeinstellungen“): https://ad.admitad.com/tpt/1e8d114494b7e165239416525dc3e8/?country_code=RU;
4
Den Link falls nötig durch eine SubID ergänzen: https://ad.admitad.com/tpt/1e8d114494b7e165239416525dc3e8/?country_code=RU&subid4=12345;
5
A/B-Testmarker hinzufügen, um die Effektivität und Performance zu messen (siehe Abschnitt „A/B-Tests“): https://ad.admitad.com/tpt/1e8d114494b7e165239416525dc3e8/?country_code=RU&subid4=12345&subid=tptA;
6
Anstelle eines Redirects über den Link wird die Anfrage von Deinem Server aus durchgeführt – Admitad antwortet mit einem JSON-Array, welches einen Link zum Advertiser erstellt:

[
"redirect_url"
]

Anstelle von redirect_url erhält man nun einen Link mit der Struktur https://www.advertiser.com?admitad_uid=b8b3fba19a9d6788408610c627f5045e&utm_source=admitad&utm_medium=affiliate — extrahiere diesen Link aus dem Array und leitet den Userdirekt dorthin.
3 | GEO EINSTELLUNGEN
Bei manchen Programmen von Admitad hängt die Provision des Publishers oder die angegebene URL des Advertisers davon ab, in welchem Land sich der Nutzer befindet.
Da Anfragen an Admitad bei der Teleport API vom Server des Publishers aus eingehen, kann Admitad das Land des Nutzers bei solchen Programmen nicht selbstständig feststellen. Lokalisiere den Nutzer mithilfe von Standort-Diensten (MaxMind z.B.) und übermitteln in Deiner Anfrage an Admitad den zweistelligen country_code im Standard ISO 3166-1 alpha-2:
https://ad.admitad.com/tpt/1e8d114494b7e165239416525dc3e8/?country_code=RU
Der Country Code hat Vorrang vor der IP-Adresse des Anfrage-Absenders und garantiert damit ein korrektes Tracking und Abwicklung der Commission. Optimalerweise sollte der country_code bei allen Programmen übermittelt werden. Wenn das Land des Nutzers nicht festgestellt werden kann, darf man in der Teleport-API nur Programme ohne Geo -Einstellungen verwenden (siehe Abschnitt „Fehler“).
4 | FEHLER
Dummy
Geo Einstellungen
Programme ohne Unterstützung
Dummy
Wenn die Werbefläche des Publishers nicht mit dem Affiliate-Programm verknüpft ist (Affiliation), erscheint in der Antwort die Adresse einer Dummy-Webseite als Platzhalter (fallback):

["https://ad.admitad.com/dummy/?w=1165099&c=15855&r=3&d=3"]

Wir empfehlen, Nutzer über den Dummy-Link zuzulassen, aber auf derartige Vorgänge anhand des Berichts „Broken Links“ (auch über API verfügbar) zu reagieren – leite den Traffic zu Programmen um, mit denen der Ad Space verbunden ist.
Geo Einstellungen
Wenn das Affiliate-Programm individuelle Geo-Einstellungen hat, werden Anfragen ohne Verwendung von country_code mit Fehlercode 400 und der Mitteilung {"error": "country_code is mandatory"} beantwortet – ergänze die Anfrage mit dem GET-Parameter country_code und der zweistelligen Länderbezeichnung und wiederhole sie. Wenn man keinen country_code hinzufügen kann, verwendet man einen sukzessiven Redirect zur Standardadresse („/tpt/“ wieder durch „/g/“ ersetzen: https://ad.admitad.com/g/1e8d114494b7e165239416525dc3e8/).
Programme ohne Unterstützung
Manche Programme können die API-Lösung vorübergehend nicht unterstützen. Die Liste dieser Programme wird immer wieder geupdatet Beim Versuch einer Anfrage für ein solches Programm erhält man den Fehlercode 403 und die Mitteilung:

{"error": "teleport API response is currently not being supported for affiliate program id {campaign_id}"}

Statt {campaign_id} wird die ID des Affiliate-Programms angegeben. Wenn dieser Fehler auftritt, muss man ihn protokollieren und den Nutzer über einen gewöhnlichen Affiliate-Link weiterleiten (ersetze das „/tpt/“ wieder durch „/g/“: https://ad.admitad.com/g/1e8d114494b7e165239416525dc3e8/). Es kann sein, dass das Programm nach einiger Zeit (wieder) unterstützt wird: Wir empfehlen, den Versuch einmal alle 2–4 Wochen zu wiederholen, da die Programme aktiv für die Arbeit mit Teleport-API weiterentwickelt werden.
5 | A/B-TESTS
Wenn man die Performance der Teleport-API messen möchte, sollte man einen A/B-Test durchführen: Man nimmt folgende Einstellung vor, dass der Traffic bei jedem Klick entweder mit Variante A (Teleport-API) oder Variante B (sukzessive Weiterleitung wie früher) gesteuert wird – jeweils zu 50 %:
Bei Variante A stellt man eine Serveranfrage zur Teleport-API und ergänzt den Parameter subid=tptA:
https://ad.admitad.com/tpt/1e8d114494b7e165239416525dc3e8/?country_code=RU&subid=tptA
Dann extrahiert man die JSON-Antwort und führt eine 302-Weiterleitung nach den Regeln der Teleport-API durch (siehe Abschnitt „Installation“).

Wir empfehlen hierfür ausdrücklich den Parameter SubID, da auf seiner Grundlage in den meisten Bereichen in den Reports eine Filterung möglich ist. Wenn der Parameter SubID schon vergeben ist, kann man auch die Parameter Sub-ID1 bis Sub-ID4 verwenden, jedoch ist eine Filterung auf dieser Grundlage nur im Bericht „Nach SubID“, beim Herunterladen aller Berichte in Excel oder über die API für Publisher möglich.
Bei Variante B führt man sofort eine 302-Weiterleitung zum Affiliate-Netzwerk durch, ergänzt den Affiliate-Link aber mit dem Parameter subid=tptB:

https://ad.admitad.com/g/1e8d114494b7e16
5239416525dc3e8/?subid=tptB.

6 | SUPPORT
Bei Fragen zum Einsatz des Tools kann man ein Support Ticket erstellen oder sich an seinen persönlichen Account Manager wenden.
© 2021 admitad GmbH. All rights reserved
Soziale Netzwerke: