Hoe segmentatie te gebruiken in app pushmeldingen met PushEngage

PushEngage stelt u in staat om uw app-abonnees in segmenten te groeperen, zodat u specifieke doelgroepen kunt targeten met relevante meldingen in plaats van naar iedereen tegelijk te broadcasten. Deze handleiding behandelt zowel statische segmenten, waarbij een abonnee in de groep blijft totdat u deze verwijdert, als dynamische segmenten, waarbij de abonnee automatisch wordt verwijderd na een ingesteld aantal dagen. Het omvat dashboardinstellingen, iOS- en Android SDK-methoden en links naar de REST API voor server-side beheer.

Voordat u begint

• Uw app moet geïntegreerd zijn met de PushEngage iOS- of Android SDK. Als u dit nog niet hebt gedaan, voltooi dan eerst de installatie:
  • iOS App Push Installatie
  • Android App Push Installatie
  • React Native App Push Installatie
  • Flutter App Push Installatie
• Segmenten moeten worden aangemaakt in het PushEngage Dashboard voordat uw SDK-code ernaar kan verwijzen. De segmentnaam die u doorgeeft aan de SDK moet exact overeenkomen met de naam in het dashboard (hoofdlettergevoelig).
• De volledige SDK-methodeverwijzingen zijn beschikbaar op iOS SDK Referentie en Android SDK Referentie.

Hoe App Push Segmentatie Werkt

Wanneer een gebruiker uw app opent en uw SDK-code een add-segment methode aanroept, registreert PushEngage dat apparaat onder het overeenkomende segment in uw account. Vanaf dat moment zal elke campagne die u op dat segment richt, die abonnee bevatten.

Er zijn twee segmenttypen:

Statische segmenten blijven bestaan totdat u de abonnee expliciet verwijdert. Gebruik deze voor permanente groeperingen die een vaste staat weerspiegelen, zoals het plan-niveau van een abonnee, de voorkeursinhoudscategorie of een voltooide onboardingstap.

Dynamische segmenten hebben een door u gedefinieerde tijdslimiet in dagen. PushEngage verwijdert de abonnee automatisch uit het segment nadat die periode is verlopen zonder enige actie van uw app. Gebruik dynamische segmenten voor tijdelijke staten zoals een recent aankoopvenster, een actieve proefperiode of een wachtperiode na boeking.

Beide typen worden op dezelfde manier aangemaakt in het dashboard. Het verschil zit in de SDK-methode die u aanroept om abonnees eraan toe te voegen.

Stap 1: Maak een Segment aan in het Dashboard

Voordat uw SDK een abonnee aan een segment kan toewijzen, moet het segment bestaan in PushEngage.

1. Log in op uw PushEngage-account op app.pushengage.com.
2. Ga naar Doelgroep » Segmenten.
3. Klik op Een nieuw segment maken.
4. Voer een segmentnaam in. Gebruik een naam die beschrijvend is en gemakkelijk te refereren in code, bijvoorbeeld "Recente Kopers" of "Premium Gebruikers".
5. Klik op Segment opslaan.

U hoeft geen URL-patronen of regels toe te voegen bij het aanmaken van segmenten voor app push. De SDK regelt de toewijzing programmatisch.

Herhaal deze stap voor elk segment dat u wilt gebruiken.

Stap 2: Voeg een App-abonnee toe aan een segment (iOS)

Roep de segmentmethoden aan waar dat zinvol is in de logica van uw app, zoals na een bevestigde aankoop, nadat een gebruiker een contentvoorkeur heeft geselecteerd, of wanneer een specifiek scherm wordt bekeken.

Statisch segment (iOS)

Gebruik addSegments om de huidige abonnee permanent toe te voegen aan een of meer segmenten.

PushEngage.addSegments(["Premium Users", "US Customers"]) { response, error in
    if response {
        print("Segments added successfully.")
    } else {
        if let error = error {
            print("Failed to add segments: \(error.localizedDescription)")
        }
    }
}

Om een abonnee uit een statisch segment te verwijderen:

PushEngage.removeSegments(["US Customers"]) { response, error in
    if response {
        print("Segments removed successfully.")
    }
}

Dynamisch segment (iOS)

Gebruik addDynamicSegments om de abonnee voor een vast aantal dagen toe te voegen aan een segment. PushEngage verwijdert de abonnee automatisch wanneer de duur is verlopen.

Elke vermelding in de array is een dictionary met twee sleutels: "name" (de segmentnaam zoals deze in het dashboard verschijnt) en "duration" (het aantal dagen dat de abonnee in dat segment blijft).

let dynamicSegments: [[String: Any]] = [
    ["name": "Recent Buyers", "duration": 30],
    ["name": "Trial Active", "duration": 14],
]

PushEngage.addDynamicSegments(dynamicSegments) { response, error in
    if response {
        print("Dynamic segments updated successfully.")
    } else {
        if let error = error {
            print("Failed to update dynamic segments: \(error.localizedDescription)")
        }
    }
}

Volledige methodehandtekeningen zijn beschikbaar in de iOS SDK Referentie.

Stap 3: Voeg een App-abonnee toe aan een segment (Android)

Statisch segment (Android)

Gebruik addSegment om de huidige abonnee permanent toe te voegen aan een of meer segmenten. Geef een lijst met segmentnamen door die exact overeenkomen met wat u in het dashboard hebt aangemaakt.

Java:

List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");

PushEngage.addSegment(segmentList, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Segment added successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Om een abonnee uit een statisch segment te verwijderen:

List<String> segmentList = new ArrayList<>();
segmentList.add("Premium Users");

PushEngage.removeSegment(segmentList, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Segment removed successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Dynamisch segment (Android)

Gebruik addDynamicSegment om de abonnee voor een bepaald aantal dagen toe te voegen aan een segment. Maak een Segment-object aan met een naam en duur, en geef dit vervolgens door in een lijst.

Java:

AddDynamicSegmentRequest addDynamicSegmentRequest = new AddDynamicSegmentRequest();
List<AddDynamicSegmentRequest.Segment> segments = new ArrayList<>();
AddDynamicSegmentRequest.Segment segment = addDynamicSegmentRequest.new Segment("Recent Buyers", 30);
segments.add(segment);

PushEngage.addDynamicSegment(segments, new PushEngageResponseCallback() {
    @Override
    public void onSuccess(Object responseObject) {
        // Dynamic segment added successfully
    }

    @Override
    public void onFailure(Integer errorCode, String errorMessage) {
        // Handle failure
    }
});

Volledige methodehandtekeningen en Kotlin-equivalenten zijn beschikbaar in de Android SDK Referentie.

Stap 4: Target een segment in een campagne

Zodra abonnees aan segmenten zijn toegewezen, kunt u die segmenten targeten bij het maken van een pushmeldingcampagne.

1. Ga naar Campagne » Push-uitzendingen (voor eenmalige verzendingen) of open een triggercampagne die u wilt configureren.
2. Klik op Nieuwe push-uitzending maken of open een bestaande campagne.
3. Vul de titel, het bericht en de URL van de melding in.
4. Selecteer in de sectie Publiek de optie Verzenden naar een segment.
5. Kies de segmentnaam uit de dropdown.
6. Voltooi de rest van de campagne-instellingen en plan of verzend.

[Screenshot: De campagnepagina met de sectie Publiek uitgevouwen, met "Verzenden naar een segment" geselecteerd en een segment gekozen uit de dropdown]

U kunt ook meerdere segmenten tegelijk targeten of segmenttargeting combineren met andere publieksfilters met behulp van Publieksgroepen. Zie de documentatie over Publieksgroepen voor meer details.

Stap 5: Beheer segmenten via de REST API (optioneel)

Als de server van uw app de abonneebeheer afhandelt, kunt u de PushEngage REST API gebruiken om segmenten te maken en abonnees toe te wijzen zonder de mobiele SDK te gebruiken.

De REST API-segment-eindpunten zijn:

Alle REST API-aanroepen vereisen uw API-sleutel in de Api-Key-header. Profiel-ID's zijn een flexibele identificatie die u toewijst aan abonnees (bijvoorbeeld een e-mailadres of gebruikers-ID) waarmee u dezelfde abonnee op verschillende apparaten kunt beheren.

Voorbeeld: Voeg een abonnee toe aan een segment met een profiel-ID:

curl -X POST \
  -H "Api-Key: <your_pushengage_api_key>" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d 'segment_name=Recent+Buyers&profile_id=user123&operation=add' \
  "https://api.pushengage.com/apiv1/profile"

Om dezelfde abonnee uit het segment te verwijderen, wijzigt u operation=add in operation=delete.

Zie de volledige REST API Segment Referentie voor volledige documentatie.

Veelgestelde vragen

Wat is het verschil tussen een statisch segment en een dynamisch segment? Een statisch segment houdt een abonnee in de groep totdat u een verwijderingsmethode aanroept. Een dynamisch segment verloopt automatisch na het aantal dagen dat u opgeeft bij het toevoegen van de abonnee. Gebruik statische segmenten voor permanente statussen zoals accounttype. Gebruik dynamische segmenten voor tijdelijke periodes zoals een periode na aankoop of een gratis proefperiode.

Moet ik een apart segment aanmaken in het dashboard voor dynamisch gebruik? Nee. Segmenten worden op dezelfde manier aangemaakt in het dashboard, ongeacht hoe u abonnees toevoegt. Het verschil zit alleen in welke SDK-methode u aanroept: addSegments voegt permanent toe, en addDynamicSegments voegt toe met een vervaldatum.

De segmentnaam die ik doorgeef aan de SDK komt niet overeen. Wat moet ik controleren? Segmentnamen zijn hoofdlettergevoelig en moeten exact overeenkomen met de naam in het PushEngage Dashboard, inclusief spaties en hoofdletters. Ga naar Audience » Segments om de exacte naam te verifiëren.

Kan een abonnee tegelijkertijd tot meerdere segmenten behoren? Ja. U kunt een abonnee toevoegen aan zoveel segmenten als u nodig heeft. Wanneer u een campagne naar een segment stuurt, ontvangen alle abonnees die momenteel aan dat segment zijn toegewezen deze.

Kan ik segmenten gebruiken met Trigger Campaigns, niet alleen met Push Broadcasts? Ja. Segment targeting is beschikbaar voor Push Broadcasts, Drip Autoresponders en Trigger Campaigns. De Audience-sectie in elk campagnetype bevat de optie om te targeten op segment.

Waar kan ik zien welke abonnees zich in een segment bevinden? Ga naar Audience » Segments in het dashboard en klik op de segmentnaam om abonneedetails en aantallen te zien.

Als u problemen ondervindt, neem dan gerust contact met ons op door hier te klikken. Ons ondersteuningsteam zal u kunnen helpen.