🔥月額$200でTenjinにフルアクセス - 全機能、アドオンなし、いつでもキャンセル可能。 価格と機能を見る

サインアップ
カテゴリーを見る

インプレッションレベル収益データAPI (S2S)

読了時間：6分

このエンドポイントは、Tenjinとまだ正式に連携していないメディエーションプロバイダーに対して、S2S経由でインプレッションレベルの収益データ(ILRD)を直接送信する場合にのみ使用してください。

認証 #

Tenjinサーバーに送信されるすべてのリクエストについて、APIキーをBasic認証のユーザー名として、またはパラメータapi_keyとして使用して認証を行います。 

汎用エンドポイント #

Path: https://track.tenjin.com/v0/ad_impressions/

Method: POST

Content-Type: application/x-www-form-urlencoded

デバイス情報のパラメータ #

*が付いている項目は必須です

パラメータ例説明
bundle_id*com.tenjin.wordfinderアプリのバンドルID
advertising_id*be277924-d076-456d-9a20-3c8dee5663d3The raw advertising ID of the device. Please note that the request will only be accepted with a valid device id (any of advertising_id, developer_device_id, and analytics_installation_id). It’s important to stay consistent in sending the device id types.
For iOS, it should be IDFA. In the case of no user consent, advertising_id can be empty or all zeros, and IDFV needs to be provided in developer_device_id along with analytics_installation_id
For Android, either advertising_id or analytics_installation_id should be provided.
developer_device_id*5f4dcc3b-5aa5-40e1-8914-7a9c5d5ebf31広告IDが存在しない場合に使用される、デバイス固有識別子の代替フィールドです。iOSの場合、IDFVを指定する必要があります。
analytics_installation_id*91d1c313-dd94-4bd3-bbbb-16c8b7afa054Tenjinが生成したアプリケーションインストール固有の識別子。S2S コールバックまたはSDK(Android SDK、iOS SDK、Unity SDK)で利用可能です。
platform*iosアプリのプラットフォーム。. ios,android （Google Playストア付き）、, android_other （Google Playストアが搭載されていないもの、例えば中国のアプリストアを搭載した端末など）、, amazon （Amazon App Store対応）
app_version*1.5The 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”]
app_version_code2Androidのみ
Android アプリのバージョン： https://developer.android.com/studio/publish/versioning
build_idRQ3A.211001.001Androidの場合： 
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];}
carrierT-2携帯電話事業者（インターネットサービスプロバイダー）
connection_typeWi-Fiモバイル／Wi-Fi
countryUSISOロケール国コード規格(例：Appleのドキュメントを参照)。
devicebluelineAndroid: android.os.Build.DEVICE (参考文献)iOS: systemInfo.machine (参考文献)
device_brandgoogle
device_manufacturerGoogle
device_modelPixel 3Androidの場合：
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];}
device_productbluelineAndroidのみ：build.PRODUCT
languageja2文字のISO 639-1コード
limit_ad_trackingFALSE広告トラッキングを許可しない？ (true, false)
opt_inTRUEGDPR準拠のためのデバイスに関するオプトイン同意： Tenjin SDKの実装
localeen_USAndroidの場合：String locale = Locale.getDefault().toString()
iOSの場合:[[NSLocale currentLocale] localeIdentifier]
os_version14Androidの場合： String.valueOf(Build.VERSION.SDK_INT)
iOSの場合: [[UIDevice currentDevice] systemVersion]
os_version_release14.3.1Android限定：フルOSリリース版
timezoneEurope/Ljubljana
user_agentLinux; U; Android 11; SM-A505FN Build/RP1A.200720.012ユーザーの端末のユーザーエージェント
screen_height2028
screen_width1080
sent_at1693581566830エポックからの経過時間（ミリ秒単位）
session_idf4239af1-cd6f-49e8-8b97-f61a9e81a7e0
source_app_storeGoogle PlayAndroidのみ： unspecified, googleplay, amazon, other
ip_address*（デバイスの国を特定するために必要）87.123.246.9ユーザーのIPアドレス。これは、Google DMAのユーザー同意パラメータにおいて国を特定するために使用されます。
ad_user_data (Googleによる必須項目)1Googleユーザー同意シグナルパラメータ：広告のためのユーザーレベルデータのサードパーティ送信に対する同意。1：同意あり、0：同意拒否。ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。
ad_personalization (Googleによる必須項目)1Googleユーザー同意シグナルパラメータ：パーソナライズド広告の同意　同意した場合は1、同意しなかった場合は0　ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。

収益情報のパラメータ #

*が付いている項目は必須です

パラメータ例説明
ad_revenue_mediation*maxメディエーションプラットフォーム名。以下の値のいずれかを使用してください：
max,ironsource,admob,topon,cas,tradplus
その他のメディエーションについては、以下をご利用ください。 custom.
network_name*mintegral広告を表示するネットワーク名。通常、メディエーションプロバイダーから渡される。
currency*USDISO通貨コード（例：USD、JPY）
revenue_decimal*0.0011インプレッションあたりの収益を小数で指定する場合、revenue_decimalまたはrevenue_cpmのいずれか一方のみを指定してください。両方が指定された場合は、revenue_decimalが優先されます。
revenue_cpm1.0CPM単位の収益、revenue_decimalに1,000を掛けた値
mediation_countryUSメディエーションプロバイダーの国(ISO2文字の国コード表記、例: US)
ad_unit_id09807a44b2f855ccWinningネットワークが報告した広告ユニットID
ad_formatbanner広告ユニットの形式： banner, mrec, xpromo, native, leaderboard/leader, interstitial/inter, rewarded/reward, rewarded_inter/rewarded_interstitial
precisionBIDメディエーションを通じて渡される値で、BID、CPM、RATE など、収益源を示します。
creative_id9299584メディエーションによって渡される値
placementBanner123パブリッシャーが定義した広告配置名に対して、メディエーションを介して渡される値。
network_placementBanner_name外部広告ネットワークの掲載名
auction_id27d38ef0-847c-11ec-8b8d-3fe5d30476ca_765960010メディエーションによって渡される値

リクエスト例 #

JSON
curl -X POST https://track.tenjin.com/v0/ad_impressions/ -H "Content-Type: application/x-www-form-urlencoded" -d 'api_key=api_key&advertising_id=123&ad_revenue_mediation=max&network_name=google&mediation_country=US&currency=USD&ad_unit_id=1&ad_format=banner&revenue_decimal=0.01&precision=BID&creative_id=2&placement=banner_1&auction_id=3&bundle_id=com.tenjin.test&platform=ios&ad_user_data=1&ad_personalization=1'
あなたの気持ちは？
anurag
インプレッション単位の収益データ API (S2S) | Tenjin
正確な広告収益の追跡を実現するため、サーバー間連携を活用したTenjinの「インプレッション単位の収益データAPI」の実装方法についてご紹介します。.
ホーム
資料
インプレッションレベル収益データAPI (S2S)
Tenjin
Growth Made Simple