Feed CJ Affiliate: guida tecnica ai campi e all'ottimizzazione

Introduzione al feed CJ Affiliate

CJ Affiliate è una piattaforma di marketing di affiliazione che consente ai commercianti di distribuire i dati dei propri prodotti a una rete di affiliati e publisher. Il feed prodotti rappresenta il fondamento della tua presenza su CJ Affiliate: contiene tutti i dettagli necessari affinché gli affiliati possano promuovere i tuoi articoli in modo accurato e conforme alle tue linee guida.

A differenza dei feed per piattaforme di shopping (come Google Shopping), il feed CJ Affiliate è progettato specificamente per supportare le esigenze dei partner di affiliazione. Questo significa che i campi sono ottimizzati per fornire informazioni che gli affiliati utilizzano per creare annunci, landing page e contenuti promozionali. Una corretta configurazione del feed influisce direttamente sulla qualità degli annunci creati dai tuoi partner e sulla conformità alle tue politiche commerciali.

Campi essenziali per l'identificazione e la struttura

Identificatori unici del prodotto

I campi id, gtin e mpn servono a identificare univocamente ogni articolo nel tuo catalogo.

id è l'identificatore primario del prodotto all'interno del tuo sistema. Deve essere unico per ogni SKU e coerente in tutti i feed che distribuisci. Se il tuo id cambia da un giorno all'altro, CJ Affiliate potrebbe trattare il prodotto come nuovo, perdendo la cronologia di performance e approvazioni precedenti.

gtin (Global Trade Item Number) è il codice EAN, UPC o ISBN del prodotto. Quando presente, consente a CJ Affiliate di collegare il tuo articolo a dati di riferimento globali e di riconoscere duplicati o varianti. L'assenza di gtin non causa il rifiuto del feed, ma la sua inclusione migliora la qualità dei dati complessiva e facilita l'identificazione dei prodotti da parte dei sistemi automatici.

mpn (Manufacturer Part Number) è il numero di parte del produttore. Utilizzalo quando il prodotto ha un codice ufficiale del produttore. Insieme a brand e gtin, mpn aiuta CJ Affiliate a evitare conflitti di identità tra varianti di prodotto.

item_group_id raggruppa varianti dello stesso prodotto (ad esempio, una maglietta disponibile in più colori e taglie). Quando utilizzi item_group_id, ogni variante deve avere il proprio id univoco, ma condividere lo stesso item_group_id. Questo permette agli affiliati di promuovere il prodotto come una famiglia di varianti, anziché come articoli separati.

Dati di base del prodotto

title deve essere descrittivo e accurato. Evita keyword stuffing o titoli eccessivamente lunghi. Un titolo come "Scarpe da corsa Nike Air Max 90 nero - uomo - taglia 42" è più efficace di "SCARPE NIKE MIGLIORI PREZZI ONLINE SUPER OFFERTA". CJ Affiliate utilizza il titolo per l'indicizzazione e gli affiliati lo copiano direttamente negli annunci, quindi la qualità del titolo influisce direttamente sulla qualità della promozione.

description deve contenere informazioni dettagliate: materiali, dimensioni, caratteristiche, vantaggi. Una descrizione vaga o generica viene spesso rifiutata durante il processo di approvazione del feed, soprattutto per categorie regolamentate (come cosmetici, prodotti sanitari o articoli per adulti). Includi specifiche tecniche, istruzioni di manutenzione e qualsiasi certificazione pertinente.

brand è obbligatorio per quasi tutti i prodotti. Deve corrispondere al marchio effettivo del produttore. Gli affiliati lo utilizzano per filtrare i prodotti e per creare annunci brand-specific. Se omesso o errato, il prodotto potrebbe non essere approvato per le campagne affiliate che richiedono brand verification.

google_product_category utilizza la tassonomia di Google. Anche se il nome contiene "Google", CJ Affiliate la utilizza come standard di categorizzazione globale. Assegna la categoria più specifica possibile: non usare "Abbigliamento" quando puoi usare "Abbigliamento > Scarpe > Scarpe da corsa". Una categorizzazione errata può portare al rifiuto durante la revisione del feed o a una visibilità ridotta presso gli affiliati che filtrano per categoria.

Dati di prezzo e disponibilità

Prezzi e sconti

price è il prezzo di listino corrente del prodotto. Deve essere un numero valido con il separatore decimale corretto (punto in inglese, virgola in italiano a seconda della configurazione del feed). Se il prezzo è zero o negativo, il prodotto viene automaticamente rifiutato.

sale_price è il prezzo scontato temporaneo. Quando sale_price è inferiore a price, CJ Affiliate riconosce l'articolo come in promozione. Gli affiliati utilizzano questa informazione per evidenziare gli sconti negli annunci. Se sale_price è assente, il sistema presuppone che non ci sia sconto attivo. Assicurati di aggiornare sale_price solo quando la promozione è effettivamente attiva: prezzi scontati scaduti causano reclami da parte degli affiliati e possono portare a restrizioni sulla distribuzione del feed.

Il formato del prezzo deve includere la valuta. Se il tuo feed specifica GBP, assicurati che tutti i prezzi siano in sterline. Conversioni di valuta errate sono una delle cause principali di rifiuto del feed.

Disponibilità e stato del prodotto

availability indica se il prodotto è in stock, pre-ordinabile o non disponibile. I valori tipici sono "in stock", "out of stock", "preorder". Questo campo è critico: gli affiliati non promuoveranno attivamente un prodotto non disponibile, e CJ Affiliate potrebbe sospendere la distribuzione di articoli sistematicamente out of stock.

Aggiorna availability in tempo reale o almeno quotidianamente. Se un prodotto è out of stock nel tuo sistema ma ancora "in stock" nel feed, gli affiliati invieranno traffico a pagine di prodotto non disponibili, generando frustrazione e richieste di rimborso.

condition specifica se il prodotto è nuovo, ricondizionato o usato. Per la maggior parte dei commercianti, il valore è "new". Se vendi ricondizionati o usati, condition deve essere impostato correttamente: gli affiliati devono sapere lo stato del prodotto per conformarsi alle normative sulla trasparenza e per evitare violazioni delle politiche pubblicitarie.

Informazioni visive e di navigazione

Immagini e link

image_link è l'URL dell'immagine principale del prodotto. Deve puntare a un file immagine valido (JPEG, PNG, GIF, WebP) di almeno 100x100 pixel, idealmente 800x800 pixel o superiore. Un'immagine assente o rotta causa il rifiuto automatico del feed. Gli affiliati utilizzano questa immagine negli annunci, nei post sui social media e nei contenuti promozionali, quindi la qualità visiva influisce direttamente sulla performance della campagna.

Assicurati che image_link sia un URL diretto al file, non a una pagina HTML. Molti sistemi di gestione dei feed estraggono erroneamente l'URL della pagina del prodotto anziché l'URL dell'immagine: verifica sempre che l'URL termini con un'estensione di file immagine.

additional_image_link consente di fornire fino a 10 immagini aggiuntive. Sebbene non sia obbligatorio, le immagini supplementari migliorano significativamente la qualità della promozione: gli affiliati possono scegliere l'immagine che meglio si adatta al loro contesto editoriale. Formatta multiple immagini come un elenco separato da virgole o come campi ripetuti, a seconda della struttura del tuo feed.

link è l'URL della pagina del prodotto nel tuo negozio. Deve essere un URL diretto al prodotto specifico, non alla homepage o a una categoria. CJ Affiliate utilizza questo link per tracciare il traffico affiliate e per verificare che il prodotto sia effettivamente disponibile al prezzo dichiarato. Se link punta a una pagina di errore o a una categoria generale, il prodotto viene rifiutato.

Assicurati che il link sia permanente e stabile. Se cambi la struttura degli URL, gli affiliati perderanno i link tracciati e il traffico storico non sarà più attribuibile. Se devi modificare la struttura degli URL, implementa reindirizzamenti 301 permanenti.

mobile_link è opzionale e punta a una versione mobile ottimizzata del prodotto. Se il tuo sito non ha una versione mobile separata (come nel caso di design responsive), ometti questo campo. Se lo includi, deve puntare a una pagina mobile effettivamente ottimizzata: un link non responsivo o che rimanda alla versione desktop viene ignorato.

Attributi e varianti del prodotto

Varianti dimensionali

color, size e age_group descrivono le varianti fisiche del prodotto.

color specifica il colore disponibile. Usa nomi di colore standard: "rosso", "blu", "nero", anziché descrizioni soggettive come "rosso Ferrari" o "blu cielo". Se il prodotto è disponibile in più colori, crea un record separato per ogni variante di colore e utilizza item_group_id per raggrupparle.

size è la taglia o il formato disponibile. Per l'abbigliamento, usa la taglia standard del mercato (XS, S, M, L, XL). Per calzature, usa le taglie numeriche (42, 43, 44). Per prodotti non indumenti, usa unità pertinenti ("250ml", "32GB", "A3"). Se il prodotto è disponibile in più taglie, crea varianti separate.

age_group specifica il gruppo di età target: "newborn", "infant", "toddler", "kids", "adult". Questo campo è particolarmente importante per i prodotti per l'infanzia, dove le normative sulla sicurezza variano in base all'età. Se il tuo prodotto non è specifico per un'età, ometti il campo.

Attributi di composizione e caratteristiche

material descrive il materiale principale o i materiali del prodotto. Per un maglione, potrebbe essere "cotone 100%" o "poliestere 65%, cotone 35%". Per un mobile, potrebbe essere "legno di quercia massello". Gli affiliati utilizzano questo campo per filtrare i prodotti in base alle preferenze dei consumatori (ad esempio, "solo prodotti in cotone biologico").

gender specifica il genere target: "male", "female", "unisex". Utilizzalo per prodotti specifici per genere come abbigliamento, calzature e articoli per la cura personale. Per prodotti neutri dal punto di vista del genere, usa "unisex" anziché omettere il campo.

shipping_weight è il peso del prodotto in unità standard (grammi, chilogrammi, libbre). Questo campo è utilizzato dagli affiliati per calcolare le spese di spedizione stimate e dai sistemi di CJ Affiliate per validare i dati di logistica. Se omesso, gli affiliati non possono fornire stime di spedizione accurate, il che riduce la conversione.

Identificazione di bundle e multiprodotto

Prodotti multipli e bundle

multipack indica il numero di unità incluse in un singolo SKU. Se vendi una confezione da 3 magliette con un singolo id, multipack deve essere "3". Questo informa gli affiliati e i clienti finali sul valore effettivo: un prezzo di 30 euro per un multipack da 3 è più attraente quando comunicato come "10 euro a capo".

is_bundle è un flag booleano (true/false) che indica se il prodotto è un bundle di articoli diversi. Un bundle potrebbe essere "Kit starter gaming" che include mouse, tastiera e tappetino. Quando is_bundle è true, CJ Affiliate applica regole di approvazione diverse: i bundle devono avere descrizioni particolarmente dettagliate che elenchino tutti gli articoli inclusi.

Se utilizzi is_bundle, assicurati che description contenga un elenco esplicito di tutti i componenti e che image_link mostri chiaramente il bundle completo, non solo uno dei componenti.

Conformità e attributi speciali

Prodotti per adulti e identificatori di conformità

adult è un flag booleano che indica se il prodotto è destinato esclusivamente a un pubblico adulto. Utilizzalo per articoli come integratori, dispositivi medici, prodotti per adulti o bevande alcoliche. Quando adult è true, CJ Affiliate applica restrizioni sulla distribuzione: gli affiliati non possono promuovere il prodotto su reti pubblicitarie che vietano contenuti per adulti, e il prodotto non viene mostrato ai minori.

Se il tuo prodotto richiede age verification o è legalmente limitato a determinati mercati, adult deve essere true. L'omissione di questo flag quando necessario causa il rifiuto del feed durante la revisione.

identifier_exists è un flag che indica se il prodotto ha un identificatore globale verificato (gtin, mpn o equivalente). Se identifier_exists è true, il sistema presuppone che gtin o mpn siano presenti e validi. Se identifier_exists è true ma questi campi sono assenti o errati, il prodotto viene rifiutato. Usa identifier_exists = false solo se il prodotto è genuinamente privo di identificatori standard (come articoli personalizzati o handmade).

Etichette personalizzate per la segmentazione

custom_label_0, custom_label_1 e custom_label_2 sono tre campi personalizzabili che utilizzi per segmentare i prodotti secondo i tuoi criteri interni. Potresti usarli per:

• custom_label_0: categoria di margine ("alto margine", "basso margine", "break even")
• custom_label_1: stagione o ciclo di vita del prodotto ("new", "best seller", "clearance")
• custom_label_2: canale di distribuzione preferito ("affiliati premium", "social media", "email only")

Gli affiliati e gli amministratori di CJ Affiliate utilizzano queste etichette per filtrare e gestire i prodotti senza dover modificare i campi principali. Ad esempio, puoi creare una regola che applica un bonus di commissione ai prodotti con custom_label_0 = "alto margine", incentivando gli affiliati a promuovere i tuoi articoli più redditizi.

Linee guida pratiche per l'ottimizzazione del feed

Validazione e coerenza dei dati

Prima di inviare il feed a CJ Affiliate, esegui una validazione rigorosa:

1. Verifica l'unicità degli id: nessun id deve ripetersi. Se un id è duplicato, il sistema potrebbe unire due prodotti diversi o rifiutare il feed.

2. Controlla i link: ogni link deve puntare a una pagina valida e raggiungibile. Utilizza uno strumento di controllo dei link morti per verificare un campione rappresentativo del feed.

3. Valida i prezzi: tutti i prezzi devono essere numeri validi maggiori di zero. Se sale_price è presente, deve essere inferiore a price. Controlla la coerenza della valuta in tutto il feed.

4. Verifica le immagini: scarica un campione di immagini dal feed per assicurarti che siano valide e di buona qualità. Le immagini rotte sono una causa frequente di rifiuto.

5. Controlla i campi obbligatori: id, title, description, link, image_link, availability, price e brand devono essere presenti per ogni prodotto. Se uno di questi campi manca, il prodotto viene rifiutato.

Aggiornamenti e frequenza

CJ Affiliate consiglia di aggiornare il feed almeno una volta al giorno, idealmente ogni 4-6 ore. Gli aggiornamenti frequenti garantiscono che:

• I prezzi rimangono accurati
• L'availability riflette lo stock reale
• I prodotti scaduti o ritirati vengono rimossi rapidamente
• Le nuove varianti vengono aggiunte tempestivamente

Se utilizzi un'integrazione API o uno strumento di feed management, configura gli aggiornamenti automatici. Se invii manualmente il feed, crea un calendario di aggiornamento coerente e rispettalo rigorosamente.

Gestione delle varianti con item_group_id

Quando utilizzi item_group_id per raggruppare varianti, segui questi principi:

• Ogni variante ha un id univoco
• Tutte le varianti condividono lo stesso item_group_id
• Campi come title, brand e description sono identici o molto simili tra le varianti
• Campi come color, size e price variano per ogni variante
• Se una variante è out of stock, aggiorna solo l'availability di quella variante, non l'intero gruppo

Esempio di corretta strutturazione di varianti:

Monitoraggio della performance del feed

Dopo aver inviato il feed a CJ Affiliate, monitora:

• Tasso di approvazione: quale percentuale di prodotti viene approvata. Un tasso inferiore al 95% indica problemi di qualità dei dati.
• Errori di validazione: CJ Affiliate fornisce rapporti dettagliati su errori specifici. Analizza questi rapporti e correggi i dati di conseguenza.
• Traffico affiliate: traccia quale prodotto genera il maggior traffico. I prodotti con scarso traffico potrebbero avere descrizioni deboli, prezzi non competitivi o categorie errate.
• Tasso di conversione: monitora quale prodotto converte il traffico affiliate in ordini. Questo indica se gli affiliati stanno promuovendo i tuoi articoli a pubblici appropriati.

Conclusione

Il feed prodotti CJ Affiliate è lo strumento fondamentale per distribuire i tuoi dati a una rete di partner di affiliazione. Una configurazione accurata e un mantenimento regolare del feed garantiscono che gli affiliati abbiano accesso a informazioni complete e aggiornate, che possono utilizzare per creare promozioni efficaci e conformi.

Focalizzati sulla coerenza dei dati, sulla completezza dei campi obbligatori e sulla descrizione accurata di ogni prodotto. Aggiorna il feed regolarmente per riflettere i cambiamenti di prezzo, disponibilità e catalogo. Monitora i rapporti di performance e i feedback di CJ Affiliate per identificare e risolvere i problemi di qualità.

Una gestione attenta del feed traduce direttamente in una migliore qualità della promozione, tassi di approvazione più elevati e una performance complessiva superiore nella tua rete di affiliazione.