Esegui la migrazione alle etichette dei feed

Ti contattiamo per presentarti la versione beta dell'API Merchant. È la nuova versione dell'API Content e quella futura.

Puoi utilizzare il campo feedLabel per aggiungere un'etichetta ai prodotti e ai feed di dati.

Le etichette dei feed possono avere il seguente formato:

• Digita stringa
• Meno di 20 caratteri
• Lettere maiuscole (A-Z)
• Numeri (0-9)
• Trattini (-)

feedLabel è disponibile nelle seguenti risorse:

• products
• datafeeds
• datafeedstatuses

ID REST

feedLabel sostituisce targetCountry negli ID REST per i nuovi prodotti.

Al posto di online:language:targetCountry:offerId, l'ID REST ha ora il formato online:language:feedLabel:offerId per i nuovi prodotti. L'ID REST dei prodotti esistenti non viene modificato.

Scarica ed elenca prodotti

Il campo feedLabel viene sempre compilato per tutti i prodotti restituiti.

Se feedLabel è un codice di territorio CLDR valido, viene eseguito automaticamente il backfill del campo targetCountry per garantire la compatibilità. Se feedLabel non è un codice di territorio CLDR valido, lasciamo il campo targetCountry vuoto.

Avviso: i valori targetCountry sottoposti a backfill non consentono la pubblicazione dei prodotti nel paese specificato. Assicurati che tutti i paesi che vuoi scegliere come target siano inclusi nel campo shipping.

Le stesse modifiche si applicano a productstatuses endpoint.

I campi specifici del paese sono vuoti per le offerte con un feedLabel che non sia un codice di territorio CLDR.

Inserire e aggiornare i prodotti

Per inserire nuovi prodotti è necessario feedLabel o targetCountry. Se inserisci o aggiorni i prodotti con feedLabel e targetCountry, i loro valori devono corrispondere.

Ricevi un errore dall'API se i campi sono entrambi vuoti o se i relativi valori non corrispondono.

Per ulteriori dettagli, consulta Utilizzare le etichette dei feed per pubblicizzare i prodotti di feed specifici.

Targeting per paese

Utilizza una delle seguenti opzioni per assicurarti che i tuoi prodotti siano destinati ai paesi corretti:

• Campo shipping della risorsa products
• Campo targetCountries della risorsa datafeeds

Prodotti

Il campo targetCountry per products è obsoleto. Utilizza invece il campo shipping per specificare i paesi di destinazione.

Se vuoi scegliere come target più paesi, puoi continuare a utilizzare shipping per aggiungere altri paesi.

Per ulteriori informazioni, consulta la sezione Targeting degli annunci in più paesi.

Feed di dati

Ora puoi vedere in quali paesi viene scelto esplicitamente come target datafeed in targets. Questo si applica quando utilizzi feedLabel anziché country nella configurazione datafeedtarget.

Abbiamo anche aggiunto il campo targetCountries per datafeeds, in modo che tu possa configurare il targeting direttamente per datafeeds. Puoi comunque configurare il targeting all'esterno del feed, ad esempio impostando l'attributo shipping della risorsa di prodotti.

Conversione da Regno Unito a GB

Al momento consentiamo il valore UK per il campo targetCountry anche se non è un codice paese valido. Convertiamo automaticamente UK in GB. I prodotti con UK come targetCountry vengono archiviati con GB nell'ID REST e offerId.

Se imposti UK come valore per feedLabel, questo non viene convertito automaticamente in GB. UK e GB sono stringhe diverse per feedLabel e creano offerte diverse.

Se inserisci un valore targetCountry di UK e lo convertiamo in GB, devi aggiornare l'ID REST del prodotto in modo da includere GB anziché UK per recuperare il prodotto con il metodo get.