Push-Plan und Smart Push: Best Practices

1. Funktionsübersicht

EngageLab bietet zwei zentrale Funktionen, die Entwickler:innen beim intelligenten und effizienten Versandmanagement von Nachrichten unterstützen:

Push-Plan:

  • Dient zur Identifikation und Verwaltung einer Reihe zusammenhängender Push-Aufgaben und ermöglicht eine einheitliche Zuordnung und Analyse auf Statistik- sowie Betriebsebene. Weitere Informationen zur Nutzung in der Konsole finden Sie im Push-Plan-Leitfaden, Details zur API-Integration unter Push-Plan-API.

Smart Push:

  • Smart Push ist eine einzigartige EngageLab-Funktion zur Steigerung der Klickrate von Push-Benachrichtigungen. Jedes Mal, wenn ein:e Nutzer:in Ihre Website oder App (mit EngageLab SDK) besucht, wird die jeweils letzte Aktivitätszeit erfasst. Das System nutzt diese Daten, um Push-Benachrichtigungen zum optimalen Zeitpunkt basierend auf Geräte-Zeitzone und Nutzungsverhalten zu versenden. Für Nutzer:innen ohne Aktivitätsdaten (z. B. neu registrierte Nutzer:innen) können Sie entweder den Versand sofort auslösen oder eine bestimmte Zeit (basierend auf der Zeitzone) planen, sodass jede Zielperson eine definierte Versandzeit erhält.

alt text

  • Für die Integration von Smart Push per API verwenden Sie bitte die Scheduled Tasks API und aktivieren Sie den intelligent-Trigger. Dieser sorgt dafür, dass Push-Benachrichtigungen automatisch zum optimalen Zeitpunkt in der lokalen Zeitzone der Nutzer:innen – basierend auf deren letzter Aktivität – versendet werden, um die Klickrate zu erhöhen.

2. Typische Anwendungsfälle und empfohlene Vorgehensweisen

✅ Szenario 1: Großes E-Commerce-Promotion-Event (z. B. Jahresend-Dankeschön-Verkauf)

Ziel: Mehrere Blitzverkaufs-Erinnerungen und Rabattbenachrichtigungen innerhalb von fünf Tagen versenden – jeweils mit personalisiertem Versandzeitpunkt für jede:n Nutzer:in.

Umsetzungsschritte:

  1. Legen Sie einen Push-Plan mit POST /v4/push_plan an, z. B. plan_id=promo_year_end_2025;
  2. Erstellen Sie für jede Promotion-Nachricht geplante Aufgaben mit POST /v4/schedules über die Scheduled Tasks API, aktivieren Sie trigger.intelligent und setzen Sie backup_time;
  3. Tragen Sie das plan_id-Feld in options.plan_id ein, um spätere statistische Auswertungen und Analysen zu ermöglichen;
  4. Mit der Push-Plan-Statistik-API können Sie Lebenszyklusdaten für mehrere Pläne abfragen, einschließlich segmentierter Kennzahlen nach Plattform, Anbieter und Nachrichtentyp.

✅ Szenario 2: Mehrsprachige Social-App im internationalen Rollout

Ziel: Personalisierte Reaktivierungs-Erinnerungen und Feature-Ankündigungen je nach Region und Zeitzone der Nutzer:innen versenden.

Best Practice:

  1. Nutzen Sie Tags oder registration_id, um Nutzer:innen in verschiedenen Regionen (z. B. USA, Indien, Philippinen) gezielt anzusprechen;
  2. Konfigurieren Sie innerhalb einer Push-Aufgabe mehrsprachige Inhalte mit options.multi_language. Das System zeigt automatisch die passende Push-Nachricht basierend auf der Gerätesprache an. Aktivieren Sie den intelligent-Scheduler, um den optimalen Versandzeitpunkt zu gewährleisten;
  3. Tragen Sie das plan_id in das Feld options.plan_id ein, um die Kampagne zuzuordnen und die Performance zu analysieren.

3. Detaillierter API-Workflow

1. Push-Plan erstellen

POST /v4/push_plan Authorization: Basic base64(appKey:masterSecret) Content-Type: application/json { "plan_id": "promo_year_end_2025", "plan_description": "Jahresend-Dankeschön-Push-Plan" }
              
              POST /v4/push_plan
Authorization: Basic base64(appKey:masterSecret)
Content-Type: application/json

{
  "plan_id": "promo_year_end_2025",
  "plan_description": "Jahresend-Dankeschön-Push-Plan"
}

            
Diesen Codeblock im schwebenden Fenster anzeigen

2. Smart Push-Aufgabe erstellen (an Plan binden)

POST /v4/schedules Authorization: Basic base64(appKey:masterSecret) Content-Type: application/json { "name": "promo_year_end_reminder_01", "enabled": true, "trigger": { "intelligent": { "backup_time": "2025-12-28 09:00:00" } }, "push": { "from": "push", "to": { "registration_id": [ "regId_userA", "regId_userB" ] }, "body": { "platform": "android", "notification": { "alert": "Blitzverkauf läuft! Jetzt zugreifen!", "android": { "title": "Heiße Angebote im Anmarsch", "extras": { "promo": "year_end_sale" } } }, "options": { "plan_id": "promo_year_end_2025", "time_to_live": 86400 } }, "request_id": "req_year_end_01", "custom_args": { "task": "reminder_01" } } }
              
              POST /v4/schedules
Authorization: Basic base64(appKey:masterSecret)
Content-Type: application/json

{
  "name": "promo_year_end_reminder_01",
  "enabled": true,
  "trigger": {
    "intelligent": {
      "backup_time": "2025-12-28 09:00:00"
    }
  },
  "push": {
    "from": "push",
    "to": {
      "registration_id": [
        "regId_userA", "regId_userB"
      ]
    },
    "body": {
      "platform": "android",
      "notification": {
        "alert": "Blitzverkauf läuft! Jetzt zugreifen!",
        "android": {
          "title": "Heiße Angebote im Anmarsch",
          "extras": {
            "promo": "year_end_sale"
          }
        }
      },
      "options": {
        "plan_id": "promo_year_end_2025",
        "time_to_live": 86400
      }
    },
    "request_id": "req_year_end_01",
    "custom_args": {
      "task": "reminder_01"
    }
  }
}

            
Diesen Codeblock im schwebenden Fenster anzeigen

3. Push-Statistiken nach plan_id abfragen

Push-Plan-Statistiken

4. Empfohlene Best Practices

Schritt Empfohlene Vorgehensweise
Kampagnenplanung Mit der push_plan-API einen Kampagnenplan anlegen
Intelligente Zustellung schedules-API mit trigger.intelligent kombinieren
Personalisierung Tags und registration_id für gezieltes Targeting nutzen
Performance-Attribution options.plan_id zur Kennzeichnung für Statistik und Analyse

Weitere Details zur Integration finden Sie in der offiziellen EngageLab-Dokumentation oder kontaktieren Sie unser Support-Team unter support@engagelab.com.

icon
Vertrieb kontaktieren