Playtime Access

The Playtime feed contains the apps which the users can install and use to gain rewards. It is contained in a separate activity.

Launching Playtime

To launch Playtime, call

Adjoe.ShowOfferwall(nil)

This will launch the AdjoeActivity displaying the adjoe ad feed. If you need to know in advance whether the user can access Playtime or not, you can call Adjoe.CanShowOfferwall(). This method will return true if you can launch Playtime for the user and false otherwise.

Before the user can interact with the partner apps on the ad feed, he has to accept the adjoe Terms of Service and grant your app permission to track the usage of other apps in his phone settings.

UA Parameters You can pass any additional UA parameters when you launch Playtime, which will be logged every time a user views or clicks a campaign:

local adjoeParams = Adjoe.NewAdjoeParams()
					:SetUANetwork("network")
					:SetUAChannel("channel")
					:SetUASubPublisherCleartext("SubPublisherCleartext")
					:SetUASubPublisherEncrypted("SubPublisherEncrypted")
					:SetPlacement("placement")

Adjoe.ShowOfferwall(adjoeParams)

teaser_shown event

You should send the teaser_shown event when the user can see the teaser, e.g. the button via which he can access the adjoe SDK from the SDK App. Trigger this event when the teaser has been successfully rendered and would successfully redirect the user to the adjoe SDK. It should be triggered regardless of whether the user has actually clicked the teaser or not. This event is mostly appropriate for uses, in which the functionality of the SDK App and SDK are kept separate to a relevant degree.

Adjoe.SendUserEvent(Adjoe.EVENT_TEASER_SHOWN, adjoeParams)

Best practices for teaser_shown event

It's always good to check if Playtime can be launched for the user before showing the teaser button.

if Adjoe.canShowOfferwall() then
    -- Show the teaser button.
    Adjoe.sendEvent(Adjoe.EVENT_TEASER_SHOWN, null, adjoeParams)
end

Last updated