Configurer les postbacks du cycle de vie des actions

Il existe deux principaux types de postbacks du cycle de vie des actions. Au niveau global crée des postbacks pour l'ensemble de votre compte et au niveau de l'é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.

circle-exclamation

Configurer un postback du cycle de vie des actions

chevron-rightConfigurer un postback du cycle de vie des actions au niveau globalhashtag

Cette section couvrira 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 d'exploiter ces postbacks ou qui souhaitent des notifications pour tous les événements non standard devraient configurer des postbacks du cycle de vie des actions au niveau global.

circle-info

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 au niveau de l'événement.

  1. Dans la barre de navigation supérieure, sélectionnez [Profil utilisateur] → Paramètres.

  2. Sous Technique, sélectionnez Notifications d'événements.

  3. À côté de Événements du cycle de vie des actions, sélectionnez [Modifier].

  4. Saisissez l'URL de votre serveur. Il s'agit de l'URL vers laquelle impact.com enverra les postbacks.

  5. Sélectionnez votre méthode HTTP préférée.

    • Si vous sélectionnez POST, vous saisirez ensuite le corps de la requête et sélectionnerez un Format du corps. Ci-dessous un exemple de la façon dont vous pourriez mapper chaque point de données pour un 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 fourni par impact.com et doivent être saisies entre crochets { }.

    • Vous ne voyez pas la valeur dont vous avez besoin ? Contactez votre Responsable de compte (ou contacter le supportarrow-up-right).

  6. 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 minimal entre le moment où un événement non standard se produit et le moment où le postback est généré et envoyé à votre système.

    • Saisissez une limite de débit pour le nombre maximal de requêtes qu'impact.com peut effectuer vers votre système par seconde.

    • Saisissez ce que vous voulez que la réponse de succès à un postback soit.

    • Saisissez ce que vous voulez que la Réponse d'erreur à un postback soit.

  7. Sélectionnez Enregistrer.

Maintenant que vous avez configuré des postbacks au niveau global, votre système devrait commencer à recevoir des postbacks chaque fois que des événements non standard se produisent, quel que soit la marque effectuant les actions non standard. Pour savoir comment tester votre nouvelle configuration de postback, consultez la section 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 pour vous notifier lorsque des actions se produisent et récupérer la ou les valeurs dynamiquement renseignées associées à l'action.

Cet exemple montre comment transmettre un 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 ceci.

Une URL de postback ressemblerait à quelque chose comme :

https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}

L'URL de postback remplira le MyParam paramètre avec la valeur récupérée depuis SharedId.

chevron-rightConfigurer des postbacks du cycle de vie des actions au niveau de l'événementhashtag

Cette section expliquera la création de postbacks pour des types d'événements spécifiques qui suivent quand 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 devriez configurer des postbacks du cycle de vie des actions au niveau de l'événement.

circle-info

Remarque : Si vous avez configuré des postbacks du cycle de vie des actions au niveau global, vous n'avez pas besoin de configurer ceux au niveau de l'événement.

  1. Dans la barre de navigation supérieure, sélectionnez Discover → Mes Marques.

  2. Sélectionnez la carte de la marque propriétaire du postback que vous souhaitez tester.

  3. Sous le nom de la marque, sélectionnez [Plus]Intégration de suivi.

  4. Près du coin supérieur droit de la page, sélectionnez Ajouter un postback.

  5. Sélectionnez le type d'événement (anciennement suivi d'action) pour lequel vous souhaitez configurer des postbacks du cycle de vie des actions.

  6. Saisissez l'URL de votre serveur. Il s'agit de l'URL vers laquelle impact.com enverra les postbacks.

  7. Sélectionnez votre méthode HTTP préférée.

    • Si vous sélectionnez POST, vous saisirez ensuite le corps de la requête et sélectionnerez un Format du corps. Ci-dessous un exemple de la façon dont vous pourriez mapper chaque point de données pour un 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 que impact.com fournit et doivent être saisies entre crochets { }.

    • Voir certains des paramètres d'impact.com paramètres du corps disponiblesarrow-up-right.

    • Vous ne voyez pas la valeur dont vous avez besoin ? Contactez votre Responsable de compte (ou contacter le supportarrow-up-right).

  8. Sélectionnez Afficher les paramètres avancés). Ces paramètres sont facultatifs.

    • Saisissez un délai minimal entre le moment où un événement non standard se produit et le moment où le postback est généré et envoyé à votre système.

    • Saisissez une limite de débit pour le nombre maximal de requêtes qu'impact.com peut effectuer vers votre système par seconde.

    • Saisissez ce que vous voulez que la réponse de succès à un postback soit.

    • Saisissez ce que vous voulez que la Réponse d'erreur à un postback soit.

  9. Sélectionnez Enregistrer.

Maintenant que vous avez configuré des postbacks au niveau de l'événement, votre système devrait commencer à recevoir des postbacks pour le type d'événement que vous avez sélectionné dans Étape 5. Pour savoir comment tester votre nouvelle configuration de postback, consultez la section 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 pour vous notifier lorsque des actions se produisent et récupérer la ou les valeurs dynamiquement renseignées associées à l'action.

Cet exemple montre comment transmettre un 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 ceci.

Une URL de postback ressemblerait à quelque chose comme :

https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}

L'URL de postback remplira le MyParam paramètre avec la valeur récupérée depuis SharedId.

section 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 devez le tester. Vous pouvez soit exécuter un postback de test dans impact.com (disponible uniquement pour les postbacks au niveau de l'événement), soit effectuer une conversion.

chevron-rightExécuter un postback de test dans impact.comhashtag

Si vous avez configuré un postback au niveau de l'événement, vous pouvez alors le tester au sein de votre compte impact.com.

  1. Dans la barre de navigation supérieure, sélectionnez Discover → Mes Marques.

  2. Sélectionnez la carte de la marque propriétaire du postback que vous souhaitez tester.

  3. Sous le nom de la marque, sélectionnez PlusIntégration de suivi.

  4. À partir du Postback section, sélectionnez [Flèche vers le bas] Actions, puis sélectionnez Lancer le test.

  5. Confirmez que l'URL du postback est correcte, puis sélectionnez Démarrer le test.

chevron-rightCréer une conversion de testhashtag

Ce test ne sera pas effectué dans l'application web impact.com. À la place, vous effectuerez un test de bout en bout qui suit un parcours utilisateur typique. Assurez-vous d'informer votre marque partenaire que vous réaliserez le test.

  1. Dans la barre de navigation supérieure, sélectionnez Contenu → Ressources.

  2. Sélectionnez une annonce.

  3. Sous le nom de l'annonce, sélectionnez Obtenir le lien de suivi.

  4. Sélectionnez [Basculer Activé] Paramètres de suivi.

  5. Entrée Sous-IDs ou un ID partagé selon les besoins. Chaque champ nécessite au moins une entrée.

    • Ignorez cette étape si vous avez déjà des valeurs dans ces champs.

  6. Optionnellement, sélectionnez une Propriété dans la liste déroulante.

  7. Sélectionnez Enregistrer.

  8. Sélectionnez Copier le lien de suivi.

  9. Collez le lien dans une nouvelle fenêtre de navigateur.

  10. Complétez l'action.

  11. Après environ 15 minutes, vérifiez votre système pour le postback généré par cette action de test.

    • 15 minutes est généralement le temps de traitement des actions.

    • Vous pourrez également voir cette nouvelle action en attente sur l'écran Actions en attentearrow-up-right . Si vous voyez l'action sur l'écran Actions en attente mais n'avez pas encore reçu de postback, vérifiez à nouveau votre configuration de postback.

  12. Demandez à votre marque d'annuler l'action.

  13. Vérifiez votre système pour le postback généré par cette annulation.

    • Si vous voyez l'action annulée sur l'écran Actions annuléesarrow-up-right , mais que vous n'avez pas reçu de postback, vérifiez à nouveau votre configuration de postback.

chevron-rightRésoudre les erreurshashtag
Erreur
Description

Paramètre obligatoire manquant

Votre serveur attend probablement une valeur au lieu d'une variable. Modifiez votre URL de postback pour transmettre une valeur de test (par ex., "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 que vos variables respectent la sensibilité à la casse correcte.

Accès refusé

La plupart des serveurs de postback ont un jeton ou une valeur de sécurité qui doit être transmis avec les variables dynamiques. Travaillez avec l'équipe technique de votre site Web (ou reportez-vous à la documentation de votre fournisseur de site) pour connaître le jeton ou la valeur de sécurité nécessaire pour accéder au serveur.

circle-info

Remarque : Si vous ne trouvez aucun problème dans votre configuration de postback mais que vous ne les recevez toujours pas, contacter le supportarrow-up-right. impact.com peut vérifier si des postbacks sont générés, quel est leur code de réponse, ainsi que le corps de chaque postback. Ces informations pourraient vous aider à déboguer correctement votre configuration

Mis à jour

Ce contenu vous a-t-il été utile ?