Introduction

Salla is an e-commerce platform in the MENA region that helps merchants set up and manage online stores. This integration allows you to seamlessly synchronize customer data and checkout events from your store to MoEngage, enabling omnichannel engagement.

Key Features

• Zero-code setup: Connect your store without development effort.
• Omnichannel Engagement:
  • Web: Web Push Notifications, On-Site Messaging (OSM), Personalization.
  • Mobile App: Mobile Push Notifications, In-App Messaging (for Salla iOS/Android apps).
• Real-time Tracking: Syncs events (Viewed Product, Added to Cart, Checkout) across Web and Mobile.

Use Cases

• Recover abandoned carts: Automatically trigger personalized messages when customers leave items in their cart.
• Welcome new customers: Engage first-time visitors with tailored welcome messages.
• Personalize shopping experience: Display dynamic product recommendations based on user behavior.

Integration Steps

Step 1: Request Integration from MoEngage

Contact your MoEngage Customer Success Manager or MoEngage Support to request Salla integration setup.

Information to provide:

• Salla Store URL: Your live store URL (e.g., yourstore.salla.sa)
• Store Name: Your Salla merchant or store name

MoEngage will provide you with an app installation link and coordinate any necessary setup with Salla.

Step 2: Install the MoEngage App

1. Click the app installation link provided by MoEngage.
2. Log in to your Salla Merchant Dashboard if not already logged in.
3. Click Install App or Add to Store.
   The My Apps page appears.
   

Step 3: Configure App Settings

Once installed, configure the app to connect it to your MoEngage workspace.

3.1 Retrieve MoEngage Credentials

1. Log in to the MoEngage Dashboard.
2. Go to Settings > Account > APIs.
3. Copy your Workspace ID and Data API Key.
4. Note your Data Center (e.g., DC-04) based on your dashboard URL (e.g., dashboard-04.moengage.com).

For more information, refer Data Centers in MoEngage.

3.2 Enter Configuration in Salla

In your Salla Merchant Dashboard, on the MoEngage App Integration page:

1. Workspace ID: Paste your Workspace ID from MoEngage.
2. Data API Key: Paste your Data API Key from MoEngage.
3. Data Center: Select your Data Center from the dropdown (e.g., DC-04).
4. Unique Identifier (Customer ID): Choose how you want to identify users in MoEngage - Email or Phone.

   warning

   This setting is critical for merging guest user data with logged-in user profiles. Ensure you select the identifier that your business uses as the primary key for customers.

5. SDK Version: Keep the default value unless instructed by MoEngage support.
6. Enable Personalization (Optional): Toggle ON to enable Web Personalization features (dynamic product recommendations, banners, etc.).
7. Debug Logs (Testing Only): Toggle ON only during testing to view logs in browser console.

   warning

   Disable Debug Mode Before Production When Debug Logs is enabled, data flows to the MoEngage Test Environment. You MUST disable this before going live to ensure data flows to your production workspace.

8. Click Save.

Step 4: Verify Integration

4.1 Verify Web SDK

1. Ensure Debug Mode is turned on.
2. Open your Salla storefront in a browser.
3. Open Developer Tools (F12 or Right Click > Inspect).
4. Go to the Console tab.
5. Look for: MoEngage: SDK initialized successfully.

4.2 Verify Event Flow

1. Perform test actions on your store (view products, add to cart, etc.).
2. Go to your MoEngage Dashboard > Test Environment (if Debug Logs is ON).
3. Check Analytics > Events or Live Events stream.
4. Verify events appear within 30-60 seconds.

Tracked Events Reference

The following events are automatically tracked based on the platform:

Configuration Guides

After integration is active, create campaigns using these guides:

• Web Push Notifications: Create Web Push Campaign
• On-Site Messaging (OSM): Create OSM Campaign
• Web Personalization: Create a Web Personalization Campaign

Support & Troubleshooting