Kochava Engagement provides a robust campaign creation and management tool. Campaigns can be created with specific goals in mind targeting very refined cohorts of users in order to maximize the effectiveness of each campaign.

---

Engagement Campaign Interface

---

Create a Push Campaign

NOTE: Engagement Push campaigns that are not activated may be saved as a draft and may be updated when needed.

 

WARNING: Clicking on Cancel at any time during the creation of a Push Campaign will erase any additions/changes that have been made to the campaign.

 

Description & Audience:

1. Click Create a Campaign > Push Campaign.
2. Enter a unique Campaign Name.
3. Enter a campaign Description.
4. Select Attribute Conversions on Push Open. (optional)

NOTE: Selecting Attribute Conversions on Push Open enables reengagement to be attributed to the Kochava Push Network and associated to a specific push campaign. If a user opens a push message from a campaign with this box checked it will convert that user, this is important to note in case you are also running reengagement campaigns with other networks as it could skew the results of those campaigns if the same user is hit by both a push campaign and the reengagement network.

5. Select Use Account Level Holdout. (optional)

NOTE: Selecting Use Account Level Holdout represents the percentage of users within an audience who are intentionally NOT sent the push message in order to measure lift.

6. Enter a Holdout Group Size (As Percent of Total).

NOTE: The Holdout Group Size is set by default to the Account level threshold. If a different holdout percentage is desired, un-check Use Account Level Holdout. The percentage entered will only apply to the current Push Campaign.

7. Select a Trigger Type:
   • Schedule One-Time
   • Schedule Recurring
   • Event Triggered
8. Select Target Audiences.

   NOTE: The audiences available for selection were created in the Engagement Audience tool or through Kochava Analytics. For more information about creating an Engagement Audience, refer to our Engagement Audiences support documentation.

   NOTE: Multiple Target Audiences may be added to a Push campaign.

   NOTE: Apps must have Engagement enabled within the Kochava UI. If a Target Audience is added where the associated app does not have Engagement enabled, before a campaign can be completed Push must be enabled. For more information about enabling Push, refer to our Create and Edit Apps documentation.

9. Click Next.

 



A. Click Save as Draft to complete the campaign at a different time.
B. If a push campaign specific Holdout Group is desired, enter a percentage of the audience to be set aside to calculate lift.


---

Segmentation:

Messages may be customized based on device properties such as geography, device type, device operating system or language. The options that are available for segmentation are dependent on the audience(s) selected. Segments can be reorganized by dragging and dropping the desired segment into the desired order.
1. Click Enable Segmentation.
2. Enter a unique Segment Name.
3. Type the desired Language in the search box. Select to:
• Include
• Exclude
4. Type the desired Country in the search box. Select to:
• Include
• Exclude
5. Type the desired Device OS in the search box. Select to:
• Include
• Exclude
6. Type the desired OS Version in the search box. Select to:
• Include
• Exclude
7. Type the desired App in the search box. Select to:
• Include
• Exclude
8. Click Apply.

NOTE: There is no limit of the number of segments that may be created.

NOTE: A default segment is created to serve as a catch-all for audience members that do not match the other segment definitions.

9. Click Next.

 



A. Segmentation Settings.
B. User Created Segments.
C. Default Segment.

---

Message:

The Messages section provides the ability to craft the default message or messages designed specifically for any created audience segments.

 

Default Message —

1. Enter the Message Title.
2. Enter the Default Message.
3. Enter the Alternate Android Image URL. (optional)

NOTE: Android allows alternative images to be used when an Engagement message is received. Before an alternative image may be used, specific code must be set up by the app developer. For more information on refer to our Push Notifications Android documentation.

4. Enter a Deeplink.
5. Enter a iOS Category. (optional)

NOTE: The iOS Category corresponds to the category that may be sent with the iOS Push Notification Payload.

6. Select Enable iOS Badging. (optional)

NOTE: Badges are used by iPhone to indicate that a new push message is waiting. A white number with a red background in the upper right corner of the app icon is present when there is unread information.

 



 

NOTE: A default message must always be created and will serve as a catch-all for any users that do not fall within the created segments.

 

Segment Messaging —

Specifically designed messages may be designed for each audience segment created.

1. Enter the Message Title.
2. Enter the Message text.
3. Enter the Alternate Android Image URL. (optional)
4. Enter a Deeplink.
5. Enter a iOS Category. (optional)
6. Select Enable iOS Badging. (optional)

 



A. Messaging designed for unique segments.

 

A:B Testing —

A:B testing provides the ability to create multiple messages for each audience segment in order to analyze performance and determine the highest performing message. By selecting A:B testing, an A and B message will be added to each segment including the default message. Up to 26 message variants may be added to each segment (A thru Z).
1. Select Enable A:B Testing.
2. Select Auto-Optimization:
• Off — (default) No optimization will take place. The manual set message weight will remain constant.
• Continuous — System constantly uses real-time feedback to adjust weighting based upon the individual open rates of each variant.
• Progressive — System waits 48 hours, then adjusts weights based on the relative success rates of the variants. The system then re-adjusts every 24 hours until one variant has been weighted to 100%.
• Full Redirect — System waits for 72 hours, then picks one variant as the “winner” and gives it 100% weighting.

NOTE: If Auto-Optimization is enabled, the manual message weight option will be disabled.

3. Enter (A) Message Title.
4. Enter (A) Message.
5. Enter the (A) Alternate Android Image URL. (optional)
6. Enter a (A) Deeplink.
7. Enter a (A) iOS Category. (optional)
8. Select Enable iOS Badging (optional)
9. Select a (A) Message Weight.
10. Enter (B) Message Title.
11. Enter (B) Message.
12. Enter the (B) Alternate Android Image URL. (optional)
13. Enter a (B) Deeplink.
14. Enter a (B) iOS Category. (optional)
15. Select Enable iOS Badging (optional)
16. Select a (B) Message Weight.

NOTE: The weight of each message may be set using either percentage or ratio. For example, Message A may have a weight of 75% and Message B a weight of 25%; Message A may be set to 3 and Message B may be set to 1. In this example, using either the percentage or ratio metrics will achieve the same outcome. Regardless of whether a percentage or ratio is entered into the weight field, a percentage value will be displayed below.

NOTE: Up to 24 additional message variants may be added to a segment by Clicking Add Another Variant.

NOTE: Variants may be copied in order to slightly alter and save time. In order to copy a variant, Click Variant Tools>Copy.

NOTE: A variant may be added to all segments. Enter the applicable data, and Click the green “+” button to add the variant to each segment.

NOTE: Variants may be deleted by Clicking Variant Tools>Delete.

 



A. Enter a message specifically for each variant.
B. Enter a Weight in either a percentage or ratio.
C. Clicking Add Another Variant will create an additional variant. Segments may contain up to 26 variants.

 

Send to Test Device —

During message creation, a test of the message may be sent to a device.

1. Click the Message Tool Menu > Send to Test Device.

 



 

2. Select a Test Audience:
• Target Audience
• Device ID (e.g., IDFA, ADID)

NOTE: If an audience has been created in CSV format, a phone number may be entered in the Device ID field.

NOTE: Telephone Numbers are required to follow E.164 formatting standard i.e., (208)555-1234 or +12085551234.

NOTE: If an audience is selected which is associated with an app that does not have Engagement enabled, the test message will not be sent and an error will be provided.

 



 

3. Click Send.

---

Schedule:


Schedule One-Time:

---




The Schedule tool provides the ability to determine when the campaign will begin and the ability to select the time zone for when the message will be sent to the user audience.

1. Select the Campaign Start date.
2. Select the Time Zone.
3. Click Next.

 




Schedule Recurring:

---




The Schedule tool provides the ability to determine when the campaign will begin and end, as well as how often the message(s) will be sent out and a cap on the number of times the message(s) will be sent to the user audience.

1. Select the Schedule to Run:
   • Every 30 Min
   • Hourly
   • Daily
   • Weekly
   • Monthly
2. Select the Day of the Week. (optional)
3. Select a Campaign Start and Campaign End.
4. Select the Time Zone.

NOTE: The options available within Message Delivery Cap are dependent upon the Schedule selected.

5. Select the No More Than frequency:
   • Once per Hour
   • Once per two Hours
   • Once per four Hours
   • Once per twelve Hours
   • Once per Day
   • Once per Week
   • Every other Week
   • Every three Weeks
   • Once per Month
   • Every Two Months
   • Once per Year

NOTE: The Day of the Week option is only available if Schedule > Weekly is selected.

6. Click Next.

 



A. Day of the week selection. Only available if Schedule>Weekly is selected.

---

Confirm:

The confirmation page provides an opportunity to review all of the settings for the Engagement Push Campaign prior to saving.

1. Update any campaign or segment details as needed.
2. Click Save.

 



A. The date the campaign will go live.
B. Campaign segment details.


WARNING: If errors exist within the campaign it cannot go live, and notifications will be provided identifying the error(s). While errors exist in the campaign, it cannot be saved; a campaign with errors can only be saved as a draft.

 



A. Errors in Engagement Campaign.
B. Link to address error.

Once the campaign has been saved, a notification will be displayed confirming that the Engagement campaign has been saved. Clicking Done! will automatically navigate the user to the Campaigns Overview page.

 



---

Create a SMS Campaign

Twilio Integration:

In order to create an SMS Campaign within Kochava Engagement, Twilio credentials must be associated with each app (app must be Push enabled) in your account that will run SMS Campaigns. Provide the following required information to your Client Success Manager and we will take care of the rest.

• Twilio Account SID (e.g., ‘ACXXXXXXX’)
• Twilio From Phone Number (e.g., ‘14150000000’)
• Twilio Authentication Token (e.g., ‘Basic QUM4MmQwXXXXXXXXXXOTc3OWUyYw==’ )

---

NOTE: Engagement SMS campaigns that are not activated may be saved as a draft and may be updated when needed.

 

WARNING: Clicking on Cancel at any time during the creation of a SMS Campaign will erase any additions/changes that have been made to the campaign.

 

Description & Audience:

1. Click Create a Campaign > SMS Campaign.
2. Enter a unique Campaign Name.
3. Enter a Campaign Description.
4. Select Use Account Level Holdout. (optional)

NOTE: Selecting Use Account Level Holdout represents the percentage of users within an audience who are intentionally NOT sent the SMS message in order to measure lift.

5. Enter a Holdout Group Size (As Percent of Total).

NOTE: The Holdout Group Size is set by default to the Account level threshold. If a different holdout percentage is desired, un-check Use Account Level Holdout. The percentage entered will only apply to the current SMS Campaign.

6. Select the Target Audience(s).

NOTE: The audiences available for selection were created in the Engagement Audience tool or through Kochava Analytics. For more information about creating an Engagement Audience, refer to our Engagement Audiences support documentation.

NOTE: Multiple Target Audiences may be added to a SMS campaign.

NOTE: Apps must have Engagement enabled within the Kochava UI. If a Target Audience is added where the associated app does not have Engagement enabled, before a campaign can be completed SMS must be enabled. For more information about enabling SMS, refer to our Create and Edit Apps documentation.

7. Click Next.

 



A. Click Save as Draft to complete the campaign at a different time.
B. If a SMS campaign specific Holdout Group is desired, enter a percentage of the audience to be set aside to calculate lift.

---

Message:

The Messages section provides the ability to craft the default message or messages designed specifically for any created audience segments.

 

Message —

1. Enter the Message.

NOTE: The SMS message has a maximum limit of 160 characters.

2. Enter a Destination.

NOTE: Destinations should be in an http or .com schema to ensure hyperlink recognition within messaging apps.

3. Click Next.

 



 

A:B Testing —

A:B testing provides the ability to create multiple messages for each audience segment in order to analyze performance and determine the highest performing message. By selecting A:B testing, an A and B message will be added to each segment including the default message. Up to 26 message variants may be added to each segment (A thru Z).

1. Select Enable A:B Testing.
2. Enter (A) Message.
3. Enter a (A) Destination.
4. Select a (A) Message Weight.
5. Enter (B) Message.
6. Enter a (B) Destination.
7. Select a (B) Message Weight.

NOTE: Destinations should be in an http or .com schema to ensure hyperlink recognition within messaging apps.

NOTE: The weight of each message may be set using either percentage or ratio. For example, Message A may have a weight of 75% and Message B a weight of 25%; Message A may be set to 3 and Message B may be set to 1. In this example, using either the percentage or ratio metrics will achieve the same outcome. Regardless of whether a percentage or ratio is entered into the weight field, a percentage value will be displayed below.

NOTE: Up to 24 additional message variants may be added to a segment by Clicking Add Another Variant.

NOTE: Variants may be copied in order to slightly alter and save time. In order to copy a variant, Click Variant Tools (⋮) > Copy.

NOTE: Variants may be deleted by Clicking Variant Tools (⋮) > Delete.

8. Click Next.

 



A. Enter a message specifically for each variant.
B. Enter a Weight in either a percentage or ratio.
C. Clicking Add Another Variant will create an additional variant. Segments may contain up to 26 variants.

Send to Test Device —

During message creation, a test of the message may be sent to a device.

1. Click the Message Tools (⋮) > Send to Test Device.

 



 


2. Select a Test Audience:
• Target Audience
• Enter a Phone Number

NOTE: Telephone Numbers are required to follow E.164 formatting standard i.e., (208)555-1234 or +12085551234.

NOTE: If an audience is selected which is associated with an app that does not have Engagement enabled, the test message will not be sent and an error will be provided.

 



 

3. Click Send.

---

Schedule:

The Schedule tool provides the ability to determine when the campaign will begin and end, as well as how often the message(s) will be sent out and a cap on the number of times the message(s) will be sent to the user audience.
1. Select the Schedule:
• Daily
• Weekly
• Monthly
2. Select the Day of the Week. (optional)
3. Select a Campaign Start.
4. Select a Campaign End.
5. Select a Time Zone.

NOTE: There may be targeted devices within your audience that are outside of your selected time zone.

6. Select the message frequency No More Than:
• Once per week
• Every other week
• Every three weeks
• Once per month
• Every two months
• Once per year
7. Click Next.

 



---

Confirm:

The confirmation page provides an opportunity to review all of the settings for the Engagement SMS campaign prior to saving.

1. Verify the campaign settings.
2. If needed, update the campaign information.

NOTE: The campaign breadcrumb menu may be used to quickly navigate to different locations within the SMS campaign.

3. Click Save.

 



A. Campaign breadcrumb menu may be used to quickly navigate to a location within the campaign to update.