Điểm cuối này chỉ nên được sử dụng khi gửi Dữ liệu Doanh thu theo Lượt hiển thị (ILRD) trực tiếp qua S2S cho một nhà cung cấp dịch vụ trung gian chưa được tích hợp chính thức với Tenjin.
Xác thực #
Chúng tôi xác thực mọi yêu cầu được gửi đến máy chủ Tenjin bằng cách sử dụng API Key làm tên người dùng trong cơ chế xác thực cơ bản (basic auth) hoặc dưới dạng tham số `api_key`.
Điểm cuối chung #
Đường dẫn: https://track.tenjin.com/v0/ad_impressions/
Phương thức: POST
Loại nội dung: application/x-www-form-urlencoded
Các thông số thông tin thiết bị #
Các tham số có dấu * là bắt buộc
| Tham số | Ví dụ | Mô tả |
bundle_id* | com.tenjin.wordfinder | ID gói của ứng dụng. |
advertising_id* | be277924-d076-456d-9a20-3c8dee5663d3 | The 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 | Trường thay thế cho mã định danh duy nhất của thiết bị, được sử dụng khi không có mã quảng cáo. Đối với iOS, giá trị này phải là IDFV. |
analytics_installation_id* | 91d1c313-dd94-4bd3-bbbb-16c8b7afa054 | Tenjin đã tạo mã định danh dành riêng cho việc cài đặt ứng dụng. Mã này có thể truy cập thông qua hàm gọi lại của khách hàng hoặc SDK.SDK AndroidSDK iOSUnity SDK |
platform* | iOS | Nền tảng của ứng dụng. ios,android (có Google Play Store), android_other (không có Google Play Store, ví dụ như các thiết bị sử dụng cửa hàng ứng dụng của Trung Quốc), amazon (với ứng dụng Amazon trên App Store) |
app_version* | 1.5 | The 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_code | 2 | Chỉ Android Phiên bản ứng dụng Android: https://developer.android.com/studio/publish/versioning |
build_id | RQ3A.211001.001 | Đối với Android: String build = String.valueOf(Build.ID) Đối với 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 | Nhà mạng di động (Nhà cung cấp dịch vụ Internet) |
connection_type | wifi | di động/Wi-Fi |
country | Hoa Kỳ | Tiêu chuẩn mã quốc gia theo vùng ngôn ngữ ISO (xem tài liệu của Apple chẳng hạn). |
device | blueline | Android: android.os.Build.DEVICE (tham khảo)iOS: systemInfo.machine (tham khảo) |
device_brand | ||
device_manufacturer | ||
device_model | Pixel 3 | Đối với Android: Chuỗi device = Build.MODEL; Đối với 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 | Chỉ dành cho Android: build.PRODUCT |
language | en | Mã ISO 639‑1 gồm hai chữ cái |
limit_ad_tracking | SAI | Thiết bị có hạn chế việc theo dõi quảng cáo không? (đúng, sai) |
opt_in | ĐÚNG | Sự đồng ý tham gia của thiết bị nhằm tuân thủ GDPR: Triển khai Tenjin SDK |
locale | en_US | Đối với Android:String locale = Locale.getDefault().toString() Đối với iOS:[[NSLocale currentLocale] localeIdentifier] |
os_version | 14 | Đối với Android: String.valueOf(Build.VERSION.SDK_INT) Đối với iOS: [[UIDevice currentDevice] systemVersion] |
os_version_release | 14.3.1 | Chỉ dành cho Android: phiên bản phát hành hệ điều hành đầy đủ |
timezone | Châu Âu/Ljubljana | |
user_agent | Linux; U; Android 11; SM-A505FN Build/RP1A.200720.012 | Trình duyệt của thiết bị người dùng |
screen_height | 2028 | |
screen_width | 1080 | |
sent_at | 1693581566830 | Thời gian Epoch tính bằng mili giây |
session_id | f4239af1-cd6f-49e8-8b97-f61a9e81a7e0 | |
source_app_store | Google Play | Chỉ dành cho Android: unspecified, googleplay, amazon, other |
ip_address* (Thông tin bắt buộc để xác định quốc gia của thiết bị) | 87.123.246.9 | Địa chỉ IP của người dùng. Thông tin này được sử dụng để xác định quốc gia nhằm đáp ứng các thông số về sự đồng ý của người dùng theo Quy định DMA của Google. |
ad_user_data (Yêu cầu của Google) | 1 | Tham số tín hiệu đồng ý của người dùng Google: consent (3) cho phép bên thứ ba truyền dữ liệu cấp người dùng cho quảng cáo; 1 cho trường hợp đã đồng ý; 0 cho trường hợp từ chối. Loại bỏ hoàn toàn tham số này khỏi yêu cầu (không để trống) khi không có dữ liệu về sự đồng ý của người dùng. |
ad_personalization (Yêu cầu của Google) | 1 | Tham số tín hiệu đồng ý của người dùng Google: consent – quảng cáo được cá nhân hóa¹ (đồng ý); 0 – từ chối đồng ý. Loại bỏ hoàn toàn tham số này khỏi yêu cầu (không để trống) khi không có dữ liệu về sự đồng ý của người dùng |
Các thông số về doanh thu #
Các tham số có dấu * là bắt buộc
| Tham số | Ví dụ | Mô tả |
ad_revenue_mediation* | max | Tên nền tảng hòa giải, vui lòng sử dụng các giá trị dưới đây:max,ironsource,admob,topon,cas,tradplusĐối với các hình thức hòa giải khác, hãy sử dụng custom. |
network_name* | mintegral | Tên mạng hiển thị quảng cáo, thường được nhà cung cấp dịch vụ trung gian truyền tải |
currency* | USD | Các mã tiền tệ theo tiêu chuẩn ISO, ví dụ: USD, JPY |
revenue_decimal* | 0.001 | Doanh thu dưới dạng số thập phân cho MỘT lần hiển thị chỉ yêu cầu một trong hai trường revenue_decimal hoặc revenue_cpm. Khi nhận được cả hai trường, trường revenue_decimal sẽ được ưu tiên. |
revenue_cpm | 1.0 | Doanh thu tính theo CPM, bằng với doanh thu_decimal nhân với 1.000 |
mediation_country | Hoa Kỳ | Quốc gia của nhà cung cấp dịch vụ hòa giải, theo mã quốc gia hai chữ cái theo tiêu chuẩn ISO, ví dụ: US |
ad_unit_id | 09807a44b2f855cc | ID đơn vị quảng cáo do mạng quảng cáo trúng thầu báo cáo |
ad_format | banner | Định dạng của đơn vị quảng cáo: banner, mrec, xpromo, native, leaderboard/leader, interstitial/inter, rewarded/reward, rewarded_inter/rewarded_interstitial |
precision | BID | Giá trị được truyền qua trung gian, cho biết nguồn thu nhập, chẳng hạn như BID, CPM, RATE |
creative_id | 9299584 | Giá trị được truyền qua trung gian, |
placement | Banner123 | Giá trị được truyền qua trung gian cho tên vị trí quảng cáo do nhà xuất bản xác định |
network_placement | Tên biểu ngữ | Tên vị trí của Mạng quảng cáo bên ngoài |
auction_id | 27d38ef0-847c-11ec-8b8d-3fe5d30476ca_765960010 | Giá trị được truyền qua trung gian |
Ví dụ về yêu cầu #
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'