Validateur sellers.json
Validez un document sellers.json par rapport à la spécification IAB Tech Lab dans votre navigateur. Le fichier que vous collez reste sur votre appareil.
Le Validateur sellers.json s'exécute entièrement dans votre navigateur. Le document que vous collez est analysé et vérifié sur votre appareil et n'est jamais récupéré depuis une URL ni téléversé vers ArrayKit.
Ouvrir le validateur ads.txt
À propos de Validateur sellers.json
Le Validateur sellers.json analyse un document sellers.json IAB Tech Lab dès que vous le collez. Il confirme le champ version de premier niveau requis et le tableau sellers[], puis parcourt chaque entrée de vendeur : chacune a besoin d'un seller_id unique dans tout le fichier et d'un seller_type PUBLISHER, INTERMEDIARY ou BOTH (insensible à la casse). name et domain sont requis sauf si le vendeur est marqué is_confidential, et is_passthrough doit être un booléen propre. Les résultats reviennent sous forme d'un verdict réussite/échec, de messages d'erreur par vendeur étiquetés avec l'index du tableau et le seller_id, et d'un résumé qui compte les vendeurs par type plus les entrées confidentielles et passthrough. Les équipes ad-ops et supply-path auditent leur propre fichier ou celui d'un partenaire ici sans l'envoyer en POST vers un service tiers — tout s'exécute sur votre appareil.
Fonctionnalités
- Vérifie le champ version de premier niveau requis et le tableau sellers[] conformément à la spec sellers.json
- Vérifie que chaque seller_id est présent et unique dans le fichier
- Valide seller_type par rapport à PUBLISHER, INTERMEDIARY et BOTH (insensible à la casse)
- Impose name et domain sauf si le vendeur définit is_confidential = 1
- Confirme que is_confidential et is_passthrough sont des indicateurs booléens propres 0/1
- Étiquette chaque erreur avec l'index sellers[] et le seller_id fautif
- Résume les décomptes par seller_type plus les totaux confidentiels et passthrough
- Analyse et valide le document dans votre navigateur — le fichier ne quitte jamais votre appareil
Comment utiliser Validateur sellers.json
- Collez votre document sellers.json, ou chargez l'exemple pour voir la forme attendue
- Lisez le verdict réussite/échec et les décomptes de résumé par type de vendeur
- Sautez à chaque entrée sellers[i] signalée à l'aide de l'index et du seller_id dans le message
- Corrigez le champ fautif et revalidez jusqu'à ce que le document passe
Exemple
Entrée
{
"version": "1.0",
"sellers": [
{ "seller_id": "1001", "seller_type": "RESELLER" }
]
}
Sortie
Invalid sellers.json — 3 issues
sellers[0] (seller_id 1001) — Invalid "seller_type" "RESELLER". Must be one of PUBLISHER, INTERMEDIARY, or BOTH.
sellers[0] — "name" is required unless the seller is confidential.
sellers[0] — "domain" is required unless the seller is confidential.
seller_type n'accepte que PUBLISHER, INTERMEDIARY ou BOTH ; les vendeurs non confidentiels ont besoin de name et domain.
Erreurs courantes et dépannage
- « Champ de premier niveau requis version manquant » sur un fichier qui a clairement des sellers. — sellers.json exige un champ version de type chaîne (par exemple « 1.0 ») au premier niveau aux côtés de sellers[]. Ajoutez-le — le tableau sellers seul ne suffit pas.
- Un vendeur confidentiel est signalé pour un name ou domain manquant. — name et domain ne sont facultatifs que lorsque is_confidential = 1 sur ce vendeur. Définissez is_confidential à 1 pour les omettre, ou fournissez les deux champs.
- seller_type est rejeté alors que la valeur semble correcte. — Seuls PUBLISHER, INTERMEDIARY et BOTH sont valides (insensibles à la casse). Des valeurs comme RESELLER, SSP ou EXCHANGE ne font pas partie de la spec et échoueront.
- « seller_id en double » sur des id que vous croyez distincts. — seller_id est comparé comme une chaîne, donc 1001 et « 1001 » entrent en collision. Chaque seller_id doit être unique dans le fichier — renumérotez ou dédupliquez les entrées.
Foire aux questions
- Que vérifie le Validateur sellers.json ?
- Il confirme le champ version de premier niveau requis et le tableau sellers[], puis vérifie que chaque vendeur a un seller_id unique, un seller_type PUBLISHER, INTERMEDIARY ou BOTH, et name et domain sauf si le vendeur est confidentiel — en signalant chaque problème avec son index et son seller_id.
- Quand un vendeur peut-il omettre name et domain ?
- Uniquement lorsque ce vendeur définit is_confidential = 1. La spec sellers.json permet à un compte confidentiel de masquer son name et son domain, donc le validateur ignore l'exigence name/domain pour ces entrées et les compte séparément dans le résumé.
- Quelles valeurs de seller_type sont valides dans sellers.json ?
- PUBLISHER (possède l'inventaire), INTERMEDIARY (revend l'inventaire d'un autre compte) et BOTH. La vérification est insensible à la casse, donc publisher et PUBLISHER passent tous deux, mais toute autre chaîne comme RESELLER est signalée comme un seller_type invalide.
- Pourquoi un seller_id est-il signalé comme un doublon ?
- Chaque seller_id doit être unique dans un même fichier sellers.json. Le validateur normalise les id en chaînes avant de les comparer, donc un 1001 numérique et une chaîne « 1001 » sont traités comme le même id et la seconde occurrence est signalée avec un pointeur vers la première.
- Le validateur récupère-t-il mon sellers.json depuis son URL ?
- Non. Il ne récupère jamais une URL distante ni un point de terminaison publicitaire. Vous collez le texte du document et il est analysé et validé sur votre appareil, donc rien concernant le fichier n'est téléversé vers ArrayKit ni un tiers.
Outils associés
- Validateur ads.txt — Valide un fichier ads.txt ou app-ads.txt ligne par ligne dans le navigateur.
- Générateur schain — Construit et valide l’objet IAB SupplyChain (schain) pour OpenRTB.
- Validateur OpenRTB — Valide une bid request OpenRTB 2.5 ou 2.6 par rapport aux règles IAB.
- Enums OpenRTB — Consulte chaque liste énumérée OpenRTB 2.x, code entier et signification.
- Validateur VAST — Vérifie un tag VAST XML par rapport aux règles IAB dans votre navigateur.
- Ad unit Prebid — Construit une config d’ad unit Prebid.js et un extrait pbjs.addAdUnits().
Tous les outils ArrayKit