Skip to main content
Version: 3.x

Placements

info

If you make changes to placements, you'll need to reinitialize the SDK to see those changes.

There are 2 types of placements:

Pop-up Placements

Use pop-up placements to display content automatically when the app loads, such as:

  • Sale banners
  • Interstitials
  • Quick Questions

Survey Wall Placements

Use survey wall placements to display content in response to user actions, such as:

  • Button clicks to open the survey wall
  • Earn center interactions

Both placement types use the showContentForPlacement() call, but behave differently based on their type.

info

When a new placement is created, your dev team must implement it in your app code. Once the placement is created, you can add and remove content from it without needing to update your app.

Pop-up Placement Content Types

Pop-up placements support the following content types:

  • Interstitial - Full-screen content shown between levels or at natural breaks
  • Floating - Smaller content displayed in the middle of the screen
  • Banner - Content that appears at the bottom of the screen

Behavior

When showContentForPlacement() is called:

  1. The user sees the first piece of content matching their attributes
  2. If no attributes are defined, the first content item is shown

Best practice: Always include a default piece of content for each placement in case users don't match any specific attributes. See the example below:

Content modal v3.1

Survey Wall Placement Content Types

Survey wall placements support:

  • Survey wall - Opens the full survey wall experience when triggered
Content modal v3.1

Creating a Placement

  1. Click the "Create placement" button in the top right corner of the placements page
Content modal v3.1
  1. Fill out the placement details in the modal
Content modal v3.1
  1. Use the generated Code tag in your app to display the placement

Example: showContentForPlacement("earn-center")

Creating Content

Once you have a placement:

  1. Click the "Create content" button in the top right of the page
Content modal v3.1
  1. Select your content type from the modal
Content modal v3.1
  1. Fill out the form and click "Submit"

Your content will immediately go live to users.

Pro Tip

To test specific content for QA, target yourself using user attributes.