Increase Adoption & Productivity of Mobile & Web Apps - Documentation (O11)

increase-adoption-productivity-of-mobile-applications

Stable version 1.0.3 (Compatible with OutSystems 11)

Uploaded

on 31 August 2020

5.0

(3 ratings)

Documentation

1.0.3

Pyze- Outsystems Mobile App Integration

Step 1: Install and initialize Pyze into the OutSystems Mobile App.

Download the Pyze component for OutSystems Mobile App
Import the Pyze component as a dependency inside the Mobile App as shown below.
Open the module Extensibility Configurations
Add the pyze plugin JSON node to install and initialize as shown below.

Replace the mandatory Android and iOS 'PYZE_APP_KEY' obtained from https://growth.pyze.com.
You are now ready to build the project and see installs and other data on https://growth.pyze.com.

Step 2: Add custom events

To post custom event to Pyze, drag, and drop 'PostCustomEvent' action in the action flow. Replace the 'eventName' attribute value with the desired event name.
Drag 'PostCustomEventWithAttribute' action if you want to add attributes to your event as shown below. 'attributes' is a JSON string.

Step 3: User Profile API's

Pyze offers User Profile API to segment data based on users.
You can use 'SetUserProfile' action to set the user profile to Pyze. It accepts 'userId', 'pyzeProfileAttributes' and 'customProfileAttributes'.
where 'userId' is a unique user identifier string and 'pyzeProfileAttributes' are specific keys shown in the table below.

Pyze User Profile Field Name	Data Type/Description
background	(string) User background, biography or historical data
country	(string) Country codes must be sent in the ISO-3166-1 alpha-2 standard.
current_location	(object) Format: {“longitude”: -33.991894, “latitude”: 25.243732}
date_of_first_use	(the date at which the user first used the app) String in ISO 8601 format or in yyyy-MM-dd’T’HH:mm:ss.SSSZ format.
date_of_last_use	(the date at which the user last used the app) String in ISO 8601 format or in yyyy-MM-dd’T’HH:mm:ss.SSSZ format.
date_of_birth	(date of birth) String in the format “YYYY-MM-DD”, for example, 1984-06-01.
email_id	(string) Email Id
email_subscribe	(string) Acceptable values are “opt_in” (explicit approval to receive email messages), “opt_out” (explicit denial to email messages), and “subscribed” (neither opted in nor out).
email_hard_bounced	Automatically updated when a hard bounce occurs (true or false)
email_spam_reported	Automatically updated when a user marks your email as spam, via the ISP (true or false)
facebook_id	Facebook ID
first_name	(string) User’s First name
gender	(string) “M”, “F”, “O” (other), “N” (not applicable), “P” (prefer not to say) or “U” (unknown).
home_city	(string) User’s Home City
image_url	(string) URL of an image to be associated with the user
language	(string) Require language to be sent in the ISO-639-1 standard.
last_name	(string) User’s Last Name
marked_email_as_spam_at	(string) The date at which the user’s email was marked as spam. Must be in ISO 8601 format or in yyyy-MM-dd’T’HH:mm:ss.SSSZ format.
phone	(string) Phone number
push_subscribe	(string) Available values are “opted_in” (explicitly registered to receive push messages), “unsubscribed” (explicitly opted out of push messages), and “subscribed” (neither opted in nor out).
push_tokens	The array of objects with app_id and token string. You may optionally provide a device_id for the device this token is associated with, e.g., [{“app_id”: App Identifier, “token”: “abcd”, “device_id”: “optional_field_value”}]. If a device_id is not provided, one will be randomly generated.
time_zone	(string) Time Zones must be sent as per IANA Time Zone Database (e.g., “America/New_York” or “Eastern Time (US & Canada)”). Only valid values will be respected.
twitter_id	Twitter ID

Attributes which are not present above and you want to track them can be sent as 'customProfileAttributes'
Use 'UpdateUserProfile' action to update the attributes set to the user. You cannot call this API if the user is not set already.
Call 'ResetUserProfile' to reset the user profile. This action will remove the user data from the device.

Note : All the attributes objects are of a type JSON string. Example of JSON string : "{""key1"":""value1"",""key2"":""value2""}".

values here can be variable, for example : "{""key"":"""+variable+"""}"