Personalized product recommendations — the same engine that powers recommendation widgets on your website — delivered inside your native iOS or Android app. The profile is shared across surfaces, so someone who browsed jackets on your site gets relevant picks the moment they open the app, rather than starting from scratch.
In the panel: New campaign › App / API › Product Recs for Apps.
Before you start
The SDK has to be installed and reporting first. Installation for both platforms, the initialisation code, and how to confirm data is arriving are in Targeting & Personalization for Mobile Apps. If your device does not appear in Live visits, stop and fix that first — recommendations cannot be produced for a user Personyze cannot see.
You also need a product catalog in Personyze, in Settings → Recommendation setup → Product Catalog. Upload or link a feed there, or push products over the API with the products object.
The campaign steps
Seven steps: Set up, Catalog, Interactions, Content, Target, Automation and Performance.
Two things to notice. There is no QA step — app campaigns are validated in a build, not in the panel. And Content comes before Target: you design the recommendation first, then decide who receives it.
1. Set up
Connects the SDK, with a tab each for Android, iOS and Server (REST). It has three steps: add the library, initialise it with your API key, and report each screen so you can present what comes back. You connect once, and later app campaigns need no setup. Full detail is in the article linked above.
2. Catalog
Your product catalog has to be in place and current. Each product needs at least an internal ID, a title and an image URL — recommendations with no image render as empty boxes in an app just as they do on the web. Keep is_in_stock accurate, or you will recommend things people cannot buy.
3. Interactions
This is the step that decides whether recommendations are any good, and the one most often skipped.
The engine learns from what people do with products: viewed, added to cart, purchased. On a website Personyze can often detect these automatically. In an app it cannot — there is no DOM to watch. Your app must report them explicitly through SDK calls.
At minimum report product views and purchases. Without interaction data, algorithms like “bought together” and “popular” have nothing to compute from, and the widget will come back empty or fall back to a generic list.
If you also sell on the web, the two streams merge into one profile — so in-app browsing improves website recommendations and vice versa.
4. Content
Add the recommendation and choose its algorithm, in the same picker on-site widgets use (see Recommendation Algorithms). For apps there are two rendering options:
- HTML (WebView) — Personyze returns a rendered widget you drop into a WebView. Quickest path, and the layout can be changed later without shipping an app update.
- JSON — the Product Recommendations JSON Feed returns the chosen products as structured data and your app lays them out natively. Better performance and a native feel; more work up front.
If you are returning JSON, choose the fields your app needs in the response — title, price, image URL, product URL, and any custom catalog fields you want to display.
5. Target
Who sees the recommendation. All standard targeting applies. Because the app reports each screen, a campaign can target one screen rather than the whole app. A common pattern is to show different algorithms to different people — newest arrivals to first-time users, “bought together” to people with purchase history.
6. Automation
This step is optional. Add rules that alert you, or act, when this campaign’s numbers cross a line. See Automation.
7. Performance
The Performance step’s Recommendations tab reports what the recommendations earned (transactions, attributed revenue, share of revenue) and the funnel: shown, viewed, clicked, added to cart, purchased. The middle of the funnel fills only if the app reports views and clicks. Every figure is explained in Product and content recommendations.
Validating it
- Confirm your device appears in Live visits.
- Report a few product views from the app, and check they land against your session.
- Widen the audience so it certainly matches you, and confirm recommendations arrive and are not empty.
- Narrow the rules back and confirm the behaviour changes.
An empty result almost always means step 2 or 3 of the campaign — a catalog that did not import, or interactions that are not being reported — rather than a targeting problem.