Aggiornato a dicembre 2023.

Introduzione

Questo documento è la tua guida per implementare i feed di dati del Product Catalog di Rakuten Advertising. Ti fornisce informazioni su come automatizzare il processo di ottenimento delle informazioni sui prodotti dai tuoi partner inserzionisti che fanno parte di Rakuten Advertising e hanno sottoscritto il programma Product Catalog.

Ci sono due livelli di implementazione per i feed di dati del Product Catalog. Prima, dovrai essere approvato e configurato per l'implementazione tecnica dei feed di dati dei prodotti, e poi dovrai essere approvato da ciascuno dei tuoi partner inserzionisti partecipanti per utilizzare il loro feed di dati del Product Catalog sul tuo sito web o blog. Vedi Iniziare per ulteriori informazioni.

Requisiti Tecnici per l'Uso del Product Catalog

Per automatizzare il processo di ottenimento delle informazioni sui prodotti, devi essere in grado di:

• Scaricare file da un account SFTP.
• Elaborare file XML o di testo delimitati da pipe che contengono le informazioni sui prodotti.

Sezioni del File

I file dei prodotti hanno tre sezioni: intestazione, dati del prodotto e trailer; clicca sul + per ulteriori informazioni su ciascuna sezione:

Formati dei File

I file del Product Catalog sono disponibili in due formati: testo delimitato da pipe e XML:

Nomi dei File

I nomi dei file del Product Catalog hanno tre parti, ciascuna separata da un trattino basso: ID Inserzionista, ID Canale Publisher e Tipo di File.

1. L'ID Inserzionista o MID è un ID univoco che il Rakuten Advertising Affiliate Network utilizza per identificare l'inserzionista. Questo è sempre numerico.
2. L'ID Canale Publisher o SID è un ID univoco che il Rakuten Advertising Affiliate Network utilizza per identificare il Canale Publisher. Questo è sempre numerico.
3. Il tipo di file “mp” definisce che il file è un file del Product Catalog.

Le estensioni dei nomi dei file specificano che tipo di file del Product Catalog è. Il file delimitato da pipe ha un'estensione .txt e il file formattato in XML ha un'estensione .xml. I file sono tutti compressi, quindi c'è .gz dopo l'estensione del tipo di file.

Esempio: 2385_112_mp.txt.gz, dove:

• 2385 è l'ID Programma Inserzionista.
• 112 è l'ID Canale Publisher.
• mp indica che è un file del Product Catalog.
• .txt indica che questo è un file del Product Catalog delimitato da pipe.

Tipi di File

La funzione Product Catalog di Rakuten Advertising consente agli inserzionisti di caricare le loro informazioni sui prodotti. Elaboriamo le informazioni caricate e creiamo un URL di tracciamento del publisher corrispondente per ciascun prodotto e rendiamo le informazioni sui prodotti disponibili ai publisher tramite SFTP. Hai diverse scelte di tipi di file che puoi scaricare per ciascun inserzionista; clicca sul + per saperne di più su ciascun tipo di file:

File Delta

I file delta ti consentono di scaricare file più piccoli che contengono solo aggiornamenti di prodotto, inclusi nuovi record di prodotto, modificati e cancellati. Questo può essere utile per aggiornare i feed per gli inserzionisti con cataloghi di prodotti particolarmente grandi. Il tipo di modifica effettuata è riflesso in un campo aggiuntivo chiamato Modifica. Nei file delimitati da pipe, questo è l'ultimo campo per ciascun record di prodotto. Nei file XML, questo è indicato dal tag <modification>. Vedi il campo Modifica in Appendice A per i valori supportati.

Il file contiene tutte le modifiche che sono state effettuate quando l'ultimo feed dell'inserzionista è stato elaborato. Gli inserzionisti possono elaborare i feed più volte al giorno, quindi si consiglia di controllare spesso il server per gli aggiornamenti, facendo riferimento al timestamp sul file per determinare se sono state apportate modifiche dall'ultima volta che hai scaricato il file. Inoltre, si consiglia di scaricare un file completo regolarmente per assicurarsi di avere il Product Catalog completo.

Il nome del file delta è lo stesso di quello utilizzato per scaricare il file completo del Product Catalog, tranne per il fatto che ha la parola delta aggiunta.

Esempi:

• File .txt: 2385_112_mp_delta.txt.gz
• File .xml: 2385_112_mp_delta.xml.gz

L'intestazione per il file Delta è la stessa di quella per il file completo e include MID, Nome Inserzionista e Timestamp nel formato mostrato in Sezioni del File del Product Catalog.

File di Categoria

Il Product Catalog per Categoria è una funzione che ti consente di scaricare file per specifiche categorie di prodotti degli inserzionisti invece di scaricare l'intero file di prodotti. Questo significa che se hai bisogno solo di prodotti nella categoria di prodotti elettronici, puoi scaricare il feed solo per questa categoria.

Per ogni inserzionista che ti ha approvato per l'accesso al loro feed del Product Catalog, vedrai una cartella. Il nome della cartella sarà il MID dell'inserzionista. La cartella conterrà due tipi di file: File Elenco Categorie di Prodotti e File del Product Catalog Specifico per Categoria; clicca sul + per maggiori informazioni su ciascun file:

File Globali e Aggiuntivi

Rakuten Advertising consente agli inserzionisti di inviare più file per account. Se un inserzionista sceglie di rendere disponibile più di un file del Product Catalog, troverai questi file nidificati sotto una cartella "GLOBAL" o una cartella "ADDITIONAL" nella directory principale del tuo account SFTP. I file "Global" contengono prodotti in una lingua e/o valuta diversa dal file principale del feed. I file "Additional" hanno la stessa lingua e valuta del file principale del feed. Clicca sul + per informazioni sul download dei file Globali o Aggiuntivi:

root

GLOBAL (cartella)

FR-FR_EUR (cartella – lingua-locale_valuta)

12345 (cartella – il numero qui è l'ID dell'inserzionista, o MID)

12345_678_mp_FR-FR_EUR.txt.gz

12345_678_mp_delta_FR-FR_EUR.txt.gz

FR-CA_CAD (cartella – lingua-locale_valuta)

12345 (cartella)

12345_678_mp_FR-CA_CAD.txt.gz

12345_678_mp_delta_FR-CA_CAD.txt.gz

root

ADDITIONAL (cartella)

12345 (cartella – il numero qui è l'ID dell'inserzionista, o MID)

2017Summer (cartella – nome del file Aggiuntivo, come specificato dall'inserzionista)

12345_678_mp_2017Summer.txt.gz

12345_678_mp_delta_2017Summer.txt.gz

Back2School (cartella – nome del file Aggiuntivo, come specificato dall'inserzionista)

12345_678_mp_Back2School.txt.gz

12345_678_mp_delta_Back2school.txt.gz

Scaricare i File del Product Catalog

Puoi scaricare il file del Product Catalog dal tuo account utilizzando qualsiasi software client SFTP. Vedi Iniziare per richiedere l'abilitazione.

Esempio: get 2385_112_mp.txt.gz

I file di prodotto sono generati dinamicamente al momento del recupero. Questo assicura che tutti i publisher ricevano le informazioni sui prodotti più aggiornate quando recuperano i file del Product Catalog degli inserzionisti. La tempestività delle informazioni sui prodotti dipende dalla frequenza con cui gli inserzionisti aggiornano le informazioni nel loro database del Product Catalog.

Iniziare

Tutti i publisher del Product Catalog devono prima registrarsi per diventare membri di Rakuten Affiliate. Se la tua azienda non lo ha ancora fatto, registrati andando su https://rakutenadvertising.com/ e cliccando su Diventa un Publisher. Una volta registrato, riceverai un'email con l'approvazione della registrazione e le informazioni sul tuo nuovo account publisher, insieme al tuo ID sito.

Dovrai quindi seguire il Passo 1 per ottenere l'accesso FTP e il Passo 2 per ottenere l'approvazione degli inserzionisti per utilizzare i loro feed del Product Catalog, come descritto di seguito.

Passo 1: Processo di Configurazione Tecnica

Configurazione SFTP

Il feed del Product Catalog è disponibile tramite SFTP. Il nome host del server SFTP di Rakuten Affiliate è aftp.linksynergy.com.

Per iniziare, contatta il Supporto Clienti con il tuo nome utente Rakuten Affiliate e l'ID sito (SID). Quando invii la tua richiesta per il Product Catalog, vengono eseguiti questi passaggi:

• Stabiliamo un account SFTP unico sui nostri server da cui puoi scaricare i file.
• Viene assegnato un nome utente e una password all'account SFTP.

Entro un giorno lavorativo, un rappresentante del Supporto Clienti risponderà alla tua richiesta con il tuo nome utente, password e l'URL del tuo account SFTP.

Accesso SFTP

Puoi accedere al tuo account SFTP utilizzando qualsiasi client SFTP. Puoi anche automatizzare il processo di download del file o farlo manualmente. Dovresti impostare la modalità di trasferimento su binario prima di iniziare a scaricare i file, poiché i file sono memorizzati in un formato compresso. Utilizzare la modalità ASCII corromperà i dati nel file e lo renderà inutilizzabile. Se stai utilizzando uno script per automatizzare il processo di download dei file, assicurati di non aprire più di cinque connessioni al server SFTP contemporaneamente.

Nota bene:

• Utilizza sempre connessioni passive quando sei connesso a aftp.linksynergy.com con FTP semplice.
• Imposta sempre la modalità su binario prima di scaricare file con FTP semplice.
• Non sono consentite più di cinque connessioni simultanee per account SFTP del publisher.
• Le dimensioni dei file mostrate sono stime. Le dimensioni effettive dei file varieranno. Pertanto, ti consigliamo di NON utilizzare la dimensione del file come controllo per garantire download riusciti. I download dovrebbero essere considerati riusciti se il file viene estratto correttamente e termina con un record di trailer che indica il numero di prodotti nel file.
• Se stai utilizzando uno script per recuperare i file, Wget è preferito rispetto a cURL. Se utilizzi cURL, devi usare l'opzione --ignore-content-length.
• Mentre l'FTP semplice è attualmente supportato, è fortemente consigliato utilizzare SFTP. Il supporto per l'FTP semplice sarà deprecato in futuro.

Contenuti dell'Account SFTP

Nella directory principale del tuo account SFTP, vedrai file e una cartella per ogni inserzionista che ti ha approvato per l'accesso al loro feed del Product Catalog. Potresti anche vedere cartelle intitolate "GLOBAL" e "ADDITIONAL" se uno dei tuoi partner inserzionisti ha più di un feed di prodotti.

I file nella directory principale sono i tuoi file del Product Catalog e le cartelle numerate contengono file che ti forniscono dati sui prodotti per singole categorie di prodotti. Il nome della cartella corrisponde al MID dell'inserzionista e i file sono disponibili in due formati: testo delimitato da pipe e XML.

Puoi selezionare il formato che preferisci nel tuo Publisher Dashboard seguendo questi passaggi:

1. Vai su Link nell'intestazione di navigazione e clicca su Product Feeds.
2. Scorri verso il basso fino a Formato feed preferito per fare la tua selezione:

   Clicca sull'immagine per una versione più grande.

Se non selezioni un formato, il tuo account SFTP conterrà due file e una cartella per ogni inserzionista che ti ha approvato per l'accesso al loro feed del Product Catalog.

Passo 2: Processo di Approvazione del Product Catalog degli Inserzionisti

Una volta completata la configurazione tecnica del Product Catalog, dovrai richiedere l'accesso agli inserzionisti partecipanti con cui sei già partner.

Per visualizzare un elenco dei tuoi partner inserzionisti che offrono il Product Catalog nel tuo Publisher Dashboard, vai su Link nell'intestazione di navigazione e clicca su Product Feeds. Scorri verso il basso per visualizzare l'elenco e cerca gli inserzionisti per nome. Da lì, puoi fare domanda per l'accesso, rimuovere te stesso dall'accesso e visualizzare lo stato della tua domanda:

Clicca sull'immagine per una versione più grande.

Puoi richiedere automaticamente l'approvazione del Product Catalog quando fai domanda per il programma di un nuovo inserzionista partecipante con la nostra opzione di iscrizione automatica. Puoi attivare o disattivare l'iscrizione automatica nella sezione Impostazioni Feed della pagina Product Feeds:

Clicca sull'immagine per una versione più grande.

Domande Comuni

Il mio script scarica i file solo quando la data del file cambia. Funzionerà con il Product Catalog?

Sì, dovresti essere in grado di utilizzare il timestamp del file nella directory, che indica l'ora di creazione in UTC, per vedere cosa è stato modificato e scaricare solo gli elementi più recenti.

Perché ho più file di inserzionisti nel mio account?

Hai la scelta tra un file di testo delimitato da pipe e un file formattato in XML. Puoi selezionare il formato preferito nel tuo Publisher Dashboard, come descritto in Contenuti dell'account SFTP sopra. Se non selezioni un formato, il tuo account SFTP conterrà versioni .txt e .xml di ciascun tipo di file.

Quali sono le cartelle che vedo nel mio account SFTP?

Le cartelle nel tuo account SFTP sono per ciascun inserzionista da cui sei idoneo a ottenere i file del Product Catalog. Le cartelle contengono i file del Product Catalog specifici per categoria degli inserzionisti.

Devo essere approvato da ciascun inserzionista per l'uso del loro feed di dati del Product Catalog?

Sì, ci sono due livelli di approvazione per il Product Catalog. Prima ricevi l'approvazione tecnica, poi hai bisogno dell'approvazione dell'inserzionista. Devi richiedere l'approvazione del Product Catalog quando ti candidi a un nuovo programma di inserzionisti, o richiederla separatamente dai partner inserzionisti esistenti, come dettagliato in Passo 2 sopra.

Cosa dovrei fare se i dati del Product Catalog di un inserzionista sono obsoleti?

È meglio informare direttamente l'inserzionista. Puoi trovare le informazioni di contatto di un inserzionista nel tuo Publisher Dashboard: vai su Inserzionisti nell'intestazione di navigazione, clicca su I Miei Inserzionisti, poi clicca sull'inserzionista rilevante per accedere alla loro pagina dei dettagli.

Se non sei sicuro che ciò di cui ti preoccupi sia un problema di dati obsoleti, contatta il Supporto Clienti.

Appendice A: Definizioni dei Campi del File del Product Catalog

Consulta Appendice A per le definizioni dei campi.

Appendice B: Definizioni delle Classi del File degli Attributi

Consulta Appendice B per le definizioni delle classi del file degli attributi.

Appendice C: Standard di Formattazione XML

Consulta Appendice C per gli standard di formattazione XML.

Appendice D: Esempi di Record

Consulta Appendice D per esempi di record di un file delimitato da pipe e di un file XML.