Overview
You can target in-app messages to appear when a customer views a particular product or category screen in your mobile app. This lets you deliver highly contextual messages — such as promoting a discount when a shopper opens a specific category, or surfacing a related offer on a particular product page. To make this work, Maestra needs to know which screen the customer is currently viewing. Your mobile app communicates this by calling product-view and category-view operations. Once those operations are wired to your mobile app integration point, you can use screen-based conditions when targeting an in-app.Setup steps
Check that view operations are configured
Make sure the product and category screens in your mobile app trigger the corresponding view operations.Each view operation must list your mobile app integration point under For integration points. Without this, Maestra cannot associate the operation with the mobile app and the operation will not be available for in-app targeting.
Connect the operations to your mobile app integration point
Go to Integrations and open your mobile app integration point.In the integration point settings, select the product-view operation and the category-view operation from the dropdown lists. Save your changes.Once saved, Maestra knows which operations represent “customer is viewing a product” and “customer is viewing a category” in your app.
Create the in-app and pick the target integration point
Create a new in-app message and select your mobile app integration point as the target.If the product-view or category-view operations have not been configured yet for that integration point, you will see a warning. Add the operations following step 2, and the screen targeting option will become available.
Configure screen targeting
In the in-app targeting settings, add the Display screen condition. You can target by:
- Category — by category name or by category external ID.
- Product — by customer segment (for example, customers who viewed a specific product) or by a specific product ID.
How it works at runtime
When a customer opens a product or category screen in your mobile app, the app calls the corresponding view operation. Maestra checks the operation against the conditions on your in-app. If the screen matches the targeted category or product, the in-app is displayed to the customer immediately.Targeting only works when the view operations are correctly mapped to the mobile app integration point. If in-apps are not showing as expected, start by verifying the operations on the integration point and confirming that the mobile app is sending the view calls with the correct product or category identifiers.
Targeting options at a glance
| Target by | Match on |
|---|---|
| Category | Category name or category external ID |
| Product | Customer segment or specific product ID |