Freshpaint React Native SDK Reference
The
track
call can be used to manually send data to your destinations. See the docs on manually tracking events in Freshpaint for more information.Freshpaint.track("Purchase", {"price": 500});
Argument | Type | Required | Description |
Event Name | String | Yes | The name of the event you want to send to Freshpaint. |
Properties | Object | No | A JSON object of properties you want to send along with the event. |
The
identify
call can used to attach user properties the current user. Destinations will then use that data to create a single profile for that user, even if data for that user comes from multiple places. See the identify docs for more information.// Associate all future events sent from
// the library with the distinct_id [email protected]
Freshpaint.identify("[email protected]", {
"email": "[email protected]",
"name": "Ada Lovelace"
});
The properties argument is optional. If you want to only attach a unique identifier to the user, you can call identify like so:
Freshpaint.identify("[email protected]");
Likewise, the identifier is also optional. If you only want to attach properties to the user without attaching an identifier, you can perform a call like the following:
Argument | Type | Required | Description |
unique_id | String | No | A string that uniquely identifies a user (such as email address). |
properties | Object | No | A JSON object of user properties to send to the destinations. |
The
group
call will add the given user to a group and attach the provided properties to the group. The callfreshpaint.group("Google", {
"plan": "enterprise",
"sign-up-date": "04/01/2019"
});
will add the current user to the "Google" group and attach the provided properties to the group.
Argument | Type | Required | Description |
unique_id | String | Yes | The ID of the group the user is being added to. |
properties | Object | No | Properties to attach to the group. |
The
reset
call clears any local Freshpaint data attached to this user. This does not clear any local data for any of your destinations.Freshpaint.reset();
The
addEventProperties
call can be used to set data layer properties. Once a property is set through addEventProperties
all events going forward will contain that property. The callFreshpaint.addEventProperties({"pricing plan": "enterprise"});
will include the property
pricing plan
with the value enterprise
until either the value is overwritten or you delete the property with removeEventProperty
. addEventProperties
should be used to set any properties that can change.Argument | Type | Required | Description |
properties | Object | Yes | An object of properties and values to attach to all events going forward. |
The
addInitialEventProperties
call works the same way as addEventProperties
except if a property is already set, addInitialEventProperties
will not override it. This is useful for when you care about the first value of some property. As an example, the callFreshpaint.addInitialEventProperties({"initial landing page": "/article"});
will set the value of the property
initial landing page
to /article
. Even after calling addInitialEventProperties
with a different of initial landing page
the value of initial landing page
will still be /article
. addInitialEventProperties
should be used to set properties that you never want to change.Argument | Type | Required | Description |
properties | Object | Yes | An object of properties and values to attach to all events going forward. |
The
removeEventProperty
call can be used to remove data layer properties. Once used, freshpaint will no longer send the given property. As an example, the call:Freshpaint.removeEventProperty('search term');
will delete the current
search term
property and Freshpaint will stop sending it going forward.Argument | Type | Required | Description |
property | String | Yes | The name of the property to remove. |
Last modified 2yr ago