Channable
Globe icon
English (US) Deutsch Español Français Italiano Nederlands
  1. Help Center - Channable
  2. Imports
  3. Import setups

Articles in this section

See more

Import items from Akeneo

In this article, you'll learn how to import your product data from Akeneo into Channable.

Before you start

You'll need

  • An Akeneo account
  • If you want to include images in listings: A third-party application (e.g. TwicPics)

Contents

 

Step 1: Create a new connection in Akeneo 

  1. Log in to your Akeneo account.
  2. Go to Connect > Connection settings > CREATE.Akeneo 1 - connect.png
  3. Create your Channable connection:
    1. For Label, call your connection "Channable".
    2. For Code, this should automatically be filled in after creating your label. If it isn't, fill in "channable".
    3. For Flow type, set it to Data destination.
  4. Click Save. You'll be directed to a page with your connection credentials.
  5. Make note of your Client ID, Secret, Username and Password, as you will need these in Step 3.
  6. For Permissions, make sure the Role is set to API and Group is set to API Connections.
    Akeneo - Connection-settings.png

Step 2: Create a TwicPics account

To list your products on different channels with images, Channable requires public image URLs. As Akeneo doesn't offer this currently, you'll need to use a third-party application. In this step, we'll use TwicPics (most used by Akeneo users).

Important: You don't need a TwicPics account to import your product data, but if you want to use images in your product listings, this step is mandatory. 
  1. Follow TwicPic's Akeneo set up guide.
  2. After creating your account and following the steps, go to Workspaces and click your domain (in Favorite domains)
  3. Ensure you have a path where nothing is added and the path is /.
    Example: An correct setup where 1) is the domain, 2) is the path, and 3) is the source:
    Test Akeneo.png
  4. Make note of your twic pics domain, as you'll need it in the next step. 

Step 3: Create your Akeneo connection

  1. In Channable, open the project where you want to import your product data.
  2. Go to Setup, click + Set up import, and select Akeneo.
  3. Fill in the required information:
    1. For Label, give your import channel a descriptive name (e.g. "Akeneo")
    2. For Akeneo URL, provide your Akeneo webshop URL (can be found in Akeneo Activity dashboard)
    3. For Client ID, fill in the Client ID you noted in Step 1.
    4. For Client secret, fill in the Secret you noted in Step 1.
    5. For Username, fill in the Username you noted in Step 1.
    6. For Password, fill in the Password you noted in Step 1.
    7. For TwicPics domain, fill in the domain you noted in Step 2.
  4. Click Connect with Akeneo. This takes you to your import settings.
    1. For Name, give Give your Akeneo import a descriptive name (e.g. "Akeneo FR")
    2. For Choose language, select the language your product data is in.
  5. Click Start import. You'll be redirected to the Edit Mapping page to map your product information.

 

Step 4: Map your products

This page displays your import fields (fields retrieved from your Akeneo site [e.g. price, description, title]), and corresponding project fields (Channable's standardized fields used to streamline channel setups).

Note: Our system will automatically detect and map most import fields our standardized fields, but it's important to review and adjust these before importing.

Akeneo has rich organization options. Sometimes, this means a field (e.g. product descriptions) have multiple variations. For example, your product description field might contain specific versions for different languages.

To make your Akeneo product data work across different channels, we 'unnest' these fields. This means we take all unique combinations and give them their own field. We use an underscore (_) to connect the different parts.

Example: 

Description field split to account for different locales and scopes.

unnested.png

Before you continue

  1. Compare and adjust mapping: 
    Review your Import fields against Channable's matched Project fields. If a field was matched incorrectly, click on the field to select a different field.
  2. Check and correct field types:
    Check that the right field type is assigned to your project fields. If a field has the wrong type, click Edit next to the field, select the correct type in the dropdown, and click Save & Import.
  3. Exclude fields (optional):
    To exclude a field from being included in your product data, click the checkbox in the Select column for that field and click Do not import selected fields.

Once you've finished mapping, click Save & Import to start importing your product data. Depending on how much data you're importing, this can take some time. 

Note: Check the Status column in Setup to check your import progress. Your product data is fully imported when the Status is Finished.

 

Step 5: Review your imported items

After your product data has finished importing:

  1. Go to the Items page to view your imported products.
  2. Click on an item to see detailed information. 
product-details.gif

You're good to go! Your items are ready to use to create and optimize Feeds, Marketplaces, Shopping Ads, and more in Channable.

Related articles