How to Setup Zakeke

Table of Contents

• Overview
• Key Features
• Prerequisites
• Integration Steps
• Linking Products to Zakeke
• Product Settings for Zakeke
• Cart and Order Management
• Limitations and Known Issues

Overview

Zakeke is a sophisticated AI visual commerce platform designed to integrate customization options into products and display them using augmented reality (AR) technology. Integrating Zakeke with your store allows customers to personalize their purchases directly from your storefront, creating unique items that reflect their individual styles and preferences.

Key Features

• Customized to the Client: Zakeke offers tailored options for product customization, including color schemes, design patterns, and imagery.
• Easily Integrated: Zakeke seamlessly integrates with existing platforms, enhancing the overall user experience.
• Mobile Responsive: Automatically adjusts to mobile devices, utilizing an optimized iframe if the screen size is less than 769px.

Learn More about Zakeke: https://www.zakeke.com

View Zakeke Documentation: https://docs.zakeke.com

Prerequisites

• Zakeke Account: Each store requires its own Zakeke account. Zakeke does not support multiple stores under one account for API integrations.
• Whitelisting: If using a resizer, add files.zakeke.com to the whitelist to ensure design images work properly.

Note: Products added before linking your store to Zakeke may produce errors and prevent changes. Always link your store first.

Integration Steps

1. Create your Zakeke account and log in. Navigate to Your Account > API Keys to generate API credentials.
2. Sign into your Cart.com Storefront in a new tab or window.
3. From the left-hand menu, go to Tools > Apps and Addons.
4. Find and click on Zakeke.
5. Enter the API Client ID and API Key obtained from Zakeke.
6. Enable the integration by toggling the switch in the top-right corner of the settings page, then click Save.

Important: The integration must be enabled to sync product data with Zakeke.

Linking Products to Zakeke

Currently, products are linked to Zakeke using the CSV method:

1. In your Storefront, go to Apps and Addons > Zakeke.
2. Select Product List.
3. Choose the products/variants you want to link to Zakeke.
4. Click More Actions > Download Zakeke File. This downloads a ZIP file containing product data.
5. Log into your Zakeke account and select Customizable Products > Add from a CSV.
6. Import the ZIP file to complete the product linking process.

Notes:

• Each variant inventory item must be linked to appear as an option in Zakeke.
• If you change the Item Number, Variant Group Name, Variant Item Number, or Variant ID, the product must be re-linked.
• Ensure all products and variant items have an Item Number and an image. Missing these will cause errors during import.

Product Settings for Zakeke

After products are linked, you can configure additional settings within Zakeke:

• Set up sides, print areas, and print types for each product.
• In the Storefront, go to Catalog > Products > Edit > General and set the Designer Type to Zakeke.

Important: Setting the Designer Type to Zakeke will replace the Add to Cart button with a Customize button on the product details page.

Cart and Order Management

Cart Behavior:

• After adding a customized product to the cart, it can be edited in Zakeke via an Edit Design link.
• Use the merge code $$ITEMZAKEKEEDITLINK$$ in the ShopCartItem layout to display the edit link.
• Each customized item added to the cart is treated as unique. Use quantity buttons to add multiples of the same design.
• Items added to a wishlist will retain their design ID.

Order Processing:

• After checkout, design details are sent to Zakeke automatically if the integration is enabled.
• Reordering a Zakeke product generates a new design ID.
• Download print files directly from Zakeke or via a ZIP file link in the order editor (only for Zakeke products with a design ID).

Limitations and Known Issues

• Unsupported Features: Advanced pricing and non-inventory variants are not supported.
• Subscription Products: Subscription-based products are set to No Renewal automatically.
• Variant Requirements: Only variant inventory using dropdowns and radio buttons are supported. 
• Product Restrictions: Does not work with:
  
  • Products using quantity grids
  • Products with subscriptions
  • Product groups

Conclusion

Integrating Zakeke with your store enhances customer engagement by enabling product personalization with real-time previews. While the integration supports a wide range of customization features, it’s essential to follow the setup steps carefully and be aware of current limitations to ensure smooth functionality.