Guide des terminaisons de dépassement de quotas

Introduction

Ce guide est conçu pour nos partenaires du flux Cint Exchange (anciennement API Supply) afin de vous aider à comprendre ce que sont les terminaisons de dépassement de quotas (OQ) et comment les réduire dans le Cint Exchange (anciennement connu sous le nom de Lucid Marketplace).

Qu’est-ce qu’une résiliation par dépassement de quota ?

Une résiliation par dépassement de quota survient lorsqu’un répondant est disqualifié d’une enquête parce que des quotas ont déjà été remplis. Il existe trois types de conditions de dépassement de quota :

Enquête close : ce type d’OQ survient lorsqu’un répondant tente de compléter une enquête dont le statut n’est pas « en ligne ». Le code de réponse du Marketplace qui reflète ce type de résiliation est 42.
Quota d’enquête/quota de fournisseurs : Ce type d’OQ survient lorsqu’un répondant tente une enquête pour laquelle un quota spécifique ou total a été atteint. Les codes de réponse du marché qui reflètent ces types de licenciements sont 40 (quota d’enquête) et 41 (quota fournisseur).

Réduction des durées fermées des enquêtes

Il existe trois façons de déterminer si une enquête n’est plus active. Si l’une des conditions OQ suivantes est remplie, mettez en pause le trafic des répondants vers l’enquête :

'message_reason ' Propriété renvoie « désactivé » pour la valeur : Si vous utilisez un abonnement Opportunités pour obtenir des données d’enquête, vous pouvez utiliser la message_reason propriété pour déterminer quand une enquête est désactivée pour votre abonnement. Si vous recevez un message webhook indiquant la valeur « désactivé » pour la message_reason propriété, vous devez marquer l’arpentage comme n’étant plus présent dans votre système.
Redirection InitialStatus du répondant La propriété montre une valeur de 42 : Le InitialStatus est utilisé pour passer le code de réponse Cint Exchange (Marketplace) pour la session d’un répondant. Toute redirection montrant une valeur de 42 pour ce paramètre indique que l’enquête a été fermée lorsque le répondant a tenté d’entrer l’enquête. Si une enquête n’est pas déjà marquée comme non existante dans votre système au moment de la réception, vous devez marquer l’enquête comme n’étant plus présente dans votre système.
« Afficher les quotas » SurveyIsStillLive La propriété montre « faux » pour la valeur : Si la réponse à la demande de montre le quota retourne « faux » comme valeur pour la propriété «SurveyIsStillLive », vous devez marquer l’arpentage comme n’étant plus présent dans votre système.

Réduction des conditions de quota d’enquête / quotas de fournisseurs

Assurez-vous de rafraîchir les données de quotas suffisamment régulièrement : La façon la plus rapide d’obtenir des mises à jour de quotas est de s’inscrire à recevoir les données via votre abonnement d’opportunités, où vous recevrez des mises à jour pour compléter les informations. Si vous utilisez encore des quotas de présentation, vous devriez appeler ce point de terminaison pour toutes les enquêtes actives aussi près que possible de la fréquence recommandée. Pour nos plus grands marchés, nous recommandons une fréquence toutes les 3 minutes pour l’appel « montrer les quotas ». Pour les marchés plus petits, vous pouvez peut-être faire l’appel moins fréquemment, mais pour « préserver » votre intégration autant que possible, nous recommandons de vous en tenir à une fois toutes les 3 minutes.
Assurez-vous de bien gérer le rythme des participants d’une enquête : Un taux de dépassement de quota élevé peut survenir si une enquête est exposée à un nombre excessif de répondants. Une bonne règle générale pour le nombre de répondants à autoriser à un sondage à un moment donné est de ne pas dépasser le nombre atteint avec cette formule : Quota remaining / Conversion rate
Utilisez les statuts de redirection des répondants comme une « API push » : Commencez à collecter le paramètre «TermedQuotaId » sur tous les redirections de dépassement de quota et utilisez les valeurs retournées par ce paramètre pour fixer le quota identifié à zéro jusqu’à la prochaine fois que vous rafraîchissez les données de quotas depuis nos points de terminaison API.

L’utilisation du flux de travail suivant aidera à éviter ces termes. Les noms des propriétés indiqués ci-dessous sont basés sur les conventions de nommage des opportunités de flux. La même logique s’applique aux fournisseurs utilisant des quotas de spectacle, mais ceux-ci seront au format CamelCase sur la réponse API.

Dépannage OQ et logique

Voici quelques recommandations générales pour dépanner les dépassements de quotas :

Assurez-vous d’avoir la logique appropriée : Vous voudrez une logique qui empêche les répondants de tenter un sondage si l’une des conditions suivantes est vraie :

Pour les fournisseurs utilisant les opportunités de flux pour gérer les données de quotas

L’enquête est-elle toujours en ligne ?
- Est-ce que le message_reason téléphone est désactivé ?
- La valeur de redirection InitialStatus du répondant est-elle 42 ?
La number_of_respondents propriété est-elle supérieure à zéro pour la survey_quota_id valeur survey_quota_type totale ? (Essentiellement, si ce quota total est conclu, tout répondant entraînera un dépassement, peu importe les autres quotas encore ouverts.
La number_of_respondents propriété est-elle supérieure à zéro pour tout survey_quota_ids ce à quoi un défendeur relève ? Un répondant peut être soumis à plus d’un quota. Par exemple, il peut y avoir des quotas pour le genre et l’âge, auquel cas un répondant peut être inclus dans deux quotas, qui doivent toutes deux être ouvertes pour que le défendeur puisse passer.

Pour les fournisseurs utilisant le point de terminaison de montrer les quotas afin de gérer les données de quotas

L’enquête est-elle toujours en ligne ?
La SurveyStillLive propriété est-elle fausse ?
- La valeur de redirection InitialStatus du répondant est-elle 42 ?
- La NumberOfRespondents propriété est-elle supérieure à zéro pour la SurveyQuotaId valeur SurveyQuotaType totale ? (Essentiellement, si ce quota total est conclu, tout répondant entraînera un dépassement, peu importe les autres quotas encore ouverts.
La NumberOfRespondents propriété est-elle supérieure à zéro pour tout SurveyQuotaIds ce à quoi un défendeur relève ? Un répondant peut être soumis à plus d’un quota. Par exemple, il peut y avoir des quotas pour le genre et l’âge, auquel cas un répondant peut être inclus dans deux quotas, qui doivent toutes deux être ouvertes pour que le défendeur puisse passer.
Voir le message Opportunités de fil raison de consulter des informations supplémentaires sur la propriété message_reason

Recommandations supplémentaires

Correspondez au plus grand nombre possible de questions standard : Vous ne pouvez pas déterminer si un répondant obtiendra un dépassement de quota si vous ne pouvez pas faire correspondre les conditions du quota aux réponses du profileur du répondant. Le correspondance aux questions standards sert non seulement à réduire les « conditions de qualification standard », mais a aussi pour effet additionnel de diminuer les conditions de dépassement du quota.

Nous exigeons que les partenaires fournisseurs soient profilés sur toutes les qualifications critiques pour chaque marché où vous avez des utilisateurs. Pour maximiser les opportunités d’enquête, nous recommandons vivement d’intégrer les qualifications primaires lors des phases initiales de développement.

Vous pouvez télécharger le fichier de niveau de qualification des fournisseurs ici.