Specifying Uses
Uses define how collected data will be utilized and optionally where it may be stored/processed.
As part of a Data License, you not only define what data is collected, but how it will be used. These fields are specifically designed to simplify building enforcement rules, and are not typically displayed to the user.
Use Cases
The purpose for the data collection.
For example, the use of a user's MAID (IDFA/GAID) for ad attribution. The license is for the MAID asset (see Selecting a Pointer Record), and the use case is ad attribution.
Use cases are an enumerated string, with support for custom use cases in the format of custom:<custom_usecase>
. Supported Enums:
Enum | Description |
---|---|
attribution | determine the actions that led to an outcome |
retargeting | advertise to and reach users, often on other platforms |
personalization | tailor messaging, offers, features, etc., to an individual |
ai_training | train machine learning models with user data |
distribution | distribute/relicense data, insights, signals, etc., to 3rd-parties |
analytics | extract insights and signals from user data |
support | add user data into customer support processes |
custom:<xyz> | a custom use case relevant to your business |
Destinations
Use include an optional destination field, where the asset may be explicitly stored or processed explicitly for the use case. This is helpful in license enforcement when one or more 3rd-parties are involved in the use.
Destinations may be either:
- an explicit destination (your-co.com) or category of destinations (data marketplaces).
- [recommended] Regex (ECMAScript) such as
'\.your-co\.com'
which functions akin to a subdomain wildcard. Don't forget to escape tokens like.
→\.
🙃.
Example
TikiSdk.config()
.offer
.use({
usecases:[
TikiSdk.LicenseUsecase.attribution(),
TikiSdk.LicenseUsecase.custom("YOUR CUSTOM USECASE")
],
destinations: [
'\.your-co\.com',
'\.facebook\.com'
]
})
try? TikiSdk.config()
.offer
.use(
usecases: [
LicenseUsecase.attribution,
LicenseUsecase("YOUR CUSTOM USECASE")
],
destinations: [
"\.your-co\.com",
"\.facebook\.com"
])
TikiSdk
.offer
.use(
listOf(
LicenseUsecase.ATTRIBUTION,
LicenseUsecase("YOUR CUSTOM USECASE")
),
listOf(
"\.your-co\.com",
"\.facebook\.com"
)
)
await TikiSdk.config()
.offer
.use(
[
LicenseUsecase.attribution(),
LicenseUsecase.custom("YOUR CUSTOM USECASE")
],
destinations: [
"\.your-co\.com",
"\.facebook\.com"
])
Updated about 1 month ago