Come notificare un'API esterna quando viene attivata una Ricompensa Prestazionale in Post Affiliate Pro

Definizione del problema

I responsabili dei programmi di affiliazione spesso hanno bisogno che Post Affiliate Pro notifichi automaticamente sistemi esterni—come API, CRM o applicazioni personalizzate—quando vengono attivate specifiche regole di Ricompensa Prestazionale (ad esempio, quando un affiliato recluta un certo numero di sub-affiliati o raggiunge un traguardo di vendite). Tuttavia, Post Affiliate Pro non offre una funzione integrata per chiamare direttamente un’API esterna da una regola di Ricompensa Prestazionale.

Per colmare questa lacuna, è possibile implementare diverse soluzioni flessibili che permettono di creare automazioni e notifiche esterne con un impatto minimo sul flusso di lavoro degli affiliati.

Utilizzo di un campo profilo nascosto e dell’Affiliate Profile Change Webhook (Consigliato e Invisibile agli Affiliati)

1. Aggiorna un campo profilo nascosto tramite la Ricompensa Prestazionale:

   • Nella sezione “Azioni” della tua regola di Ricompensa Prestazionale, seleziona “Aggiorna utente” e scegli un campo profilo da aggiornare.
   • Imposta questo campo profilo come Nascosto nelle impostazioni del profilo affiliato, così non sarà visibile agli affiliati e verrà usato solo per automazioni interne.

2. Configura il plugin Affiliate Profile Change Webhook:

   • Installa e configura il plugin Affiliate Profile Change Webhook .
   • Impostalo per monitorare il campo profilo nascosto che aggiorni.
   • Quando il campo cambia, il plugin invia un webhook (HTTP POST) con i dettagli dell’affiliato al tuo endpoint API esterno.

Questo approccio assicura che solo il tuo sistema venga notificato e gli affiliati non siano a conoscenza dell’esistenza o delle modifiche di questo campo.

Soluzione 1: Utilizzo dell’azione “Invia email a” e del plugin Emails Callback Webhook

1. Duplica la regola di Ricompensa Prestazionale:

   • Crea un duplicato della tua regola originale di Ricompensa Prestazionale, mantenendo le stesse condizioni.
   • Nell’azione, scegli “invia email a” e configurala per inviare un’email al merchant.

2. Configura il plugin Emails Callback Webhook:

   • Installa e configura il plugin Emails Callback Webhook .
   • Questo plugin elabora tutte le email in uscita e le inoltra come richieste HTTP al tuo endpoint esterno.

3. Rileva e processa la notifica:

   • Il tuo sistema esterno può filtrare le email specifiche inviate dalla tua regola di Ricompensa Prestazionale e attivare i relativi workflow.

Questo metodo è semplice e sfrutta l’infrastruttura email per le notifiche.

Soluzione 2: Utilizzo di una commissione azione da 0€, General Callback URL e Application Callbacks

1. Duplica la regola di Ricompensa Prestazionale:

   • Duplica la tua regola di Ricompensa Prestazionale come sopra, ma cambia l’azione in “aggiungi bonus di commissione azione” e seleziona una commissione azione da 0€ (vedi Azioni Commissioni ).

2. General Callback URL (Tutti gli account):

   • Vai su Configurazione > Impostazioni di tracciamento > Callback tracking.
   • Configura il General Callback URL per ricevere notifiche per ogni commissione tracciata (vendita o azione).
   • Nel tuo endpoint, ascolta e processa solo le specifiche commissioni azione da 0€ attivate dalla tua regola di Ricompensa Prestazionale.

3. Application Callbacks (Solo piani Ultimate/Network):

   • Vai su Configurazione > Callbacks e usa l’opzione “Aggiungi callback tracking vendita”.
   • Seleziona la tua commissione azione da 0€ sotto “Tipo Commissione” e specifica l’URL del tuo endpoint.
   • In questo modo solo il tipo di commissione selezionato attiverà il callback.

4. Sopprimi le notifiche email agli affiliati per le commissioni da 0€:

   • Di default, gli affiliati vedranno queste commissioni azione da 0€ nel loro pannello.
   • Per evitare che ricevano notifiche email, vai su Configurazione > Notifiche email > Notifiche affiliato e seleziona la casella “Valore predefinito per affiliato” accanto a “Disabilita notifiche per commissioni a zero Su vendita / lead”.

Nota: Lo svantaggio principale di questo approccio è che gli affiliati vedranno comunque queste commissioni da 0€ nelle loro dashboard (anche se non riceveranno email se le notifiche sono disabilitate).

Best practice per automazione e notifiche API in Post Affiliate Pro

• Usa campi dedicati o nascosti per i trigger di automazione per evitare confusione o modifiche accidentali.
• Documenta chiaramente tutti i flussi di lavoro di automazione e quali campi o plugin sono utilizzati per le notifiche.
• Proteggi i tuoi endpoint webhook e callback per accettare solo richieste affidabili.
• Testa ogni soluzione approfonditamente per assicurarti che le notifiche vengano recapitate come previsto.
• Rivedi regolarmente regole di Ricompensa Prestazionale, impostazioni dei plugin e configurazioni delle campagne per garantirne l’affidabilità.

Cosa sono le Ricompense Prestazionali in Post Affiliate Pro?

Le Ricompense Prestazionali sono potenti regole che consentono di assegnare automaticamente bonus, aggiornare profili affiliati o attivare azioni personalizzate quando gli affiliati raggiungono obiettivi specifici, come un certo numero di vendite, referral o altre attività tracciate. Le azioni possono includere l’assegnazione di bonus, il cambio di gruppo commissionale, l’invio di notifiche o l’aggiornamento (anche di campi nascosti) del profilo.

Come configurare e scegliere la soluzione migliore

• Per notifiche interne e invisibili: Usa il campo profilo nascosto e l’Affiliate Profile Change Webhook.
• Per elaborazione basata su email: Usa l’azione “invia email a” con il plugin Emails Callback Webhook.
• Per notifiche basate su commissioni: Usa una commissione azione da 0€ con General Callback URL o Application Callbacks, tenendo conto della visibilità nel pannello affiliato.

Guida passo passo: Esempio di campo profilo nascosto + webhook

1. Vai su Configurazione > Ricompense Prestazionali.
2. Modifica o crea una regola e seleziona “Aggiorna utente” nelle Azioni.
3. Scegli (o crea) un campo profilo e impostalo come Nascosto.
4. Imposta il valore che vuoi attivi il tuo workflow.
5. Installa e configura il plugin Affiliate Profile Change Webhook per monitorare quel campo.
6. Inserisci il tuo endpoint API esterno nelle impostazioni del plugin.
7. Testa il workflow soddisfacendo le condizioni della Ricompensa Prestazionale e verifica che il webhook venga inviato.

Guida passo passo: Esempio di commissione azione da 0€ + General Callback URL

1. Duplica la tua regola di Ricompensa Prestazionale, imposta l’azione su “aggiungi bonus di commissione azione”, scegli un tipo di commissione da 0€.
2. Configura il General Callback URL in Configurazione > Impostazioni di tracciamento > Callback tracking.
3. Nel tuo endpoint, filtra i callback in arrivo per il tuo specifico tipo di commissione da 0€.
4. Facoltativamente, disabilita le email di notifica agli affiliati per le commissioni zero.
5. Testa attivando la ricompensa e conferma il comportamento del callback e dell’endpoint.

Riepilogo

Post Affiliate Pro non offre notifiche API dirette dalle regole di Ricompensa Prestazionale, ma con queste soluzioni comprovate—campo profilo nascosto più webhook, callback email o commissione azione da 0€ con callback—puoi automatizzare in modo affidabile notifiche esterne e integrazioni su misura per le tue esigenze di gestione affiliati.