Guide d’intégration des échanges privés

Cet article fournit des instructions pour fournir des opportunités d’enquête Private Exchange (anciennement Private Marketplace) via un Cint Exchange Matching (anciennement Marketplace Supply Link) et/ou une intégration API.

Exigences pour les partenaires intégrés de correspondance

Les partenaires fournisseurs qui souhaitent cibler uniquement les opportunités d’échanges privés et les acheteurs sélectionnés devront ajouter certains paramètres supplémentaires à leurs liens d’entrée de correspondance, dans le format décrit ci-dessous.  Si ces paramètres ne sont pas inclus dans le lien d’entrée, les opportunités d’échange privé et ouvert seront activées pour la session du répondant.

Veuillez noter :

• Les fournisseurs utilisant le paramètre de rev pour fixer un chiffre d’affaires minimum par entretien devraient examiner cette configuration lors de l’activation des enquêtes Private Exchange, afin de s’assurer qu’elle correspond aux valeurs des cartes de taux convenues avec les acheteurs.

• La valeur du RPI (Revenu par entretien) retournée lors de la redirection pour un échange privé complète reflétera la valeur nette de l’enquête basée sur votre carte de taux convenue avec l’acheteur.

• Les nouveaux paramètres, px_only et px_buyer_ids, seront prêts pour la production en juin 2025. Votre équipe de compte vous informera dès qu’ils seront en ligne.

Exigences pour les partenaires intégrés API

Si votre intégration collecte des données d’enquêtes provenant de Feed (anciennement OTS) Opportunities, veuillez consulter la section « Identifier la demande d’échange privé pour des partenaires intégrés aux opportunités de flux ».  Si votre intégration ne collecte pas de données d’enquête issues de Feed Opportunities, mais que vous utilisez l’un de nos critères de référence (par exemple, List Marketplace Surveys, List Filtered Marketplace Surveys), veuillez vous rendre à la section « Identifier la demande d’échange privé pour des partenaires Intégré aux API Survey (offerwall).

Identifier la demande d’échange privé pour des partenaires intégrés aux opportunités d’alimentation

Les fournisseurs utilisant des opportunités d’alimentation peuvent identifier les acheteurs de Private Exchange via le nouveau bien « buyer_id ».  Alors que le bien « account_name » restera dans le modèle Opportunités, le « buyer_id » deviendra la méthode privilégiée pour l’identification des acheteurs dans tous les aspects de la Cint Exchange.  Par conséquent, toute logique que vous avez en place pour identifier les acheteurs devrait être basée sur buyer_id.  Votre équipe de comptes vous fournira le identifiants d’acheteurs d’échange privé pertinents.

De plus, nous allons ajouter la propriété « px_buyer_message » au modèle Opportunités. Ce champ permettra aux acheteurs de Private Exchange de communiquer des instructions spécifiques concernant le projet à un fournisseur. Auparavant, cela était appelé balise de métadonnées dans l’intégration de Cobra.  

Veuillez noter : 

• Le bien « revenue_per_interview » restituera la valeur nette de l’étude basée sur votre carte de taux convenue avec l’acheteur.

• Vous n’êtes pas obligé de recréer votre abonnement pour voir ces nouvelles propriétés de données

• La propriété « px_buyer_message » sera ajoutée à Feed Opportunities en juin 25.

Propriétés en Feed Opportunités pour soutenir la livraison d’échanges privés

Exemples de réponse du modèle d’opportunités

{
      "survey_id": 12345678,
      "survey_name": "My Great Survey",
      "account_name": "Sample_Account",
      "buyer_id": 12345,
      "country_language": "eng_us",
      "industry": "other",
      "study_type": "adhoc",
      "bid_length_of_interview": 5,
      "bid_incidence": 50,
      "collects_pii": false,
      "survey_group_ids": [1258951],
      "is_live": true,
      "survey_quota_calc_type": "completes",
      "is_only_supplier_in_group": true,
      "revenue_per_interview": {
        "value": 1.35,
        "currency_code": "USD"
      },
      "total_client_entrants": 480,
      "total_remaining": 46,
      "completion_percentage": 0.15824915,
      "conversion": 0.39166668,
      "overall_completes": 188,
      "mobile_conversion": 0.28,
      "revenue_per_click": 0.35,
      "length_of_interview": 3,
      "termination_length_of_interview": 2,
      "relationship_type": "private",
      "respondent_pids": [],
      "message_reason": "new",
      "px_buyer_message": [
        "some-example-text",
        "another-tag"
      ],

Identifier la demande d’échanges privés pour des partenaires intégrés aux API Survey (offerwall)

Les fournisseurs utilisant les endpoints Survey (offerwall) peuvent identifier les acheteurs de Private Exchange via le bien « AccountName ». Votre équipe de compte fournira les noms des acheteurs de la Plateforme Privée.  Veuillez noter : le bien « RPI » restituera la valeur nette de l’étude basée sur votre tarif convenu avec l’acheteur.

Si vous collectez l’étiquette de métadonnées via votre intégration Cobra et que vous avez besoin de ces informations dans le Cint Exchange, vous devrez vous intégrer à notre produit Opportunités de Flux afin de collecter ces informations via la nouvelle propriété de données « px_buyer_message ». Ce champ permettra aux acheteurs de Private Exchange de communiquer des instructions spécifiques concernant le projet à un fournisseur.  S’il n’y a pas d’accord pour collecter les données px_buyer_message, vous pouvez gérer l’inventaire de Private Exchange via votre intégration existante de Cint Exchange en utilisant la propriété AccountName, comme indiqué ci-dessus. Une intégration avec les opportunités de flux n’est pas nécessaire à ce stade.

Intégration avec les opportunités d’alimentation (si nécessaire)

Pour éviter les retards, nous recommandons au minimum d’utiliser les opportunités de flux pour remplacer le terminau de l’enquête (offerwall). Cela vous permettra de collecter des informations sur les nouvelles enquêtes, y compris la demande des échanges privés. Opportunités inclut toutes les données disponibles dans les critères d’évaluation de l’enquête, ainsi que plus encore.  

Plus d’informations : Pour plus de détails sur l’identification des stocks de Private Exchange via les nouvelles propriétés de données dans Feed Opportunities, consultez la section « Identifier la demande d’échange privé pour des partenaires intégrés aux opportunités de flux

Veuillez contacter votre consultant en intégration si vous avez d’autres questions concernant l’intégration avec Feed Opportunities, alternativement, veuillez consulter notre matériel en ligne :

• Documentation des opportunités de flux

• Opportunités du fil d’échange Cint et FAQ sur les résultats des répondants

Exemples de réponse au modèle d’enquêtes

"Surveys": [
    {
      "SurveyName": "Asthma Sufferers",
      "SurveyNumber": 457751,
      "SurveySID": "26CB55E2-74CC-4E19-88E3-7F2F8D4DE74D",
      "AccountName": "Sample Company",
      "CountryLanguageID": 11,
      "LengthOfInterview": 12,
      "BidIncidence": 30,
      "Conversion": 1,
      "RPI": {
        "Value": 1.35,
        "CurrencyCode": "USD"
      },
      "FieldEndDate": "\/Date(1541000567000-0600)\/",
      "IndustryID": 30,
      "StudyTypeID": 1,
      "OverallCompletes": 5,
      "TotalRemaining": 995,
      "CompletionPercentage": 0,
      "SurveyGroup": null,
      "SurveyGroupID": null,
      "SurveyGroupExists": 1,
      "BidLengthOfInterview": 10,
      "TerminationLengthOfInterview": 6,
      "SurveyQuotaCalcTypeID": 1,
      "IsTrueSample": false,
      "SurveyMobileConversion": 0,
      "SampleTypeID": null,
      "CollectsPII": true,
      "IsOnlySupplierInGroup": false,
      "RelationshipType": "private",
      "RespondentPIDs": ["75530545", "30776758", "23180686"]
    }
  ]
}

Mise à jour de la logique d’intégration

Si vous avez une logique ou des processus internes basés sur les données Private Exchange, vous devrez effectuer les ajustements nécessaires du système, qui peuvent inclure : 

• Recommandé pour les clients Feed Opportunities : migrer vers l’utilisation de buyer_id depuis account_name

• Ajuster toute sélection interne d’enquête ou logique de classement incluant les identifiants acheteurs Private Exchange pour inclure l’identifiant acheteur ou le nom du compte Cint Exchange.

• S’assurer que tous les processus internes liés aux données obtenues des px_buyer_message de propriété sont poursuivis.

Exigences supplémentaires pour tous les partenaires fournisseurs

Suivi des sessions d’échange privé

Vous pouvez suivre les résultats des sessions d’échange privé de plusieurs manières :

• Redirections fournisseurs : Surveillez les sessions des répondants via vos redirections fournisseurs.

  • Pour nos clients Match, nous allons introduire un nouveau paramètre qui vous permet de suivre la période de réalisation d’un échange privé. Si vous souhaitez inclure ce paramètre dans vos redirections, veuillez contacter votre équipe de compte.

• Alimentez les résultats des répondants : Abonnez-vous, si ce n’est pas déjà fait, pour recevoir les résultats des sessions des répondants en temps quasi réel directement sur votre webhook choisi. La réponse issue inclut la propriété buyer_id , ce qui vous aide à identifier les sessions Private Exchange.

  • Ressource supplémentaire : Opportunités du fil d’échange de Cint et FAQ sur les résultats des répondants

• Rapports UI : Utilisez nos outils de reporting pour extraire les détails des sessions. Consultez la section de déclaration de cet article pour plus de détails.

Mesure des médias

Lorsque les répondants sont envoyés vers des opportunités d’enquête Private Exchange, la fonctionnalité de mesure des médias sera désactivée et les utilisateurs ne seront pas interceptés.

Processus de paiement

Cint paie de manière proactive les fournisseurs de Cint Exchange pour toutes les transactions complètes dans le Cint Exchange. En conséquence, les fournisseurs n’ont pas besoin de facturer Cint pour recevoir des paiements liés à l’activité d’échange privé. Cint paie les fournisseurs mensuellement selon les termes du contrat, et les paiements sont effectués en dollars américains (USD).  

Plus d’informations : Pour plus d’informations, veuillez consulter l’article Processus de paiement pour les fournisseurs de Cint Exchange

Reportage

L’activité d’échange privé est disponible à suivre dans nos rapports du portail fournisseurs ; il suffit d’utiliser le segmentateur de type d’échange en haut de tout rapport et de sélectionner « Échange privé ».  Les métriques Private Exchange sont également disponibles via le reporting UI. Le tableau ci-dessous détaille comment identifier les données d’échange privé dans chaque rapport UI spécifique. Pour la surveillance le jour même, nous recommandons le reporting de l’interface utilisateur, car les données du portail comportent un délai de 24 heures.

Veuillez noter que les rapports de Cint Exchange n’indiquent pas si une session terminée est provisoire ou clôturée. Les acheteurs sur le Cint Exchange ont jusqu’au 25 du mois suivant pour finaliser leur audit de rapprochement.  Par exemple, si une vérification complète a eu lieu le 1er ou le 31 juillet, l’acheteur dispose d’un audit de rapprochement jusqu’au 25 août.  Après cette période, les sessions ne peuvent plus être ajustées, et le statut du résultat est verrouillé. Par conséquent, pour consulter les sessions liées aux « clôtures » complètes, veuillez ajuster la plage de dates dans vos rapports en conséquence.