Comment notifier une API externe lorsqu'une récompense de performance est déclenchée dans Post Affiliate Pro

Définition du problème

Les gestionnaires de programmes d’affiliation ont souvent besoin que Post Affiliate Pro notifie automatiquement des systèmes externes—tels que des API, des CRM ou des applications personnalisées—lorsque des règles de récompense de performance spécifiques sont déclenchées (par exemple, lorsqu’un affilié recrute un certain nombre de sous-affiliés ou atteint un objectif de ventes). Cependant, Post Affiliate Pro ne propose pas de fonctionnalité native pour appeler une API externe directement depuis une règle de récompense de performance.

Pour combler cette lacune, plusieurs solutions flexibles peuvent être mises en place afin d’automatiser et de notifier des systèmes externes sans perturber votre flux de travail d’affiliation.

Utilisation d’un champ de profil caché et du Webhook de changement de profil affilié (Recommandé et invisible pour les affiliés)

1. Mettre à jour un champ de profil caché via la récompense de performance :

   • Dans la section “Actions” de votre règle de récompense de performance, sélectionnez “Mettre à jour l’utilisateur” et choisissez un champ de profil à mettre à jour.
   • Définissez ce champ de profil comme Caché dans les paramètres du profil affilié afin qu’il ne soit pas visible pour les affiliés et utilisé uniquement pour l’automatisation interne.

2. Configurer le plugin Webhook de changement de profil affilié :

   • Installez et configurez le plugin Webhook de changement de profil affilié .
   • Paramétrez-le pour surveiller le champ de profil caché que vous mettez à jour.
   • Lorsqu’une modification intervient sur ce champ, le plugin envoie un webhook (HTTP POST) avec les détails de l’affilié vers votre endpoint API externe.

Cette approche garantit que seul votre système est notifié et que les affiliés ignorent l’existence ou la modification de ce champ.

Solution 1 : Utiliser l’action “Envoyer un e-mail à” et le plugin Emails Callback Webhook

1. Dupliquer la règle de récompense de performance :

   • Créez un duplicata de votre règle de récompense de performance originale, en conservant les mêmes conditions.
   • Dans l’action, choisissez “envoyer un e-mail à” et configurez-le pour envoyer un e-mail à l’annonceur.

2. Configurer le plugin Emails Callback Webhook :

   • Installez et configurez le plugin Emails Callback Webhook .
   • Ce plugin traite tous les e-mails sortants et les transmet en requêtes HTTP vers votre endpoint externe.

3. Détecter et traiter la notification :

   • Votre système externe peut filtrer les e-mails envoyés par votre règle de récompense de performance et déclencher les workflows correspondants.

Cette méthode est simple et exploite l’infrastructure d’e-mail pour les notifications.

Solution 2 : Utiliser une commission d’action à 0 $, General Callback URL et Application Callbacks

1. Dupliquer la règle de récompense de performance :

   • Dupliquez votre règle de récompense de performance comme ci-dessus, mais modifiez l’action pour “ajouter un bonus de commission d’action” et sélectionnez une commission d’action à 0 $ (voir Commissions d’action ).

2. General Callback URL (Tous comptes) :

   • Rendez-vous dans Configuration > Paramètres de tracking > Suivi des callbacks.
   • Configurez le General Callback URL pour recevoir des notifications pour chaque commission suivie (vente ou action).
   • Sur votre endpoint, écoutez et traitez uniquement les commissions d’action à 0 $ déclenchées par votre règle de récompense de performance.

3. Application Callbacks (Forfaits Ultimate/Network uniquement) :

   • Rendez-vous dans Configuration > Callbacks et utilisez l’option “Ajouter un callback de suivi de vente”.
   • Sélectionnez votre commission d’action à 0 $ dans “Type de commission”, puis indiquez l’URL de votre endpoint.
   • Cela garantit que seul le type de commission sélectionné déclenchera le callback.

4. Supprimer les notifications par e-mail affilié pour les commissions à 0 $ :

   • Par défaut, les affiliés verront ces commissions d’action à 0 $ dans leur panneau.
   • Pour éviter qu’ils ne reçoivent des notifications par e-mail, rendez-vous dans Configuration > Notifications par e-mail > Notifications affilié et cochez la case “Valeur par défaut pour l’affilié” à côté de “Désactiver les notifications de commissions nulles Sur vente / lead”.

Remarque : Le principal inconvénient de cette méthode est que les affiliés verront tout de même ces commissions à 0 $ dans leur tableau de bord (mais pas par e-mail si les notifications sont désactivées).

Bonnes pratiques pour l’automatisation et les notifications API dans Post Affiliate Pro

• Utilisez des champs dédiés ou cachés pour les déclencheurs d’automatisation afin d’éviter toute confusion ou modification accidentelle.
• Documentez clairement tous les workflows d’automatisation et quels champs ou plugins sont utilisés pour les notifications.
• Sécurisez vos endpoints de webhook et de callback pour qu’ils n’acceptent que des requêtes de confiance.
• Testez chaque solution en profondeur afin de garantir la bonne livraison des notifications.
• Passez régulièrement en revue les règles de récompense de performance, les paramètres des plugins et la configuration des campagnes afin d’assurer la fiabilité.

Que sont les récompenses de performance dans Post Affiliate Pro ?

Les récompenses de performance sont de puissantes règles qui attribuent automatiquement des bonus, mettent à jour les profils affiliés ou déclenchent des actions personnalisées lorsque les affiliés atteignent certains jalons, comme un nombre défini de ventes, de parrainages ou d’autres activités suivies. Les actions peuvent inclure l’attribution de bonus, le changement de groupe de commission, l’envoi de notifications ou la mise à jour (y compris cachée) des champs de profil.

Comment configurer et choisir la meilleure solution

• Pour des notifications invisibles et internes : Utilisez le champ de profil caché et le Webhook de changement de profil affilié.
• Pour un traitement basé sur les e-mails : Utilisez l’action “envoyer un e-mail à” avec le plugin Emails Callback Webhook.
• Pour des notifications basées sur les commissions : Utilisez une commission d’action à 0 $ avec General Callback URL ou Application Callbacks, en tenant compte de la visibilité dans le panneau affilié.

Guide pas à pas : Exemple champ de profil caché + Webhook

1. Rendez-vous dans Configuration > Récompenses de performance.
2. Modifiez ou créez une règle et sélectionnez “Mettre à jour l’utilisateur” dans les Actions.
3. Choisissez (ou créez) un champ de profil, définissez-le comme Caché.
4. Définissez la valeur qui doit déclencher votre workflow.
5. Installez et configurez le plugin Webhook de changement de profil affilié pour surveiller ce champ.
6. Saisissez votre endpoint API externe dans les paramètres du plugin.
7. Testez le workflow en remplissant les conditions de la récompense de performance et vérifiez que le webhook se déclenche.

Guide pas à pas : Exemple commission d’action à 0 $ + General Callback URL

1. Dupliquez votre règle de récompense de performance, définissez l’action sur “ajouter un bonus de commission d’action”, choisissez un type de commission à 0 $.
2. Configurez General Callback URL dans Configuration > Paramètres de tracking > Suivi des callbacks.
3. Sur votre endpoint, filtrez les callbacks entrants pour votre type de commission à 0 $ spécifique.
4. Désactivez éventuellement les notifications e-mail affilié pour les commissions nulles.
5. Testez en déclenchant la récompense et en confirmant le comportement du callback et du endpoint.

Résumé

Post Affiliate Pro ne propose pas de notifications API directes depuis les règles de récompense de performance, mais avec ces solutions éprouvées—champ de profil caché plus webhook, callback par e-mail ou commission d’action à 0 $ avec callback—vous pouvez automatiser de façon fiable les notifications et intégrations externes selon les besoins de gestion de votre programme d’affiliation.