Übersicht
Mit der Google Mobile Data Plan Sharing API kann ein Operator Benachrichtigungen auch an Nutzer senden, indem er einen PlanStatus überträgt.
Die API unterstützt derzeit die folgenden Benachrichtigungen:
- Niedriges Guthaben: wenn PlanModule.coarse BalanceLevel auf LOW_KONTINGENT festgelegt ist
- Out of Data: Wenn PlanModule.coarse BalanceLevel auf OUT_OF_DATA gesetzt ist. Wenn zusätzlich PlanModule.overUsagePolicy auf PAY_AS_YOU_GO gesetzt ist, wird der Nutzer benachrichtigt, dass er gleich nach dem Start den Modus „Pay as you go“ starten soll.
- Datenablaufwarnung: wenn PlanModule.planModuleState auf EXPIRING_SOON gesetzt ist
- Plan Activation: wenn PlanModule.planModuleState auf NEWLY_ACTIVE gesetzt ist
- Pay as you go: Wenn AccountInfo.payAsYouGoCharge mit dem Betrag gefüllt wird, den der Nutzer ausgegeben hat. Wenn der Betrag für accountGuthaben ausgefüllt ist, enthält die Benachrichtigung das verbleibende Guthaben auf dem Konto.
- Konto aufladen: wenn AccountInfo.accountTopUp und AccountInfo.accountGuthaben ausgefüllt sind. Beide Felder sind erforderlich, um die Kontoaufladebenachrichtigung an den Nutzer zu senden. Wenn Einheiten und Nanos in AccountInfo.accountTopUp auf null gesetzt sind, ist der Aufladebetrag nicht in der Benachrichtigung enthalten.
- Datenablauf: wenn PlanModule.planModuleState auf EXPIRED gesetzt ist. Dies gilt für bereits abgelaufene Pläne.
Für jeden Feldsatz wird eine Benachrichtigung an den Nutzer gesendet. Wenn in einem einzelnen PlanStatus mehrere coarseBalanceLevel- oder planModuleState-Felder festgelegt sind, wird die gleiche Anzahl von Benachrichtigungen an den Nutzer gesendet.
Der Tarifstatus, der die Benachrichtigung auslöst, wird an das Nutzergerät gesendet, um den On-Device-Cache zu aktualisieren. Dies verbessert die Nutzererfahrung, da ein aktueller Tarifstatus angezeigt wird, wenn der Nutzer auf die Benachrichtigung klickt. Wenn der zum Senden einer Benachrichtigung verwendete Tarifstatus nicht abgeschlossen ist und dem Nutzer nicht angezeigt werden soll, MUSS der Mobilfunkanbieter UiCompatibility auf UI_INCOMPATIBLE setzen.
Voraussetzungen
Ein PlanStatus in der Benachrichtigung sollte so viele Informationen wie möglich zum Mobilfunktarif des Nutzers enthalten. Für jeden Benachrichtigungstyp definiert die Data Plan Sharing API auch eine Mindestanzahl von Feldern, die zum Erstellen des Benachrichtigungstexts erforderlich sind. Der Operator MUSS diese Felder in einem „PlanStatus“ der Benachrichtigung enthalten.
| Benachrichtigung | Erforderliche Felder |
|---|---|
| Niedriger Kontostand | PlanModule.moduleName, PlanModule.byteBalancing.remainingBytes |
| Keine Daten mehr | PlanModule.moduleName |
| Warnung zum Ablauf von Daten | PlanModule.moduleName, PlanModul.expirationTime |
| Planaktivierung | PlanModule.moduleName |
| Pay as you go | AccountInfo.payAsYouGoCharge |
| Konto aufladen | AccountInfo.accountTopUp |
| Datenablauf | PlanModule.moduleName |