AppMetrica

AppMetrica là công cụ phân tích miễn phí giúp bạn theo dõi hành vi người dùng và phân tích hiệu suất ứng dụng di động theo thời gian thực. Bằng cách tích hợp AppMetrica với Adapty, bạn có thể hiểu sâu hơn về các chỉ số gói đăng ký và mức độ tương tác của người dùng.

Cách thiết lập tích hợp AppMetrica

Thiết lập tích hợp AppMetrica gồm hai bước chính:

  1. Cấu hình tích hợp trong Adapty Dashboard
  2. Thiết lập tích hợp trong code của ứng dụng

Cấu hình trên dashboard

Để thiết lập tích hợp AppMetrica:

  1. Mở danh sách ứng dụng AppMetrica
  2. Chọn ứng dụng bạn muốn theo dõi
  3. Vào Settings > Main và sao chép Application IDPost API key
appmetrica.webp
  1. Vào Integrations > AppMetrica trong Adapty Dashboard
  2. Dán thông tin xác thực AppMetrica của bạn vào.
appmetrica_creds.webp

Sự kiện và thẻ

Adapty cho phép bạn gửi ba nhóm sự kiện tới AppMetrica. Bạn có thể bật các sự kiện cần theo dõi hiệu suất ứng dụng. Xem danh sách đầy đủ các sự kiện có sẵn trong tài liệu về sự kiện.

AppMetrica đồng bộ sự kiện mỗi 4 giờ, vì vậy có thể có độ trễ trước khi sự kiện xuất hiện trên dashboard của bạn.

6ed2d88-CleanShot_2023-08-18_at_14.59.042x.webp

Chúng tôi khuyến nghị sử dụng tên sự kiện mặc định của Adapty để đảm bảo tính nhất quán, nhưng bạn có thể tùy chỉnh chúng để phù hợp với thiết lập phân tích hiện có của mình.

Cài đặt doanh thu

Mặc định, Adapty gửi dữ liệu doanh thu dưới dạng thuộc tính trong các sự kiện, hiển thị trong báo cáo Events của AppMetrica. Bạn có thể cấu hình cách tính toán và hiển thị dữ liệu doanh thu này:

  • Tính toán doanh thu: Chọn cách tính giá trị doanh thu để phù hợp với nhu cầu báo cáo tài chính của bạn:

    • Doanh thu gộp: Hiển thị tổng doanh thu trước khi trừ bất kỳ khoản nào, hữu ích để theo dõi tổng số tiền khách hàng thanh toán
    • Doanh thu sau khi trừ hoa hồng cửa hàng: Hiển thị doanh thu sau khi đã trừ phí App Store/Play Store, giúp bạn theo dõi thu nhập thực tế
    • Doanh thu sau khi trừ hoa hồng cửa hàng và thuế: Hiển thị doanh thu ròng sau khi trừ cả phí cửa hàng và thuế áp dụng, cho bức tranh chính xác nhất về thu nhập của bạn
  • Báo cáo theo tiền tệ của người dùng: Khi bật, doanh số được báo cáo theo tiền tệ địa phương của người dùng, giúp phân tích doanh thu theo khu vực dễ dàng hơn. Khi tắt, tất cả doanh số được quy đổi sang USD để báo cáo nhất quán trên các thị trường khác nhau.

  • Gửi sự kiện doanh thu: Bật tùy chọn này để dữ liệu doanh thu xuất hiện không chỉ trong báo cáo Events mà còn trong báo cáo In-app and ad revenue của AppMetrica. Đảm bảo bạn không gửi doanh thu từ bất kỳ nguồn nào khác, vì điều này có thể dẫn đến trùng lặp dữ liệu.

  • Loại trừ sự kiện lịch sử: Khi bật, Adapty sẽ không gửi các sự kiện xảy ra trước khi người dùng cài đặt ứng dụng có tích hợp Adapty SDK. Điều này giúp tránh trùng lặp dữ liệu nếu bạn đã gửi sự kiện tới analytics trước khi tích hợp Adapty.

appmetrica_revenue.webp

Cấu hình SDK

Để bật tích hợp AppMetrica trong ứng dụng, bạn cần thiết lập hai mã định danh:

  1. appmetrica_device_id: Bắt buộc để tích hợp cơ bản
  2. appmetrica_profile_id: Tùy chọn, nhưng được khuyến nghị nếu ứng dụng có chức năng đăng ký tài khoản người dùng

Sử dụng phương thức setIntegrationIdentifier() để thiết lập các giá trị này. Cách triển khai cho từng nền tảng:

Các SDK bên thứ ba tạo user ID theo cách bất đồng bộ. ID có thể chưa sẵn sàng khi Adapty.activate() chạy. Nếu Customer User ID của bạn đến từ một trong các SDK này, hãy gọi Adapty.activate() mà không truyền ID đó. Khi ID đã có, gọi setIntegrationIdentifier(), sau đó gọi identify() với CUID.

Cấu trúc sự kiện AppMetrica

Adapty gửi sự kiện tới AppMetrica qua các POST request với các tham số được truyền dưới dạng query parameter. Với mỗi sự kiện Adapty, AppMetrica nhận tới hai request riêng biệt:

  1. Sự kiện profile (luôn được gửi): Chứa metadata của sự kiện
  2. Sự kiện doanh thu (tùy chọn): Chứa dữ liệu doanh thu nếu tùy chọn “Gửi sự kiện doanh thu” được bật trong Adapty Dashboard

Yêu cầu sự kiện profile

Gửi tới: https://api.appmetrica.yandex.ru/logs/v1/import/events

Ví dụ URL với query parameter:

POST https://api.appmetrica.yandex.ru/logs/v1/import/events?post_api_key=your_key&application_id=your_app_id&event_name=subscription_renewed&event_timestamp=1709294400&event_json=%7B%22vendor_product_id%22%3A%22yearly.premium%22...%7D&os_name=ios&ios_ifa=00000000-0000-0000-0000-000000000000&ios_ifv=12345678-1234-1234-1234-123456789012&profile_id=user_12345&session_type=foreground

Query parameter:

Tham sốKiểuMô tả
post_api_keyStringPost API Key AppMetrica của bạn.
application_idStringApplication ID AppMetrica của bạn.
event_nameStringTên sự kiện (được ánh xạ từ sự kiện Adapty).
event_timestampLongTimestamp UNIX của sự kiện tính bằng giây. Bị giới hạn về 7 ngày gần nhất nếu cũ hơn.
event_jsonStringChuỗi JSON được URL-encoded chứa tất cả các trường sự kiện có sẵn. Chỉ bao gồm các trường không null.
os_nameString”ios” hoặc “android”.
profile_idStringAppMetrica Profile ID (nếu đã thiết lập), nếu không thì Customer User ID (nếu có).
appmetrica_device_idStringAppMetrica Device ID Hash. Chỉ được gửi nếu profile_id không có sẵn.
session_typeStringLuôn là “foreground”.
ios_ifaStringChỉ iOS. ID for Advertisers.
ios_ifvStringChỉ iOS. ID for Vendors.
google_aidStringChỉ Android. Google Advertising ID.

Yêu cầu sự kiện doanh thu (Tùy chọn)

Gửi tới: https://api.appmetrica.yandex.ru/logs/v1/import/revenue

Request này chỉ được gửi khi tùy chọn “Gửi sự kiện doanh thu” được bật trong cài đặt tích hợp Adapty Dashboard của bạn.

Ví dụ URL với query parameter:

POST https://api.appmetrica.yandex.ru/logs/v1/import/revenue?post_api_key=your_key&application_id=your_app_id&revenue_event_type=subscription_renewed&price=9.99&currency=USD&product_id=yearly.premium&quantity=1&transaction_id=GPA.3383...&payload=%7B%22vendor_product_id%22%3A%22yearly.premium%22...%7D&os_name=ios&ios_ifa=00000000-0000-0000-0000-000000000000&profile_id=user_12345&session_type=foreground

Query parameter:

Tham sốKiểuMô tả
post_api_keyStringPost API Key AppMetrica của bạn.
application_idStringApplication ID AppMetrica của bạn.
revenue_event_typeStringLoại sự kiện doanh thu (ví dụ: “subscription_renewed”, “refund”, “intro_started”). Xem ánh xạ sự kiện AppMetrica.
priceFloatGiá trị doanh thu (dựa trên cài đặt tính toán doanh thu của bạn).
currencyStringMã tiền tệ (ví dụ: “USD”).
product_idStringProduct ID từ cửa hàng.
quantityIntegerLuôn là 1.
transaction_idStringStore Transaction ID.
payloadStringChuỗi JSON được URL-encoded chứa thông tin chi tiết sự kiện. Tự động cắt bớt nếu vượt quá 30KB bằng cách xóa các trường tùy chọn theo thứ tự ưu tiên để giữ lại dữ liệu quan trọng nhất.
os_nameString”ios” hoặc “android”.
profile_idStringAppMetrica Profile ID (nếu đã thiết lập), nếu không thì Customer User ID (nếu có).
appmetrica_device_idStringAppMetrica Device ID Hash. Chỉ được gửi nếu profile_id không có sẵn.
session_typeStringLuôn là “foreground”.
ios_ifaStringChỉ iOS. ID for Advertisers.
ios_ifvStringChỉ iOS. ID for Vendors.
google_aidStringChỉ Android. Google Advertising ID.