Campagnes

Utilisez /referraltrack campaign inspect <id> pour obtenir les nombres de parrainages actuels et les nombres d'événements durables. Toutes les commandes d'administration des campagnes nécessitent referraltrack.admin.

Après la date de fin configurée, /referraltrack campaign archive <id> enregistre un instantané immuable des compteurs et de l'ensemble du classement des parrains validés. /referraltrack campaign archived <id> affiche cet instantané (jusqu'à 100 entrées du classement), même après la suppression de la définition de la configuration. Répéter l'archivage conserve l'instantané d'origine. Utilisez un nouvel ID de campagne pour chaque saison. Les parrainages en attente peuvent être validés plus tard ; l'archive est expressément un instantané à son heure UTC enregistrée. Attendez la fin des validations en cours avant d'archiver si vous voulez qu'elles figurent dans les résultats finaux.

La collecte des événements commence à l'installation de cette version ; les événements antérieurs ne peuvent pas être reconstitués. Les nombres de parrainages actuels et d'événements ne correspondent donc pas forcément. Écraser une attribution ne crée pas une seconde réclamation réussie. Supprimer un parrainage n'efface pas ses événements historiques.

  • Impressions : affichages réussis de /referral top <campaign-id>, une fois par joueur et par jour UTC.
  • Réclamations : réclamations de campagne initiales réussies, enregistrées dans la même transaction que le parrainage.
  • Validations : réclamations acceptées immédiatement ou franchissant plus tard leur seuil de validation, une fois par réclamation.
  • Rejets : résultats de réclamations de campagne rejetées comme inactives, non éligibles, invalides ou déjà réclamées ; une fois par joueur, campagne, résultat et jour UTC. Les codes de campagne inconnus et les refus au niveau de la commande dus au délai d'attente ou à la fenêtre de réclamation ne sont pas des événements de rejet de campagne.
  • Récompenses en file : le marqueur de récompense du parrainage, une fois par réclamation. Il mesure l'admission de la récompense, pas une livraison confirmée par Vault ou par des commandes externes. Les récompenses de paliers ne sont pas incluses.

Les clés d'observation contiennent des UUID de joueurs et des numéros de jour UTC, jamais d'adresses IP ni d'identifiants Discord. Les archives et les événements historiques sont conservés. Aucun archivage ni aucune suppression automatique n'est effectué.