Configurer les postbacks du cycle de vie des actions
Il existe deux principaux types de postbacks du cycle de vie des actions. Niveau global crée des postbacks pour l’ensemble de votre compte et niveau événement crée des postbacks pour des types d’événements spécifiques. Sélectionnez celui qui correspond le mieux à vos besoins pour en savoir plus sur le processus de configuration.
Avertissement : Pour les postbacks de niveau global, vous devriez recevoir un postback chaque fois qu’un événement « non standard » se produit, par exemple une modification ou une annulation. Notez que les postbacks de niveau événement ne déclencheront pas les événements non standards du cycle de vie des actions.
Configurer un postback du cycle de vie des actions
Configurer un postback du cycle de vie des actions de niveau global
Cette section couvre la création de postbacks pour l’ensemble de votre compte en une seule fois. Les partenaires qui n’ont qu’un seul système capable de recevoir et de traiter ces postbacks, ou qui souhaitent des notifications pour tous les événements non standards, doivent configurer des postbacks du cycle de vie des actions de niveau global.
Remarque : Si vous souhaitez être plus sélectif quant aux types d’événements pour lesquels vous recevrez des postbacks, consultez la section ci-dessous pour configurer des postbacks du cycle de vie des actions de niveau événement.
Dans la barre de navigation supérieure, sélectionnez
[Profil utilisateur] → Paramètres.Sous Technique, sélectionnez Notifications d’événements.
À côté de Événements du cycle de vie des actions, sélectionnez
[Modifier].Saisissez l’URL de votre serveur. C’est l’URL vers laquelle impact.com enverra les postbacks.
Sélectionnez votre méthode HTTP préférée.
Consultez certains des paramètres du corps disponibles.
Si vous sélectionnez POST, vous saisirez alors le corps de la requête et sélectionnerez un Format du corps. Vous trouverez ci-dessous un exemple de la manière dont vous pouvez mapper chaque point de données au format JSON. Les clés de chaque paire clé-valeur doivent provenir de la configuration de votre propre système, et les valeurs seront le point de données correspondant de votre choix fourni par impact.com et devront être saisies entre crochets
{ }.
Vous ne voyez pas la valeur dont vous avez besoin ? Contactez votre gestionnaire de compte (ou contactez le support).
Sélectionnez Événements du cycle de vie des actions). Ces paramètres sont facultatifs.
Saisissez un en-tête HTTP. Si plusieurs paires sont nécessaires, séparez-les par un point-virgule.
Saisissez un Délai minimum entre le moment où un événement non standard se produit et celui où le postback est généré puis envoyé à votre système.
Saisissez une limite de débit pour le Nombre maximal de requêtes qu’impact.com peut envoyer à votre système par seconde.
Indiquez ce que vous souhaitez comme Réponse de succès à un postback.
Indiquez ce que vous souhaitez comme Réponse d’erreur à un postback.
Sélectionnez Enregistrer.
Maintenant que vos postbacks de niveau global sont configurés, votre système devrait commencer à recevoir des postbacks chaque fois que des événements non standards se produisent, quelle que soit la marque à l’origine des actions non standards. Pour apprendre à tester votre nouvelle configuration de postback, consultez le Tester un postback du cycle de vie des actions ci-dessous.
Exemple de valeurs dynamiques
Si vous avez configuré des variables dynamiques pour vos liens de suivi, vous pouvez configurer une URL de postback vers votre propre serveur afin d’être averti lorsque des actions se produisent et de récupérer la ou les valeurs renseignées dynamiquement associées à l’action.
Cet exemple montre comment transmettre une SharedId valeur (une valeur que vous souhaitez partager avec les marques) à un paramètre dans un postback (MyParam). Certaines marques peuvent exiger que vous configuriez cela.
Une URL de postback ressemblerait à ceci :
https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}
L’URL de postback renseignera le MyParam paramètre avec la valeur récupérée à partir de SharedId.
Configurer des postbacks du cycle de vie des actions de niveau événement
Cette section couvre la création de postbacks pour des types d’événements spécifiques qui suivent le moment où vous générez des actions. Si vous souhaitez être plus sélectif quant aux types d’événements pour lesquels vous recevez des postbacks, vous devez configurer des postbacks du cycle de vie des actions de niveau événement.
Remarque : Si vous avez configuré des postbacks du cycle de vie des actions de niveau global, vous n’avez pas besoin de configurer ceux de niveau événement.
Dans la barre de navigation supérieure, sélectionnez Découvrir → Mes marques.
Sélectionnez la carte de la marque propriétaire du postback que vous souhaitez tester.
Sous le nom de la marque, sélectionnez
[Plus] → Intégration du suivi.Près du coin supérieur droit de la page, sélectionnez Ajouter un postback.
Sélectionnez le type d’événement (anciennement action tracker) pour lequel vous souhaitez configurer des postbacks du cycle de vie des actions.
Saisissez l’URL de votre serveur. C’est l’URL vers laquelle impact.com enverra les postbacks.
Sélectionnez votre méthode HTTP préférée.
Si vous sélectionnez POST, vous saisirez alors le corps de la requête et sélectionnerez un Format du corps. Vous trouverez ci-dessous un exemple de la manière dont vous pouvez mapper chaque point de données au format JSON. Les clés de chaque paire clé-valeur doivent provenir de la configuration de votre propre système, et les valeurs seront le point de données correspondant de votre choix fourni par impact.com et devront être saisies entre crochets { }.
Consultez certains des paramètres du corps disponibles.
Vous ne voyez pas la valeur dont vous avez besoin ? Contactez votre gestionnaire de compte (ou contactez le support).
Sélectionnez Afficher les paramètres avancés). Ces paramètres sont facultatifs.
Saisissez un Délai minimum entre le moment où un événement non standard se produit et celui où le postback est généré puis envoyé à votre système.
Saisissez une limite de débit pour le Nombre maximal de requêtes qu’impact.com peut envoyer à votre système par seconde.
Indiquez ce que vous souhaitez comme Réponse de succès à un postback.
Indiquez ce que vous souhaitez comme Réponse d’erreur à un postback.
Sélectionnez Enregistrer.
Maintenant que vos postbacks de niveau événement sont configurés, votre système devrait commencer à recevoir des postbacks pour le type d’événement que vous avez sélectionné à l’étape 5. Pour apprendre à tester votre nouvelle configuration de postback, consultez le Tester un postback du cycle de vie des actions ci-dessous.
Exemple de valeurs dynamiques
Si vous avez configuré des variables dynamiques pour vos liens de suivi, vous pouvez configurer une URL de postback vers votre propre serveur afin d’être averti lorsque des actions se produisent et de récupérer la ou les valeurs renseignées dynamiquement associées à l’action.
Cet exemple montre comment transmettre une SharedId valeur (une valeur que vous souhaitez partager avec les marques) à un paramètre dans un postback (MyParam). Certaines marques peuvent exiger que vous configuriez cela.
Une URL de postback ressemblerait à ceci :
https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}
L’URL de postback renseignera le MyParam paramètre avec la valeur récupérée à partir de SharedId.
Tester un postback du cycle de vie des actions
Une fois que vous avez configuré un postback du cycle de vie des actions, quel que soit le niveau auquel il s’applique, vous devriez le tester. Vous pouvez soit exécuter un postback de test dans impact.com (disponible uniquement pour les postbacks de niveau événement), soit effectuer une conversion.
Si un postback échoue lorsque impact.com publie sur votre URL de destination, impact.com réessaie automatiquement la livraison. impact.com réessaie un postback ayant échoué jusqu’à 15 fois au total. impact.com ignore les 3 premières nouvelles tentatives pour les réponses HTTP de 400 pour 500. Pour connaître le calendrier complet des nouvelles tentatives et les détails de dépannage, consultez Tester et dépanner une URL de postback.
Exécuter un postback de test dans impact.com
Si vous avez configuré un postback de niveau événement, vous pouvez alors le tester dans votre compte impact.com.
Dans la barre de navigation supérieure, sélectionnez Découvrir → Mes marques.
Sélectionnez la carte de la marque propriétaire du postback que vous souhaitez tester.
Sous le nom de la marque, sélectionnez
Plus → Intégration du suivi.À partir du Postback section, sélectionnez
[Flèche vers le bas] Actions, puis sélectionnez Lancer le test.Confirmez que l’URL du postback est correcte, puis sélectionnez Démarrer le test.
Créer une conversion de test
Ce test ne sera pas effectué dans l’application web impact.com. À la place, vous réaliserez un test de bout en bout suivant un parcours utilisateur typique. Assurez-vous d’informer la marque partenaire que vous effectuerez le test.
Dans la barre de navigation supérieure, sélectionnez Contenu → Ressources.
Sélectionnez une annonce.
Sous le nom de l’annonce, sélectionnez Obtenir le lien de suivi.
Sélectionnez
[Activer] Paramètres de suivi.Entrée Sub IDs ou un ID partagé selon les besoins. Chaque champ nécessite au moins une valeur.
Passez cette étape si vous avez déjà des valeurs dans ces champs.
En option, sélectionnez une propriété dans la liste déroulante.
Sélectionnez Enregistrer.
Sélectionnez Copier le lien de suivi.
Collez le lien dans une nouvelle fenêtre de navigateur.
Effectuez l’action.
Après environ 15 minutes, vérifiez dans votre système le postback généré par cette action de test.
15 minutes correspond généralement au temps nécessaire au traitement d’une action.
Vous pourrez également voir cette nouvelle action en attente sur l’ Actions en attente écran. Si vous voyez l’action sur l’ Actions en attente écran, mais que vous n’avez pas encore reçu de postback, vérifiez à nouveau votre configuration de postback.
Demandez à votre marque d’annuler l’action.
Vérifiez dans votre système le postback généré par cette annulation.
Si vous voyez l’action annulée sur l’ Actions annulées écran, mais que vous n’avez pas reçu de postback, vérifiez à nouveau votre configuration de postback.
Résoudre les erreurs
Paramètre obligatoire manquant
Votre serveur attend probablement une valeur au lieu d’une variable. Modifiez l’URL de postback pour transmettre une valeur de test (par exemple, « 12345678 » au lieu de {SubId1}) et voyez s’il accepte la valeur codée en dur.
Variables sensibles à la casse
Les variables dynamiques sont sensibles à la casse et doivent être exactes, ce qui signifie que {SubId1} n’est pas la même chose que {subid1}. Vérifiez bien que vos variables respectent la casse correcte.
Accès refusé
La plupart des serveurs de postback disposent d’un jeton ou d’une valeur de sécurité qui doit être transmis avec les variables dynamiques. Travaillez avec l’équipe technique de votre site web (ou consultez la documentation de votre fournisseur de site web) pour connaître le jeton ou la valeur de sécurité nécessaire pour accéder au serveur.
Remarque : Si vous ne trouvez aucun problème dans votre configuration de postback mais que vous ne les recevez toujours pas, contactez le support. impact.com peut vérifier si des postbacks sont générés, quel est le code de réponse pour chacun et le corps de chaque postback. Ces informations peuvent vous aider à déboguer votre configuration.
Mis à jour
Ce contenu vous a-t-il été utile ?