このエンドポイントは、Tenjinとまだ正式に連携していないメディエーションプロバイダーに対して、S2S経由でインプレッションレベルの収益データ(ILRD)を直接送信する場合にのみ使用してください。
認証 #
Tenjinサーバーに送信されるすべてのリクエストについて、APIキーをBasic認証のユーザー名として、またはパラメータapi_keyとして使用して認証を行います。
注：サーバー間連携は、すべてのTenjinクライアントに標準で提供されている機能ではありません。この機能のホワイトリスト登録をご希望の場合は、Tenjinのアカウントマネージャーまでお問い合わせください。.
汎用エンドポイント #
Path: https://track.tenjin.io/v0/ad_impressions/
Method: POST
Content-Type: application/x-www-form-urlencoded
デバイス情報のパラメータ #
*が付いている項目は必須です
| パラメータ | 例 | 説明 |
bundle_id* | com.tenjin.wordfinder | アプリのバンドルID |
advertising_id* | be277924-d076-456d-9a20-3c8dee5663d3 | デバイスの生の広告IDです。リクエストは、有効なデバイスID(advertising_id、developer_device_id、analytics_installation_idのいずれか)が指定されている場合にのみ処理されますのでご注意ください。デバイスIDの種類の指定については、一貫性を保つことが重要です。 iOSの場合は、IDFAを指定する必要があります。ユーザーの同意がない場合、advertising_idは空またはすべて0でも構いませんが、developer_device_idにはIDFVとanalytics_installation_idを併せて指定する必要があります。 Android の場合、advertising_id または analytics_installation_id のいずれかを指定する必要があります。. |
developer_device_id* | 5f4dcc3b-5aa5-40e1-8914-7a9c5d5ebf31 | 広告IDが存在しない場合に使用される、デバイス固有識別子の代替フィールドです。iOSの場合、IDFVを指定する必要があります。 |
analytics_installation_id* | 91d1c313-dd94-4bd3-bbbb-16c8b7afa054 | Tenjinが生成したアプリケーションインストール固有の識別子。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.5 | アプリバージョン Androidの場合： String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode) iOSの場合: [[[NSBundle mainBundle] infoDictionary] objectForKey:@”CFBundleShortVersionString”] |
app_version_code | 2 | Androidのみ Android アプリのバージョン： https://developer.android.com/studio/publish/versioning |
build_id | RQ3A.211001.001 | 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];} |
carrier | T-2 | 携帯電話事業者（インターネットサービスプロバイダー） |
connection_type | Wi-Fi | モバイル／Wi-Fi |
country | US | ISOロケール国コード規格(例：Appleのドキュメントを参照)。 |
device | blueline | Android: android.os.Build.DEVICE (参考文献)iOS: systemInfo.machine (参考文献) |
device_brand | ||
device_manufacturer | ||
device_model | Pixel 3 | 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];} |
device_product | blueline | Androidのみ：build.PRODUCT |
language | ja | 2文字のISO 639-1コード |
limit_ad_tracking | FALSE | 広告トラッキングを許可しない？ (true, false) |
opt_in | TRUE | GDPR準拠のためのデバイスに関するオプトイン同意： Tenjin SDKの実装 |
locale | en_US | Androidの場合：String locale = Locale.getDefault().toString() iOSの場合:[[NSLocale currentLocale] localeIdentifier] |
os_version | 14 | Androidの場合： String.valueOf(Build.VERSION.SDK_INT) iOSの場合: [[UIDevice currentDevice] systemVersion] |
os_version_release | 14.3.1 | Android限定：フルOSリリース版 |
timezone | Europe/Ljubljana | |
user_agent | Linux; U; Android 11; SM-A505FN Build/RP1A.200720.012 | ユーザーの端末のユーザーエージェント |
screen_height | 2028 | |
screen_width | 1080 | |
sent_at | 1693581566830 | エポックからの経過時間（ミリ秒単位） |
session_id | f4239af1-cd6f-49e8-8b97-f61a9e81a7e0 | |
source_app_store | Google Play | Androidのみ： unspecified, googleplay, amazon, other |
ip_address*（デバイスの国を特定するために必要） | 87.123.246.9 | ユーザーのIPアドレス。これは、Google DMAのユーザー同意パラメータにおいて国を特定するために使用されます。 |
ad_user_data （Googleによる必須項目） | 1 | Googleユーザー同意シグナルパラメータ：広告のためのユーザーレベルデータのサードパーティ送信に対する同意。1：同意あり、0：同意拒否。ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 |
ad_personalization （Googleによる必須項目） | 1 | Googleユーザー同意シグナルパラメータ：パーソナライズド広告の同意 同意した場合は1、同意しなかった場合は0 ユーザー同意データがない場合は、リクエストからパラメータを完全に削除してください(空白にしないでください)。 |
収益情報のパラメータ #
*が付いている項目は必須です
| パラメータ | 例 | 説明 |
ad_revenue_mediation* | max | メディエーションプラットフォーム名。以下の値のいずれかを使用してください：max,ironsource,admob,topon,cas,tradplusその他のメディエーションについては、以下をご利用ください。 custom. |
network_name* | mintegral | 広告を表示するネットワーク名。通常、メディエーションプロバイダーから渡される。 |
currency* | USD | ISO通貨コード（例：USD、JPY） |
revenue_decimal* | 0.001 | 1インプレッションあたりの収益を小数で指定する場合、revenue_decimalまたはrevenue_cpmのいずれか一方のみを指定してください。両方が指定された場合は、revenue_decimalが優先されます。 |
revenue_cpm | 1.0 | CPM単位の収益、revenue_decimalに1,000を掛けた値 |
mediation_country | US | メディエーションプロバイダーの国(ISO2文字の国コード表記、例: US) |
ad_unit_id | 09807a44b2f855cc | Winningネットワークが報告した広告ユニットID |
ad_format | banner | 広告ユニットの形式： banner, mrec, xpromo, native, leaderboard/leader, interstitial/inter, rewarded/reward, rewarded_inter/rewarded_interstitial |
precision | BID | メディエーションを通じて渡される値で、BID、CPM、RATE など、収益源を示します。 |
creative_id | 9299584 | メディエーションによって渡される値 |
placement | Banner123 | パブリッシャーが定義した広告配置名に対して、メディエーションを介して渡される値。 |
network_placement | Banner_name | 外部広告ネットワークの掲載名 |
auction_id | 27d38ef0-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¤cy=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'