You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Marketing analytics relies on data about customer behaviour. This can include how a customer finds you, e.g. through a campaign, and what a customer does when they interact. Kinde allows you to pass UTM data in tokens, and store it as [properties](/properties/about-properties/) in Kinde. From here, you can extrapolate campaign success and other metrics you wish to track.
14
+
Marketing analytics relies on data about customer behaviour. This can include how a customer finds you, e.g. through a campaign, and what a customer does when they interact. Kinde allows you to pass marketing tag data in tokens, and store it as [properties](/properties/about-properties/) in Kinde. From here, you can extrapolate campaign success and other metrics you wish to track.
15
15
16
-
## Set up properties in Kinde
16
+
## What tracking tags are supported?
17
17
18
-
-[Set up the properties in Kinde](/properties/about-properties/)
19
-
-[Add properties to tokens](/properties/work-with-properties/properties-in-tokens/)
18
+
Out of the box Kinde gives you 3 categories containing marketing properties which are available at both an organization and user level:
20
19
21
-
##Update your application to pass marketing codes
20
+
### UTM tags category
22
21
23
-
Wherever you have a campaign, button, or interaction that you want to track, add the property key and unique code so it is picked up and added to Kinde when the user interacts.
22
+
Contains the following properties:
23
+
24
+
* UTM source `utm_source`
25
+
* UTM medium `utm_medium`
26
+
* UTM campaign `utm_campaign`
27
+
* UTM content `utm_content`
28
+
* UTM term `utm_term`
29
+
30
+
### Google Ads smart campaign tracking
31
+
32
+
Contains the following properties:
33
+
34
+
* Google ID `gclid`
35
+
* Google click ID `click_id`
36
+
* HSA account `hsa_acc`
37
+
* HSA campaign `hsa_cam`
38
+
* HSA group `hsa_grp`
39
+
* HSA ad `hsa_ad`
40
+
* HSA source `hsa_src`
41
+
* HSA target `hsa_tgt`
42
+
* HSA keyword `hsa_kw`
43
+
* HSA match type `hsa_mt`
44
+
* HSA network `hsa_net`
45
+
* HSA version `hsa_ver`
46
+
47
+
### Marketing category
48
+
49
+
Contains the following properties:
50
+
51
+
* Match type `match_type`
52
+
* Keyword `keyword`
53
+
* Device `device`
54
+
* Ad position `ad_position`
55
+
* Facebook ID `fbclid`
56
+
* LinkedIn ID `li_fat_id`
57
+
* Microsoft ID `msclkid`
58
+
* X ID `twclid`
59
+
* TikTok ID `ttclid`
60
+
61
+
## Getting marketing tags into Kinde
62
+
63
+
There are a few mechanisms for updating these property values in Kinde.
64
+
65
+
### Pass the tracking tags via the auth flow
66
+
67
+
This is the most common method. For example, if you want to pass in the UTM source, you just need to forward the `utm_source` query parameter as part of the sign up flow authentication url. Most of our SDKs allow you to pass this in via additional URL params.
68
+
69
+
For example in the React SDK:
70
+
71
+
```jsx
72
+
<RegisterLink
73
+
className="btn btn-dark"
74
+
authUrlParams={{
75
+
utm_source:"my source",
76
+
utm_medium:"some medium",
77
+
utm_campaign:"awesome campaing",
78
+
utm_content:"something else",
79
+
utm_term:"my terms",
80
+
click_id:"1234",
81
+
}}
82
+
>Register</RegisterLink>
83
+
```
84
+
85
+
We automatically map the standard query parameters to the specific Kinde properties for you. For example `utm_source` URL param will be mapped to the `kp_usr_utm_source` Kinde parameter for a user and `kp_org_utm_source` for an organization. We map these automatically so that you do not need to make changes to the parameters in your code.
86
+
87
+
The property values are set during the sign up flow for new users and at the point of organization creation for new organizations.
88
+
89
+
### Update the tracking tags manually
90
+
91
+
* Via dashboard - Open a user or organization in Kinde, then select *Properties* from the side navigation. Update the relevant property.
92
+
* Via the Kinde Management API -
93
+
*[Update user property](https://docs.kinde.com/kinde-apis/management/#tag/users/put/api/v1/users/{user_id}/properties/{property_key}) - make sure to add `kp_usr_` as a prefix to the standard tag key.
94
+
*[Update organization property](https://docs.kinde.com/kinde-apis/management/#tag/organizations/put/api/v1/organizations/{org_code}/properties/{property_key}) - make sure to add `kp_org_` as a prefix to the standard tag key.
95
+
96
+
## Accessing marketing tags data
97
+
98
+
* Via dashboard - Open a user or organization in Kinde, then select *Properties* from the side navigation.
99
+
* Via the Kinde Management API -
100
+
*[View user properties](https://docs.kinde.com/kinde-apis/management/#tag/users/get/api/v1/users/{user_id}/properties)
## Check how specific marketing tags are performing
104
+
105
+
Likely you will want to see which tags are converting into sign ups and are performing well. For this, you can use the User search API to return all users that match a specific property value. For example, if you wanted to see all users who signed up with a UTM source of "Hello" and a UTM campaign of "World" you could use this query:
0 commit comments