Đ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`.
Lưu ý: Tích hợp giữa các máy chủ không phải là tính năng tiêu chuẩn dành cho tất cả khách hàng của Tenjin. Vui lòng liên hệ với người quản lý tài khoản Tenjin của quý vị nếu quý vị muốn được đưa vào danh sách trắng để sử dụng tính năng này.
Điểm cuối chung #
Đường dẫn: https://track.tenjin.io/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 | ID quảng cáo thô của thiết bị. Xin lưu ý rằng yêu cầu chỉ được chấp nhận khi đi kèm với một ID thiết bị hợp lệ (có thể là advertising_id, developer_device_id hoặc analytics_installation_id). Điều quan trọng là phải đảm bảo tính nhất quán khi gửi các loại ID thiết bị này. Đối với iOS, giá trị này phải là IDFA. Trong trường hợp người dùng không đồng ý, trường `advertising_id` có thể để trống hoặc toàn bộ là số 0, và trường `IDFV` phải được cung cấp trong trường `developer_device_id` cùng với trường `analytics_installation_id`. Đối với Android, cần cung cấp một trong hai thông tin sau: advertising_id hoặc analytics_installation_id. |
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 | Phiên bản ứng dụng của bạn Đối với Android: String app_version = context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionName + “.” + context.getPackageManager().getPackageInfo(context.getPackageName(), 0).versionCode) Đối với 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'