Specifiche del feed per le promozioni locali

Le informazioni fornite per le promozioni locali vengono distribuite negli annunci locali nella scheda Shopping e sono visibili sia da computer che da dispositivo mobile. A tale scopo, devi caricare un feed delle promozioni contenente informazioni sulle promozioni che svolgi nei negozi. Queste informazioni devono essere accurate e includere tutti gli attributi che utilizzi per descrivere le tue promozioni locali.

Un feed è un file XML, un file delimitato da tabulazioni o un foglio di lavoro Google che viene caricato su Google Merchant Center e può includere più voci. Carica il feed delle promozioni nello stesso account Merchant Center utilizzato per il tuo feed dei prodotti Google. Lo stesso feed può essere utilizzato sia per le promozioni online sia per quelle in negozio.

Questo articolo illustra gli attributi disponibili per un feed delle promozioni specifico per le promozioni locali. Per visualizzare un esempio di feed delle promozioni locali, seleziona il pulsante di seguito.

Scarica feed di esempio

Aspetti da considerare

• Tutte le promozioni vengono sottoposte a revisione in base alle Norme del programma Promozioni e ai relativi requisiti redazionali.
• Ti consigliamo di utilizzare gli attributi dei dati strutturati per le offerte inviate tramite un feed delle promozioni. Scopri di più sugli attributi dei dati strutturati.
• Le offerte relative alla spedizione non sono accettate per le promozioni locali.
• L'invio di un feed delle promozioni non influisce in alcun modo sui tuoi ranking su Google.

Attributi obbligatori

ID promozione [promotion_id]

Si tratta dell'ID univoco di una promozione. Per le promozioni in negozio che si applicano a prodotti specifici, i valori specificati per l'ID promozione nel feed delle promozioni devono corrispondere ai valori dell'ID promozione indicati nel feed dei prodotti. Ciò consente a Google di identificare i prodotti a cui applicare la promozione.

Importante:

• L'ID promozione è sensibile alle maiuscole. Se intendi associare una determinata promozione a un insieme di prodotti presenti nel tuo feed dei prodotti, l'ID deve essere esattamente lo stesso in entrambi i feed.
• L'ID promozione non deve contenere spazi né simboli (ad es. %, ! ecc.).
• Per aggiungere più valori di ID promozione a un articolo (puoi aggiungerne fino a 10 per articolo), specifica i singoli valori separati con una virgola nella colonna "ID promozione" del feed dei prodotti.
• Un ID promozione non può superare i 60 caratteri.

Prodotti idonei alla promozione [product_applicability]

Indica se la promozione è applicabile a tutti i prodotti o solo a prodotti specifici.

Valori validi:

• Tutti i prodotti [all_products]
• Prodotti specifici [specific_products]

Importante:

• Se il valore è impostato su specific_products, per determinare i prodotti oggetto della promozione verranno utilizzati gli attributi relativi al targeting per prodotto (consulta gli attributi facoltativi di seguito per scoprire di più sul targeting per prodotto).
• Se il valore è impostato su all_products, i filtri relativi al targeting per prodotto verranno ignorati.

Codice promozionale richiesto [offer_type]

Questo attributo indica se richiedi o meno agli acquirenti online di utilizzare un codice per usufruire dell'offerta.

Valori validi:

• Nessun codice [no_code]
• Codice generico [generic_code]

Nota: se l'attributo codice promozionale richiesto [offer_type] è impostato su generic_code (ovvero un codice che è uguale per tutti gli acquirenti), è obbligatorio anche l'attributo codice promozionale generico [generic_redemption_code].

Codice promozionale generico [generic_redemption_code]

Questo attributo specifica il codice (esempio: EXTRA20) che gli acquirenti utilizzeranno online per usufruire della promozione.

Importante:

• È obbligatorio se l'attributo codice promozionale richiesto [offer_type] è impostato su generic_code.
• Il valore inviato per l'attributo codice promozionale generico [generic_redemption_code] non deve superare i 20 caratteri.

Titolo della promozione [long_title]

Si tratta del titolo completo della promozione. Questi requisiti redazionali descrivono le linee guida per la redazione e la formattazione dei titoli e forniscono esempi di titoli accettabili e non accettabili.

Importante:

• Il titolo della promozione [long_title] deve descrivere la promozione nella sua interezza e in modo preciso.
• Non deve superare i 60 caratteri.

Data di inizio della promozione [promotion_effective_dates]

Questo attributo indica le date e l'intervallo di tempo in cui sarà attiva la promozione. Sintassi:

• Formato della data: AAAA-MM-GG
• Formato dell'ora: HH:MM:SS, senza includere la correzione pertinente per il fuso orario GMT (vedi di seguito).
  • Gli orari sono basati sul fuso orario GMT (fuso orario di Greenwich). Di conseguenza, devi includere anche la differenza tra il tuo orario e quello GMT, espressa in numero di ore e minuti (+HH:MM o -HH:MM).
    • Ad esempio, se l'ora della tua promozione è nel fuso orario PST (fuso orario del Pacifico), devi aggiungere "-08:00" in quanto il fuso orario PST è 8 ore in anticipo rispetto al fuso orario GMT.
• Date e ore devono essere separate dalla lettera "T".
• Indica prima data di inizio + ora, poi data di fine + ora, separando le due parti con una barra (/).

Esempi:

• Per una promozione valida dalle 03:00 del 19 luglio 2019 alle 21:00 del 26 luglio 2019 EST (fuso orario della costa orientale) verrebbe indicato:
  • 2019-07-19T03:00:00-05:00/2019-07-26T21:00:00-05:00
• Per una promozione valida dalle 03:00 del 19 luglio 2019 alle 21:00 del 26 luglio 2019 GMT (fuso orario di Greenwich) verrebbe indicato:
  • 2019-07-19T03:00:00+00:00/2019-07-26T21:00:00+00:00

Importante:

• Quando opportuno, ricorda di tenere conto dell'ora legale:
  • Quando è in vigore l'ora standard, "-05:00" rappresenta EST, mentre "-08:00" rappresenta PST.
  • Quando è in vigore l'ora legale, "-04:00" rappresenta EDT, mentre "-07:00" rappresenta PDT.

Idoneità alla promozione online [redemption_channel]

Questo attributo indica dove viene offerta la promozione.

Valori validi:

• in_store
• online
• online_and_in_store

Importante:

• Se la tua è una promozione omnicanale (disponibile sia in negozio che online), specifica il valore "online_and_in_store".
• Se questo valore viene lasciato vuoto, per impostazione predefinita la promozione sarà online.
  • Le promozioni online non vengono limitate al raggio regionale del negozio e vengono visualizzate nei tuoi annunci Shopping online.

Applicabilità del negozio [store_applicability]

Questo attributo indica se la promozione è applicabile a tutti i negozi o solo a negozi specifici.

Valori validi:

• all_stores
• specific_stores

Importante:

• Se hai selezionato specific_stores, devi utilizzare anche l'attributo inclusione dei codici negozio [store_codes_inclusion] o l'attributo esclusione dei codici negozio [store_codes_exclusion].
• Se selezioni all_stores, gli attributi inclusione dei codici negozio ed esclusione dei codici negozio (vedi di seguito) verranno ignorati.

URL della promozione [promotion_url]

L'URL della promozione deve essere un link che rimanda alla pagina del tuo sito web in cui i clienti possono trovare i dettagli della promozione. Può essere una pagina del sito web che descrive la promozione, una pagina con il banner promozionale o la pagina in cui è ospitata l'immagine del banner promozionale. Questo link viene utilizzato nell'ambito della procedura di approvazione della promozione per verificare che sia applicabile a livello locale e che sia utilizzabile in negozio o nell'ambito di un ritiro all'esterno. Viene utilizzato anche per verificare che i clienti non debbano compiere ulteriori passaggi per utilizzare la promozione in negozio oltre a esibire un codice coupon o un codice a barre. Le informazioni presenti nella pagina con i dettagli della promozione devono corrispondere ai dati inviati per la promozione.

Destinazione della promozione [promotion_destination]

Questo attributo indica la destinazione della promozione.

Valori validi:

• promotion_destination: local_inventory_ads
• promotion_destination: Shopping_ads
• promotion_destination: Buy_on_Google_listings
• promotion_destination: Free_listings

Attributi correlati al negozio

Inclusione dei codici negozio [store_codes_inclusion]

Questo attributo indica i negozi specifici a cui si applica la promozione.

Importante:

• Se la promozione è valida per specific_stores, elenca i codici negozio così come li hai specificati nei profili dell'attività.
• Puoi utilizzare a scelta l'attributo inclusione dei codici negozio [store_codes_inclusion] o esclusione dei codici negozio [store_codes_exclusion], ma non entrambi contemporaneamente.

Esclusione dei codici negozio [store_codes_exclusion]

Questo attributo indica i negozi specifici esclusi dalla promozione.

Importante:

• Se la promozione esclude specific_stores, elenca i codici negozio così come li hai specificati nei profili dell'attività.
• Puoi utilizzare a scelta l'attributo esclusione dei codici negozio [store_codes_exclusion] o inclusione dei codici negozio [store_codes_inclusion], ma non entrambi contemporaneamente.

Attributi facoltativi

Attributi di targeting per prodotto

Gli attributi di targeting per prodotto sono "filtri" facoltativi che ti consentono di specificare direttamente nel feed delle promozioni locali i prodotti a cui può essere applicata una promozione.

In alternativa, puoi aggiungere l'attributo ID promozione [promotion_id] direttamente ai prodotti tramite il feed dei prodotti.

ID prodotto per la promozione [item_id]

Questo attributo mappa la tua promozione a determinati articoli presenti nel feed dei prodotti.

Se l'attributo prodotti idonei alla promozione [product_applicability] per le tue promozioni è impostato su specific_products, la configurazione dell'attributo ID articolo ti consente di mappare la promozione agli articoli rappresentati dagli ID associati nel tuo feed dei prodotti.

Importante:

• È possibile mappare fino a 20 ID articolo di prodotti a una singola promozione nel feed delle promozioni.
• Non utilizzare l'attributo ID prodotto per la promozione [item_id] se vuoi assegnare la promozione a più di 20 articoli. Aggiungi invece l'ID promozione direttamente agli articoli nel feed dei prodotti.

Categoria prodotto Google [google_product_category]

Questo attributo mappa la tua promozione a una specifica categoria di prodotto nel tuo feed dei prodotti.

Se l'attributo prodotti idonei alla promozione[product_applicability] inviato per la promozione è impostato su specific_products, la configurazione dell'attributo categoria prodotto Google [google_product_category] ti consente di mappare la promozione a una specifica categoria di prodotto Google.

Importante:

• Non impostare questo attributo se sono previste esclusioni all'interno della categoria. In questo caso, dovrai associare manualmente l'attributo ID promozione [promotion_id] agli articoli idonei nel tuo feed dei prodotti oppure utilizzare l'attributo ID prodotto per la promozione [item_id] (vedi sopra) per associare gli articoli idonei nel tuo feed delle promozioni. Per ulteriori dettagli sulla mappatura, consulta l'articolo su come scegliere i prodotti per la promozione nella nostra guida all'implementazione delle promozioni.
• Le categorie di livello più elevato, come Abbigliamento e accessori (166) o Media (783), non sono supportate. Se i tuoi prodotti rientrano in una di queste categorie, dovrai fornire una categoria più granulare. Ad esempio: Abbigliamento e accessori > Abbigliamento > Abbigliamento per attività fisica > Abbigliamento sportivo da ciclista (5697).

Tipo di prodotto [product_type]

L'attributo tipo di prodotto mappa la tua promozione a uno o più tipi di prodotto specifici nel tuo feed dei prodotti.

Se l'attributo prodotti idonei alla promozione [product_applicability] inviato per la promozione è impostato su specific_products, la configurazione dell'attributo tipo di prodotto [product_type] ti consente di mappare la promozione a uno o più tipi di prodotto.

Importante:

• Non impostare questo attributo se sono previste esclusioni all'interno dei tipi di prodotto. In questo caso, dovrai associare manualmente l'attributo ID promozione [promotion_id] agli articoli idonei nel tuo feed dei prodotti oppure utilizzare l'attributo ID prodotto per la promozione [item_id] (vedi sopra) per associare gli articoli idonei nel tuo feed delle promozioni (fino a 20 articoli). Per ulteriori dettagli sulla mappatura, consulta l'articolo su come scegliere i prodotti per la promozione nella nostra guida all'implementazione delle promozioni.

Marca [brand]

L'attributo marca mappa la tua promozione a una marca specifica nel tuo feed dei prodotti.

Se l'attributo prodotti idonei alla promozione [product_applicability] è impostato su specific_products, la configurazione dell'attributo marca ti consente di mappare la promozione a una selezione di marche.

Importante:

• Puoi specificare fino a 10 marche. Separa ogni marca specificata con una virgola.
• Gli attributi marca sono sensibili alle maiuscole e all'uso degli spazi e devono corrispondere esattamente all'ortografia utilizzata nel feed dei prodotti.
• Non impostare questo attributo se sono previste esclusioni all'interno delle marche interessate. In questo caso, dovrai associare manualmente l'attributo ID promozione [promotion_id] agli articoli idonei nel tuo feed dei prodotti oppure utilizzare l'attributo ID prodotto per la promozione [item_id] (vedi sopra) per associare gli articoli idonei nel tuo feed delle promozioni (fino a 20 articoli). Per ulteriori dettagli sulla mappatura, consulta l'articolo su come scegliere i prodotti per la promozione nella nostra guida all'implementazione delle promozioni.

ID articolo escluso [item_id_exclusion]

L'attributo ID articolo escluso ti consente di escludere dalla promozione articoli specifici del tuo feed dei prodotti.

Se l'attributo prodotti idonei alla promozione [product_applicability] inviato per la promozione è impostato su specific_products, la configurazione dell'attributo ID articolo escluso [item_id_exclusion] mapperà la promozione a tutti gli ID articolo presenti nel feed dei prodotti, ad eccezione di quelli indicati qui.

Esclusione della categoria prodotto Google [google_product_category_exclusion]

L'attributo esclusione della categoria prodotto Google ti consente di escludere dalla promozione tutti gli articoli del feed dei prodotti che appartengono a una categoria di prodotto specifica.

Se l'attributo applicabilità del prodotto della promozione [product_applicability] è impostato su specific_products, la configurazione dell'attributo esclusione della categoria prodotto Google escluderà dalla promozione tutti gli articoli presenti nel tuo feed dei prodotti che hanno la stessa categoria di prodotto.

Importante:

• Non impostare questo attributo se sono presenti articoli idonei nella categoria. In questo caso, dovrai associare manualmente l'attributo ID promozione [promotion_id] agli articoli idonei nel tuo feed dei prodotti oppure utilizzare l'attributo ID prodotto per la promozione [item_id] (vedi sopra) per associare gli articoli idonei nel tuo feed delle promozioni (fino a 20 articoli). Per ulteriori dettagli sulla mappatura, consulta l'articolo su come scegliere i prodotti per la promozione nella nostra guida all'implementazione delle promozioni.

Tipi di prodotti esclusi [product_type_exclusion]

L'attributo tipi di prodotti esclusi ti consente di escludere dalla promozione uno o più tipi di prodotto presenti nel tuo feed dei prodotti.

Se l'attributo prodotti idonei alla promozione [product_applicability] inviato per la promozione è impostato su specific_products, la configurazione dell'attributo tipi di prodotti esclusi [product_type_exclusion] escluderà dalla promozione tutti gli articoli presenti nel feed dei prodotti che ricadono nei tipi di prodotto in questione.

Importante:

• È possibile specificare fino a 10 tipi di prodotto. Separa ogni tipo di prodotto specificato con una virgola.
• Non impostare questo attributo se sono presenti articoli idonei nei tipi di prodotto. In questo caso, dovrai associare manualmente l'attributo ID promozione [promotion_id] agli articoli idonei nel tuo feed dei prodotti oppure utilizzare l'attributo ID prodotto per la promozione [item_id] (vedi sopra) per associare gli articoli idonei nel tuo feed delle promozioni (fino a 20 articoli). Per ulteriori dettagli sulla mappatura, consulta l'articolo su come scegliere i prodotti per la promozione nella nostra guida all'implementazione delle promozioni.

Marche escluse [brand_exclusion]

L'attributo marche escluse ti consente di escludere dalla promozione una o più marche presenti nel tuo feed dei prodotti.

Se l'attributo prodotti idonei alla promozione [product_applicability] inviato per la promozione è impostato su specific_products, la configurazione dell'attributo marche escluse [brand_exclusion] escluderà dalla promozione tutti gli articoli presenti nel feed dei prodotti che appartengono alle marche in questione.

Importante:

• Puoi specificare fino a 10 marche. Separa ogni marca specificata con una virgola.
• Gli attributi marca sono sensibili alle maiuscole e all'uso degli spazi e devono corrispondere esattamente all'ortografia utilizzata nel feed dei prodotti.
• Non impostare questo attributo se sono presenti articoli idonei all'interno delle marche. In questo caso, dovrai associare manualmente l'attributo ID promozione [promotion_id] agli articoli idonei nel tuo feed dei prodotti oppure utilizzare l'attributo ID prodotto per la promozione [item_id] (vedi sopra) per associare gli articoli idonei nel tuo feed delle promozioni (fino a 20 articoli). Per ulteriori dettagli sulla mappatura, consulta l'articolo su come scegliere i prodotti per la promozione nella nostra guida all'implementazione delle promozioni.

Tag della promozione [promotion_tags]

L'attributo tag della promozione ti consente di specificare dei sottoinsiemi di categorie di prodotti, tipi di prodotti e marche a cui verrà applicata la promozione. Questo attributo può essere impostato in coppia con gli attributi elencati in precedenza e i relativi valori specifici per specificare un sottoinsieme di articoli all'interno del feed dei prodotti.

Sintassi:

• Chiavi accettabili: google_product_category, product_type, brand
• Formato: {attributo1: "valoreA", attributo2: "valoreB"}
• La lunghezza massima è di 500 caratteri.

Esempio:

• {brand: "Nike", google_product_category: "Abbigliamento e accessori > Scarpe"}

Importante:

• L'attributo tag della promozione [promotion_tags] deve essere utilizzato quando la promozione si applica a un sottoinsieme (non alla totalità) degli articoli appartenenti a una categoria, a un tipo o a una marca e se gli ID articolo specifici non sono noti.

TORNA ALLA HOME PAGE DI PROMOZIONI