Soumettre des données de conversion via FTP ou e-mail

Suivre le cours PXA

Si vous collectez des données de conversion (c.-à-d. des actions) côté serveur ou via un cookie, vous devrez soumettre vos données à impact.com afin de visualiser les performances de votre programme, attribuer le crédit aux partenaires et modifier ou annuler toute action avant qu'elle ne soit verrouillée.

Ce document vous guide pour formater et soumettre vos données de conversion, et suppose que vous avez déjà commencé à collecter des données.

Avant de commencer

• Si vous avez besoin d'aide pour collecter des données de conversion avec un suivi non basé sur un pixel, contactez votre CSM ou contacter le support. Pour en savoir plus sur votre méthode de suivi et votre intégration, nous vous recommandons de consulter le Plan d'intégration technique original fourni par notre équipe des services techniques.

• Si vous avez Connections activé pour votre compte, la configuration d'un pipeline de données de conversion se présentera différemment pour vous. Apprenez comment créer une Connection.

• Les paramètres requis pour les actions web et les actions d'application mobile sont différents. Voir Paramètres spécifiques au mobile pour plus d'informations sur la soumission de conversions d'applications mobiles.

Avertissement : Nous recommandons fortement de ne pas soumettre d'actions datant de plus de 88 jours, car impact.com ne traite actuellement pas les conversions soumises par FTP avec des dates d'événement dépassant cette fenêtre. Des conversions vieux de jusqu'à 398 jours peuvent être traitées, mais uniquement si l'attribution est faite en utilisant MediaId.

Étape 1 : Préparez vos données

Suivez les instructions ci-dessous pour afficher un fichier modèle, y ajouter vos données de conversion et l'enregistrer au format .csv. Le modèle dont vous avez besoin dépend de si vous suivez les conversions au niveau article (c.-à-d. en incluant le SKU, la quantité, etc. de chaque article d'une commande) ou au niveau commande (c.-à-d. en suivant uniquement les commandes elles‑mêmes, et non les articles qui les composent). Vous pouvez également soumettre données d'action en chaîne .

1. Sélectionnez l'un des liens ci‑dessous pour afficher le modèle de fichier .csv correspondant au niveau auquel vous suivez les actions.

   • Modèle de données/Actions au niveau article

   • Modèle de données/Actions au niveau commande

   • Modèle de données pour les actions en chaîne

2. Ajoutez vos données de conversion au fichier.

   • Voir le document de référence Action & Conversion d'impact.com pour des exemples, et utilisez ce fichier comme référence pour les paramètres acceptés. Contactez votre CSM pour savoir quels paramètres il serait préférable d'inclure dans votre modèle de données de conversion.

3. Ajoutez en tant que nouvelles colonnes dans votre fichier tous les paramètres optionnels que vous souhaitez déclarer.

4. Enregistrez votre fichier au format .CSV avec un titre et une date facilement identifiables (par ex., 2020-01-01_ActionData.csv).

   Remarque : Pour les fichiers de lot au niveau article, les ID de commande (Order ID) ayant plusieurs SKU associés doivent être listés consécutivement. Ne pas regrouper les lignes d'article ayant le même ID de commande et des SKU différents entraînera une erreur OID_DUPLICATE pour les SKU listés plus bas dans le fichier.

Étape 2 : Soumettez votre fichier de données

Téléverser via FTP/SFTP

• Nous recommandons de diviser les fichiers FTP/SFTP pour maintenir le nombre maximal d'entrées par fichier en dessous de 10 000.

• Pour soumettre un fichier au serveur FTP/SFTP d'impact.com, vous devrez d'abord récupérer les identifiants du compte. Suivez les instructions ci-dessous pour savoir comment faire envoyer vos identifiants existants par e‑mail.

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

2. Dans la colonne de droite, sous Suivi, sélectionnez Types d'événements.

3. Survolez le type d'événement pour lequel vous souhaitez soumettre des données de suivi d'actions côté serveur, sélectionnez [Plus] à droite, puis sélectionnez Afficher / Modifier.

4. À côté de Traitement des retours, sélectionnez [Modifier].

5. Sélectionnez Automatiser le traitement des retours (avancé) → Télécharger le fichier sur le serveur FTP du système.

6. Sélectionnez Envoyer par e‑mail le nom d'utilisateur et le mot de passe FTP et Enregistrer.

   • Une fois que vous avez reçu vos identifiants FTP/SFTP, utilisez un client FTP/SFTP pour vous connecter à impact.com avec les informations suivantes :

   	FTP	SFTP
   Serveur	batch.impact.com	sftp://batch.impact.com
   Port	21	22
   Nom d'utilisateur	(Votre nom d'utilisateur FTP impact.com sensible à la casse.)	(Votre nom d'utilisateur SFTP impact.com sensible à la casse.)
   Mot de passe	(Votre mot de passe FTP impact.com sensible à la casse.)	(Votre mot de passe SFTP impact.com sensible à la casse.)

7. Une fois connecté, téléversez votre fichier dans le répertoire principal du serveur. Après un téléversement réussi, allez à la Étape 3 : Examiner la soumission du fichier section ci‑dessous.

   Remarque : Si vous n'avez pas reçu l'e‑mail contenant les identifiants FTP/SFTP, contactez la personne qui a créé votre compte impact.com. Sinon, contacter le support.

Récupérer le fichier via FTP/SFTP

Joindre le fichier par e‑mail

Étape 3 : Examiner la soumission du fichier

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

2. Dans la colonne de gauche, sous la section Technique , sélectionnez Soumissions de fichiers.

3. Utilisez le tableau pour examiner les soumissions de fichiers récentes reçues par impact.com, y compris le statut de traitement actuel.

   • Ci‑dessous, vous pouvez consulter diverses erreurs que vous pouvez rencontrer lors de l'examen des soumissions de fichiers et les actions que vous pouvez entreprendre pour y remédier.

Erreurs lors de l'examen des soumissions de fichiers

Certaines erreurs courantes lors de l'examen des soumissions de fichiers peuvent inclure :

Problème	Action à entreprendre
La colonne Enregistrements indique 0	Assurez‑vous que l'extension du fichier est .CSV ou .XML.
ActionTrackerId : Valeur invalide	Le ActionTrackerId n'appartient pas au type d'événement soumis. 1. Accédez à [Profil utilisateur] → Paramètres → Suivi. 2. Sélectionnez Types d'événements et vérifiez le type d'événement.
NO_REFERRERS_FOUND ou l'un des paramètres suivants est requis : • ClickId • CustomerId • CustomProfileId • CustomClickId • OrderPromoCode • MediaPartnerId • UniqueUrl • CallerId • GoogAId • AndroidId • AppleIfa • AppleIfv • WinId • PhoneNumber • Odin1 • DeviceId • OpenUdId • Mac • MacMd5 est requis	Vous n'avez fourni aucun paramètre lié à l'attribution. Fournissez au moins un paramètre d'attribution, afin que le système puisse identifier le partenaire auquel attribuer.
OID_Duplicate	Le OID est déjà présent dans le système d'impact.com. Veuillez fournir un type d'événement unique. Remarque : Si vous tentez de téléverser des conversions non attribuées qui nous ont déjà été signalées par le passé, utilisez un OID légèrement différent. Par ex. xxxxxx _1.
CLICK_AFTER_CONVERSION_EVENT	Le clickid soumis est postérieur à l'événement de conversion. Veuillez vous assurer que la ClickId et EventDate soumise est correcte.
NO_VALID_REFERRERS_FOUND ACTIONTERMS_NOT_FOUND	Le contrat avec le partenaire actif pendant la EventDate n'inclut pas ce type d'événement spécifique. Assurez‑vous de vérifier votre contrat avec le partenaire sous [Engage] → Contrats → Contrats.
NO_VALID_REFERRERS _ FOUND CONTRACT_NOT_FOUND	Il n'existe aucun contrat actif avec le partenaire pendant la EventDate. • Sélectionnez [Engage] → Contrats → Contrats pour vérifier l'historique des contrats.
NO_VALID_REFERNO_VALID_REFERRERS_FOUND OUTSIDE_ASSOCIATION_WINDOW	La conversion est en dehors de la fenêtre de référence de clic indiquée dans les conditions du contrat. Le réglage par défaut est de 30 jours. • Sélectionnez [Engage] → Contrats → Contrats pour vérifier la fenêtre de référence pour un partenaire spécifique.