📘

Before you begin

Make sure you have a working Placement integration (token, view, provider) as described in the Initial Setup.

Set your Labels in Storyly Dashboard

In the Storyly Dashboard, while creating story groups, you will see an option called Audience. Here you can set your labels ["new comers", "europe"] by enabling Labels checkbox. You may use AND , OR options according to your targeting conditions.

• Use labels like: ["new comers", "europe"]
• Select AND / OR depending on your targeting logic

Pass Labels to the SDK

You need to pass labels via STRPlacementConfig.Builder().setLabels(...).

val placementConfig = STRPlacementConfig.Builder()
    .setLabels(setOf("new comers", "europe"))
    .build(placementToken)

Label Behavior

• If you do not give any parameters to segments, Storyly Placement SDK will show all active Story Groups with/without labels. This is the default behavior.
• AND condition: When the Audience uses an AND condition for the labels ["new comers", "europe"], the Storyly Placement SDK displays the Story Group only if both ["new comers"] and ["europe"] are passed to setLabels.
• OR condition: When the Audience uses an OR condition for the labels ["new comers", "europe"], the Storyly Placement SDK displays the Story Group if either one of ["new comers"] or ["europe"] is passed to setLabels.

📘

Important

• Label values are case-sensitive on many backends; prefer consistent lowercase labels (e.g. "europe", not "Europe").
• If you change labels at runtime, ensure the Placement provider/view refreshes data accordingly in your integration.