Skicka pushnotiser till delmängder av dina appanvändare

Det grundläggande konceptet för hur du kan skicka push-notiser till en grupp användare av din app är följande:

1. Användaren John öppnar din app (i det här exemplet antar vi att det är en shoppingapp).
2. John utför en handling som gör honom till en del av din målgrupp, t.ex. genom att trycka på en knapp för att prenumerera på meddelanden om rabatter på köksredskap. Åtgärden kan också bestå i att han bara surfar runt på avdelningen för köksredskap i din app, vilket kan betyda att John är intresserad av produkter till sitt kök.
3. Din webbplats kallar javascript-funktionen "setNotificationTopicSubscriptionStatus" med namnet på det ämne som du vill att John ska prenumerera på, till exempel "kitchen".
4. Senare kan du skicka ett meddelande till John och alla andra användare som prenumererar på det här ämnet. Om du till exempel har en rabattkod på köksartiklar kan du skicka ett meddelande till alla som prenumererar på ämnet "kök" för att informera dem om rabatten.

Tillgängliga Javascript-funktioner

När du vill prenumerera en appinstans på ett push-notiseringsämne är det bara att anropa funktionen setNotificationTopicSubscriptionStatus med den nya prenumerationsstatusen (true = prenumeration, false = avprenumeration) och det önskade ämnesnamnet.

<script>
    try {
        await setNotificationTopicSubscriptionStatus(true, "mytopic");
    }
    catch (e) {
        // Can occur if:
        // - you passed an invalid topic name.
        // - you didn't pass all necessary parameters to setNotificationTopicSubscriptionStatus().
        // - the app couldn't subscribe to the topic, for example because of connection issues. Should be very unlikely.
        // - the app couldn't connect to the native code. Should be very unlikely.
        // - push notifications are not included in your current plan
        console.log(e);
    }
</script>
    

Saker att tänka på:

• Ämnet måste matcha följande regex: [a-zA-Z0-9-_.~%]{1,850}
• Du bör återprenumerera användare på deras önskade ämnen ungefär en gång per månad. Detta säkerställer att ämnesprenumerationerna fortsätter att fungera även efter långvarig inaktivitet.
• Även om det är osannolikt kan det hända att prenumerationen misslyckas, så se till att fånga upp eventuella fel.

Du kanske också senare vill få en lista över ämnen som appinstansen prenumererar på. Returvärdet är en lista med strängar.

<script>
    try {
        var topics = (await getSubscribedNotificationTopics())["topics"];
    }
    catch (e) {
        // Can occur if:
        // - the app couldn't connect to the native code. Should be very unlikely.
        // - push notifications are not included in your current plan
        console.log(e);
    }
</script>
    

Du kanske också vill titta på ett mer komplett kodexempel. Här är koden för en knapp som prenumererar/avregistrerar användaren till/från kategorin på den aktuella sidan på en WordPress-webbplats.

Skärmdumpar

I appinställningarna finns det också ett sätt för dina användare att avregistrera sig från meddelanden.

API Endpoint-referens

Nu när du har prenumererat användare på ditt ämne, kan du börja skicka notifikationer till ditt ämne genom vårt API.

Hämta din appspecifika API-nyckel från din apps instrumentpanel.

Skicka din API-nyckel som en fråga i URL:en och förfrågningskroppen i JSON-format.