Zum Hauptinhalt springen

Mobile SDK - FAQs

Beantwortung der häufigsten Fragen

Verfasst von Eric Fitzgerald

Allgemein

Wie groß sind die Intercom Mobile SDKs?

Die Größe der SDKs variiert, aber die Mobile SDK-Größen sind ungefähr:

  • iOS: ~9mb

  • Android: ~7mb (wird bei der Installation mit allen gemeinsamen Abhängigkeiten usw. kleiner)

Dies hängt von der Konfiguration ab.

Plattformen und Support

Gibt es Xamarin Support?

Nein, Sie müssen sich auf Community-Bibliotheken verlassen, falls dies benötigt wird.

Gibt es React Native Support?

Ja! Unser React Native Wrapper wurde am 24. Juni 2021 veröffentlicht. Installationsinformationen finden Sie in unseren Developer Docs hier.

Gibt es Ionic Support?

Offiziell unterstützen wir Ionic nicht. Allerdings kann Intercom mit Ionic 1 & 2 funktionieren. Um Intercom mit Ionic zu verwenden, führen Sie Folgendes aus:

cordova plugin add cordova-plugin-intercom

Stellen Sie sicher, dass Sie Intercom korrekt initialisieren.

Ionic 1

Für Ionic 1 können Sie Intercom so verwenden:

.run(function($ionicPlatform) {

  $ionicPlatform.ready(function() {

    cordova.plugins.intercom.registerIdentifiedUser({userId: "123456"});

    cordova.plugins.intercom.setLauncherVisibility('VISIBLE');

  });

})

Ionic 2

Für Ionic 2 müssen Sie die folgende Variable zu Ihrer app.component.ts hinzufügen:

declare var cordova:any;

Sie können Intercom dann so verwenden:

this.platform.ready().then(() => {

    cordova.plugins.intercom.registerIdentifiedUser({userId: "12345"});

    cordova.plugins.intercom.setLauncherVisibility('VISIBLE');

});

Beachten Sie, dass diese Installationsmethode nicht offiziell unterstützt wird.

Gibt es eine minimale erforderliche iOS SDK-Version?

Um Updates für das Intercom iOS SDK zu erhalten, benötigen Sie mindestens iOS 13. Wir unterstützen weiterhin Kunden mit älteren iOS-Versionen, jedoch werden für diese keine Updates mehr bereitgestellt.

Erstellen Sie Patches für ältere Versionen Ihrer SDKs?

Wir bieten keine Patches für ältere Versionen unserer SDKs an. Alle Fehlerbehebungen und Updates sind in der neuesten Version enthalten.

Hinweis: Mobile SDK-Updates erfolgen nicht automatisch. Ihr Entwicklungsteam muss manuell auf die neueste SDK-Version aktualisieren, um neue Funktionen und bug fixes zu erhalten.

Funktionen

Funktioniert der Messenger in mobilen Apps?

Ja! Aber der Messenger funktioniert in mobilen Apps etwas anders als auf dem Desktop. Dieser Artikel erklärt, wie Sie Ihre SDKs aktualisieren, um mit dem neuen Messenger zu arbeiten, und welche Funktionen auf iOS- und Android-Apps unterstützt werden.

Was ist mit dem Messenger in mobilen Apps verfügbar?

Wenn Besucher oder users den Messenger in Ihrer iOS- oder Android-App aufrufen, können sie mit den Help und Messages Spaces interagieren, falls Sie diese aktiviert haben, sowie mit Apps, die Sie zu Ihrem Home Space hinzufügen – so können sie mehr als nur chatten.

Sie können auch Gespräche mit Ihnen starten und tickets einreichen.

Ihre Kunden können Bilder & GIFs senden, aber das Hochladen anderer Dateien wird derzeit auf mobilen Geräten nicht unterstützt.

Erfahren Sie hier mehr über die Anpassung und Nutzung des neuen Messenger auf mobilen Geräten.

Unterstützt das Intercom mobile SDK mehrere Sprachen?

Wenn Intercom in Ihrer mobilen App geladen wird, wird die Sprache des users basierend auf der Sprache des Betriebssystems erkannt. Der Messenger wird in der Sprache des users geladen, wenn diese in Ihrem Workspace unterstützt wird. Wenn Ihr Workspace die Sprache nicht unterstützt, wird der Messenger in der Standardsprache Ihres Workspace geladen.

Intercom verfolgt nicht automatisch die Sprache des mobilen users als Attribut in deren Profil, wie wir es für das Web tun. Für users, die den Messenger im Web nutzen, verfolgt Intercom deren Sprache im Attribut „Browser language“, das nur für Web-Integrationen gilt.

Wenn Sie ausgehende Inhalte für mobile users basierend auf Sprache ausrichten möchten, müssen Sie das Tracking selbst einrichten. Sie können entweder das language_override-Attribut verwenden, um die Sprache mobiler users zu verfolgen, oder ein benutzerdefiniertes Attribut zur Sprachverfolgung erstellen.

Unterstützt das Intercom mobile SDK das Hochladen von Videos auf mobilen Geräten?

Derzeit unterstützen wir Video-Uploads im Android SDK.

Unterstützen die mobile SDKs Right To Left Sprachen (RTL)?

Derzeit unterstützen wir RTL in den mobilen SDKs nicht offiziell. Neuere Funktionen in den SDKs wie der Help Center unterstützen es jedoch, weshalb Sie in neueren SDK-Versionen einen Verweis auf RTL sehen. Wir planen, RTL in Zukunft vollständig zu unterstützen, aber derzeit unterstützen wir RTL nicht.

Wie kann ich Intercom verwenden, um Ankündigungen wie einen Splashscreen anzuzeigen?

Intercom bietet keine spezielle Splashscreen-Funktion, aber Sie können ausgehende Nachrichten wie Chats und Posts verwenden, um einen ähnlichen Effekt zu erzielen. Chats können verwendet werden, um Ihren Kunden über den Intercom Messenger etwas anzukündigen und sie zu einem Gespräch zu bewegen. Posts können verwendet werden, um eine Ankündigung in Ihrem Produkt zu machen, die sofort die Aufmerksamkeit Ihrer Kunden erhält und in zwei Größen gesendet werden kann: Klein oder Groß.

Kann ich Nachrichten an bestimmte Bildschirme in meiner mobilen App senden?

Es ist nicht möglich, eine Nachricht an users Ihrer mobilen App auf bestimmten Bildschirmen zu senden.

Als Workaround können Sie jedoch ein benutzerdefiniertes Attribut verfolgen, nennen wir es ‚current_screen‘, und dieses Attribut mit einem Bezeichner (z. B. ein Name oder eine ID) des Bildschirms aktualisieren, wann immer Ihre users in Ihrer mobilen App zu einem anderen Bildschirm navigieren. Dies kann für alle Bildschirme erfolgen oder nur für diejenigen, die Sie mit einer automatischen Nachricht ansprechen möchten.

Nach der Implementierung des Attributs können Sie die Regel ‚current_screen ist splashScreen‘ in Ihrem Zielpublikum konfigurieren, um eine Nachricht nur an users zu senden, die sich auf dem Splashscreen befinden.

Verfolgt Intercom zusätzliche Attribute über users über mobile SDKs?

Sobald das mobile SDK in einem Workspace installiert ist, sind zusätzliche Attribute in der Weboberfläche verfügbar

Für iOS/Android

  • Is mobile unidentified

    • Unidentified users sind diejenigen, die sich nicht mit einer E-Mail/User_id angemeldet haben (ähnlich wie leads in der Webintegration, aber denken Sie daran, dass alle mobilen SDK-Datensätze users sind)

  • Enabled Push Messaging

    • zeigt an, dass der Datensatz ein Gerätetoken hat und somit Push Messaging/Benachrichtigungen empfangen kann

Hinweis: Das mobile SDK-Attribut 'Enabled Push Messaging' wird nur auf 'True' oder 'Unknown' gesetzt. Wenn ein Benutzer ein Gerätetoken in seinem Benutzerprofil hat, wird 'Enabled Push Messaging' true zurückgeben. Andernfalls wird 'Unknown' zurückgegeben.

Für Android

  • Zuletzt auf Android gesehen

  • Android-Sitzungen

  • Android-App-Version

  • Android-Gerät

  • Android OS-Version

Für iOS

  • Zuletzt auf iOS gesehen

  • iOS-Sitzungen

  • iOS-App-Version

  • iOS-Gerät

  • iOS OS-Version

Wann werden mobile Sitzungen erhöht?

  • Hier ist ein Link zu unserem Artikel, der dies erläutert

  • iOS

    • Wir erhöhen die iOS-Sitzungsanzahl beim ersten Registrieren eines Benutzers

    • Und anschließend bei jeder UIApplicationDidBecomeActiveNotification, die ausgelöst wird, wenn ein Benutzer Ihre App öffnet, sofern sie zwanzig Sekunden auseinanderliegen.

    • App-Öffnungen innerhalb von zwanzig Sekunden werden nicht gezählt.

  • Android: folgt ähnlichen Regeln

Gibt es einen Unterschied bei App Version-Attributen?

  • iOS-App-Version ist vom Typ String

  • Android-App-Version ist vom Typ „Version“, was Größer-als- und Kleiner-als-Vergleiche ermöglicht

Funktionieren Product Tours auf Mobilgeräten?

Product Tours ermöglichen es Ihnen, geführte In-App-Erlebnisse für Ihre Kunden zu erstellen, um eine bessere Akzeptanz zu fördern.

Product Tours funktionieren nur auf dem Desktop. Sie funktionieren derzeit nicht auf mobilen Geräten (einschließlich Tablets) im Browser oder in mobilen Apps.

Für ein ansprechendes, mehrstufiges Erlebnis in Ihrer Mobile App probieren Sie Mobile Carousels aus.

Funktionieren Workflows auf Mobilgeräten?

Ja, das tun sie.

Gibt es bekannte Verbindungsprobleme für Kunden in Vietnam?

Ja, die gibt es.

Wenn Sie oder Ihre Kunden in Vietnam Verbindungsprobleme mit der intercom.com domain in unseren mobilen SDKs haben, können Sie den Standard-Domainnamen wie folgt überschreiben:

Android

Fügen Sie die folgende Meta-Daten in der AndroidManifest.xml Ihrer App hinzu:

<meta-data
android:name="io.intercom.android.sdk.host"
android:value=".intercom-messenger.com" />

iOS

Fügen Sie dieses Attribut in Ihre Info.plist ein:

Key: IntercomCustomURL
Type: String
Value: intercom-messenger.com

Mit dieser Änderung werden alle API-Anfragen über intercom-messenger.com statt über mobile-messenger.intercom.com geleitet.

Dies wird vom Android SDK 9.1.2+ und iOS SDK 13+ unterstützt.

Wie werden Push-Benachrichtigungen von Intercom gesendet?

Obwohl es Unterschiede gibt, wie Apple und Android Push handhaben, sind die Prinzipien unten dargestellt gleich.

  1. Anfrage für Push-Gerätetoken: Wenn eine App Push-Benachrichtigungen verwenden möchte und ein Benutzer den Berechtigungsdialog akzeptiert, wird eine Anfrage an den entsprechenden Push-Dienst für ein Push-Gerätetoken gesendet. Dieses Token ist die „Adresse“, die es dem Push-Dienst ermöglicht, eine Push-Benachrichtigung an ein bestimmtes Gerät zu senden (ähnlich einer E-Mail-Adresse).

  2. Push-Gerätetoken gesendet: Wenn die Anfrage gültig ist, gibt der Push-Dienst ein gültiges Token an das Gerät zurück.

  3. Push-Gerätetoken an Intercom übermittelt Ein Token muss vom Gerät an einen anderen Dienst gesendet werden, um für Push verwendet zu werden. Es kann an den eigenen Server eines App-Entwicklers, an Intercom, an einen anderen Drittanbieter oder an alle genannten gesendet werden. Wenn dieses Token bei Intercom eingeht, wird es dem Benutzer-Datensatz zugeordnet.

  4. Push-Paket von Intercom an Apple/Google gesendet Wenn eine Push-Benachrichtigung gesendet werden soll, müssen folgende Informationen an die Apple/Google-Push-Server gesendet werden:

    1. Gerätetoken

    2. Benachrichtigungsdetails (z. B. Logo, Titel, Text)

    3. Authentifizierungsdetails (die es uns ermöglichen, Push-Nachrichten im Namen der App zu senden: Hier kommen Apple iOS-Zertifikate und Google Android GCM/FCM-Schlüssel ins Spiel, die im Intercom Settings Dashboard aktualisiert werden müssen)

  5. Push-Benachrichtigung an Gerät gesendet

    1. Wenn Intercom sich für ein bestimmtes Token beim Push-Dienst authentifiziert, wird die Push-Nachricht an das Gerät gesendet

    2. Push-Dienste verwenden Quality of Service (QOS)

Wie kann man das Push-Symbol auf iOS anpassen?

Push-Benachrichtigungssymbole sind in Xcode über Assets > AppIcon konfigurierbar

image.png

Verwendung der Intercom Mobile SDKs

Kann man mehrere app_ids dynamisch initialisieren / wechseln?

Es ist derzeit nicht möglich, auf Android zwischen mehreren IDs zu wechseln. Intercom.registerForLaterInitialisation(this) erlaubt nur eine spätere Initialisierung, ist aber nicht zum Wechseln von app_ids gedacht.

Es funktioniert jedoch auf iOS.

Speichern die Android/iOS Mobile SDKs Sitzungsdaten beim Deinstallieren und Neuinstallieren der App?

Nein, tun sie nicht

  • Für iOS: Die Apps sind sandboxed, daher hat die neue Installation keine Kenntnis von einer vorherigen Installation.

  • Für Android: Alle Daten gehen bei der Deinstallation verloren

Wenn eine App z. B. über den App/Play Store oder im Entwicklungsmodus aktualisiert wird, bleiben die Sitzungsdaten erhalten.

Wie speichert Intercom Sitzungsdaten auf dem mobilen Gerät einer App, die unser SDK verwendet?

Wir speichern eine Datei identity.icm, die eine anonyme UserId für nicht identifizierte users enthält. Für identifizierte users speichern wir deren E-Mail (sofern angegeben), deren userid und intercom id. Dies verwenden wir, um eine erneute Registrierung eines zuvor registrierten users zu verhindern. Ob eine neue Sitzung erstellt wird, hängt vom Zeitintervall seit der letzten Sitzung ab. Der Standardwert beträgt 20 Sekunden. Wir speichern nichts auf der Festplatte, um dies zu verfolgen.

Kann das Android SDK in einer App installiert werden, die keine Google Play Services hat, d. h. die App wird über Huawei App Gallery statt Google Play Store installiert?

Nein, Google Play Services sind für unser Android SDK erforderlich.

Wo finde ich meinen Mobile API-Schlüssel?

Ihre Mobile API Keys finden Sie, indem Sie mit der Maus über Ihr Avatar-Profilfoto unten links auf dem Bildschirm fahren, wenn Sie bei Intercom angemeldet sind, und dann Einstellungen > Installation > iOS / Android auswählen:

Falls Sie unsere Installationsanleitungen für iOS, Android und/oder Cordova, React Native noch nicht gelesen haben, empfehlen wir Ihnen, dies nachzuholen! 😊

Kann ich device tokens in Intercom importieren?

Nein, device tokens können nicht in Intercom importiert werden.

Wie kann ich Benutzersitzungen und Authentifizierung mit dem Intercom Android SDK verwalten, und was sind die besten Praktiken für den Umgang mit dem Benutzerstatus?

Das Intercom Android SDK verwaltet Benutzersitzungen intern. Sobald sich ein user mit Intercom.loginIdentifiedUser() anmeldet, wird die Sitzung gespeichert, und es ist nicht nötig, den user bei jedem Start der App erneut zu authentifizieren. Das SDK speichert den Anmeldestatus lokal und behält ihn, bis Sie explizit Intercom.logout() aufrufen.

Um die Logik Ihrer App mit Intercom synchron zu halten, stellen Sie sicher, dass Sie den user gleichzeitig in Intercom und in Ihrer App anmelden und Intercom.logout() aufrufen, wenn er sich abmeldet. So bleibt der Authentifizierungsstatus in Ihrem System und bei Intercom synchron.

Optional können Sie Benutzerdaten (z. B. ID, E-Mail) in Ihrer App speichern, um den aktuellen Sitzungsstatus zu verwalten, aber Intercom verlangt nicht, dass Sie den user erneut speichern oder identifizieren, es sei denn, die App wird neu installiert oder der user meldet sich explizit ab.

Warum bringt die Zurück-Taste den user zurück zum Startbildschirm, wenn er eine Push-Benachrichtigung aus der Benachrichtigungsleiste auswählt?

Die Launcher-Aktivität Ihrer App wird nicht zum Back-Stack hinzugefügt, daher führt das Drücken der Zurück-Taste nach Auswahl einer Benachrichtigung aus einer Intercom-Nachricht den Kunden zum Startbildschirm und nicht zu dem Bildschirm in der App, der zum Öffnen des Messengers gestartet wurde.

Warum können Endnutzer keine Bilder in das Android Mobile SDK hochladen?

Wenn ein Endnutzer keine Bilder in das Mobile SDK hochladen kann, liegt das typischerweise an fehlenden Berechtigungen zum Zugriff auf die Fotobibliothek des Geräts. Wenn das SDK versucht, den Picker zu öffnen, melden iOS/Android, dass der Zugriff verweigert wurde, sodass Uploads nicht möglich sind.

  • Neuere Android-Versionen fordern bei der Auswahl zusätzlicher Funktionen wie Datei-/Bildzugriff um Erlaubnis.

    image.png

  • Wenn der Zugriff verweigert wird, kann die Abfrage erneut erscheinen, andernfalls müssen Kunden ihre App-Berechtigungen manuell überprüfen und aktivieren.

image.png

Wenn Sie auch „Sie haben den Zugriff auf Ihre Fotos verweigert“ Fehler / Keine Speicherberechtigung angezeigt bekommen

Fehlender Block: uses-permission

Ohne diese Berechtigungen ist keine „Speicher“-Berechtigung verfügbar

image.png

Korrekte Berechtigungen

Android Korrekte Berechtigungen.png
Verwandte Artikel
Intercom in Ihrer mobilen App installieren und verwenden
Erste Schritte mit Mobile Push
Begrüßen und betreuen Sie Ihre app users mit mobilen Karussells
Mobile-Karussell entwerfen und erstellen
Bilder zu mobilen Push-Nachrichten hinzufügen
Hat dies deine Frage beantwortet?