Skip to end of metadata
Go to start of metadata

 Mobile Data campaigns enable your iOS and Android apps to process/render Evergage campaign data however you like. The Evergage Platform handles triggering campaigns and delivering the data to your app. Your developer(s) write 'campaign handler(s)' as app code to flexibly consume campaign data. Once that code is in place, campaigns can deliver dynamic content to your app.

For example, you can use Mobile Data campaigns for:

  • Messaging: One app already has its own banner/infobar system and uses Evergage campaigns to feed it information about sales, promotions, user credit/points, and other data.
  • Recommendations: Apps can have content zones (sometimes called 'targets') to display recommended items. A campaign can deliver recommendations to the campaign handler code.

How does it work?

  1. The mobile app code registers campaign handlers for targets (content zones)
  2. The mobile app's Evergage integration sends events (like screen/product views) to Evergage
  3. Campaigns may be triggered in response to these events
  4. The mobile app's campaign handler code gets called with campaign data, in JSON format, to process/render
  5. The mobile app calls Evergage APIs to track impressions/dismissals/clicks as appropriate
This Article Explains

This article details how to create a mobile data campaign.

Sections in this Article

Android/iOS App Setup

See Mobile Data Campaigns Guide in Evergage SDK documentation:


Creating a Mobile Data Campaign in the Evergage Platform

Create a New Mobile Data Campaign

Mobile data campaigns are created at the Campaign level in the Evergage platform.

  1. Log into the Evergage platform with Campaign Editor or higher permissions
  2. In the Channels & Campaigns section, hover over Mobile, then select Mobile Data Campaigns 
  3. Click New Campaign




Define Target and Add Data to Experience

  1. Enter a Target which is a 'content zone' of the app that should match the app code (see Android/iOS App Setup above)
  2. Define data payload by building up Name/Value/Type rows
    1. Click Add New to insert a new data item
    2. Name: String identifier for the data item. Static only, not dynamic.
    3. Type: What kind of data the Value should be
      1. Text: Value will be a JSON string
      2. Number: Value will be a JSON number
      3. Promoted Content: Value will be defined by the promoted content in Message Rules (see below for how to configure)
    4. Value: Static or dynamic value for the data item, for the indicated Type (see below for how to use dynamic values)
  3. Click Copy To All to copy the data item value across all experiences
  4. Click Delete to remove the data item from all experiences



Configure Promoted Content

This is typically used to obtain item(s) from the catalog for recommendations/promotions.

  1. Set a data item's Type to Promoted Content

  2. Configure Promoted Content in Message Rules

  3. Set the data item's Value to either:

    1. $items - Return all applicable items in a JSON array

    2. $item - Return one applicable item as a JSON object



Using Dynamic Values

  • Data items with Type of Text and Number can provide dynamic values, such as user name, attributes, and much more
  • Insert dynamic content queries by selecting the Value entry, clicking the Dynamic+ dropdown, and selecting an option
  • Value entries for Text and Number types can use Dynamic Message Content (DMC) and Advanced Dynamic Message Content (ADMC). If the value cannot be fulfilled, then the experience (and potentially the campaign) cannot be triggered. You can use the #field syntax to provide a fallback value




Configuring Targeting

A/B Tests and Rule-Based Targeting

  1. Click SETUP 
  2. Select Experiences
  3. Here you can:
    1. Clone the Experience you made
    2. Set up A/B tests and control percentages
    3. Target experiences based on rules



Campaign Targeting Rules and Goals

  1. Click SETUP 
  2. Select Campaign Settings to access this interface
  3. Here you can:
    1. Set up the Goals for this particular campaign - remember all campaigns are auto-attributed against the Global Goals you have configured
    2. Set up Campaign-wide rules - limit the campaign to particular segments, pages, actions, or other criteria 
    3. Schedule the campaign