Recette d'importation
Déterminer les backlinks pour chaque prospect de votre importation
Un job d'enrichissement propre nécessite quatre requêtes et une colonne de date. Cette page liste ce qu'il faut stocker, le coût de chaque appel et où les importations échouent silencieusement.

Liste de pré-vol pour le script d'importation
- Supprimer les protocoles, les chemins et
www.pour que chaque ligne soit un domaine nu - Dédupliquer avant d'appeler ; un domaine répété coûte toujours un slot de crédit
- Découper en lots de 2 000 maximum pour
bulk_dr - Écrire le score et une date de récupération dans des colonnes séparées
- Traiter les erreurs HTTP 401 et 402 comme des signaux d'arrêt, et non comme des résultats vides
- Journaliser le solde des crédits depuis
_creditsaprès chaque lot
Référence des champs : quelle action remplit quelle colonne
| Action | Crédits | Entrée | Ce que vous pouvez stocker |
|---|---|---|---|
| domaine / aperçu / statistiques | 0 | Un domaine dans q | Comptes de titres et DR pour une seule recherche |
| suggérer | 0 | Nom partiel | Autocomplétion lorsqu'un utilisateur tape le nom d'une publication |
| bulk_dr | 1 | Jusqu'à 2 000 domaines | DR pour chaque domaine du lot |
| refdomains | 2 | Un domaine, jusqu'à 1 000 lignes par appel | La liste des domaines qui lient le prospect |
| anchors | 2 | Un domaine | Les textes d'ancrage qui pointent vers lui |
| toppages | 2 | Un domaine | Ses pages les plus liées |
Comment déterminer les backlinks pour 5 000 lignes sans trop dépenser
Commencez par le scoring. Arrêtez-vous là pour la plupart des lignes. Un passage bulk_dr sur 5 000 domaines représente trois appels, soit 3 crédits au total, une fraction infime de centime par ligne.
Des extractions plus profondes sont réservées à la partie que vous allez réellement contacter. Si 300 prospects dépassent votre seuil DR, refdomains pour chacun coûte 600 crédits, soit six centimes. Faites la même chose pour les 5 000 et la facture s'élève à 1 $, ce qui reste faible, mais la sortie contient surtout du bruit que personne ne lit. Restez léger.
L'ordre est important ici. Scoring d'abord, filtrage par seuil (voir le tableau de seuil DR), puis enrichissement des survivants. Ensuite, vous pouvez comparer les finalistes par paires.

Une note sur les sous-domaines et les redirections
Les listes de prospects contiennent des hôtes désordonnés : m.example.com, blog.example.com, un domaine fantaisie qui fait une redirection. Choisissez une règle et notez-la dans le commentaire du job.
Notre recommandation est de scorer le domaine enregistrable, de conserver l'hôte original dans une colonne séparée et de marquer toute ligne où les deux diffèrent. Une newsletter hébergée sur un sous-domaine de plateforme est le piège habituel, car l'autorité de la plateforme ne dit rien sur l'auteur. Vérifiez-les manuellement avant le premier envoi. Ne sautez pas cette étape.
Lignes qui n'étaient jamais des domaines
La plupart des recherches qui reviennent vides n'étaient jamais des domaines valides au départ. Une entrée mixte est la cause habituelle, et une colonne qui mélange adresses web, noms de contact et texte libre envoie des données erronées à l'API. Nettoyez avant de dépenser un crédit.
Imaginez une feuille de 4 000 contacts où la colonne de la publication contient parfois un nom devant le site. Gardez uniquement la partie domaine. Notez chaque modification pour qu'elle puisse être annulée plus tard.
Supprimez les parties qu'un navigateur a besoin et qu'un domaine n'a pas
Un lien collé contient un schéma, un chemin, une chaîne de requête et parfois un port. Rien de tout cela n'appartient à q. Supprimez-les en un seul passage, puis vérifiez que ce qui reste contient un point et pas d'espaces.
Tout ce qui contient un espace n'est pas un domaine, donc envoyez-le à une liste de révision au lieu de l'API. Un comptage rapide de ces lignes montre souvent la source du désordre, comme un importateur qui a copié des adresses entières depuis la barre du navigateur.
- Les protocoles tels que https:// et http://
- Tout ce qui suit la première barre oblique, y compris le chemin
- Les numéros de port tels que :8080
Scorer la publication, pas la signature
De nombreuses listes de publications stockent le nom d'une personne dans la même colonne que la publication. Une signature ou une marque de newsletter est une étiquette pour un contact, pas un hôte. Scorer le domaine de la publication, puis conserver le nom du contact dans sa propre colonne.
Disons que trois journalistes partagent une même rédaction. Les trois lignes devraient recevoir le même DR, car le domaine est le même. Dédupliquez les domaines, puis rejoignez les scores à chaque contact, afin qu'une seule recherche serve toute l'équipe.
Gérer un domaine qui a déménagé ou qui fait une redirection
Les publications changent d'hôte. Un titre peut migrer vers un nouveau domaine, ou un site ancien peut faire une redirection vers une marque mère. L'ancien nom dans votre liste décrit alors un site que l'éditeur ne gère plus.
Vérifiez la redirection une fois manuellement. Enregistrez l'hôte final et marquez la ligne, afin que l'ancien nom ne soit pas scorer à nouveau le mois prochain. Répéter cette vérification à chaque actualisation ajoute du coût et ne vous apprend rien de nouveau.
Appel groupé avec un corps POST
GET fonctionne pour les petites listes. Pour un lot complet, envoyez les domaines dans le corps pour que l'URL reste courte.
curl -X POST "https://linkfluence.app/api.php?action=bulk_dr&key=sk_live_..." \
-d "domains=techcrunch.com,hubspot.com,theverge.com"
# then, for the shortlist only
curl "https://linkfluence.app/api.php?action=refdomains&q=hubspot.com&per=1000&key=sk_live_..."Ordonnez le job pour ne pas gaspiller de crédit
Normaliser la colonne
Appliquez les règles de nettoyage, puis comptez les lignes qui ont échoué. Une ligne rejetée est une découverte, donc conservez la liste des lignes rejetées.
Dédupliquer tout le fichier
Un domaine est envoyé dans la requête une seule fois, quel que soit le nombre de contacts qui se cachent derrière.
Scorer par lots de 2 000
Envoyez chaque chunk à bulk_dr, lisez ok en premier, puis stockez le score et la date de récupération pour chaque ligne.
Extraire la profondeur uniquement pour le filtrage
Appliquez votre seuil issu du tableau de seuil, puis appelez les actions à 2 crédits uniquement pour les lignes qui l'ont dépassé.
Journaliser le solde
Écrire le solde _credits après chaque chunk, afin qu'une exécution interrompue montre exactement où elle s'est arrêtée.
Les erreurs qui corrompent un CRM, et la solution
| Erreur | Ce qui se passe | Solution |
|---|---|---|
| Écraser le score d'hier avec un vide après un 402 | Les prospects semblent non scorés et sortent de la file d'attente | Arrêter le job sur tout code non-200, conserver l'ancienne valeur |
| Scorer des sous-domaines tels que blog.example.com | Les comptes reflètent l'hôte, pas la marque pour laquelle travaille votre contact | Décider par ligne s'il faut scorer le domaine racine ou l'hôte, et enregistrer le choix |
| Pas de colonne de date | Personne ne peut distinguer un score de mars d'un score d'octobre | Stocker la date de récupération à côté de chaque nombre |
Rappeler refdomains chaque semaine | Payer deux fois pour des données qui s'actualisent mensuellement | Mettre en cache par domaine jusqu'au prochain cycle d'indexation |
| Utiliser le DR comme une vérité absolue dans les discussions clients | Un client le compare avec Ahrefs et voit une incohérence | L'étiqueter comme DR Linkfluence dans chaque export |

Questions sur l'exécution de l'enrichissement
Les questions ci-dessous surviennent presque à chaque importation. Chaque réponse est courte et renvoie à une règle énoncée plus haut sur cette page.
Pourquoi une ligne revient-elle sans score ?
Généralement, l'entrée n'était pas un domaine nu, ou la valeur a été nettoyée différemment du reste du lot. Vérifiez d'abord la valeur nettoyée. Un 401 ou 402 signifie que tout le job doit s'arrêter, tandis qu'un seul champ vide n'est qu'une mauvaise ligne, et les deux nécessitent une gestion différente.
Puis-je lancer le job une seule fois et plus jamais ?
Vous le pouvez, mais un score ponctuel devient obsolète. L'index s'actualise environ une fois par mois, donc rescorez la liste active après chaque actualisation et conservez la valeur précédente comme historique. Une vérification de placement couvre les nouveaux liens qui apparaissent entre les exécutions.
Un nombre de 0 à 100 suffit-il pour décider ?
Il suffit pour trier, pas pour décider seul. Utilisez le score pour ordonner la liste, puis ajoutez une vérification de pertinence et une vérification de timing. Aucun nombre unique ne peut vous dire si un rédacteur couvre votre sujet ce trimestre.
Que doit contenir la note CRM pour chaque ligne ?
Le score, la date de récupération, l'hôte nettoyé, la règle qui l'a modifié et le numéro de lot. Avec ces cinq champs, n'importe qui peut reconstruire le nombre plus tard sans vous demander.
Comment estimer les crédits avant de lancer un job ?
Comptez les appels, pas les lignes. Un appel bulk_dr prend jusqu'à 2 000 domaines pour 1 crédit, donc 10 000 domaines représentent cinq appels. Ajoutez les extractions à 2 crédits pour les survivants, puis multipliez par $0,0001 par crédit.
Ce qu'un fichier d'enrichissement terminé doit contenir
Un fichier terminé est un que vous pouvez expliquer six mois plus tard sans la personne qui a écrit le script. Chaque nombre doit porter la raison de son existence, et chaque ligne sautée doit porter la raison de son saut. C'est là la majeure partie de la discipline. Cela coûte presque rien une fois le job exécuté par lots.
Considérez le fichier comme un registre de décisions. Le score n'est qu'une colonne. L'hôte nettoyé, le seuil qui a sélectionné la ligne et la date du dernier pull profond racontent à la prochaine personne ce qui s'est passé et si cela tient encore.
Les colonnes qui doivent survivre au job
Conservez la valeur brute exactement telle qu'elle est arrivée, puis le domaine nettoyé à côté. Lorsqu'un score semble incorrect, la valeur brute est ce qui permet de remonter à l'erreur depuis l'importation plutôt que de blâmer l'API.
Stockez le DR, la date de récupération et le numéro de lot comme des champs séparés. Les mélanger dans une seule cellule texte rend impossible le filtrage par date, et le filtrage par date est la première chose qu'un réviseur demandera.
- Valeur brute telle qu'importée
- Domaine enregistrable nettoyé
- DR et la date de récupération
- Numéro de lot et crédits facturés
Lignes que vous ne devez jamais supprimer silencieusement
Certaines lignes échouent pour des raisons qui compteront plus tard. Une redirection, un domaine en attente ou un site qui ne retourne rien du tout peuvent tous ressembler à des données vides. Marquez ces lignes au lieu de les supprimer, afin que l'écart soit visible dans le fichier.
Disons qu'un prospect ne retourne aucun domaine référent lors d'un pull profond. Cela peut signifier que le site est nouveau, petit ou que la ligne est mauvaise. Le fichier doit indiquer lequel, car chaque réponse mène à une action différente.
Un fichier qu'un client ou un collègue peut auditer
Quiconque lit la feuille devrait pouvoir reproduire un nombre unique à partir des seules notes. S'il ne le peut pas, un champ manque aux notes, et l'écart appartient aux notes plutôt qu'au lecteur.
Conservez une exportation par exécution plutôt que d'écraser la feuille maître. Ainsi, une question sur la courte liste du mois dernier a une réponse, et la comparaison de courte liste peut être relancée sur les mêmes entrées.