Mit Deep Links zu App-Inhalten verlinken

1. Was ist ein Deep Link? Und warum brauchen wir das?

• Ein Deep Link ist ein Link, der auf eine Unterseite verweist.
  • D.h.: Es handelt sich um eine Verknüpfung zu einer Unterseite einer Website.
• Mittels Deep Links können wir nun z.B. über einen Button direkt zu Inhalten in der App (z.B. Audio, Schritt im Programm) verlinken.
• Aktuelles Anwendungsszenario (Stand 09/2023):
  • Wir schicken unseren User:innen eine Push-Nachricht (z.B. "Hey, heute ist es Zeit für Tag 2 deiner Audio-Reise")
  • Die User:innen öffnen die Push-Nachricht und gelangen auf die Nachrichtenseite
  • Dort erwartet sie die inApp-Nachricht, die mittels Button, auf den gewünschten App-Inhalt (z.B. das Audio für Tag 2 der Audio-Reise) verlinkt
  • Die User:innen klicken auf den Button (z.B. "Hier gehts zum Audio) und gelangen direkt in den Audioplayer, in dem das Audio automatisch startet
• Zukünftiges Anwendungsszenario:
  • Beim Öffnen der Push-Nachricht gelangen die User:innen direkt zum gewünschten App-Inhalt (bisher noch nicht möglich)

2. Wie erstelle ich Deep Links?

• Schritt 1: Message URL Builder öffnen
  • Um Deep Links zu erstellen, verwenden wir unseren Message URL Builder (https://www.mein-intumind.de/message-url-builder/)
  • Hinweis: Du musst im mein-intumind.de Backend eingeloggt sein, um auf den Message URL Builder zugreifen zu können

• Schritt 2: Inhalte der Push-Nachricht und der inApp-Nachricht festlegen
  • Im Message URL Builder kannst du dann zunächst folgende Felder befüllen:
    • Title (= Titel der inApp-Nachricht, d.h. der Nachricht, die auf der Nachrichtenseite in der App angezeigt wird)
    • Push Titel (=Titel der Push-Nachricht)
    • Message (=Inhalt der inApp-Nachricht)
    • Push-Message (=Inhalt der Push-Nachricht)
    • Button-Text (= der Text, der im Button angezeigt werden soll)
    • optional: Image-URL (wenn du ein Bild in der inApp-Nachricht mitsenden willst)

• Schritt 3: Deep-Link erstellen
  • Im unteren Bereich des Message URL Builders (siehe "Deeplink Generator") kannst du deinen Deep Link erstellen
  • Mit der Suchfunktion kannst du den App-Inhalt, auf den du gerne verlinken möchtest, suchen

• Wähle den Inhalt aus
• Du erhältst unten deinen Deep Link, den du dann kopieren kannst (z.B. exp+intumind://25/31839)

• Schritt 4: Deep Link als Button URL festlegen & Link generieren
  • Im nächsten Schritt fügst du deinen kopierten Deep Link (z.B. exp+intumind://25/31839) oben im Feld "Button URL" ein
  • Fast geschafft, klicke nun auf "GENERATE LINK"
  • Diesen Link kannst du nun in AC als Webhook verwenden - sobald der Webhook aktiviert wird, wird die Push-Nachricht gesendet und du kannst diese Öffnen & deinen ersten Deep Link testen!
  • Viel Spaß! 

Genereller Hinweis zu Pushnachrichten:

• Wenn du eine Push-Nachricht senden möchtest, die in der App nicht auf der Nachrichtenseite angezeigt wird, hänge am Ende &push_only=1 an den Link
• Wenn der User die Pushnachricht erhält und öffnet, landet der User auf dem Homescreen (Programmauswahlseite) der App