Transmission des paramètres et postback
Une source relie la plateforme et Qubix dans les deux sens :
- Du lien vers Qubix — lorsqu'un visiteur clique sur une annonce, Qubix récupère depuis le lien les paramètres nécessaires (l'identifiant de l'annonce, le pixel, etc.) et les associe à la visite.
- De Qubix vers la plateforme — lorsqu'un événement se produit (inscription, dépôt), Qubix envoie un postback à la plateforme afin qu'elle connaisse le résultat.
Les réglages des deux sens se définissent dans la source — voir Créer une source.
Les paramètres dans le lien publicitaire
Quelles valeurs récupérer depuis le lien se définit dans le tableau Paramètres de la source. Pour chaque paramètre, vous indiquez :
- Clé URL — sous quelle clé la valeur arrive dans le lien ;
- Placeholder — ce que la plateforme substituera dans la valeur (sa propre macro ou une valeur fixe).
Exemple de lien pour une annonce Facebook :
https://your-domain/?pixel=123456789&ad_id={{ad.id}}
Ici {{ad.id}} est une macro Facebook : lors de l'affichage de l'annonce, la plateforme la remplace elle-même par l'identifiant réel. Le lien prêt à l'emploi pour votre source est assemblé par Qubix dans le bloc URL d'exemple pour une annonce du formulaire de la source — il peut être copié et collé dans le champ URL de l'annonce sur la plateforme.
Le paramètre ID de l'annonce est nécessaire pour relier les clics aux annonces et voir les statistiques par annonce. Sans lui, la source continuera de fonctionner, mais la ventilation par annonce sera indisponible.
À propos des paramètres du côté du lien de campagne — Lien de campagne et paramètres.
Postback S2S : notifier la plateforme
Un postback (server-to-server, S2S) est une requête que Qubix envoie à la plateforme lorsqu'un événement se produit. Le modèle de requête se définit dans le champ Postback S2S de la source. On insère des macros dans le modèle — Qubix y substituera les valeurs réelles avant l'envoi :
| Macro | Valeur |
|---|---|
{external_id} | L'identifiant de la visite/du lead côté plateforme. |
{status} | Le statut de l'événement (par exemple, inscription, dépôt, rejet). |
{revenue} | Le revenu de l'événement. |
{payout} | Le payout de l'événement. |
{currency} | La devise. |
{sub_id_N} | Marques supplémentaires (sub_id_1, sub_id_2, etc.). |
{tid} | L'identifiant de la transaction. |
Exemple de modèle de postback :
https://source.com/postback?subid={external_id}&status={status}&payout={revenue}
Facebook : Conversions API au lieu d'un postback
Pour une source basée sur le modèle facebook, le postback habituel n'est pas utilisé. À la place, Qubix envoie les événements directement à la Facebook Conversions API. Vous configurez uniquement le mapping des événements : quel événement Qubix correspond à quel événement Facebook (par exemple, dépôt → Purchase). L'identifiant du pixel est récupéré depuis le lien de clic, et le token d'accès — depuis le registre des pixels.
Plus — Facebook Conversions API et Pixels.