Méthodes de gamification dans Instagram et Facebook
Pour configurer le fonctionnement des fonctions, nous vous recommandons d'utiliser le modèle de gamification pour les chats Instagram comme référence.
Pour utiliser les fonctions listées ci-dessous, vous devez déclarer des variables communes dans les Paramètres du projet :
game_add_comment(text=None) - ajoute des points pour un commentaire sur Instagram ou FB ; vous pouvez également passer n'importe quel texte.
game_add_stories() - ajoute des points pour les réactions dans les stories
game_add_message() - ajoute des points pour les messages directs
game_add_stories_mention() - ajoute des points pour les mentions dans les stories
game_get_user_score() - retourne les points de l'utilisateur
game_get_user_place() - affiche la position de l'utilisateur dans le classement
game_get_leader_score() - retourne les points du leader dans le classement
game_get_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None) - appeler la fonction sans arguments retourne un classement trié sous forme de tableau d'utilisateurs. Elle accepte les 5 paramètres suivants : count - combien d'utilisateurs retourner ; shift - la position de départ dans le classement pour la sélection (0 signifie que la liste commence par le leader et descend par points ; par exemple, 3 signifie que la sélection commence à partir de la 4ème place et en dessous) ; humanize 0 - retourne un tableau de dictionnaires d'utilisateurs, 1 retourne une liste formatée pour l'affichage à l'utilisateur ; delimiter - le séparateur entre le nom d'utilisateur et son score (utilisé si humanize=1) ; platform 1 - affiche le login Instagram (par exemple, @nik) au lieu du nom d'utilisateur.
Exemple 1 : game_get_top(10, 0, 1, ' - ') retournera : John - 40 Anna - 30 George - 10
Exemple 2 : game_get_top(3, 0, 1, ' - ', 1) retournera : @john - 40 @anna - 30 @privet - 10
game_add_score(count=1, client_id=None) - ajoute des points à l'utilisateur
game_set_score(score, client_id=None) - définit le total des points de l'utilisateur
game_ban_player() - bloque l'utilisateur
game_unban_player() - débloque l'utilisateur
game_user_banned() - retourne le statut de bannissement de l'utilisateur ; True si banni, False sinon
# permet de travailler avec des valeurs arbitraires dans le classement.
game_add_value(val_name, count=1, client_id=None) -
game_set_value(val_name, value, client_id=None)
Si client_id n'est pas fourni, la fonction fonctionne avec le client actuel.
game_minus_user_score(count =10) - soustrait des points à l'utilisateur (count - combien de points soustraire)
game_get_today_user_comment_action() - nombre de commentaires effectués par l'utilisateur aujourd'hui
game_get_today_user_message_actions() - nombre de messages envoyés par l'utilisateur aujourd'hui
game_get_today_user_stories_actions() - nombre de stories publiées par l'utilisateur aujourd'hui
game_get_today_user_mention_actions() - nombre d'activités (mentions) de l'utilisateur aujourd'hui
game_get_today_user_post_mention_actions() - nombre de publications avec mentions par l'utilisateur aujourd'hui
game_get_total_comment_action() - nombre total de commentaires pendant toute la durée du jeu
game_get_total_message_actions() - nombre total de messages pendant toute la durée du jeu
game_get_total_stories_actions() - nombre total de stories pendant toute la durée du jeu
game_get_total_stories_mention_actions() - nombre total de mentions dans les stories pendant toute la durée du jeu
game_get_total_post_mention_actions() - nombre total de mentions dans les publications pendant toute la durée du jeu
Obtenir le classement dans Telegram
Pour configurer le fonctionnement des fonctions, nous vous recommandons d'utiliser le modèle de gamification pour les chats Telegram comme référence.
Dans les variables globales, vous devez créer un dictionnaire nommé tg_thanks_score_data pour stocker les informations du client au format suivant :
{"total_thanks":20,"326659632":{"name":"John","user_name":"john","score":5},"403051597":{"name":"Timm","user_name":"dbeing","score":15,"banned":false}}
tg_get_top(count=99999999, shift=0, humanize=False, delimiter=None)
Paramètres :
count - combien d'utilisateurs retourner
shift - la position de départ dans le classement pour la sélection (0 signifie que la liste commence par le leader et descend par points ; par exemple, 3 signifie que la sélection commence à partir de la 4ème place et en dessous)
humanize - 0 retourne un tableau de dictionnaires d'utilisateurs, 1 retourne une liste formatée pour l'affichage à l'utilisateur
delimiter - le séparateur entre le nom d'utilisateur et son score (utilisé si humanize=1)
tg_get_user_info()
{'score': user_score, 'place': place, 'name': name}