Méthodes de gamification

Méthodes de gamification sur Instagram et Facebook

Pour configurer les opérations des fonctions, nous recommandons d’utiliser la gamification modèle pour les chats Instagram comme référence.

Pour utiliser les fonctions listées ci-dessous, vous devez déclarer des variables communes dans le Paramètres du projet:

comment_score	nombre de points à attribuer pour les commentaires	10
comment_max_actions	nombre maximal de commentaires par jour	5
min_comment_len	longueur minimale du commentaire	25
stories_score	nombre de points à attribuer pour les réactions dans les stories	15
stories_max_actions	nombre maximal d’actions par jour	1
stories_mention_score	nombre de points à attribuer pour les mentions dans les stories	5
stories_mention_max_actions	nombre maximal d’actions par jour	2
post_mention_score	nombre de points à attribuer pour les mentions dans les publications	10
post_mention_max_actions	nombre maximal d’actions par jour	3
end_game_date	date de fin du jeu	30.12.2021

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 privés

game_add_stories_mention() - ajoute des points pour les mentions dans les stories

game_get_user_score() - renvoie les points de l’utilisateur

game_get_user_place() - affiche la position de l’utilisateur dans le classement

game_get_leader_score() - renvoie les points du leader dans le classement

game_get_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None) - l’appel de la fonction sans arguments renvoie un classement trié sous forme de tableau d’utilisateurs. Elle accepte les 5 paramètres suivants : count - combien d’utilisateurs retourner ; décalage - la position de départ dans le classement pour la sélection (0 signifie que la liste commence par le leader et descend selon les points ; par exemple, 3 signifie que la sélection commence à partir de la 4e place et au-dessous) ; humanize 0 - renvoie un tableau de dictionnaires d’utilisateurs, 1 renvoie une liste formatée à afficher à l’utilisateur ; delimiter - le séparateur entre le nom d’utilisateur et son score (utilisé si humanize=1); plateforme 1 - affiche le identifiant Instagram (par exemple, @nik) à la place du nom d’utilisateur.

Exemple 1 : game_get_top(10, 0, 1, ' - ') renverra : John - 40 Anna - 30 George - 10 Exemple 2 : game_get_top(3, 0, 1, ' - ', 1) renverra : @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() - renvoie l’état de bannissement de l’utilisateur ; True s’il est 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 de l’utilisateur (mentions) 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

Obtention du classement dans Telegram

Pour configurer les opérations des fonctions, nous recommandons d’utiliser la gamification modèle 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 des clients 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 décalage - la position de départ dans le classement pour la sélection (0 signifie que la liste commence par le leader et descend selon les points ; par exemple, 3 signifie que la sélection commence à partir de la 4e place et au-dessous) humanize - 0 renvoie un tableau de dictionnaires d’utilisateurs, 1 renvoie une liste formatée à afficher à 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}