# Akeneo

In diesem Artikel lernst du, wie du deine Produktdaten von Akeneo in Channable importierst.

### Bevor du beginnst

Du brauchst

* Ein Akeneo-Konto
* Wenn du Bilder in Listings einbinden willst: Eine Drittanbieter-Anwendung (z. B. TwicPics)

{% stepper %}
{% step %}

### Erstelle eine neue Verbindung in Akeneo

* Melde dich in deinem Akeneo-Konto an.
* Gehe zu **Connect > Connection settings > CREATE**.<br>

  <figure><img src="https://3095163456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FvXMfcpmX2Qj7CHxtRr0O%2F21020674572178?alt=media&#x26;token=5635965f-4524-4226-bde7-56f81655a9ce" alt=""><figcaption></figcaption></figure>
* Erstelle deine Channable-Verbindung:

  * Für **Label**, nenne deine Verbindung „Channable“.
  * Für **Code**, das sollte nach dem Erstellen deines Labels automatisch ausgefüllt werden. Falls nicht, trage „channable“ ein.
  * Für **Flow-Typ**, setze ihn auf **Datenziel**.
  * Klicke **Speichern**. Du wirst zu einer Seite mit deinen Verbindungsdaten weitergeleitet.
  * Notiere dir deinen **Client-ID**, **Secret**, **Benutzername** und **Passwort**, da du diese in einem späteren Schritt benötigst.
  * Für **Berechtigungen**, stelle sicher, dass die **Rolle** auf **API** und **Gruppe** auf **API-Verbindungen**.

  ![Akeneo - Connection-settings.png](https://3095163456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2Fm36W4zJGLXTkhQ11C4vC%2F21020685456018?alt=media\&token=af0892d5-9971-405a-a6ed-5e69b1beffc2)
  {% endstep %}

{% step %}

### Erstelle ein TwicPics-Konto

Um deine Produkte mit Bildern auf verschiedenen Kanälen zu listen, benötigt Channable öffentliche Bild-URLs. Da Akeneo dies aktuell nicht anbietet, musst du eine Drittanbieter-Anwendung verwenden. In diesem Schritt nutzen wir TwicPics (am häufigsten von Akeneo-Nutzern verwendet).

Wichtig: Du brauchst kein TwicPics-Konto, um deine Produktdaten zu importieren, aber wenn du Bilder in deinen Produktlistings nutzen willst, ist dieser Schritt erforderlich.

1. Folge TwicPics Anleitung für Akeneo: <https://www.twicpics.com/docs/integrations/akeneo#connect-your-pim-with-akeneo-twicpics-app>
2. Nachdem du dein Konto erstellt und die Schritte befolgt hast, gehe zu **Workspaces** und klicke auf deine Domain (in **Favorisierte Domains**).
3. Stelle sicher, dass du einen Pfad hast, bei dem nichts angehängt wird und der Pfad ist `/`.

Beispiel: Eine korrekte Einrichtung, bei der 1) die **Domain**, 2) der **Pfad**, und 3) die **Quelle sind:**

![Test Akeneo.png](https://3095163456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2Fa8q8nYdL2m4R4FTbNddX%2F21020685456786?alt=media\&token=9652ddad-be57-46ff-b7f0-23cd79f72019)

4. Notiere dir deinen **twic pics domain**, da du sie im nächsten Schritt benötigst.
   {% endstep %}

{% step %}

### Erstelle deine Akeneo-Verbindung in Channable

1. Öffne in Channable das Projekt, in das du deine Produktdaten importieren möchtest.
2. Gehe zu **Setup**, klicke **+ Set up import**, und wähle **Akeneo**.
3. Fülle die erforderlichen Informationen aus:
   * Für **Label**, gib deinem Importkanal einen aussagekräftigen Namen (z. B. „Akeneo“)
   * Für **Akeneo-URL**, gib deine Akeneo-Webshop-URL an (zu finden im Akeneo Activity Dashboard)
   * Für **Client-ID**, trage das **Client-ID** die du zuvor notiert hast.
   * Für **Client-Secret**, trage das **Secret** die du zuvor notiert hast.
   * Für **Benutzername**, trage das **Benutzername** die du zuvor notiert hast.
   * Für **Passwort**, trage das **Passwort** die du zuvor notiert hast.
   * Für **TwicPics-Domain**, trage die Domain ein, die du im TwicPics-Schritt notiert hast.
4. Klicke **Mit Akeneo verbinden**. Du gelangst damit zu deinen Import‑Einstellungen.
   * Für **Name**, gib deinem Akeneo-Import einen aussagekräftigen Namen (z. B. „Akeneo FR“)
   * Für **Sprache wählen**wähle die Sprache, in der sich deine Produktdaten befinden.
5. Klicke **Import starten**. Du wirst zum **Mapping bearbeiten** Seite, um deine Produktinformationen zuzuordnen.
   {% endstep %}

{% step %}

### Ordne deine Produkte zu

Auf dieser Seite siehst du deine Importfelder (Felder, die von deiner Akeneo-Seite abgerufen werden – z. B. Preis, Beschreibung, Titel) und die entsprechenden Projektfelder (Channables standardisierte Felder zur Vereinfachung der Kanal-Einrichtung).

Hinweis: Unser System erkennt und weist die meisten Importfelder automatisch den standardisierten Feldern zu, trotzdem solltest du diese vor dem Import überprüfen und anpassen.

Akeneo bietet umfangreiche Organisationsmöglichkeiten. Das bedeutet manchmal, dass ein Feld (z. B. Produktbeschreibungen) mehrere Varianten für verschiedene Sprachen oder Bereiche hat. Damit deine Akeneo-Produktdaten auf verschiedenen Kanälen funktionieren, „entpacken“ wir diese Felder — wir nehmen alle eindeutigen Kombinationen und geben ihnen jeweils ein eigenes Feld. Wir verwenden einen Unterstrich (\_) zur Verbindung der verschiedenen Teile.

Beispiel: Beschreibungsfeld aufgeteilt, um unterschiedliche Lokalitäten und Bereiche zu berücksichtigen.<br>

![](https://3095163456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2F9paStBnAaw61m85BTkCq%2F27788028834450?alt=media\&token=4743344c-ed00-4a12-93fe-34d3bb460d8d)

Bevor du fortfährst:

* Vergleiche und passe das Mapping an:
  * Überprüfe deine **Importfelder** gegen Channables zugeordnete **Projektfelder**. Wenn ein Feld falsch zugeordnet wurde, klicke auf das Feld, um ein anderes Feld auszuwählen.
* Prüfe und korrigiere Feldtypen:
  * Überprüfe, ob der richtige Feldtyp deinen Projektfeldern zugewiesen ist. Wenn ein Feld den falschen Typ hat, klicke **Bearbeiten** neben dem Feld, wähle den richtigen Typ im Dropdown und klicke **Speichern & Importieren**.
* Felder ausschließen (optional):
  * Um ein Feld vom Import deiner Produktdaten auszuschließen, aktiviere das Kontrollkästchen in der **Auswählen** Spalte für dieses Feld und klicke **Ausgewählte Felder nicht importieren**.

Wenn du das Mapping abgeschlossen hast, klicke **Speichern & Importieren** um den Import deiner Produktdaten zu starten. Je nach Datenmenge kann das einige Zeit dauern.

Hinweis: Prüfe das **Status** Spalte in **Setup** um deinen Importfortschritt zu kontrollieren. Deine Produktdaten sind vollständig importiert, wenn der Status **Beendet**.
{% endstep %}

{% step %}

### Überprüfe deine importierten Artikel

Nachdem deine Produktdaten importiert wurden:

* Gehe zur **Items** Seite, um deine importierten Produkte anzusehen.
* Klicke auf ein Item, um detaillierte Informationen zu sehen.

Alles bereit! Deine Items sind einsatzbereit, um Feeds, Marktplätze, Shopping-Anzeigen und mehr in Channable zu erstellen und zu optimieren.
{% endstep %}
{% endstepper %}

<figure><img src="https://3095163456-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZa0iYflHeXmKWGnfFMAN%2Fuploads%2FXhXYnkuQFuvSjI2gJlbR%2F15277510036242?alt=media&#x26;token=41baadcb-e44c-4372-9222-be788f0c9dd5" alt=""><figcaption></figcaption></figure>
