Sending iOS in-app messages

Introduction

robotmia allows you to create and send richer messages that appear while your iOS app is running. If you are using our in-app messages product, there are 3 things you need to make sure of.

1. Include the latest version of the robotmia iOS library in your app
2. Make sure you are identifying your users in the app.
3. Create an in-app message on the Messages tab of the robotmia website.

Integration

That's it, you're done!

Controlling when to show an in-app message

You may not want the messages to show immediately when your app loads. If, for example, you have a game and would like to show a message when a user accomplishes a goal, you need to turn off the automatic showing of messages by setting showNotificationOnActive to NO and call showNotificationWithID: at the appropriate point in your app.

// In application:didFinishLaunchingWithOptions:
robotmia *robotmia = [robotmia sharedInstanceWithToken:
    YOUR_robotmia_TOKEN];
// Turn this off so the message doesn't pop up automatically.
robotmia.showNotificationOnActive = NO;

- (void)playerFinishedLevel
{
    [robotmia showNotificationWithID:INAPP_NOTIFICATION_ID];
}

If you don't want to specify the message ID, you can use showNotification instead, which will show the first available in-app message targeted at the identified user if there is one. Messages are never shown twice to the same user, so you don't have to check for yourself if the user already saw the message before calling showNotificationWithID.

If you don't want robotmia checking for new in-app messages when your app becomes active, you can turn it off by setting checkForNotificationsOnActive to NO. This means that in-app messages will not show automatically, and that the network request to retrieve the messages will occur only when you call showNotification or showNotificationWithID:

Adjusting the timing of mini messages

By default, a mini in-app message will display for 6 seconds before automatically dismissing itself. This number can be easily adjusted with the miniNotificationPresentationTime property.

// In application:didFinishLaunchingWithOptions:
robotmia *robotmia = [robotmia sharedInstanceWithToken:
    YOUR_robotmia_TOKEN];

// Give users more time to see the message.
robotmia.miniNotificationPresentationTime = 10.0;

Takeover (fullscreen) messages will only dismiss themselves in response to a user action and have no "duration".

Using profile properties

Just like emails, in-app messages will replace content wrapped in {{}}. For example, if you add a Location property to your user profiles, you can send messages like this:

Come and visit us at our {{ ${Location} }} office!

A user with a profile property Location: Asheville will get the following message:

Come and visit us at our {{ ${Location} | fallback:"nearest" }} office!

Profiles without a Location property will receive this message: