> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md).

# Aggiungi cataloghi prodotti come brand

Un catalogo prodotti è un feed di dati che contiene un elenco dei tuoi prodotti e dei relativi metadati. Viene comunemente usato se vendi prodotti online, ma può essere usato anche in altri settori, come carte di credito, viaggi, annunci immobiliari e altro ancora. Molti brand creano un catalogo prodotti tramite la propria soluzione di e-commerce (o carrello acquisti), che può essere esportata e condivisa con impact.com.

Quando aggiungi un catalogo prodotti retail, ci sono una serie di passaggi che devi completare, che aiutano a mettere in risalto le tue offerte, migliorare l'esperienza del cliente e semplificare il processo di acquisto. Segui i passaggi seguenti:

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F1diRYN9k9QfiHhDHlZMK%2Feng-350-6.mp4?alt=media&token=417e2657-d1ae-4bce-a600-f7e6572d4322>" %}

## Prepara il tuo catalogo per il caricamento

Fai quanto segue per configurare il tuo catalogo per ottenere la migliore visibilità e performance possibile.

{% stepper %}
{% step %}

### Assicurati che siano soddisfatti i requisiti di visibilità del Marketplace

1. Ogni prodotto nel file del catalogo deve includere dati completi per i seguenti campi critici, altrimenti potrebbe essere escluso dalle superfici del Marketplace come il Product Marketplace e l'app mobile:
   * SKU / `CatalogItemId`
   * `URL del prodotto`
   * `URL dell'immagine`
   * `Disponibilità di magazzino`
   * `Prezzo` (verranno mostrati solo i prodotti con prezzo > $2,00 USD)
     * Vedi [Requisiti dei campi del catalogo prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-field-requirements.md) per l'elenco completo dei campi.
2. Per evitare errori di convalida non necessari e assicurarti di avere tutti i campi richiesti, è inoltre consigliabile allineare il file del catalogo con i nostri [Best practice per i cataloghi prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) prima di continuare.
   {% endstep %}

{% step %}

### Controlla le impostazioni pubblicitarie del tuo programma

Prima di aggiungere cataloghi prodotti al tuo programma, assicurati che siano abilitati nelle impostazioni pubblicitarie. I partner non potranno visualizzare i tuoi cataloghi prodotti se questa impostazione non è abilitata.

1. Dalla barra di navigazione superiore, seleziona ![](/files/c0279a0e9c22a5b78cc1bbb3be84cac24b0fd825) **\[Profilo utente] → Impostazioni**.
2. Nella colonna di destra, sotto *Generale*, seleziona [**Impostazioni annunci**](https://app.impact.com/secure/advertiser/campaign/campaign-ad-settings-flow.ihtml).
3. Nella *Tipi di annunci* sezione, sotto *Cataloghi prodotti*, assicurati che ![](/files/2ae7e003a150c6a3bb698feb3db565445cc63b94) **\[Casella selezionata]** **Abilita i cataloghi prodotti per questo programma** sia selezionato.
4. Seleziona **Salva**.
   {% endstep %}
   {% endstepper %}

## Collega il tuo catalogo

Fai quanto segue per aggiungere il tuo catalogo a impact.com e rendere i suoi prodotti disponibili per la promozione.

{% stepper %}
{% step %}

### Carica il tuo catalogo prodotti

1. Dalla barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage]** → **Contenuti** → **Prodotti** → [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Nell'angolo in alto a destra, seleziona **Crea catalogo prodotti** **Risorsa** → **Vendita al dettaglio**.
   * Per i cataloghi di carte di credito, vedi [Aggiungi cataloghi di carte di credito](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-credit-card-catalogs-as-a-brand.md).
3. Inserisci un **Nome catalogo prodotti** (è così che i tuoi partner lo cercheranno).
4. Facoltativamente, inserisci **Etichette** che i partner possono usare per cercare questo catalogo prodotti.
5. Facoltativamente, carica un documento PDF con *Istruzioni del catalogo* in modo che i partner comprendano come navigare nel tuo catalogo prodotti.
6. Seleziona un metodo di caricamento per il tuo catalogo prodotti (i metodi sono elencati in ordine di raccomandazione):
   * **Recupera da URL**: impact.com recupererà il catalogo dal tuo server.
   * **Importazione carrello acquisti integrata**: impact.com recupererà il catalogo dal tuo carrello acquisti.
   * **Server FTP di Impact**: carichi il file sul nostro server FTP.
   * **Server SFTP di Impact**: un metodo di caricamento specializzato riservato solo a integrazioni specifiche.
   * **Caricamento diretto**: carichi manualmente il file del catalogo ogni volta che vuoi aggiornarlo.
7. Se applicabile, seleziona un **Formato**. In caso contrario, seleziona **Importazione carrello acquisti integrata**.

{% tabs %}
{% tab title="Formato" %}

1. Seleziona il ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[Menu a discesa]**, quindi seleziona un formato.
2. Inserisci il **Nome file di caricamento** per il catalogo prodotti con la relativa estensione del file. Il nome inserito qui deve corrispondere al nome del file che carichi.
   * Ad es., `starks_catalog.xml`, `starks_catalog.txt`, `starks_catalog.csv`.
   * Se utilizzi un file CSV, sostituisci gli spazi nei nomi dei campi con i trattini bassi.

| Formato                           | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Google Merchant Center**        | impact.com attualmente supporta i [formati basati su testo](https://support.google.com/merchants/answer/7052112) (file TXT delimitati da tabulazioni, non file CSV), oltre a [file XML](https://support.google.com/merchants/answer/14987622) (RSS e Atom).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Formato personalizzato**        | <p>impact.com supporta anche cataloghi in formato personalizzato. Puoi caricare file nei formati .XML, .TXT, .CSV e .PSV.</p><p>1. Specifica il <strong>campo URL del link, campo ID elemento catalogo e campo nome</strong> nelle rispettive caselle di testo. Questi campi sono obbligatori.</p><p>2. Compila i <strong>ID elemento catalogo</strong> e <strong>Nome</strong> campi obbligatori.</p><ul><li>Visualizza i <a href="https://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">campi del file in formato personalizzato</a> per l'elenco completo dei campi.</li><li>Vedi l'esempio seguente dei formati da seguire quando inserisci i dettagli del prodotto.</li></ul><p>3. Facoltativamente, puoi aggiungere campi personalizzati al tuo catalogo prodotti. Seleziona <strong>Aggiungi un altro campo</strong>, quindi seleziona il <img src="/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8" alt=""> <strong>\[Menu a discesa]</strong> e seleziona un'opzione.</p><ul><li>Consulta il <a href="https://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">campi del file in formato personalizzato</a> per saperne di più sulle opzioni nel menu a discesa.</li></ul> |
| **eBay Commerce Merchant Center** | impact.com supporta sia i formati basati su testo (.TXT e .CSV) sia i formati XML per eBay Commerce. Quando usi un file .CSV, assicurati di sostituire gli spazi nella colonna Field con i trattini bassi. Puoi anche visualizzare i campi del file merchant di eBay Commerce [qui](https://docs.google.com/spreadsheets/d/1np1YixxczH_IZBxer-EckMkAdcV9_lp74RQAtI-1Ct0/edit?usp=sharing).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Connexity Merchant Center**     | impact.com attualmente supporta le versioni dei file .TXT e .CSV di [cataloghi prodotti di Connexity](https://connexity.jitbit.com/helpdesk/KB/View/8469181-required-data-feed-fields-and-template). Dopo aver generato il tuo catalogo prodotti, puoi caricarlo su impact.com.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **CJ Affiliate by Conversant**    | impact.com supporta vari formati per [cataloghi prodotti CJ Affiliate](https://developers.cj.com/docs/data-imports/product-feeds), inclusi file .TXT, .CSV, .PSV e .XML nella *Specifiche del feed prodotti: Shopping (formato Google)* sezione. Dopo aver generato il tuo catalogo prodotti, puoi caricarlo su impact.com.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

{% hint style="info" %}
**Esempio**

```programlisting
name,id,url,manufacturingcost,mycurrency,mycategory
ACME Bird Seed,1234567,http://example.com/products,20,USD,Accessories
```

{% endhint %}
{% endtab %}

{% tab title="Importazione carrello acquisti integrata" %}

1. Seleziona il tuo **carrello acquisti** soluzione:
   * **Shopify**, **Magento**, **BigCommerce**, **WooCommerce**, **Demandware**, **Shoplazza**, oppure **Amazon**.
2. Inserisci i tuoi dati di accesso all'e-commerce. Seleziona qui sotto la tua soluzione di e-commerce per informazioni su dove trovare questi dati:<br>

   **Shopify**

   Consulta la nostra guida sul [Catalogo prodotti Shopify](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog) per scoprire come trovare e configurare le tue credenziali.

   1. Inserisci il **URL base** del tuo negozio.
      * Ad es., `https://www.acmeacademy.com`.
   2. Inserisci il tuo **token di accesso**.
      * Scopri come ottenere il tuo [token di accesso](https://shopify.dev/docs/api/storefront/latest/objects/CustomerAccessToken).
   3. Facoltativamente, inserisci un **ID collezione**.
   4. Facoltativamente, ![\[Toggle on\]](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-84d1224fd3bb6ba94b899febe2021eaa.svg) **\[Attiva]** **Includi varianti di prodotto** per filtrare le varianti.

   **Magento**

   1. Inserisci il **URL base** del tuo negozio.
      * Ad es., `https://www.acmeacademy.com`.
   2. Per il **Consumer Key**, **Consumer Secret**, **token di accesso**, e **Access Token Secret**, accedi alle tue [chiavi e token di autenticazione](https://devdocs.magento.com/guides/v2.3/get-started/authentication/gs-authentication-token.html).

   **BigCommerce**

   1. Inserisci il tuo **Hash negozio**.
   2. Inserisci il tuo **token di accesso**.
      * Dovrai [creare un account API a livello di negozio](https://support.bigcommerce.com/s/article/Store-API-Accounts) in BigCommerce e usare il token di accesso generato per collegare il tuo catalogo prodotti. Questo è un esempio delle credenziali API di BigCommerce che riceverai:

        ```programlisting
        Client ID: h81bpnt123hrx3crd219ebxyr3dsou1
        Client secret: edbdc3c61dd6030909a5ea6a4c8123456a2824b41536bee6274b27a17fcbe5f8
        Access token: mv05yxg8ji49cdboa5wc8vpx1un1234
        ```
      * Per gli scope API a livello di negozio, imposta entrambi *Prodotti* e *Informazioni e impostazioni* come sola lettura. Tutti gli altri scope possono essere lasciati invariati.

   **WooCommerce**

   1. Inserisci il **URL base** del tuo negozio.
      * Ad es., `https://www.acmeacademy.com`.
   2. Inserisci il tuo **Nome utente API** e **Password**.

      * **nome utente API** — inserisci la tua *Consumer Key* qui
      * **password API** — inserisci la tua *Consumer Secret* qui

      Scopri come [generare le tue chiavi](https://woocommerce.com/document/woocommerce-rest-api/#generate-api-keys). Dovrai anche abilitare [API REST legacy](https://woocommerce.com/document/woocommerce-rest-api/#enable-legacy-rest-api).

   **Demandware**

   1. Inserisci il tuo **URL base** e **ID sito**. Saranno gli stessi. Scopri come ottenere il tuo [ID sito](https://documentation.b2c.commercecloud.salesforce.com/DOC1/index.jsp?topic=%2Fcom.demandware.dochelp%2FDWAPI%2Fscriptapi%2Fhtml%2Fapi%2Fclass_dw_system_Site.html).
      * Ad es., `https://www.acmeacademy.com`.
   2. Scopri come ottenere le [credenziali di nome utente e password API](https://developer.salesforce.com/docs/commerce/b2c-commerce/references/b2c-commerce-ocapi/get-started-with-ocapi.html).

   **Shoplazza**

   1. Inserisci il **URL base** del tuo negozio.
      * Ad es., `https://www.acmeacademy.com`.
   2. Inserisci il tuo **token di accesso**.
      * Scopri come ottenere il tuo [token di accesso](https://www.shoplazza.dev/reference/overview-23).
   3. Facoltativamente, specifica un **ID collezione** per aggiungere solo prodotti da un [collezione prodotti Shoplazza](https://www.shoplazza.dev/reference/collection-list).

   **Amazon**

{% hint style="warning" %}
**Attenzione:** L'integrazione del carrello acquisti Amazon è attualmente riservata ai brand con [abbonamenti Seller](/brand/it/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) e non è una funzionalità self-service.
{% endhint %}

Se il tuo catalogo Seller contiene più di 1.000 prodotti, usa uno dei metodi manuali di [caricamento file](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand#format) per importarli invece. L'importazione automatica del catalogo è limitata a 1.000 prodotti a causa delle restrizioni dell'API di Amazon.
{% endtab %}
{% endtabs %}

8. Dai ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[Menu a discesa],** seleziona **Lingua** e **Valuta** in cui il catalogo verrà visualizzato per i partner.
9. Usa i ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[Menu a discesa]** per selezionare **Aree di servizio** per il geo-targeting.

   * Le tue *Disponibili* aree sono le aree di servizio target del tuo programma. Puoi modificarle nelle impostazioni del programma come segue:<br>

   ### Gestisci le aree di servizio disponibili

   * Dalla barra di navigazione superiore, seleziona ![](/files/c0279a0e9c22a5b78cc1bbb3be84cac24b0fd825) **\[Profilo utente]** **→ Impostazioni**.
   * Sotto *Generale* nella colonna di destra, seleziona [**Profilo Marketplace**](https://app.impact.com/secure/advertiser/campaign/view-edit-campaign-flow.ihtm).
   * Sotto *Informazioni sul programma*, vai a *Aree di servizio*.
   * Usa i ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[Menu a discesa]** e ![](/files/34db5bf563ca95521c0d0f996a5e41c1ec498a75) **\[Caselle non selezionate]** per selezionare o deselezionare le aree di servizio secondo necessità.
   * Una volta terminato, seleziona **Salva**.<br>
10. Facoltativamente, puoi gestire il tuo catalogo prodotti tramite API. Fai riferimento a [Panoramica cataloghi](https://integrations.impact.com/brand-api-reference/reference/catalogs).
11. Facoltativamente, configura il fallback mobile.<br>

    ### Configura fallback mobile

    Puoi configurare il fallback mobile nei tuoi cataloghi prodotti. Questa opzione consente di indirizzare il traffico alle tue app mobili, permettendo ai partner di usare annunci generici per una singola app su molte piattaforme.

    1. Nella *Fallback app mobile* sezione, ![](/files/bcb6da087265fb9beef85997a54e50203691b8d1) **\[Attiva] Fallback mobile**.
       * In alternativa, trova un catalogo prodotti esistente e seleziona **Modifica**.
    2. Dai ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[Menu a discesa]** opzioni sotto *Android* e *iOS*, seleziona un'opzione di fallback per ciascuna piattaforma. Questa selezione verrà quindi compilata con l'URL per scaricare la tua app.
       * impact.com rileverà automaticamente il tipo di dispositivo del consumatore e lo indirizzerà all'app store appropriato per scaricare la tua app una volta configurato il fallback mobile.
    3. Seleziona **Salva**.<br>
12. Seleziona **Salva**.
13. Facoltativamente, per limitare quali partner possono accedere a questo catalogo prodotti, ![](/files/bcb6da087265fb9beef85997a54e50203691b8d1) **\[Attiva] Limita accesso partner**, quindi inserisci i nomi di *Partner* e partner *Gruppi* che devono avere accesso.
14. Seleziona quali *Opzioni di download per i partner* vuoi rendere disponibili per questo catalogo. Le opzioni che puoi abilitare includono **FTP**, **API**, oppure **Download dal browser del Portale Partner**
15. Seleziona **Salva** per creare la voce del catalogo prodotti e passare alla schermata di caricamento (per i caricamenti diretti).
    * Altrimenti, se non stai aggiungendo il tuo catalogo tramite *Caricamento diretto*, tornerai alla *Cataloghi prodotti* schermata e continuerai il processo seguente.
      {% endstep %}

{% step %}

### Esamina e risolvi i problemi di salute del catalogo

Ogni catalogo prodotti ha un punteggio di salute che evidenzia eventuali problemi. Per raggiungere il livello *eccellente* risolvi errori, avvisi e duplicati.

1. Dal menu di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Contenuti → Prodotti →** [**Cataloghi prodotti**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Se un catalogo presenta errori, avvisi o righe duplicate, vedrai quanti ce ne sono nella colonna *Salute* .
   * **In attesa** - Il tuo catalogo è in fase di caricamento.
   * **In elaborazione** - Il tuo catalogo è in fase di elaborazione.
   * **Eccellente** - Il tuo catalogo è in salute. Questo set di dati di prodotto è completo e ben strutturato, offrendogli le migliori possibilità di ottenere buone prestazioni.
   * **Buono** - Alcuni campi cruciali, come categoria o stato, potrebbero mancare. Correggere questo è necessario per migliorare la qualità complessiva del catalogo.
   * **Scarso** - Manca più del 10% delle informazioni richieste. Il catalogo deve essere corretto e ricaricato.
3. Seleziona *errori*, *avvisi*, oppure *duplicati* per visualizzare le righe con problemi.
   * Solo il primo elemento di un insieme di duplicati verrà rappresentato in impact.com; tutti gli elementi duplicati rispetto al primo verranno ignorati.
4. Affronta i problemi, usando [Risolvi errori e avvisi del catalogo prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md) come guida. Quindi ricarica il catalogo su impact.com usando lo stesso metodo che hai utilizzato per caricare il catalogo originale.
   * I metodi di caricamento che recuperano automaticamente il catalogo dovrebbero aggiornarsi automaticamente al successivo evento di recupero.

{% hint style="warning" %}
**Suggerimento importante:** Per assicurarti che il tuo catalogo sia configurato per ottenere la migliore visibilità e performance possibile, consulta [Best practice per i cataloghi prodotti](/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md).
{% endhint %}
{% endstep %}

{% step %}

### Rendi disponibili i cataloghi ai partner

Dopo aver aggiunto il catalogo e averne controllato la salute, passa al passaggio finale per renderlo disponibile ai tuoi partner e assicurarti che i tuoi prodotti siano presenti nel Product Marketplace. Questo potrebbe attirare più candidature al programma. Valuta [la creazione di flussi di lavoro](/brand/it/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications.md) per automatizzare la gestione delle candidature al programma.

1. Dai [*Cataloghi prodotti*](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) schermata, trova il catalogo appena aggiunto.
2. Passa con il mouse sul catalogo appena aggiunto, a destra seleziona ![](/files/6a36670a9e3518128f7130049c54b7a9613f756b) **\[Altro]** → **Rendi disponibile per l'uso**.<br>

   <div data-gb-custom-block data-tag="hint" data-style="success" data-icon="circle-info" class="hint hint-success"><p><strong>Nota:</strong> Per abilitare i link diretti ai prodotti, aggiungi il dominio della pagina di destinazione del prodotto come dominio abilitato ai deep link nella <a href="/pages/805487ac078074bca1570de5bbab39afb298c3c4"><em>Consenti ai partner di creare deep link a pagine specifiche del mio sito</em></a> sezione delle impostazioni di tracciamento.</p></div>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
