Placement Targeting allows you to control which offers are returned to your app or site based on where the offer will be shown. This acts as a filtering layer, so you can run different offers in different parts of your product (home screen, rewards page, popups, etc.).
What Is a Placement?
A Placement represents a specific surface in your app or site where offers appear, such as:
Home feed
Rewards page
Featured carousel
Pop-up modal
Dedicated offer wall
Placements let you:
Show different offers in different locations
Prevent certain offers from appearing in the wrong UI
Fully control offer distribution by surface
How Placement Targeting Works
1. Create & Manage Placements (Back Office)
Placements are created and managed in the Back Office.
From there, you can:
Create new placements
Edit existing placements
Delete placements
Each placement will have a unique Placement ID, which is the value used for targeting in API requests.
2. Assign Placements at the Offer Level (Targeting Rules)
When creating or editing an offer, you assign the placements you want the offer to appear in Step 3 (Budget and Targeting).
If a placement is not assigned to the offer, that offer will not appear in the API response if the placement query parameter is included in the request URL.
3. Pass the Placement ID in the Offer Request (Response Filtering)
When requesting offers via the API, your request URL must include the Placement ID that was created in the Back Office.
⚠️ Important: You must pass the Placement ID, not the Placement name.
GoKart uses the Placement ID to:
✅ Match against offer targeting rules
✅ Return only eligible offers
✅ Enforce placement-based distribution at the response level
If the Placement ID does not match any placement assigned to the offer, the offer will not be returned.
Example Request:
GET https://api.[YOUR_TENANT].getgokart.ai/api/v1/offer-wall/offers?pub_member_id=test&fields=epc&filter.placementId=9f3c2e18-7d45-4a91-b6d8-2b7c5e4d91fa
When filter.placementId is included in the request, only offers that have this placement selected in their configuration will be returned in this API response.
Key Points
Placements act as a distribution filter
Offer responses are scoped by Placement ID
One offer can run in multiple placements
If no Placement ID is passed, GoKart will only return offers that do not have any placements assigned (offers without placement targeting).