Overview

Swrve is a mobile marketing automation platform.

Integrating Lytics with Swrve can improve the personalization and precision of your mobile marketing by leveraging Lytics' powerful data science driven segments for targeting.

Authorization

If you haven't already done so, you will need to set up a Swrve account before you begin the process described below. There are two types of Swrve imports that require different types of authorizations.

If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

Select Swrve from the list of providers.
Select the method for authorization. Note that different methods may support different job types. Swrve supports the following authorization methods:
- Swrve API - Import Audiences
- Swrve S3 - Import Activity Data
Enter a Label to identify your authorization.
(Optional) Enter a Description for further context on your authorization.
Complete the configuration steps needed for your authorization. These steps will vary by method.
Click Save Authorization.

Swrve API

To import audiences, Lytics uses the standard Swrve API authentication, requiring the following credentials: API Key and Personal Key. You can find more information on creating a Swrve API keys here.

In the Label text box, enter a name for the authorization.
(Optional) In the Description text box, enter a description for this authorization.
Enter your API Key credential.
Enter your Personal Key credential.

Swrve S3

To import user activity data, you must first set up a raw data export in Swrve, which exports to a S3 bucket. You will need the following credentials: AWS S3 Access Token, Secret Token, and Bucket.

In the Label text box, enter a name for the authorization.
(Optional) In the Description text box, enter a description for this authorization.
Enter your Access Token credential.
Enter your Secret Token credential.
Enter your Bucket credential.

Import Activity Data

Importing Swrve user activity data allows you to enrich your Lytics profiles and give you a more accurate view of your users' engagement.

Integration Details

Implementation Type: Server-side Integration
Implementation Technique: File Based Transfer Integration
Frequency: Batch Integration
Resulting data: Raw Event Data

This integration utilizes the Amazon S3 API to import user data. Once the import is started the workflow will:

Fetch the file selected in the configuration step from S3.
Send data to the swrve_activity stream.
Schedule the next run of the import if the Keep Updated options is selected.

Fields

The following fields are included in the default mapping of the swrve_activity stream:

Source Field	Lytics User Field	Description	Type
count(type)	swrve_currency_given_ct	Swrve Currency Given Count	int
count(type)	swrve_event_ct	Swrve Event Count	int
count(type)	swrve_iap_ct	Swrve IAP Count	int
count(type)	swrve_purchase_ct	Swrve Purchase Count	int
count(type)	swrve_session_end_ct	Swrve Session End Count	int
count(type)	swrve_session_start_ct	Swrve Session Start Count	int
device_id	swrve_device_id	Swrve Device ID	string
device_name	swrve_device_name	Swrve Device Name	string
game	swrve_game	Swrve Game	string
max(epochms())	swrve_last_purchase_ts	Swrve Last Purchase	date
min(epochms())	swrve_first_purchase_ts	Swrve First Purchase	date
name	swrve_activity_name	Swrve Activity Name	string
os	swrve_os	Swrve OS	string
os_version	swrve_os_version	Swrve OS Version	string
product_id	swrve_product_id	Swrve Product ID	string
type	swrve_activity_type	Swrve Activity Type	string
user	swrve_user_id `unique id`	Swrve User ID	string
valuect(type)	swrve_activty_ct	Swrve Events	map[string]intsum

Configuration

Follow these steps to set up and configure an import job for Swrve in the Lytics platform.If you are new to creating jobs in Lytics, see the Data Sources documentation for more information.

Select Swrve from the list of providers.
Select the Import Activity Data job type from the list.
Select the Authorization you would like to use or create a new one.
Enter a Label to identify this job you are creating in Lytics.
(Optional) Enter a Description for further context on your job.
Complete the configuration steps for your job.
From the File input, select choose the file, or if this is a continuous import, choose the first file in a dated sequence to import. Listing files may take up to a couple minutes.
(Optional) Select the Keep Updated checkbox to continuously run this import.
(Optional) Toggle Show Advanced Options.
1. (Optional) In the File Prefix text box, enter enter the file name prefix. You may use regular expressions.
2. (Optional) From the Time of Day input, select time of day to complete the import each day.
3. (Optional) From the Timezone input, select.
Click Start Import.

Import Audiences

Integrating Swrve and Lytics allows you to unite user data across channels and leverage Lytics' powerful data science driven segments for targeting.

Integration Details

Implementation Type: Server-side Integration
Implementation Technique: REST API Integration
Frequency: Batch Integration
Resulting data: User Profiles

This integration utilizes the Swrve APIs import user data. Once the import is started the workflow will:

Import all user data into the swrve_users stream.
Schedule the next run of the import if the Keep Updated options is selected.

Fields

The following fields are included in the default mapping of the swrve_users stream:

Source Field	Lytics User Field	Description	Type
epochms()	swrve_last_user_imported	Last User Imported	date
max(totimestamp(last_active))	last_active_ts	Last Active on Any Channel	date
max(totimestamp(last_active))	swrve_last_active	Swrve Last Active	date
milliseconds_played	swrve_milliseconds_played	Swrve Milliseconds Played	int
min(totimestamp(date_joined))	swrve_date_joined	Swrve Date Joined	date
min(totimestamp(swrve_install_date))	swrve_install_date	Swrve Install Date	date
spend	swrve_spend	Swrve Spend	number
swrve_all_events	swrve_all_events	Swrve All Events	int
swrve_app_store	swrve_app_store	Swrve App Store	string
swrve_app_version	swrve_app_version	Swrve App Version	string
swrve_conversation_version	swrve_conversation_version	Swrve Conversation Version	string
swrve_data_id	swrve_data_id `unique id`	Swrve Data ID	string
swrve_device_dpi	swrve_device_dpi	Swrve Device DPI	int
swrve_device_height	swrve_device_height	Swrve Device Height	int
swrve_device_name	swrve_device_name	Swrve Device Name	string
swrve_device_region	swrve_device_region	Swrve Device Region	string
swrve_device_width	swrve_device_width	Swrve Device Width	int
swrve_error_invalid_currency	swrve_invalid_currency	Swrve Invalid Currency Errors	int
swrve_first_session	swrve_first_session	Swrve First Session	int
swrve_ios_min_version	swrve_ios_min_version	Swrve iOS Minimum Version	string
swrve_language	swrve_language	Swrve Language	string
swrve_location_version	swrve_location_version	Swrve Location Version	string
swrve_messages_campaigns_downloaded	swrve_cmpgns_downloaded	Swrve Messages Campaigns Downloaded	int
swrve_os	swrve_os	Swrve OS	string
swrve_os_version	swrve_os_version	Swrve OS Version	string
swrve_permission_ios_camera	swrve_permission_ios_camera	Swrve iOS Camera Permission	string
swrve_permission_ios_contacts	swrve_permission_ios_contacts	Swrve iOS Contacts Permission	string
swrve_permission_ios_location_always	swrve_permission_ios_location_always	Swrve iOS Location Always Permission	string
swrve_permission_ios_location_when_in_use	swrve_permission_ios_location_when_in_use	Swrve iOS Location In Use Permission	string
swrve_permission_ios_photos	swrve_permission_ios_photos	Swrve iOS Photos Permission	string
swrve_permission_ios_push_notifications	swrve_permission_ios_push_notifications	Swrve iOS Push Permission	string
swrve_sdk_version	swrve_sdk_version	Swrve SDK Version	string
swrve_segments	swrve_segments	Swrve Segments	string
swrve_session_start	swrve_session_start	Swrve Session Start	int
swrve_sim_operator_code	swrve_sim_operator_code	Swrve SIM Operator Code	string
swrve_sim_operator_iso_country_code	swrve_sim_operator_iso_country_code	Swrve SIM Operator Country	string
swrve_sim_operator_name	swrve_sim_operator_name	Swrve SIM Operator Name	string
swrve_timezone_name	swrve_timezone_name	Swrve Timezone Name	string
swrve_user_id	swrve_user_id `unique id`	Swrve User ID	string
swrve_user_properties_changed	swrve_user_properties_changed	Swrve User Properties Changed	int
swrve_utc_offset_seconds	swrve_utc_offset_seconds	Swrve UTC Offset Seconds	int

Configuration

Follow these steps to set up and configure an import job for Swrve in the Lytics platform.If you are new to creating jobs in Lytics, see the Data Sources documentation for more information.

Select Swrve from the list of providers.
Select the Import Audiences job type from the list.
Select the Authorization you would like to use or create a new one.
Enter a Label to identify this job you are creating in Lytics.
(Optional) Enter a Description for further context on your job.
Complete the configuration steps for your job.
(optional) Select the Keep Updated checkbox, to continuously run this import.
(Optional) Toggle Show Advanced Options.
1. (Optional) From the Time of Day input, select time of day to complete the import each day.
2. (Optional) From the Timezone input, select timezone for time of day.
Click Start Import.