Follow this guide to launch the pre-prepared giveaway offer from the Monetizr.
The following steps are required:
- Step 1 Authenticate in console
- Step 2 Open your offers section
- Step 3 Check how your offer looks with Pacman or with Tic Tac Toe game
- Step 4 Invite your developer
- Step 5 Developer: Create the reward center
- Step 6 Developer: Add the required webhook
- Step 7 Developer: Create the offer claim request
- Step 8 Launch
- Step 9 Repeat
Go to https://app.themonetizr.com and authenticate yourself.
Read more: https://docs.themonetizr.com/docs/creating-account
Every user has a pre-prepared offer configured for them upon registration. This offer is configured as a giveaway offer (Read more). You will need to open this offer to view the details of it. To do that - click on View button or on the offer card, this action will open the Offer details (Read more).
To check how the offer looks in game: Copy the API key and the Offer tag from For developer tab and open the Pacman Demo. Do not forget to turn on the Monetizr section and refresh the game after you enter your credentials.
You will need your developer to proceed with integration.
To invite your developer, use For developer tab and click on the Invite button. It will redirect you to the Teams section,
Skip this step if you know what to do next and you do not need developers help.
Create your team:
And then invite your developer. Give developer a role Administrator as he is most likely the one who will need to configure your settings.
The following actions will require developer.
Your game most likely already has a rewarding engine (in-game shop, reward center, etc) integrated.
To test the reward list you can use our Tic Tac Toe game. Copy your API key from For developer tab and go to https://tutorial.themonetizr.com. Copy your API key in the Monetizr API key field and click on Show Offers button.
The Tic Tac Toe reward center will be shown in the pop-up window. You can follow through the Reward center from scratch where we show step by step how to create this reward center.
You (or your developer) will need to integrate the Monetizr API requests into the rewarding system in your game. To do that, you will need to get familiar with the following information.
API methods involved in this step:
- What are giveaway offers?
- Creating giveaway offers
- About API
- API process flow
- Creating an Offer View
- Giveaway offers with multiple choices
To actually claim (receive reward) the offer, you have to implement player credential checking process. We do this by using Webhooks.
Monetizr use webhooks to validate whether the user is allowed to actually receive the offer. To add the webhook, Go to For developer tab and add your webhook details. Read more about webhooks and what they are used for: https://docs.themonetizr.com/docs/webhooks.
Webhooks are required when the offer is claimed.
If you have reached this point, you have some understanding about how Monetizr works, here is a quick reminder:
First: Create offers in Monetizr Console,
Second: Add offers in your game (use our API or SDKs)
Third: Create the claim (action when player says he/she wants to receive this reward) request.
This is the Third step:
The player has to apply for the reward. This step requires the developer (or you) to create a claim request to the Monetizr API. In the simplest integration only the players email is a required parameter as Monetizr has to know where we need to deliver the reward.
Below you can see an example of the Claim request from our Pacman Game.
Test the claim request
- Open the Pacman Game;
- Turn on the Monetizr: Toggle switch at the bottom of the screen (See the Step 3);
- Collect the four burgers playing the Pacman;
- Open the Rewards center (to see the button complete the level or pause the game by clicking on the game screen);
- Click on the Collect reward button at the Rewards center;
- Click on the Claim button;
- You will see a congratulations screen and an e-mail will be sent to your provided email with the offers details.
Turn on the Monetizr and collect four burgers, then go to Rewards center.
Click on the Collect reward button.
Enter your email and click on the Claim button
You will see a congratulations screen and an e-mail will be sent to your provided email with the offers details.
An email will be sent to your provided email. We use Shopify as our e-commerce backbone, it allows us to automate fulfillment processes.
API methods involved in this step:
- Simple giveaway offer:
- Giveaway offer with multiple choices:
- Creating offer checkout
- Acquiring shipping rates
- Update offer with multiple choices
- Claim offer with multiple choices
- Offer checkout status
Your giveaway offer is ready to launch.
Follow your offers statistics in Stats section.
Choose pricing plan
Monetizr will not enable offer fulfillment process without an agreement. You will need to choose a pricing plan. Contact our sales stuff: [email protected].
Repeat the process with other offers. Customize the offer with your own assets.
Read more about different sections of Monetizr:
- Monetizr console: https://app.themonetizr.com
- Console user guide: https://docs.themonetizr.com/docs/creating-account
- Offer catalog: https://app.themonetizr.com/offers
- API instructions: https://docs.themonetizr.com/docs/about-api
- iOS SDK: https://docs.themonetizr.com/docs/ios
- Android SDK: https://docs.themonetizr.com/docs/android
- Unity SDK: https://docs.themonetizr.com/docs/unity
Updated 3 months ago
Want to know more?