Cài đặt Smadex
Smadex là mạng quảng cáo có tích hợp với Adjust. Sau khi tích hợp với Adjust, Smadex sẽ nhận được dữ liệu phân bổ và dữ liệu in-app event qua callback tự động.
Dưới đây là hướng dẫn cài đặt tính năng đo lường Smadex. Hướng dẫn gồm các bước kích hoạt tích hợp, tạo liên kết chiến dịch, và xác định loại dữ liệu mà Adjust có thể chia sẻ cho Smadex.
Trước khi bắt đầu
Yêu cầu
- Quyền truy cập Admin, Editor hoặc Custom Editor.
- Adjust SDK phiên bản 4.0.0 trở lên, để liên kết tham số SDK với tham số của Smadex. Chọn hướng dẫn phù hợp với nền tảng đang sử dụng.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Thông tin tài khoản
TRACKING GROUP ID
- Để được hỗ trợ tìm thông tin tài khoản, vui lòng liên hệ với đại diện Smadex.
Chọn Smadex và ứng dụng trên Campaign Lab
- Tại mục Campaign Lab , chọn Đối tác.
- Chọn Đối tác mới > Smadex. Chọn Tiếp theo để chuyển sang màn hình kế tiếp.
- Trên màn hình Lựa chọn ứng dụng , chọn ứng dụng mà bạn muốn tạo liên kết, sau đó kích hoạt tích hợp để chia sẻ dữ liệu cho Smadex.
- Chọn Tiếp theo.
Kích hoạt tính năng chia sẻ dữ liệu
Kích hoạt tính năng chia sẻ dữ liệu để kích hoạt tích hợp giữa Adjust và Smadex. Để kích hoạt tính năng chia sẻ dữ liệu:
- Nhập TRACKING GROUP ID.
Sau khi bạn kích hoạt tính năng chia sẻ dữ liệu cho Smadex, Adjust sẽ mặc định gửi các dữ liệu sau cho Smadex:
Cài đặt tính năng chia sẻ dữ liệu
Nếu ứng dụng của bạn là đa nền tảng (multi-platform app), và tính năng chia sẻ dữ liệu đã được kích hoạt cho các nền tảng này, thì bạn có thể thực hiện các thao tác sau:
- Chọn Sử dụng cài đặt riêng của nền tảng nếu bạn muốn cài đặt tính năng chia sẻ dữ liệu khác nhau cho mỗi nền tảng.
- Chọn Sử dụng cài đặt chung nếu bạn muốn cài đặt tính năng giống nhau cho tất cả nền tảng.
Tại mục Dữ liệu nào sẽ được chia sẻ mặc định? , kiểm tra lại các dữ liệu mà Adjust mặc định chia sẻ cho Smadex.
- lượt cài đặt
- phiên truy cập
- lượt gỡ cài đặt
- lượt cài đặt lại
- lượt cài đặt lại_tái phân bổ
- tái phân bổ
- sự kiện
- lượt cài đặt bị từ chối
- tái phân bổ bị từ chối
- doanh thu quảng cáo
Gửi dữ liệu bổ sung
Chọn số lượng và loại dữ liệu mà bạn muốn chia sẻ cho Smadex qua callback. Smadex có thể sử dụng dữ liệu bạn chia sẻ để cải thiện dịch vụ.
- Tại mục Bạn muốn chia sẻ nguồn dữ liệu nào?, chọn nguồn phân bổ của dữ liệu mà bạn đang chia sẻ cho Smadex:
- Dữ liệu từ tất cả nguồn phân bổ
- Chỉ chia sẻ dữ liệu đã được phân bổ cho Smadex
Doanh thu quảng cáo (từ số lượt xem quảng cáo)
Nếu bạn chọn chia sẻ dữ liệu doanh thu, Smadex sẽ nhận được dữ liệu doanh thu quảng cáo đến từ người dùng. Smadex có thể sử dụng dữ liệu này để cải thiện chiến dịch của bạn, đảm bảo chiến dịch tiếp cận người dùng hiệu quả hơn.
Tính năng trên chỉ có trong gói Ad Revenue. Để mua gói Ad Revenue, vui lòng liên hệ với đại diện bán hàng.
Để chia sẻ dữ liệu doanh thu cho Smadex, chọn Nguồn doanh thu quảng cáo.
- Nếu bạn để trống trường thông tin này, thì chúng tôi sẽ gửi dữ liệu doanh thu quảng cáo đến tất cả nền tảng dàn xếp quảng cáo (mediation) được tích hợp trong hệ thống.
Phiên truy cập
Adjust không tự động gửi callback phiên truy cập, vì số lượng dữ liệu là rất lớn. Nếu bạn chọn chia sẻ dữ liệu phiên truy cập, Smadex sẽ nhận được dữ liệu liên quan đến hoạt động truy cập ứng dụng.
Lượt gỡ cài đặt và cài đặt lại
Nếu bạn chọn chia sẻ dữ liệu lượt gỡ cài đặt (uninstall) hoặc cài đặt lại (reinstall), Smadex sẽ nhận được tất cả dữ liệu liên quan đến lượt gỡ cài đặt và/hoặc lượt cài đặt lại do Adjust đo lường.
Dữ liệu lượt gỡ cài đặt và/hoặc lượt cài đặt lại của ứng dụng iOS có thể không nhiều. Để biết thêm thông tin, tham khảo bài viết Đo lường lượt gỡ cài đặt và cài đặt lại.
Doanh thu in-app (từ giao dịch in-app)
Nếu bạn chọn chia sẻ dữ liệu doanh thu in-app, Smadex sẽ nhận được dữ liệu số tiền và sự kiện doanh thu. Bạn cần liên kết sự kiện để có thể chia sẻ dữ liệu này; lưu ý, sự kiện phải tạo doanh thu.
Liên kết event
Liên kết sự kiện mà bạn muốn chia sẻ, với giá trị mà Smadex có thể nhận được. Đối với sự kiện không được liên kết, dữ liệu liên quan đến sự kiện sẽ không được chia sẻ cho Smadex.
Liên kết các sự kiện riêng lẻ
Nếu bạn sở hữu ứng dụng đa nền tảng (multi-platform app), thì có thể chia sẻ cho Smadex các sự kiện khác nhau tùy theo từng nền tảng. Tức bạn có thể:
- Cài đặt sự kiện riêng lẻ để quản lý chiến dịch theo từng nền tảng.
- Điều chỉnh tính năng chia sẻ dữ liệu của từng nền tảng.
Để chọn in-app event mà muốn bạn muốn gửi trực tiếp cho Smadex, thực hiện các bước sau tại mục Liên kết sự kiện .
Chọn Liên kết sự kiện.
Mở danh sách Sự kiện của Adjust , chọn sự kiện mà bạn muốn chia sẻ cho Smadex.
Tại mục Sự kiện đối tác , chọn sự kiện của Smadex, đảm bảo sự kiện đó tương ứng với sự kiện của Adjust.
Đối với ứng dụng đơn nền tảng và ứng dụng đa nền tảng nhưng chỉ bật tính năng chia sẻ dữ liệu cho một nền tảng, thì bạn chỉ cần liên kết sự kiện cho nền tảng đó. Còn đối với ứng dụng đa nền tảng nhưng bật tính năng chia sẻ dữ liệu cho nhiều nền tảng, thì bạn có các lựa chọn sau:
- Chọn Sử dụng biểu đồ liên kết riêng của nền tảng để liên kết sự kiện theo từng nền tảng một, hoặc để không liên kết sự kiện cho một số nền tảng nhất định.
- Chọn Sử dụng biểu đồ liên kết chung để liên kết chung sự kiện cho tất cả nền tảng.
Trong danh sách Sự kiện của đối tác , chọn sự kiện có sẵn hoặc nhập sự kiện do bạn đặt tên - sự kiện này sẽ liên kết với sự kiện của Adjust.
Chọn Áp dụng .
Giờ đây, Smadex sẽ nhận được dữ liệu về in-app event của từng sự kiện được liên kết.
Liên kết tất cả sự kiện
Nếu Smadex cho phép liên kết tự động tất cả sự kiện, thì tại mục Liên kết sự kiện , chọn Liên kết tất cả sự kiện. Như vậy bạn đỡ mất thời gian liên kết từng sự kiện một.
Sau bước trên, Smadex sẽ nhận được dữ liệu sự kiện in-app của tất cả sự kiện được liên kết.
Định cấu hình cho liên kết và cài đặt
Bạn có thể cài đặt các thành phần sau:
Tạo liên kết và chia sẻ liên kết cho Smadex
Trên màn hình Kiểm tra lại cài đặt , kiểm tra lại các thao tác đã thực hiện. Bạn có thể quay lại để thực hiện thay đổi nếu cần:
- Ứng dụng đã chọn
- Cách chia sẻ dữ liệu
- Tham số cấu trúc (Link structure parameters)
- Trang đến (User destination)
- Cài đặt phân bổ
Chọn Tạo liên kết để tạo click URL, impression URL, mã QR và link token. Sau khi liên kết được tạo, tính năng chia sẻ dữ liệu và tích hợp Smadex sẽ được kích hoạt.
Sau khi tạo xong liên kết, chia sẻ liên kết cho Smadex để Smadex đưa liên kết vào chiến dịch quảng cáo.
Danh sách tất cả tham số được chuyển tiếp đến Smadex
Smadex yêu cầu Adjust gửi các tham số (điểm dữ liệu) sau trong callback:
| Placeholder | Information |
{country} | Device two-character country code |
{environment} | Current Adjust SDK environment setting |
{idfa||gps_adid} | IDFA, or GPS ADID if IDFA is empty |
{ip_address} | Device IP address |
{language} | Device two-character language code |
{lifetime_session_count} | Number of sessions recorded across entire user lifetime |
{match_type} | Attribution method |
{nonce} | Random lowercase alphanumeric string (unique per callback) |
{os_name} | Device operating system |
{random_user_id} | Random user ID (per device) |
{random} | Random number (unique per callback) |
{revenue_usd} | Revenue, in US dollars |
{sdk_version} | Adjust SDK version (per app) |
{session_count} | Number of sessions recorded by current Adjust SDK |
{timezone} | Device time zone |
{app_id} | Store App ID or Google Play Store |
{app_version} | App version number (Android), build-version-number for the bundle (iOS) |
{connection_type} | Internet connection type |
{cpu_type} | CPU type |
{created_at} | Activity timestamp |
{impression_based} | 1 if impression-based engagement, 0 if not |
{install_begin_time} | App download began timestamp (Android and Google Play Store only) |
{install_finish_time} | App download completion timestamp |
{installed_at} | Install (i.e., first app open) timestamp |
{is_organic} | 1 if organic traffic, 0 if non-organic |
{network_name} | Network name, as taken from the tracker |
{network_type} | Network type |
{referral_time} | User landed on app Play Store page timestamp (Android and Google Play Store only) |
{rejection_reason} | Reason for a rejected attribution |
{store} | Target store of click |
{ad_impressions_count} | Number of mobile ads served to end users |
{ad_revenue_network} | Ad network that displayed the ad |
{ad_revenue_unit} | Ad unit that generated the revenue |
{ad_revenue_placement} | User placement, as defined on the platform |
{is_s2s_engagement_based} | 1 if attributed to a server to server engagement, 0 if not |
{proxy_ip_address} | IP address of user's proxy |
{ad_mediation_platform} | Mediation platform name |