Grundlagen
Smart Links und Weiterleitungen
Dein Smart Link, mapps.one/habitly, prüft das Gerät jedes Besuchers und entscheidet in wenigen Millisekunden, wohin er ihn schickt. Diese Seite erklärt die Standardregeln, wie du sie änderst, was Bots für Linkvorschauen sehen und wie Kampagnen-Tags an die Stores weitergegeben werden.
Standard-Routing
| Besucher | Geht zu | Wenn dieser Link fehlt |
|---|---|---|
| iPhone, iPad, iPod | App Store | Landingpage |
| Android | Google Play | Landingpage |
| Huawei- und Honor-Geräte, HarmonyOS | AppGallery | Google Play, dann die Landingpage |
| Windows | Microsoft Store | Landingpage |
| macOS | App Store | Landingpage |
| Nicht erkannte Geräte („Sonstige“) | Landingpage | — |
| Linux und ChromeOS | Landingpage | — |
Das Gerät wird anhand des User-Agents des Browsers erkannt. Tablets folgen denselben Regeln wie Smartphones mit demselben System. iPads, die Desktop-Websites anfordern, geben sich als Mac aus und landen trotzdem im App Store, weil macOS standardmäßig dorthin geht.
Weiterleitungsregeln
Öffne den Tab Links der App, um für jede dieser Plattformen ein Ziel zu wählen: iOS, Android, Huawei, Windows, macOS und Sonstige. Zur Auswahl stehen:
- App Store, Google Play, AppGallery oder Microsoft Store: Weiterleitung zu diesem Store-Eintrag,
- Web-URL: Weiterleitung zur Webadresse, die bei der App gespeichert ist, zum Beispiel eine Webversion oder eine Warteliste,
- Landingpage: Anzeige der Landingpage unter der Adresse des Smart Links.
Ist für das gewählte Ziel kein Link gespeichert, greift ein Fallback: Huawei-Besucher versuchen es mit Google Play und dann mit der Landingpage, alle anderen sehen die Landingpage. Die Regelvorschau im Dashboard zeigt, wo jede Plattform gerade landet, und markiert die Zeilen, die einen Fallback verwenden.
Weiterleitungen verwenden HTTP 302 mit Cache-Control: no-store. Browser und Proxys speichern sie daher nicht zwischen, und Regeländerungen gelten ab dem nächsten Besuch.
Linkvorschauen und Bots
Wenn jemand deinen Link in einen Chat oder Beitrag einfügt, ruft die jeweilige App die Seite ab, um eine Vorschau zu erstellen. Diese Crawler erhalten immer die Landingpage, nie eine Weiterleitung. Die Vorschau zeigt daher App-Namen, Tagline und Bild aus den Open-Graph-Tags der Seite. Das gilt unter anderem für Facebook, Instagram, WhatsApp, X, LinkedIn, Slack, Discord, Telegram, iMessage, Pinterest, Reddit, Mastodon, Bluesky, Snapchat, Skype, Zoom und Microsoft Teams.
Suchmaschinen-Crawler, SEO-Tools, Uptime-Monitore, KI-Crawler und Kommandozeilen-Clients wie curl, wget oder python-requests werden ebenfalls als Bots behandelt. Bots bekommen die Landingpage und werden nie in den Analysen gezählt.
In-App-Browser
Links, die in Instagram, Facebook, TikTok, X, LinkedIn, Snapchat, Pinterest, LINE, Telegram, WeChat, Reddit und Threads geöffnet werden, werden erkannt. Der Besucher wird wie bei jedem anderen Besuch nach Gerät weitergeleitet. In den Analysen wird die App, aus der er kam, als Traffic-Quelle erfasst, obwohl diese Browser meist keinen Referrer senden.
Kampagnen-Tags
Füge deinem Smart Link Standard-UTM-Tags hinzu, um Kanäle zu vergleichen:
https://mapps.one/habitly?utm_source=instagram&utm_medium=social&utm_campaign=launchmapps.one erfasst utm_source, utm_medium und utm_campaign immer in deinen Analysen. Ist Kampagnenparameter an die Stores weitergeben aktiviert (Standard), werden die Tags außerdem im jeweils passenden Format an das Ziel weitergegeben:
| Ziel | Was wir hinzufügen |
|---|---|
| Google Play | Einen referrer-Parameter mit den URL-kodierten UTM-Tags, den deine App mit der Play Install Referrer API auslesen kann.https://play.google.com/store/apps/details?id=com.habitly.app&referrer=utm_source%3Dinstagram%26utm_medium%3Dsocial%26utm_campaign%3Dlaunch |
| App Store | Ein ct-Kampagnentoken: den Wert von utm_campaign oder, wenn es keine Kampagne gibt, von utm_source, bis zu 40 Zeichen.https://apps.apple.com/app/id1612345678?ct=launch |
| Web-URL | Die UTM-Tags selbst.https://habitly.app/?utm_source=instagram&utm_medium=social&utm_campaign=launch |
| AppGallery, Microsoft Store | Nichts. Der Eintrag öffnet sich ohne zusätzliche Parameter. |
Alle fünf Tags werden weitergegeben: utm_source, utm_medium, utm_campaign, utm_term und utm_content. Jeder Wert wird auf 100 Zeichen gekürzt.
ct-Token nur dann einer Kampagne zu, wenn der Link auch dein Provider-Token (pt) enthält. Store-Links werden in kanonischer Form gespeichert, ein in deinen App-Store-Link eingefügtes pt bleibt daher nicht erhalten. Nutze die Kampagnen-Aufschlüsselung in den Analysen von mapps.one, um Kanäle zu vergleichen.Links der Store-Badges
Die Store-Badges auf der Landingpage verweisen auf eine erfasste Weiterleitung, mapps.one/habitly/go/{store}. Der Klick wird als Store-Klick gezählt, dann wird der Besucher zum Store-Eintrag geschickt. Hat die App für diesen Store keinen Link, wird der Besucher zurück zur Landingpage geschickt.
Du kannst diese URLs auch selbst verwenden, wenn du unabhängig vom Gerät einen bestimmten Store willst, zum Beispiel in einer reinen Android-Kampagne. UTM-Tags an einer /go/-URL werden genauso weitergegeben wie beim Smart Link.
| Store-Schlüssel | URL |
|---|---|
app_store | mapps.one/habitly/go/app_store |
google_play | mapps.one/habitly/go/google_play |
app_gallery | mapps.one/habitly/go/app_gallery |
microsoft_store | mapps.one/habitly/go/microsoft_store |
web | mapps.one/habitly/go/web |
URL-Referenz
| URL | Zweck |
|---|---|
/habitly | Smart Link: Weiterleitung nach Gerät oder die Landingpage |
/habitly/page | Landingpage auf jedem Gerät |
/habitly/go/{store} | Erfasste Weiterleitung zu einem Store |
/habitly/open/{path} | Deep Link in die installierte App |
/habitly/privacy, /habitly/privacy/{language} | Datenschutzerklärung |
/habitly/terms, /habitly/terms/{language} | Nutzungsbedingungen |
/habitly/press, /habitly/press.zip | Seite und Download des Pressekits |
/habitly/qr.svg, /habitly/qr.png | QR-Code für den Smart Link |
Wenn ein Link nicht funktioniert
- 404 Not Found: Keine App verwendet diesen Slug. Prüfe die Schreibweise oder ob der Slug geändert wurde.
- 410 Gone, „pausiert“: Die App ist im Dashboard pausiert. Aktiviere sie wieder.
- 410 Gone, „nicht mehr verfügbar“: Die App wurde vom Trust-and-Safety-Team gesperrt. Kontaktiere den Support.
- Immer die Landingpage: Für das Ziel der Plattform ist kein Link gespeichert, die Regel steht auf Landingpage, oder du testest mit einem Bot-ähnlichen Client.