Configuration de la livraison à haute vitesse

Dans Pushwoosh, les segments d’audience sont définis à l’aide de Segments.

Pour les campagnes push standard, le segment est compilé après l’envoi de la requête /createMessage. Cela signifie qu’il peut y avoir un court délai avant l’envoi du message, surtout si le segment est complexe.

Avec la livraison à haute vitesse, les segments sont précompilés toutes les 10 minutes. Cela les maintient à jour et prêts à l’emploi, de sorte que les messages peuvent être envoyés instantanément, sans attendre que le segment soit compilé.

La livraison à haute vitesse est particulièrement utile lorsque le timing est crucial. Par exemple, des organisations sportives comme l’UEFA et la FIBA peuvent l’utiliser pour envoyer des mises à jour en temps réel où chaque seconde compte.

Ce guide explique comment configurer la livraison à haute vitesse en utilisant une application de sport comme exemple. Vous apprendrez à créer des segments d’audience pour notifier les utilisateurs des matchs à venir et des événements en direct.

Les prérequis pour utiliser la livraison à haute vitesse par les organisations sportives sont les suivants :

• Tous les matchs sont planifiés à l’avance, vous savez donc quand créer les Segments correspondants et pouvez précompiler les segments d’audience.
• Chaque match est associé à un ID unique. Par exemple, l’ID de match pour la finale de la Ligue des Champions est 0123.
• Chaque équipe est associée à un ID unique. Par exemple, l’ID de la Juventus est 111, celui du Real Madrid est 222, etc.
• Il existe un ensemble d’événements en direct sur lesquels vous souhaitez notifier les utilisateurs (buts, compositions d’équipe, coup d’envoi, etc.).

Tous les segments pour la livraison à haute vitesse doivent être créés à l’avance — idéalement avant le début du match dans le cas d’utilisation de l’exemple. Pushwoosh applique les conditions du segment à la base d’utilisateurs de l’application et précompile les segments toutes les 10 minutes (cet intervalle est réglable).

Lorsque vous envoyez une requête API /createMessage avec le contenu du push et le nom du segment, Pushwoosh dispose déjà d’une liste précompilée de destinataires, ce qui permet d’envoyer la notification push instantanément.

Tout d’abord, créez un ensemble de Tags à appliquer, et définissez les valeurs de Tag pour les appareils des utilisateurs. Créez des Tags de type LIST correspondant aux événements de match en direct tels que coup d’envoi, but, carton rouge, etc.

Par exemple : MATCH-KICKOFF, MATCH-GOAL, MATCH-RED_CARD

Créez le même ensemble de Tags décrivant les événements de match en direct pour les équipes. Par exemple : TEAM-KICKOFF, TEAM-GOAL, TEAM-RED_CARD

En s’abonnant à ces Tags, les utilisateurs de l’application peuvent choisir quelles notifications ils souhaitent recevoir :

• notifications sur le match spécifique (par ex., le match Juventus - Real Madrid) ;
• notifications sur les matchs de leur équipe favorite (par ex., uniquement les matchs de la Juventus) ;
• notifications sur les événements se produisant pendant le match (par ex., uniquement les buts du match Juventus - Real Madrid) ;
• notifications sur des événements spécifiques de leur équipe favorite (par ex., les buts et les compositions d’équipe des matchs de la Juventus).

Vous pouvez maintenant renseigner les valeurs de Tag spécifiées précédemment via la requête API setTags, et abonner les utilisateurs à des catégories spécifiques de notifications push.

Par exemple : Lorsqu’un utilisateur s’abonne pour recevoir les mises à jour sur le coup d’envoi et les buts de la finale de la Ligue des Champions, appelez le /setTags avec l’ID du match :

{
  "request": {
    "application": "app_code",
    "hwid": "device_hardware_id",
    "tags": {
      "MATCH_KICKOFF": "0123", // match ID
      "MATCH_GOAL": "0123"     // match ID
    }
  }
}

L’utilisateur recevra des notifications sur le coup d’envoi et les buts marqués lors de la finale de la Ligue des Champions. Lorsqu’un utilisateur s’abonne pour recevoir les mises à jour sur les buts et les cartons rouges des matchs du Real Madrid, appelez le /setTags comme suit :

{
  "request": {
    "application": "app_code",
    "hwid": "device_hardware_id",
    "tags": {
      "TEAM_KICKOFF": "222", // team ID
      "TEAM_GOAL": "222"     // team ID
    }
  }
}

Cet utilisateur recevra des notifications sur les coups d’envoi et les buts à chaque fois que le Real Madrid joue.

Vous pouvez maintenant créer des Segments pour les événements de match basés sur les Tags et leurs valeurs (ID de match et ID d’équipe). Les Segments doivent être créés via la requête API /createFilter 30 minutes avant le début du match.

Pour notifier les utilisateurs des buts marqués lors de la finale de la Ligue des Champions de l’exemple ci-dessus, appelez le /createFilter avec les paramètres suivants : Nom du segment : 0123_GOAL Conditions du segment : #TEAM-GOAL(111, 222) OR #MATCH-GOAL(0123)

{
  "request": {
    "auth": "auth_token",
    "name": "0123_GOAL",
    "conditions": [
      ["TEAM-GOAL", "IN", ["111", "222"]],
      ["MATCH-GOAL", "IN", ["0123"]]
    ],
    "operator": "OR", // optionnel. Valeurs de l'opérateur : 'AND', 'OR'
    "application" : "AAAAA-00000"
  }
}

Cette requête compilera le segment d’utilisateurs abonnés aux mises à jour sur les buts de la finale de la Ligue des Champions (ID de match=0123) OU les utilisateurs qui suivent soit la Juventus soit le Real Madrid (ID d’équipe=111,222).

Pour configurer une livraison à haute vitesse dans votre Pushwoosh Control Panel, créez un nouveau Segment avec les valeurs de Tag correspondantes et associez-le à l’application à laquelle vous allez envoyer des pushes. Les Segments spécifiques à l’application sont précompilés toutes les 10 minutes pour garder les segments d’audience toujours à jour.

Lorsque l’événement du match se produit (but marqué, coup d’envoi, carton rouge, etc.), appelez le /createMessage avec le contenu de la notification push et le nom du Segment :

{
  "request": {
    "application": "AAAAA_00000",
    "auth": "auth_token",
    "notifications": [
      {
        "content": "12’ But de la Juventus ! Juventus 1 – 0 Real Madrid",
        "filter": "0123_GOAL",
        "send_date": "now"
      }
    ]
  }
}

Une fois que nous recevons l’appel /createMessage, nous avons déjà une liste pré-compilée d’appareils qui correspondent aux critères du Segment, et nous envoyons immédiatement la notification vers les passerelles APNs et FCM.

Une fois le match terminé, tous les Segments correspondants doivent être supprimés afin que les ressources de calcul ne soient pas dépensées pour une nouvelle compilation de Segments qui ne sont plus pertinents, surtout au détriment des Segments pour les matchs qui sont prévus ensuite. Supprimez les Segments via la requête API /deleteFilter, par exemple :

{
  "request": {
    "auth": "auth_token",
    "name": "0123_GOAL"
  }
}

Pour éviter la suppression manuelle des Segments, définissez la date d’expiration du Segment via la requête /createFilter afin que le Segment soit supprimé automatiquement à la date spécifiée :

{
  "request": {
    "auth": "auth_token",
    "name": "0123_GOAL",
    "conditions": [
      ["TEAM-GOAL", "IN", ["111", "222"]],
      ["MATCH-GOAL", "IN", ["0123"]]
    ],
    "operator": "OR",  // optionnel. Valeurs : 'AND', 'OR'
    "application": "AAAAA-00000",
    "expiration_date": "YYYY-MM-DD"  // optionnel. Expiration du Segment (Filtre)
  }
}