Skip to main content
Version: 3.x

Placements

if you makes changes to placements, you'll need to reinitialize the SDK to see those changes

There are 2 different types of placement:

  • Automatic
  • Manual

They function similarly, but have different use cases. With the Automatic type of placement, this is intended to be used when you have something you want to show when the app boots, like a sale banner or interstitial.

With the Manual type of placement, this is intended to be used when you want to show something in response to a user action, like a button click to display a survey wall.

Both placement types work with the showContentForPlacement() call. The behavior is dependent on the placement type.

info

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

Automatic Placements

Automatic placements will allow the following content types

  • Interstitial - A full screen ad that is shown between levels or at a natural break in the game
  • Floating - A smaller ad that is shown in the middle of the screen
  • Banner - A banner that will appear at the bottom of the screen

Each placement of type: Interstitial, Floating interstitial, and Banner will have the following behavior:

When called in code, the user will be shown the first piece of content for which they have matching attributes. If no attributes are defined for any content, they will be shown the first content item.

We recommend always having a default piece of content for each placement, in case the user does not match any attributes. The image below shows an example.

Content modal v3.1

Manual Placements

Manual placements allow for the following content types

  • Survey wall - This is a "button type" that, when called, will take the user directly to the survey wall
Content modal v3.1

Creating a placement

To create a placement, click on the "Create placement" button in the top right corner of the placements page.

Content modal v3.1

This will bring up the create placement modal.

Content modal v3.1

The Code tag that is generated is what you will use in your app to show the placement.

example: showContentForPlacement("earn-center")

Creating content

Once you have created a placement, you can add content to it. To do this, click on the "Create content" button on the top right of the page.

Content modal v3.1

After clicking the button, you will be presented with the create content modal.

Content modal v3.1

Select the type of content you want and fill out the form. Once you click "Submit" the content will be live to your users.

Pro tip: If you want to test specific content for QA, you can target yourself with user attributes.