Dokumentation

01 / App verbinden

App erstellen

Melden Sie sich mit Google oder bestätigter E-Mail-Adresse und Passwort an. Erstellen Sie unter Apps eine Anwendung und wählen Sie Android. Einstellungen für iOS und Web können Sie für später speichern.

Kopieren Sie die App-ID aus den Einstellungen. Sie ist eine PushPort-Kennung, keine Firebase-Projekt-ID und kein Android-Paketname.

Voraussetzungen

• Android-App ab API 23.
• Testgerät mit Google Play-Diensten und Internetzugang.
• Zugriff auf das Firebase-Projekt der App.

02 / App verbinden

Firebase verbinden

Öffnen Sie das passende Projekt in Firebase. Erstellen Sie unter Project settings → Service accounts einen privaten JSON-Schlüssel und laden Sie ihn in den Android-Einstellungen der entsprechenden PushPort-App hoch.

Der private Schlüssel bleibt auf dem Server. Er gehört nicht ins Android-Projekt. Diese PushPort-Integration benötigt weder google-services.json noch das Google Services Gradle-Plugin. Eine unabhängige Firebase-Integration der App kann bestehen bleiben.

• Verwenden Sie die Zugangsdaten des richtigen Firebase-Projekts.
• Eine Paketbeschränkung muss zur Android applicationId passen.
• Firebase Analytics ist für die Gebietsschema-Daten nicht erforderlich.

03 / App verbinden

Android-SDK installieren

SDK 0.3.0 wird derzeit als Maven-Repository-Build bereitgestellt, noch nicht über Maven Central. Fragen Sie den Support nach dem Build und tragen Sie den Repository-Pfad in Gradle ein. Eine einzelne AAR-Datei enthält keine Metadaten für transitive Abhängigkeiten.

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("/path/to/pushport-maven-repository")
            content { includeGroup("dev.pushport") }
        }
    }
}

dependencies {
    implementation("dev.pushport:android-sdk:0.3.0")
}

Initialisieren Sie das SDK in Ihrer Application-Klasse und registrieren Sie diese in AndroidManifest.xml. Nutzen Sie eine vorhandene Application-Klasse weiter. Bei mehreren Prozessen erfolgt die Initialisierung nur im Hauptprozess.

import android.app.Application
import dev.pushport.sdk.PushPort

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        PushPort.initWithContext(this, "PUSHPORT_APP_ID")
    }
}

<application android:name=".MyApplication" />

PushPort.requestNotificationPermission(this)

• Fragen Sie die Benachrichtigungsberechtigung aus einer sichtbaren Activity ab und erklären Sie den Nutzen.
• Firebase Messaging, WorkManager und Manifest-Komponenten kommen mit der Abhängigkeit.
• Starten Sie die App, erteilen Sie die Berechtigung und prüfen Sie die Installation unter Zielgruppe.

04 / Nachrichten verwalten

Zielgruppe verstehen

Die Zielgruppe zählt Installationen. Eine Person mit zwei Geräten kann zweimal erscheinen. Filtern Sie nach Sprache, Gebietsschema, ungefährem Land und Abonnementstatus; speichern Sie hilfreiche Kombinationen als Segmente.

Das SDK synchronisiert App- und System-Gebietsschemas, Zeitzone, Version und Benachrichtigungsstatus. de-DE ist ein Gebietsschema, de eine Sprache. Das Land wird anhand der IP geschätzt und kann unbekannt sein.

PushPort.setLocale(context, "de-DE")
PushPort.setLocale(context, null)
PushPort.setSubscribed(context, false)
PushPort.setSubscribed(context, true)
PushPort.sync(context)

• SUBSCRIBED — Versand möglich, wenn Token und Berechtigung vorliegen.
• UNSUBSCRIBED / PERMISSION_DENIED — App oder System hat Benachrichtigungen deaktiviert.
• AWAITING_TOKEN / INVALID_TOKEN — kein verwendbares Token vorhanden.

05 / Nachrichten verwalten

Senden und planen

Öffnen Sie die Kampagnen Ihrer App. Speichern Sie Titel, Nachricht und Zielgruppe als Entwurf. Prüfen Sie die erreichbare Anzahl und senden Sie zunächst einen Test an Ihre eigene Installation.

Wählen Sie sofortigen Versand oder einen zukünftigen Zeitpunkt. Die Anzeige nutzt die Browser-Zeitzone, gespeichert wird UTC. Der Zeitplan läuft auf dem Server auch nach dem Schließen der Seite weiter.

• Reihenfolge der Übersetzung: genaues Gebietsschema → Sprache → Standardtext.
• Einmalige Zeitpläne sind verfügbar; Wiederholungen und lokale Empfängerzeiten noch nicht.
• Abbrechen stoppt ausstehende Nachrichten, ruft aber bereits an FCM übergebene nicht zurück.

06 / Nachrichten verwalten

Bilder und Links

Geben Sie eine öffentlich erreichbare HTTPS-Bildadresse und optional einen HTTPS-Ziellink an. SDK 0.3.0 zeigt zuerst den Text und ergänzt das Bild nach erfolgreichem Download.

Unterstützt werden PNG, JPEG und WebP bis 1 MiB: maximal 4096 Pixel je Seite und insgesamt 8 Millionen Pixel. Adressen mit Anmeldung oder in privaten Netzwerken eignen sich nicht.

• Das Bild muss zum Versandzeitpunkt erreichbar bleiben.
• Prüfen Sie Bild und Ziel auf einem echten Gerät.
• Ein fehlgeschlagenes Bild verhindert nicht grundsätzlich die Textanzeige.

07 / Prüfen und verstehen

Ergebnisse verstehen

FCM-Annahme bedeutet, dass der Anbieter die Anfrage akzeptiert hat. Sie bestätigt keine Anzeige auf dem Gerät. Öffnungen werden separat erfasst, wenn das SDK einen Tipp meldet.

Prüfen Sie Kampagnenergebnis und Installationsstatus gemeinsam. Ein ungültiges Token ist etwas anderes als ein vorübergehender Anbieterfehler. Unklare Ergebnisse werden nicht blind wiederholt, um Duplikate zu vermeiden.

• Vor einem neuen Versuch Abonnement und Systemberechtigung prüfen.
• Vorschau und tatsächliche Zielgruppe können sich unterscheiden.
• Für die Untersuchung Zeitpunkt und Installations-ID vergleichen.

08 / Prüfen und verstehen

Probleme beheben

Fehlt die Installation, starten Sie die App und prüfen Sie App-ID, Serververbindung und SDK-Initialisierung. Ist sie vorhanden, aber nicht erreichbar, prüfen Sie Berechtigung, Abonnement und Token.

Wurde die Nachricht angenommen, erscheint aber nicht, prüfen Sie Netzwerk, Benachrichtigungseinstellungen und Zielinstallation. Bei Bildproblemen öffnen Sie die URL ohne Anmeldung und prüfen Sie Größe und Format.

• Code fehlt: Spamordner und Adresse prüfen, vor einem neuen Code eine Minute warten.
• Firebase-Fehler: Gehören die Sender-Zugangsdaten zum richtigen Projekt?
• Weiterhin Probleme? Senden Sie App-ID, ungefähren Zeitpunkt und erwartetes Ergebnis über Kontakt.