Link analytics

Through the onUIEvent callback function, it is possible to track what the users are doing within Argyle Link.

This provides a better understanding of users' behavior and allows you to troubleshoot and optimize conversion rates.

Persistent properties

The onUIEvent is invoked when specific events are activated. These events are passed with a data object with persistent properties as follows:

linkItem string

Link Item ID.

accountId string

Account ID.

userID string

User ID.

deepLink boolean

Denotes if deep Link is activated.

Possible values: true, false.

{
    "name": "login - form submitted",
    "properties": {
        // Persistent:
        "linkItem": "kroger",
        "accountId": "e98d80cfecd94bbf96b11d58382b96ef",
        "userId": "e98d80cfecd94bbf96b11d58382b96ef",
        "deepLink": false,
    }
}

Event-specific properties

In addition to the persistent properties, events can have specific properties. Find below all the Link screens on which events can be triggered and their respective event-specific properties (if applicable):

Intro screen

Search screen

Event properties

term string

The text entered in the search field.

tab string

The tab that the user has opened when entering text in the search field. This is ignored for an empty term, so if a user deletes the search term, the event callback will not be started.

Possible values: All, Employer, Gig, Payroll.

Login screen

Event properties

errorCode string

The error code received while opening the Login screen.

Possible values: see connection.error_code.

errorMessage string

The error message received while opening the Login screen.

MFA screen

Event properties

type string

Denotes whether the user was in the Login or Pay distribution screen when a multi-factor authentication (MFA) screen was shown to the user.

Possible values: Login, PD Review.

mfaType string

Denotes the type of multi-factor authentication (MFA) method that was required of the user.

Possible values:
sms_code, email_code, secret_question, email_link_confirmation, otp_code, email_message_conformation.

Success screen

Event properties

Account Status screen

Event properties

Pay distribution screen

Event properties

showEdit boolean

Denotes if the Edit button was shown.

Possible values: true, false.

defaultSplit string

Denotes which pay allocation type was shown as the default one when the user opened the Pay distribution screen.

Possible values: percent, amount.

splits string

Denotes which pay allocation type was available when the user opened the Pay distribution screen.

Possible values: percent, amount, both.

Pay distribution edit screen

Event properties

defaultSplit string

Denotes which pay allocation type was shown as the default one when the user opened the Pay distribution screen.

Possible values: percent, amount.

splits string

Denotes which pay allocation type was available when the user opened the Pay distribution screen.

Possible values: percent, amount, both.

Pay distribution success screen

Event properties

Account Error screen

Event properties

connectionStatus string

Represents the status of the link between Argyle and the work platform.

Possible values: see connection.status.

connectionErrorCode string

Provides information on why the connection failed when connection.status is error.

Possible values: see connection.error_code.

payDistributionStatus string

Denotes the point in the process of the pay distribution update process.

Possible values: see pay_distribution.status.

payDistributionErrorCode string

Provides information on why the pay distribution update was unsuccessful when pay_distribution.status is error.

Possible values: see pay_distribution.error_code.

Error screen

Event properties

errorType string

The type of error received while opening Link.

Possible values: generic, invalid_link_items, invalid_pd_config, invalid_link_key, invalid_user_token.

Multiple screens

The event below happens on several screens:

Event properties

{
    "name": "pd review - opened",
    "properties": {
        // Persistent:
        "linkItem": "kroger",
        "accountId": "e98d80cfecd94bbf96b11d58382b96ef",
        "userId": "e98d80cfecd94bbf96b11d58382b96ef",
        "deepLink": false,
        // Event specific:
        "showEdit": true,
        "defaultSplit": "amount",
        "splits": "both"
    }
}