Mobile App Product Recommendations Integration Guide

This guide explains how to implement Personyze Product Recommendations inside Android and iOS mobile apps
using the official Personyze SDKs. After setting up the SDK, you can create a mobile app product recommendation
in your Personyze dashboard and render it using either the HTML (WebView) or JSON format.

Android SDK Integration

The Android SDK allows you to connect your native app to Personyze and send tracking events
for personalization. Follow these steps to integrate it.

1. Add the SDK to Your Project

Clone or download the Personyze Android SDK from
GitHub.
Place the personyzeandroidsdk directory in your project root.
Edit settings.gradle:
```
include ':app', ':personyzeandroidsdk'
```

In app/build.gradle, add:

implementation project(path: ':personyzeandroidsdk')

Add Internet permission in your manifest:

<uses-permission android:name="android.permission.INTERNET" />

2. Initialize the SDK

Call initialization early in your Application class.

PersonyzeTracker.inst.initialize(this, "YOUR_API_KEY");
PersonyzeTracker.inst.navigate("MainActivity");
PersonyzeTracker.inst.done();

Your API key is available under Settings → Integrations in the Personyze dashboard.
Once initialized, the SDK will begin sending navigation and tracking events automatically.
You can confirm data flow by checking the Live Visits dashboard in Personyze.

iOS SDK Integration

The iOS SDK enables you to track events and display personalized recommendations in iOS apps.
Get the SDK and demo from:
personyze-ios-sdk and
personyze-ios-sdk-demo.

1. Install the SDK

Add the SDK using Swift Package Manager or CocoaPods.

pod 'PersonyzeSDK'

2. Initialize in AppDelegate

import PersonyzeSDK

func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
  Personyze.initialize(apiKey: "YOUR_API_KEY", domain: "YOUR_DOMAIN")
  return true
}

Once initialized, the SDK connects automatically to your Personyze account and begins logging session data.

Creating a Mobile App Recommendation (Wizard)

After SDK integration, open your Personyze dashboard and go to
Wizard → Mobile App Product Recommendation.
You can choose one of the two output formats, depending on how your app displays content:

HTML Widget (WebView) — render a full ready-to-use HTML widget inside your app.
JSON — request and parse structured recommendation data for native UI rendering.

Template Language Reference

To format dynamic elements and product data, Personyze uses the
Template Language.
Templates can define which fields appear in your recommendation response, allowing your app to
display names, prices, images, or stock messages consistently with your website.

QA & Testing

Test your integration on real devices or emulators to verify event tracking and recommendations.
Review incoming data under Live Visits and ensure products appear correctly in the app.
For detailed QA workflow, see
QA campaigns.

Knowledge Base