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 gemeinsamen Abhängigkeiten usw. kleiner)

Dies variiert je nach Konfiguration.

Plattformen und Support

Gibt es Xamarin Support?

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

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. Intercom kann jedoch 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 SDK-Versionen 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 öffnen, können sie mit den Help und Messages Spaces interagieren, wenn 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 auf Mobilgeräten Bilder, GIFs und Videos senden. Auf iOS wird der Datei-Upload (über Bilder/GIFs/Videos hinaus) seit SDK v18.2.0 unterstützt, mit Multi-Datei-Upload ab v19.6.0.

Erfahren Sie hier mehr über die Anpassung und Nutzung des neuen Messengers auf Mobilgerä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 Workspaces geladen.

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

Wenn Sie ausgehende Inhalte für mobile users sprachbasiert 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 Video-Uploads auf Mobilgeräten?

Video-Uploads werden sowohl von den Android- als auch iOS-SDKs unterstützt. Auf iOS werden Video-Uploads seit SDK v10.3.1 unterstützt, mit Kamera-basiertem Foto- und Videoaufnahmen ab v13. Auf Android werden Video-Uploads ebenfalls unterstützt. Endnutzer können auf beiden Plattformen Bilder, GIFs und Videos senden.

Unterstützen die Mobile SDKs Rechts-nach-Links-Sprachen (RTL)?

Derzeit unterstützen wir RTL in den Mobile 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 zukünftig vollständig zu unterstützen, aber aktuell wird RTL nicht unterstützt.

Wie kann ich Intercom verwenden, um Ankündigungen wie einen Splash-Screen anzuzeigen?

Intercom bietet keine spezielle Splash-Screen-Funktion, aber Sie können ausgehende Nachrichten wie Chats und Posts verwenden, um einen ähnlichen Effekt zu erzielen. Chats können genutzt werden, um Ihren Kunden etwas über den Intercom Messenger anzukündigen und sie zu einem Gespräch zu animieren. 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, Nachrichten 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 einer Kennung (z. B. einem Namen oder einer ID) des Bildschirms aktualisieren, wenn Ihre users zu einem anderen Bildschirm in Ihrer mobilen App navigieren. Dies kann für alle Bildschirme oder nur für die, die Sie mit einer automatischen Nachricht ansprechen möchten, erfolgen.

Nach der Implementierung des Attributs können Sie die Regel „current_screen ist splashScreen“ in Ihrer Zielgruppe konfigurieren, um eine Nachricht nur an users zu senden, die sich auf dem Splash-Screen befinden.

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

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

Für iOS/Android

Ist 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).
Aktivierte 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 erklärt
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, vorausgesetzt, sie liegen zwanzig Sekunden auseinander.
- App-Öffnungen innerhalb von zwanzig Sekunden werden nicht gezählt.
Android: folgt ähnlichen Regeln.

Gibt es Unterschiede 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 erlaubt.

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 mobilen App probieren Sie Mobile Carousels.

Funktionieren Workflows auf Mobilgeräten?

Ja, Workflows funktionieren auf Mobilgeräten über die iOS- und Android-SDKs. Einige Schrittarten sind auf Mobilgeräten nicht verfügbar – für eine vollständige Liste kompatibler Aktionen siehe Kanal-Kompatibilität im Workflows-Artikel.

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 die AndroidManifest.xml Ihrer App ein:

<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 mobile-messenger.intercom.com geleitet.

Dies wird ab 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.

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).
Push-Gerätetoken gesendet: Wenn die Anfrage gültig ist, gibt der Push-Dienst ein gültiges Token an das Gerät zurück.
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 Dritten oder an alle genannten gesendet werden. Wenn dieses Token bei Intercom eingeht, wird es dem Benutzer-Datensatz zugeordnet.
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)
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

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 dient dazu, eine erneute Registrierung eines bereits registrierten users zu verhindern. Ob eine neue Sitzung erstellt wird, hängt vom Zeitintervall seit der letzten Sitzung ab. Standardmäßig sind das 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, also z. B. über Huawei App Gallery statt Google Play Store installiert wurde?

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 im 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 Gerätetokens in Intercom importieren?

Nein, Gerätetokens 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 die Handhabung des 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 cached den Anmeldestatus lokal und hält ihn aufrecht, 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 der Zurück-Button 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 des Zurück-Buttons nach Auswahl einer Benachrichtigung aus einer Intercom-Nachricht den Kunden zum Startbildschirm zurück, anstatt 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 meist 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 der Upload nicht fortgesetzt werden kann.

Neuere Android-Versionen fragen bei der Auswahl zusätzlicher Funktionen wie Datei-/Bildzugriff nach Berechtigungen.

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

Für Bildanhänge unter Android 10 und höher sind keine zusätzlichen Speicherberechtigungen erforderlich. Das SDK verwendet den systemeigenen Fotopicker und Scoped Storage APIs, die den Zugriff ohne explizite Speicherberechtigungen regeln. Stellen Sie sicher, dass Ihre App den Zugriff auf die Fotobibliothek nicht explizit in der Berechtigungsverwaltung verweigert.