🔥 Full Tenjin access for $200/month — all features, no add‑ons, cancel anytime. See pricing & features

Sign up
View Categories

Server-To-Server (S2S) Setup

11 min read

Event API #

(to be used to send First App Open and App Open events)

Authentication:

We authenticate every request sent to the Tenjin server using the Tenjin SDK Key

POST or GET URL:

https://track.tenjin.com/v0/event

A response of {“code”:200} indicates a successful request.

Parameters:

*: required

ParameterTypeDescriptionExample
api_key*StringSDK key Tenjin generated for each app. Please find it on the app page. If you use basic authentication instead, this parameter is not needed.ENECCCVB8UQVLPSQ58S8EZXTJHA7FHDW
analytics_installation_id*UUIDTenjin generated Application Install-specific identifier.Available by S2S callbacks or SDK(Android SDK,iOS SDK,Unity SDK)29eeb1610fe74997b6d53f02e9711f8c
advertising_id*StringThe raw advertising ID of the device. For opt-out users, it can be empty or all zeros.f024e65f3dd94f16983726bcef192d68
developer_device_id (*required for iOS)StringThe identifier for vendorb6bc48fe0ce949e4b229ce6c55663fca
bundle_id*StringBundle ID of the app.com.tenjin.wordfinder
platform*Stringios, android, amazon, android_otherios 
limit_ad_trackingString1 for yes, 0 for no.1
os_version*StringFor Android: 
String os_version = String.valueOf(Build.VERSION.SDK_INT)
For iOS:
[[UIDevice currentDevice] systemVersion]		8.0
app_versionFloat, DecimalThe version of your app
For Android:
String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode)
For iOS:
[[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”]		1.0.3
sdk_version*Stringserverserver
countryStringThe ISO locale country codes standard (see Apple documentation for example).US
ip_addressStringThe User’s IP Address.  This is used to lookup country. If this parameter is missing, we will use IP in http header.71.165.85.114
ad_user_data BooleanGoogle User Consent Signal Parameter: consent of 3P transmission of user level data for ads1 for consent granted0 for consent deniedRemove the parameter entirely from the request (do not set blank) when there is no user consent data1
ad_personalization Boolean Google User Consent Signal Parameter: consent of personalized ads1 for consent granted0 for consent deniedRemove the parameter entirely from the request (do not set blank) when there is no user consent data1
referrerStringCollected for Android installs trackedcampaign_id%3D%26clicked_at%3D
os_version_release (*required to track Google Ads)StringFor Android: 
String os_version_release = String.valueOf(Build.VERSION.RELEASE)
For iOS:
[[UIDevice currentDevice] systemVersion]		8.0.1
build_id (*required to track Google Ads)StringFor Android: 
String build = String.valueOf(Build.ID)
For iOS: 
@import Darwin.sys.sysctl;
NSString *build(void) {  size_t bufferSize = 64;  NSMutableData *buffer =    [[NSMutableData alloc]      initWithLength:bufferSize];  int status =    sysctlbyname(“kern.osversion”,      buffer.mutableBytes,      &bufferSize, NULL, 0);  if (status != 0) {    return nil;  }  return [[NSString alloc]    initWithCString:buffer.mutableBytes    encoding:NSUTF8StringEncoding];}		UP1B.231005.007
locale (*required to track Google Ads)StringFor Android:
String locale = Locale.getDefault().toString()
For iOS:
[[NSLocale currentLocale] localeIdentifier]		es_AR
device_model (*required to track Google Ads)StringFor Android:
String device = Build.MODEL;
For iOS:
@import Darwin.sys.sysctl;
NSString *device(void) {  size_t bufferSize = 64;  NSMutableData *buffer =    [[NSMutableData alloc]      initWithLength:bufferSize];  int status =    sysctlbyname(“hw.machine”,      buffer.mutableBytes,      &bufferSize, NULL, 0);  if (status != 0) {    return nil;  }  return [[NSString alloc]    initWithCString:buffer.mutableBytes    encoding:NSUTF8StringEncoding];}		SM-F731A
odm_infoStringThis is the string required for running probabilistic Attribution via Google Ads for iOS. You will need to fetch this from the ODM SDK first. AB7Dr_EJBWQ_lT_l1V0z5xqDB9MnLGbINV5r2w1jhVTITlm0IK7QE16Bf2sIjI_twjeMoQl3SedWsZiPtijTZ2DkUYI_H9RI6lkStqbwmBVsnu_QH4hfkuJeMwhFEzBEJCz3a8cdD2U1MRd1jwn2b_hbaHsbVO3NlE0xsExo5HtcuWmsaMdddKn9vFRPtyPQvSLjSl4AlsdyAaYg9Hw-FyYfm9eAbqrxy3NXkZtjJeXRThMG6MTNJA
customer_user_idStringcustom User ID for the eventjdabGcerT32_d

Purchase API #

(to be used to send Purchase events)

Authentication:

We authenticate every request sent to the Tenjin server using the Tenjin SDK Key

POST or GET URL:

https://track.tenjin.com/v0/purchase

Parameters:

*: required

ParameterTypeDescriptionExample
api_key*StringSDK key Tenjin generated for each app. Please find it on the app page. If you use basic authentication instead, this parameter is not needed.ENECCCVB8UQVLPSQ58S8EZXTJHA7FHDW
analytics_installation_id*UUIDTenjin generated Application Install-specific identifier.Available by S2S Callbacks or SDK.Android SDK,iOS SDK,Unity SDK29eeb1610fe74997b6d53f02e9711f8c
advertising_id*StringThe raw advertising ID of the device. For opt-out users, it can be empty or all zeros.f024e65f3dd94f16983726bcef192d68
developer_device_id (*required for iOS)StringThe identifier for vendorb6bc48fe0ce949e4b229ce6c55663fca
bundle_id*StringBundle ID of the app.com.tenjin.wordfinder
platform*Stringios, android, amazon, android_otherios
limit_ad_trackingString1 for yes, 0 for no.1
os_version*StringFor Android: 
String.valueOf(Build.VERSION.SDK_INT)
For iOS: [[UIDevice currentDevice] systemVersion]		8.0
app_version (*required to track Google Ads)Float, DecimalThe version of your app
For Android:
String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode)
For iOS:
[[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”]		1.0.3
sdk_version*Stringserverserver
ip_addressStringThe User’s IP Address.  This is used to look up countries for Google DMA user consent parameters. If this parameter is missing, we will use IP in http header.71.165.85.114
ad_user_data BooleanGoogle User Consent Signal Parameter: consent of 3P transmission of user level data for ads1 for consent granted0 for consent deniedRemove the parameter entirely from the request (do not set blank) when there is no user consent data1
ad_personalization Boolean Google User Consent Signal Parameter: consent of personalized ads1 for consent granted0 for consent deniedRemove the parameter entirely from the request (do not set blank) when there is no user consent data1
postcutString1 for sending purchases after the platform cut1
product_id*StringUnique name for the product purchased.coin_store
price*Float, DecimalThe unit price of the item purchased in the currency standard unit (ex. USD is reported in dollars).0.99
quantity*IntegerThe number of units purchased.1
countryStringThe ISO locale country codes standard (see Apple documentation for example).US
currency*StringThe ISO currency codes used by Apple and Google (see Apple documentation for example).USD
os_version_release (*required to track Google Ads)StringFor Android: 
String os_version_release = String.valueOf(Build.VERSION.RELEASE)
For iOS:
[[UIDevice currentDevice] systemVersion]		14
build_id (*required to track Google Ads)StringFor Android: 
String build = String.valueOf(Build.ID)
For iOS: 
@import Darwin.sys.sysctl;
NSString *build(void) {  size_t bufferSize = 64;  NSMutableData *buffer =    [[NSMutableData alloc]      initWithLength:bufferSize];  int status =    sysctlbyname(“kern.osversion”,      buffer.mutableBytes,      &bufferSize, NULL, 0);  if (status != 0) {    return nil;  }  return [[NSString alloc]    initWithCString:buffer.mutableBytes    encoding:NSUTF8StringEncoding];}		UP1B.231005.007
locale (*required to track Google Ads)StringFor Android:
String locale = Locale.getDefault().toString()
For iOS:
[[NSLocale currentLocale] localeIdentifier]		es_AR
device_model (*required to track Google Ads)StringFor Android:
String device = Build.MODEL;
For iOS:
@import Darwin.sys.sysctl;
NSString *device(void) {  size_t bufferSize = 64;  NSMutableData *buffer =    [[NSMutableData alloc]      initWithLength:bufferSize];  int status =    sysctlbyname(“hw.machine”,      buffer.mutableBytes,      &bufferSize, NULL, 0);  if (status != 0) {    return nil;  }  return [[NSString alloc]    initWithCString:buffer.mutableBytes    encoding:NSUTF8StringEncoding];}		SM-F731A
customer_user_idStringcustom User ID for the eventjdabGcerT32_d

If you don’t have a proper receipt or signature, don’t add the parameters at all to the request URL. We can still show the purchase without receipt or signature via S2S on the dashboard.

Custom Event API #

(to be used to send all Custom Events)

Authentication:

We authenticate every request sent to the Tenjin server using the Tenjin SDK Key

POST or GET URL:

https://track.tenjin.com/v0/event

Parameters:

*: required

ParameterTypeDescriptionExample
api_key*StringSDK key Tenjin generated for each app. Please find it on the app page. If you use basic authentication instead, this parameter is not needed.ENECCCVB8UQVLPSQ58S8EZXTJHA7FHDW
analytics_installation_id*UUIDTenjin generated Application Install-specific identifier.Available by S2S callbacks or SDK.Android SDK,iOS SDK,Unity SDK29eeb1610fe74997b6d53f02e9711f8c
advertising_id*StringThe raw advertising ID of the device. For opt-out users, it can be empty or all zeros.f024e65f3dd94f16983726bcef192d68
developer_device_id (*required for iOS)StringThe identifier for vendorb6bc48fe0ce949e4b229ce6c55663fca
bundle_id*StringBundle ID of the app.com.tenjin.wordfinder
platform*Stringios, android, amazon, android_otherios
limit_ad_trackingString1 for yes, 0 for no.1
os_version*StringFor Android: 
String.valueOf(Build.VERSION.SDK_INT)
For iOS: 
[[UIDevice currentDevice] systemVersion]		8.0
app_version (* required for Google Ads)Float, DecimalThe version of your app
For Android:
String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode)
For iOS:
[[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”]		1.0.3
sdk_version*Stringserverserver
ip_address StringThe User’s IP Address.  This is used to lookup country. If this parameter is missing, we will use IP in http header.71.165.85.114
ad_user_dataBooleanGoogle User Consent Signal Parameter: consent of 3P transmission of user level data for ads1 for consent granted0 for consent deniedRemove the parameter entirely from the request (do not set blank) when there is no user consent data1
ad_personalization Boolean Google User Consent Signal Parameter: consent of personalized ads1 for consent granted0 for consent deniedRemove the parameter entirely from the request (do not set blank) when there is no user consent data1
event*StringThis is the name of the event – event name (e.g. “tutorial_complete”, “registration_complete”, or “level_1_complete”)event_complete
valueNil, IntegerValue tied to the event name (above). This can be used for calculating values related to an event name. (e.g want to calculate the number of virtual currency for a specific event).10
os_version_release (*required for Google Ads)StringFor Android: 
String os_version_release = String.valueOf(Build.VERSION.RELEASE)
For iOS:
[[UIDevice currentDevice] systemVersion]		14
build_id (*required for Google Ads)StringFor Android: 
String build = String.valueOf(Build.ID)
For iOS: 
@import Darwin.sys.sysctl;
NSString *build(void) {  size_t bufferSize = 64;  NSMutableData *buffer =    [[NSMutableData alloc]      initWithLength:bufferSize];  int status =    sysctlbyname(“kern.osversion”,      buffer.mutableBytes,      &bufferSize, NULL, 0);  if (status != 0) {    return nil;  }  return [[NSString alloc]    initWithCString:buffer.mutableBytes    encoding:NSUTF8StringEncoding];}		UP1B.231005.007
locale (*required for Google Ads)StringFor Android:
String locale = Locale.getDefault().toString()
For iOS:
[[NSLocale currentLocale] localeIdentifier]		es_AR
device_model (*required for Google Ads)StringFor Android:
String device = Build.MODEL;
For iOS:
@import Darwin.sys.sysctl;
NSString *device(void) {  size_t bufferSize = 64;  NSMutableData *buffer =    [[NSMutableData alloc]      initWithLength:bufferSize];  int status =    sysctlbyname(“hw.machine”,      buffer.mutableBytes,      &bufferSize, NULL, 0);  if (status != 0) {    return nil;  }  return [[NSString alloc]    initWithCString:buffer.mutableBytes    encoding:NSUTF8StringEncoding];}		SM-F731A
customer_user_idStringcustom User ID for the eventjdabGcerT32_d

What are your Feelings