This feature is available only with paid Kochava accounts. Contact us to learn more.
Engagement Campaign Interface
- Log in to Free App Analytics.
- Select the desired Account and App.
- Select Engagement > Campaigns.
Create a Push Campaign
NOTE: Engagement Push campaigns that are not activated may be saved as a draft and may be updated when needed.
Description & Audience:
- Click Create a Campaign > Push Campaign.
- Enter a unique Campaign Name.
- Enter a campaign Description.
- Select Attribute Conversions on Push Open. (optional)
- Select Use Account Level Holdout. (optional)
- Enter a Holdout Group Size (As Percent of Total).
- Select a Trigger Type:
- Schedule One-Time
- Schedule Recurring
- Event Triggered
- 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.
- Click Next.
- Click Enable Segmentation.
- Enter a unique Segment Name.
- Type the desired Language in the search box. Select to:
- Include
- Exclude
- Type the desired Country in the search box. Select to:
- Include
- Exclude
- Type the desired Device OS in the search box. Select to:
- Include
- Exclude
- Type the desired OS Version in the search box. Select to:
- Include
- Exclude
- Type the desired App in the search box. Select to:
- Include
- Exclude
- Click Apply.
- Click Next.
- Enter the Message Title.
- Enter the Default Message.
- Enter the Alternate Android Image URL. (optional)
- Enter a Deeplink.
- Enter a iOS Category. (optional)
- Select Enable iOS Badging. (optional)
- Enter the Message Title.
- Enter the Message text.
- Enter the Alternate Android Image URL. (optional)
- Enter a Deeplink.
- Enter a iOS Category. (optional)
- Select Enable iOS Badging. (optional)
- Select Enable A:B Testing.
- 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.
- Enter (A) Message Title.
- Enter (A) Message.
- Enter the (A) Alternate Android Image URL. (optional)
- Enter a (A) Deeplink.
- Enter a (A) iOS Category. (optional)
- Select Enable iOS Badging (optional)
- Select a (A) Message Weight.
- Enter (B) Message Title.
- Enter (B) Message.
- Enter the (B) Alternate Android Image URL. (optional)
- Enter a (B) Deeplink.
- Enter a (B) iOS Category. (optional)
- Select Enable iOS Badging (optional)
- Select a (B) Message Weight.
- Click the Message Tool Menu > Send to Test Device.
- Select a Test Audience:
- Target Audience
- Device ID (e.g., IDFA, ADID)
- Click Send.
- Select the Campaign Start date.
- Select the Time Zone.
- Click Next.
- Select the Schedule to Run:
- Every 30 Min
- Hourly
- Daily
- Weekly
- Monthly
- Select the Day of the Week. (optional)
- Select a Campaign Start and Campaign End.
- Select the Time Zone.
- 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
- Click Next.
- Update any campaign or segment details as needed.
- Click Save.
- Twilio Account SID (e.g., ‘ACXXXXXXX’)
- Twilio From Phone Number (e.g., ‘14150000000’)
- Twilio Authentication Token (e.g., ‘Basic QUM4MmQwXXXXXXXXXXOTc3OWUyYw==’ )
- Click Create a Campaign > SMS Campaign.
- Enter a unique Campaign Name.
- Enter a Campaign Description.
- Select Use Account Level Holdout. (optional)
- Enter a Holdout Group Size (As Percent of Total).
- Select the Target Audience(s).
- Click Next.
- Enter the Message.
- Enter a Destination.
- Click Next.
- Select Enable A:B Testing.
- Enter (A) Message.
- Enter a (A) Destination.
- Select a (A) Message Weight.
- Enter (B) Message.
- Enter a (B) Destination.
- Select a (B) Message Weight.
- Click Next.
- Click the Message Tools (⋮) > Send to Test Device.
- Select a Test Audience:
- Target Audience
- Enter a Phone Number
- Click Send.
- Select the Schedule:
- Daily
- Weekly
- Monthly
- Select the Day of the Week. (optional)
- Select a Campaign Start.
- Select a Campaign End.
- Select a Time Zone.
- 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
- Click Next.
- Verify the campaign settings.
- If needed, update the campaign information.
- Click Save.
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.
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.
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.
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.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.
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 —
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.
NOTE: The iOS Category corresponds to the category that may be sent with the iOS Push Notification Payload.
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.
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).NOTE: If Auto-Optimization is enabled, the manual message weight option will be disabled.
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.
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.
Schedule:
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.
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.
NOTE: The options available within Message Delivery Cap are dependent upon the Schedule selected.
NOTE: The Day of the Week option is only available if Schedule > Weekly is selected.
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.
A. The date the campaign will go live.
B. Campaign segment details.
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.
NOTE: Engagement SMS campaigns that are not activated may be saved as a draft and may be updated when needed.
Description & Audience:
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.
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.
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.
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 —
NOTE: The SMS message has a maximum limit of 160 characters.
NOTE: Destinations should be in an http or .com schema to ensure hyperlink recognition within messaging apps.
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).
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.
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.
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.
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.NOTE: There may be targeted devices within your audience that are outside of your selected time zone.
Confirm:
The confirmation page provides an opportunity to review all of the settings for the Engagement SMS campaign prior to saving.
NOTE: The campaign breadcrumb menu may be used to quickly navigate to different locations within the SMS campaign.
A. Campaign breadcrumb menu may be used to quickly navigate to a location within the campaign to update.