Message to Earn (M2E)

Best Practices

• Message to Earn should be set up with currency sales or running any type of targeting test to maximize effectiveness of Offerwall.
• Message to Earn should appear at the home screen/main menu to introduce users to the Offerwall.
• Test, test, test! Run M2E for 10-20% of your traffic via an A/B test to measure the efficacy of your M2E messaging.
• Customize your Message to Earn to mimic the look and feel of your game.

Using Message to Earn (M2E)

• On app open, after main app loading is completed
• Insufficient currency pop-up or user abandon pop-up
• From app inbox message (if available)
• After game level or event is completed
• From app messaging

Setting up Message to Earn content cards

1. On the left navigation, select “Create Content”. Then select “Message to Earn”.
2. Proceed to set up your content card.
3. Under Message, you can either add your own custom image or request one created by Tapjoy's team. Do the following too add a custom image:
   • Select Upload Image.
   • Select a transition type.
   • Create a custom message text.
4. Under Placement, select the placement where you would like the Message to Earn to appear to your users.
5. Select Save.

Advanced Setup

Currency Sale

• Personalize your currency sale with Message to Earn to create more awareness around the sale. Instructions on how to create can be found here.

Targeting

• Target specific segments of users with personalized messages. Common examples include the following:
  • Introduce first time users who have not used Offerwall
  • Encourage users that have not completed an offer in X days
  • Nudge users that have not logged into the Offerwall in X days
  • Re-engage users that are in mid-Offerwall event ie 3/7
  • For more information, refer to Targeting

A/B Testing

• To optimize your message to users, you can run an A/B test to validate the most effective copy with data by doing the following:
  • When creating your content card, toggle on the A/B test.
  • Under A/B Test, select “Add a Variant”. For each variant, you upload different images and messages.
  • Finish creating your content card and select Save.
  • Learn more about Tapjoy's A/B Testing tool here.

Deeplinking internal messaging to Offerwall

1. Create a contextual placement in the dashboard that will represent your internal message. We recommend naming it in relation to what the placement represents ex. Custom_Popup. For instructions on how to do this, refer to Placements.
2. Create Offerwall Card(s) that you want your users to be directed to from the message. In this step, ensure that you do not enable Message to Earn so users will not be shown two messages, both M2E and internal. For instructions on how to do this, refer to Offerwall cards setup.
3. Implement the placement in your code. To request a Placement, use the TJPlacement class. Be sure the Placement name string in your code matches the Placement name you've set up in the dashboard exactly from step one.

TJPlacementListener placementListener = this;
TJPlacement p = Tapjoy.getPlacement("[PLACEMENT_NAME]", placementListener);

// Listeners

public void onRequestSuccess(TJPlacement placement);
public void onRequestFailure(TJPlacement placement, TJError error);
public void onContentReady(TJPlacement placement);
public void onContentShow(TJPlacement placement);
public void onContentDismiss(TJPlacement placement);

4. Once the listener methods are in place, and the placement has been instantiated, you can request content for that placement.

if(Tapjoy.isConnected()) {
  p.requestContent();
} else {
  Log.d("MyApp", "Tapjoy SDK must finish connecting before requesting content.");
}

5. Before you request content, ensure that the Tapjoy connect call has succeeded. Do not make a request before you have received the onConnectSuccess callback.
6. When the content is ready, you can show it.

Android
public void onContentReady(TJPlacement tjPlacement) {
  if(tjPlacement.isContentReady()) {
      p.showContent();
  }
}