> For the complete documentation index, see [llms.txt](https://helpcenter.channable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.channable.com/import-data/import-data-it/guida-allimportazione/importa-i-dati-dei-prodotti/importa-tramite-un-webshop/akeneo.md).

# Akeneo

En questo articolo imparerai come importare i dati dei tuoi prodotti de Akeneo su Channable.

### Prima di iniziare

Ti servirà

* Un Account Akeneo
* si vuoi includere immagini nelle inserzioni: condivisione immagini integrata en Akeneo o un'Applicazione di tercero parti come TwicPics

{% hint style="info" %}
Channable supporta l'importazione integrata de immagini de Akeneo. Supportiamo ancora TwicPics si vuoi mantenere la tua Configura Actual.
{% endhint %}

{% stepper %}
{% step %}

### Crear una nuova connessione en Akeneo

* Accedi Para il tuo Account Akeneo.
* Vai Para **Connetti > Impostazioni della connessione > Crear**.<br>

  <figure><img src="/files/7e276c0833914a28a353f69e4524e291e1ea87c2" alt=""><figcaption></figcaption></figure>
* Crear la tua connessione Channable:

  * Per **Etiqueta**, chiama la tua connessione "Channable".
  * Per **Codice**, questo dovrebbe essere compilato automaticamente dopo aver creato la tua etichetta. Se non lo è, inserisci "channable".
  * Per **Tipo di flusso**, impostalo su **Destinazione dei dati**.
  * Fai clic **Salva**. Verrai reindirizzato a una pagina con le credenziali di connessione.
  * Prendi nota del tuo **ID cliente**, **Segreto**, **Nome utente** y **Password**, poiché ti serviranno en un passaggio successivo.
  * Per **Permisos**, assicurati che il **Ruolo** è impostato Para **Api** y **Gruppo** è impostato Para **Api Connessioni**.

  ![Akeneo - Connection-Impostazioni.png](/files/e1b78a5080384eb5303b98ee63115dde011e9f35)
  {% endstep %}

{% step %}

### Imposta arriba l'importazione delle immagini

Si vuoi importare le immagini dei prodotti, puoi usar la condivisione immagini integrata di Akeneo o TwicPics.

{% tabs %}
{% tab title="Importazione immagini integrata" %}
Para importare le immagini senza un plugin di tercero, attiva **Link di condivisione** en Akeneo per ogni famiglia di asset che contiene le immagini che vuoi Para importare.

1. En Akeneo, vai Para **Asset > Modifica famiglia > Proprietà**.
2. Attiva **Link di condivisione** per la famiglia di asset pertinente.
3. Assicurati che le immagini dei prodotti che vuoi Para importare appartengano a quella famiglia di asset.

Una volta **Link di condivisione** è abilitato, Channable rileva automaticamente le immagini de Akeneo CDN y le importa come una Lista de URL.
{% endtab %}

{% tab title="TwicPics" %}
Se già usar TwicPics, puoi continuare a usarlo.

1. Segui la guida Configura di TwicPics Akeneo: <https://www.twicpics.com/docs/integrations/akeneo#connect-your-pim-with-akeneo-twicpics-app>
2. Dopo aver creato il tuo account y aver seguito i passaggi, vai Para **Spazi di lavoro** y fai clic sul tuo dominio en **Domini preferiti**.
3. Assicurati di avere un percorso a cui non viene aggiunto nulla y il percorso è `/`.

Esempio: una configurazione corretta in cui 1) è il **dominio**, 2) è il **percorso**, y 3) è il **target**.

![Test Akeneo.png](/files/80b2c88b39d3f9e12280636cfae0616f532f342c)

4. Prendi nota del tuo **Dominio TwicPics**, poiché potresti averne bisogno en passaggio successivo.
   {% endtab %}
   {% endtabs %}
   {% endstep %}

{% step %}

### Crear la tua connessione Akeneo en Channable

1. Apri il progetto che vuoi usare per importare i dati dei prodotti.
2. Vai Para **Configura > Importazione** y fai clic **+ Scegli il metodo di importazione**. Selecciona **Akeneo**.
3. Fai clic **Aggiungi una nuova connessione** o Selecciona una connessione esistente.&#x20;
4. Compila en questa sezione le informazioni richieste:
   * Per **Etiqueta**, assegna al tuo canale di importazione un nome descrittivo, per esempio Akeneo.
   * Per **URL di Akeneo**, inserisci l'URL del tuo webshop Akeneo (si trova en Pannello attività di Akeneo)
   * Per **ID cliente**, compila en il campo **ID cliente** che hai annotato prima.
   * Per **Segreto client**, compila en il campo **Segreto** che hai annotato prima.
   * Per **Nome utente**, compila en il campo **Nome utente** che hai annotato prima.
   * Per **Password**, compila en il campo **Password** che hai annotato prima.
   * , si usar TwicPics, inserisci **Dominio TwicPics** con il dominio che hai annotato nel passaggio precedente.
5. Fai clic **Connetti con Akeneo**. Questo ti porta Para le impostazioni di importazione.
   * Per **Nombre**, assegna al tuo import da Akeneo un nome descrittivo, per esempio Akeneo FR.
   * Per **Scegli la lingua**, seleziona la lingua en cui si trovano i dati del prodotto.
6. Fai clic **Avvia importazione**. Verrai reindirizzato Para il **Mappatura di importazione** Pagina Para la mappatura delle informazioni sui tuoi prodotti.
   {% endstep %}

{% step %}

### Mappatura di importazione

Questa pagina mostra i campi di importazione (campi recuperati de il tuo sito Akeneo — ad esempio prezzo, Descripción, titolo), y i campi del progetto corrispondenti (i campi standardizzati di Channable, da usar Para semplificare la configurazione dei canali).

{% hint style="info" %}
**Nota:** Il nostro sistema rileverà y mapperà automaticamente la maggior parte dei campi di importazione Para i nostri campi standardizzati, ma è importante rivederli y modificarli prima di importarli.
{% endhint %}

Akeneo ha ricche opzioni di organizzazione. A volte questo significa che un campo (ad esempio le descrizioni dei prodotti) ha múltiples varianti per lingue o ambiti diversi. Per far funzionare i dati prodotto di Akeneo su diversi canali, “unnestiamo” questi campi — prendendo tutti gli abbinamenti unici y assegnando loro un Campo. Usar un underscore (\_) Para collegare le diverse parti.

Esempio: Campo Descripción suddiviso Para tenere conto de localizzazioni y ambiti diversi.

{% hint style="info" %}
Si l'importazione integrata delle immagini è abilitata en Akeneo, Channable importa quelle immagini come una Lista de URL.
{% endhint %}

{% hint style="info" %}
**Prima di continuare:**

* Confronta y adatta la Mappatura:
  * Rivedi il tuo **Campi dei dati importati** rispetto ai campi abbinati di Channable **Campi del progetto**. Si un Campo è stato abbinato in modo errato, fai clic sul Campo. Para Selecciona un Campo diverso.
* Controlla y correggi i tipi di Campo:
  * Controlla che il Tipo di Campo corretto sia assegnato ai campi del tuo progetto. si un Campo ha il Tipo sbagliato, fai clic **Modifica** Vicino Para al Campo, Selecciona il Tipo corretto en il menu a tendina, y fai clic **Salva e importa**.
* Escludi i campi (facoltativo):
  * Para excluir un Campo de ser incluido en tus datos de producto, haz clic en la casilla de verificación en el **Selecciona** colonna per quel Campo y Selecciona la **excluir** casella di controllo.&#x20;
    {% endhint %}

Una volta terminata la mappatura, fai clic **Salva e importa** Para iniziare a importare i dati dei tuoi prodotti. A seconda di quanti dati stai importando, questo può tomar un po' di tiempo.

{% hint style="info" %}
**Nota:** Controlla la **Status** colonna en **Configura** Para controllare l'avanzamento dell'importazione. I tuoi dati di prodotto sono completamente importati quando lo Status è **Finito**.
{% endhint %}
{% endstep %}

{% step %}

### Controlla i tuoi Ítems importati.

Dopo che l'importazione dei dati del prodotto è Finito:

* Vai **Panoramica** Para visualizzare i prodotti importati.
* Fai clic su un ítem Para vedere informazioni dettagliate.

Sei pronto! I tuoi Ítems sono pronti Para usar Para Crear y Ottimizzare Feeds, Marketplaces, Shopping Ads, y altro en Channable.
{% endstep %}
{% endstepper %}

<figure><img src="/files/25253a3ae677033e29bf8c1f8d9ecfc60b6991b9" alt=""><figcaption></figcaption></figure>


---

# 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://helpcenter.channable.com/import-data/import-data-it/guida-allimportazione/importa-i-dati-dei-prodotti/importa-tramite-un-webshop/akeneo.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.
