Event API #
(初回アプリ起動イベントおよびアプリ起動イベントの送信に使用します)
認証:
Tenjin SDKキーを使用して、Tenjinサーバーに送信されるすべてのリクエストを認証します。
- リクエストURLのパラメータapi_keyとして、または
- ユーザー名として入力し、パスワードを空欄のままにすると、basic access authenticationで使用できます。
POSTまたはGET URL:
https://track.tenjin.com/v0/event
{“code”:200}という応答は、リクエストが成功したことを示します。
パラメータ
*: 必須パラメータ
| パラメータ | 型 | 説明 | 例 |
api_key* | String | 各アプリごとにTenjinが生成するSDKキーです。アプリページに記載されていますのでご確認ください。basic authenticationを使用する場合は、このパラメータは不要です。 | ENECCCVB8UQVLPSQ58S8EZXTJHA7FHDW |
analytics_installation_id* | UUID | Tenjinが生成したアプリケーションインストール固有の識別子。S2S コールバックまたはSDK(Android SDK、iOS SDK、Unity SDK)で利用可能です。 | 29eeb1610fe74997b6d53f02e9711f8c |
advertising_id* | String | デバイスの広告ID。オプトアウトユーザーの場合は、空欄またはすべてゼロ。 | f024e65f3dd94f16983726bcef192d68 |
developer_device_id (iOSで必須) | String | ベンダーID | b6bc48fe0ce949e4b229ce6c55663fca |
bundle_id* | String | アプリのバンドルID | com.tenjin.wordfinder |
platform* | String | ios, android, amazon, android_other | ios |
limit_ad_tracking | String | はいの場合は1、いいえの場合は0。 | 1 |
os_version* | String | Androidの場合: String os_version = String.valueOf(Build.VERSION.SDK_INT) iOSの場合: [[UIDevice currentDevice] systemVersion] | 8.0 |
app_version | Float, Decimal | アプリバージョン Androidの場合: String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode) iOSの場合: [[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”] | 1.0.3 |
sdk_version* | String | server | server |
country | String | ISOロケール国コード規格(例:Appleのドキュメントを参照)。 | US |
ip_address | String | The 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 | Boolean | Googleユーザー同意シグナルパラメータ:広告のためのユーザーレベルデータのサードパーティ送信に対する同意。1:同意あり、0:同意拒否。ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 | 1 |
ad_personalization | Boolean | Googleユーザー同意シグナルパラメータ:パーソナライズド広告の同意 同意した場合は1、同意しなかった場合は0 ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 | 1 |
referrer | String | Androidインストールのトラッキングのためのパラメータ | campaign_id%3D |
os_version_release (*Google Adsのトラッキングで必須) | String | Androidの場合: String os_version_release = String.valueOf(Build.VERSION.RELEASE) iOSの場合: [[UIDevice currentDevice] systemVersion] | 8.0.1 |
build_id (*Google Adsのトラッキングで必須) | String | Androidの場合: String build = String.valueOf(Build.ID) 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 (*Google Adsのトラッキングで必須) | String | Androidの場合: String locale = Locale.getDefault().toString() iOSの場合: [[NSLocale currentLocale] localeIdentifier] | es_AR |
device_model (*Google Adsのトラッキングで必須) | String | Androidの場合: String device = Build.MODEL; 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_info | String | これは、iOS 向けGoogle 広告でプロバビリスティックアトリビューションを実行するために必要な文字列です。まずODM SDKからこの文字列を取得する必要があります。 | AB7Dr_EJBWQ_lT_l1V0z5xqDB9MnLGbINV5r2w1jhVTITlm0IK7QE16Bf2sIjI_twjeMoQl3SedWsZiPtijTZ2DkUYI_H9RI6lkStqbwmBVsnu_QH4hfkuJeMwhFEzBEJCz3a8cdD2U1MRd1jwn2b_hbaHsbVO3NlE0xsExo5HtcuWmsaMdddKn9vFRPtyPQvSLjSl4AlsdyAaYg9Hw-FyYfm9eAbqrxy3NXkZtjJeXRThMG6MTNJA |
customer_user_id | String | カスタマーユーザID | jdabGcerT32_d |
Purchase API #
(課金イベントの送信に使用されます)
認証:
Tenjin SDKキーを使用して、Tenjinサーバーに送信されるすべてのリクエストを認証します。
- リクエストURLのパラメータapi_keyとして、または
- ユーザー名として入力し、パスワードを空欄のままにすると、basic access authenticationで使用できます。
POSTまたはGET URL:
https://track.tenjin.com/v0/purchase
パラメータ
*: 必須パラメータ
| パラメータ | 型 | 説明 | 例 |
api_key* | String | 各アプリごとにTenjinが生成するSDKキーです。アプリページに記載されていますのでご確認ください。basic authenticationを使用する場合は、このパラメータは不要です。 | ENECCCVB8UQVLPSQ58S8EZXTJHA7FHDW |
analytics_installation_id* | UUID | Tenjinが生成したアプリケーションインストール固有の識別子。S2S コールバックまたはSDK(Android SDK、iOS SDK、Unity SDK)で利用可能です。 | 29eeb1610fe74997b6d53f02e9711f8c |
advertising_id* | String | デバイスの広告ID。オプトアウトユーザーの場合は、空欄またはすべてゼロ。 | f024e65f3dd94f16983726bcef192d68 |
developer_device_id (iOSで必須) | String | ベンダーID | b6bc48fe0ce949e4b229ce6c55663fca |
bundle_id* | String | アプリのバンドルID | com.tenjin.wordfinder |
platform* | String | ios, android, amazon, android_other | ios |
limit_ad_tracking | String | はいの場合は1、いいえの場合は0。 | 1 |
os_version* | String | Androidの場合: String.valueOf(Build.VERSION.SDK_INT) iOSの場合: [[UIDevice currentDevice] systemVersion] | 8.0 |
app_version (*Google Adsのトラッキングで必須) | Float, Decimal | アプリバージョン Androidの場合: String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode) iOSの場合: [[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”] | 1.0.3 |
sdk_version* | String | server | server |
ip_address | String | The 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 | Boolean | Googleユーザー同意シグナルパラメータ:広告のためのユーザーレベルデータのサードパーティ送信に対する同意。1:同意あり、0:同意拒否。ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 | 1 |
ad_personalization | Boolean | Googleユーザー同意シグナルパラメータ:パーソナライズド広告の同意 同意した場合は1、同意しなかった場合は0 ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 | 1 |
postcut | String | プラットフォームカット後の課金の場合1 | 1 |
product_id* | String | プロダクトID | coin_store |
price* | Float, Decimal | 課金額 | 0.99 |
quantity* | Integer | 課金数 | 1 |
country | String | ISOロケール国コード規格(例:Appleのドキュメントを参照)。 | US |
currency* | String | AppleとGoogleが使用するISO通貨コード(例:Appleのドキュメントを参照)。 | USD |
os_version_release (*Google Adsのトラッキングで必須) | String | Androidの場合: String os_version_release = String.valueOf(Build.VERSION.RELEASE) iOSの場合: [[UIDevice currentDevice] systemVersion] | 14 |
build_id (*Google Adsのトラッキングで必須) | String | Androidの場合: String build = String.valueOf(Build.ID) 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 (*Google Adsのトラッキングで必須) | String | Androidの場合: String locale = Locale.getDefault().toString() iOSの場合: [[NSLocale currentLocale] localeIdentifier] | es_AR |
device_model (*Google Adsのトラッキングで必須) | String | Androidの場合: String device = Build.MODEL; 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_id | String | カスタマーユーザID | jdabGcerT32_d |
正式なreceiptやsignatureがない場合は、リクエストURLにパラメータを一切追加しないでください。receiptやsignatureがなくても、ダッシュボード上でS2S経由で購入履歴を表示できます。.
Custom Event API #
(カスタムイベントの送信に使用されます)
認証:
Tenjin SDKキーを使用して、Tenjinサーバーに送信されるすべてのリクエストを認証します。
- リクエストURLのパラメータapi_keyとして、または
- ユーザー名として入力し、パスワードを空欄のままにすると、basic access authenticationで使用できます。
POSTまたはGET URL:
https://track.tenjin.com/v0/event
パラメータ
*: 必須パラメータ
| パラメータ | 型 | 説明 | 例 |
api_key* | String | 各アプリごとにTenjinが生成するSDKキーです。アプリページに記載されていますのでご確認ください。basic authenticationを使用する場合は、このパラメータは不要です。 | ENECCCVB8UQVLPSQ58S8EZXTJHA7FHDW |
analytics_installation_id* | UUID | Tenjinが生成したアプリケーションインストール固有の識別子。S2S コールバックまたはSDK(Android SDK、iOS SDK、Unity SDK)で利用可能です。 | 29eeb1610fe74997b6d53f02e9711f8c |
advertising_id* | String | デバイスの広告ID。オプトアウトユーザーの場合は、空欄またはすべてゼロ。 | f024e65f3dd94f16983726bcef192d68 |
developer_device_id (iOSで必須) | String | ベンダーID | b6bc48fe0ce949e4b229ce6c55663fca |
bundle_id* | String | アプリのバンドルID | com.tenjin.wordfinder |
platform* | String | ios, android, amazon, android_other | ios |
limit_ad_tracking | String | はいの場合は1、いいえの場合は0。 | 1 |
os_version* | String | Androidの場合: String.valueOf(Build.VERSION.SDK_INT) iOSの場合: [[UIDevice currentDevice] systemVersion] | 8.0 |
app_version (* required for Google Ads) | Float, Decimal | アプリバージョン Androidの場合: String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode) iOSの場合: [[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”] | 1.0.3 |
sdk_version* | String | server | server |
ip_address | String | The 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 | Boolean | Googleユーザー同意シグナルパラメータ:広告のためのユーザーレベルデータのサードパーティ送信に対する同意。1:同意あり、0:同意拒否。ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 | 1 |
ad_personalization | Boolean | Googleユーザー同意シグナルパラメータ:パーソナライズド広告の同意 同意した場合は1、同意しなかった場合は0 ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 | 1 |
event* | String | イベント名(例:tutorial_complete、registration_complete、level_1_complete) | event_complete |
value | Nil, Integer | イベント名に関連付けられた値(上記参照)。これは、イベント名に関連する値を計算するために使用できます(例:特定のイベントの仮想通貨の数を計算したい場合)。 | 10 |
os_version_release (*Google Adsでのトラッキングで必須) | String | Androidの場合: String os_version_release = String.valueOf(Build.VERSION.RELEASE) iOSの場合: [[UIDevice currentDevice] systemVersion] | 14 |
build_id (*Google Adsでのトラッキングで必須) | String | Androidの場合: String build = String.valueOf(Build.ID) 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 (*Google Adsでのトラッキングで必須) | String | Androidの場合: String locale = Locale.getDefault().toString() iOSの場合: [[NSLocale currentLocale] localeIdentifier] | es_AR |
device_model (*Google Adsでのトラッキングで必須) | String | Androidの場合: String device = Build.MODEL; 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_id | String | カスタマーユーザID | jdabGcerT32_d |