Thử nghiệm tích hợp SDK trên thiết bị di động với ứng dụng – Hỗ trợ AppsFlyer

Khái quát: Thử nghiệm tích hợp ứng dụng Android/iOS của bạn với AppsFlyer.

Thử nghiệm và Debugging Tích hợp SDK

Thử nghiệm tích hợp SDK trước khi gửi ứng dụng đến cửa hàng ứng dụng. Trong bài viết này, SDK đề cập đến cả SDK của AppsFlyer iOS và Android.

Các trường hợp đặc biệt về thử nghiệm và gỡ lỗi

TV thông minh: SDK tương thích với TV thông minh dựa trên Android và Apple TV (tvOS). Thử nghiệm các ứng dụng TV thông minh bằng cách sử dụng chỉ dẫn trong phần hướng dẫn này.
Ứng dụng tvOS chưa được phát hành: xem Thử nghiệm tích hợp tvOS trước khi phát hành.
Amazon Fire TV: xem Thử nghiệm các cửa hàng Android thay thế.

Tại sao tôi nên gỡ lỗi và thử nghiệm?

Tích hợp được thử nghiệm cẩn thận đảm bảo việc thu thập dữ liệu sẽ chính xác và toàn diện. Bằng cách thử nghiệm tích hợp SDK, bạn đảm bảo rằng các lượt cài đặt và sự kiện trong ứng dụng được ghi nhận và phân bổ chính xác.

Thử nghiệm và gỡ lỗi tích hợp SDK

Sử dụng một trong các phương pháp sau để thử nghiệm và gỡ lỗi tích hợp SDK

Thử nghiệm cơ bản:
- Kiểm tra tích hợp bằng cách sử dụng các đường dẫn phân bổ.
- Mô hình phân bổ của AppsFlyer sử dụng các đường dẫn phân bổ. Tiến hành thử nghiệm bằng cách sử dụng các liên kết phân bổ được đề xuất.
- Khi thử nghiệm tích hợp SDK bằng cách sử dụng đường dẫn phân bổ, bạn sẽ có được thông tin chi tiết chuyên sâu về mô hình phân bổ AppsFlyer. Điều này mang lại cho bạn cơ hội để tối ưu hóa hoạt động tiếp thị và phân tích của mình.
Thử nghiệm nâng cao:
- Gỡ lỗi trực tiếp từ môi trường phát triển.
- Phần thử nghiệm tích hợp SDK chỉ thử nghiệm một số tính năng hạn chế. Thử nghiệm những yếu tố sau trong môi trường phát triển bằng cách sử dụng nhật ký gỡ lỗi:
  - Xác thực mua
  - Dữ liệu chuyển đổi
  - Lỗi thiết lập SDK. Bạn có thể thử nghiệm các yếu tố này trong môi trường phát triển với sự trợ giúp của nhật ký gỡ lỗi.

Bài đọc liên quan cho mạng quảng cáo: Thử nghiệm tích hợp mạng quảng cáo.

Sử dụng trang Thử nghiệm tích hợp SDK để xác định các vấn đề tích hợp trong dự án của bạn. Sử dụng trang này để thử nghiệm lượt cài đặt, sự kiện trong ứng dụng và liên kết sâu.

Thử nghiệm tích hợp SDK

Để thử nghiệm tích hợp SDK:

Chuẩn bị một thiết bị (iOS hoặc Android) chưa cài đặt ứng dụng. Nếu cần, hãy gỡ cài đặt ứng dụng khỏi thiết bị.
Đăng ký thiết bị làm thiết bị thử nghiệm.
Trong bảng điều khiển, hãy chọn ứng dụng.
Đi đến Integration (Tích hợp) > SDK Integration Tests (Thử nghiệm Tích hợp SDK).
Trang thử nghiệm tích hợp SDK sẽ mở ra.
Chọn một tùy chọn thử nghiệm:
- Các lượt Cài đặt không tự nhiên
- Sự kiện trong Ứng dụng
- Deep Linking
Sử dụng quy trình thử nghiệm sau theo loại thử nghiệm đã chọn.

Thử nghiệm các lượt cài đặt tự nhiên

Cài đặt ứng dụng trên thiết bị thử nghiệm đã đăng ký.
Khởi chạy ứng dụng.
Bảng điều khiển ứng dụng sẽ hiển thị một lượt cài đặt tự nhiên mới.

Thử nghiệm các lượt Cài đặt không tự nhiên

Chọn Non-organic install (Cài đặt không tự nhiên).
Chọn một thiết bị có trong danh sách.
Chọn nguồn của ứng dụng:
- Android:
  - Google Play
  - Khác (Ngoài cửa hàng, Android Studio, tệp tin .APK, v.v.)
- iOS:
  - Cửa hàng Ứng dụng
  - Khác (XCode, TestFlight, v.v.)
Quét mã QR bằng thiết bị thử nghiệm đã đăng ký và làm theo hướng dẫn trên thiết bị.
Đợi cho đến khi lượt cài đặt không tự nhiên được đăng ký trên trang Thử nghiệm Tích hợp SDK cho biết thử nghiệm thành công. Thao tác này có thể kéo dài lên tới 2 phút.
Nếu ứng dụng không ghi lại lượt cài đặt không tự nhiên vào thời điểm đó, hãy xem phần khắc phục sự cố xuất hiện trên trang Thử nghiệm Tích hợp SDK.

Để thử nghiệm lượt cài đặt LAT:

Bật chế độ LAT trên thiết bị của bạn.
Thực hiện việc thử nghiệm Lượt cài đặt không tự nhiên.

Để thử nghiệm các lượt cài đặt không có sự đồng ý ATT (không có IDFA):

Trong hộp thoại ATT consent (đồng ý ATT), hãy nhấp vào Ask App Not to Track (Yêu cầu Ứng dụng Không Theo dõi).
Thực hiện việc thử nghiệm Lượt cài đặt không tự nhiên.

Thử nghiệm Sự kiện trong Ứng dụng

Nhấp vào Run test (Chạy thử nghiệm) trong phần In-app events (Sự kiện trong ứng dụng).
Chọn một thiết bị thử nghiệm đã đăng ký từ menu thả xuống, nhấp vào Next (Tiếp theo).
Khởi chạy ứng dụng của bạn và bắt đầu tạo các sự kiện trong ứng dụng.
Bạn sẽ thấy một bản ghi của những sự kiện này khi chúng được đăng ký trong thời gian thực.

Thử nghiệm Liên kết Sâu

OneLink phải được xác định cho ứng dụng của bạn để thử nghiệm liên kết sâu. Xem hướng dẫn OneLink của chúng tôi tại đây. Điều quan trọng cần lưu ý là thực sự nên triển khai Liên kết Sâu SDK, như được nêu trong hướng dẫn tích hợp liên kết sâu.
Xác minh đảm bảo rằng tính năng nhắm mục tiêu lại đã được bật.
Nhấp vào Run test (Chạy thử nghiệm) trong Deep linking (Liên kết sâu).
Chọn một thiết bị thử nghiệm đã đăng ký từ menu thả xuống và nhấp vào Next (Tiếp theo).
Chọn Test Type (Loại Thử nghiệm):
- OneLink - Chọn OneLink bạn muốn thử nghiệm từ menu thả xuống Chọn một OneLink.
- Lược đồ URI - chỉ định lược đồ URI mà bạn muốn thử nghiệm. Ví dụ: greatapps://cars.
Quét mã QR bằng thiết bị thử nghiệm đã được đăng ký của bạn và làm theo hướng dẫn trên thiết bị.
Sau khi hai thử nghiệm này được hoàn thành, Thử nghiệm Liên kết Sâu được đăng ký là thành công.

Thử nghiệm Tích hợp SDK Sử dụng Ứng dụng Gỡ lỗi

Khi thử nghiệm bằng đường dẫn phân bổ, dữ liệu sẽ được ghi vào bảng điều khiển của ứng dụng. Khi dữ liệu được ghi lại thì không thể xóa. Nếu không muốn dữ liệu thử nghiệm được ghi nhận như một phần của ứng dụng thực, bạn có thể thử nghiệm tích hợp SDK bằng sử dụng các ứng dụng gỡ lỗi.

Nếu bạn không yêu cầu ứng dụng thử nghiệm hoặc nếu bạn không quan tâm đến việc trộn dữ liệu thử nghiệm và dữ liệu thực, bạn có thể bỏ qua phần này.

Ứng dụng gỡ lỗi là bản sao chính xác của các ứng dụng được xuất bản trong các cửa hàng ứng dụng. Bằng cách chạy thử nghiệm tích hợp SDK trên các ứng dụng gỡ lỗi, bạn không xâm phạm đến dữ liệu thực với dữ liệu thử nghiệm.

Các ứng dụng gỡ lỗi khác với các ứng dụng sản xuất ở điểm:

Có ID ứng dụng khác
Có bảng điều khiển riêng
Không được xuất bản trên các cửa hàng ứng dụng

Tạo Ứng dụng Thử nghiệm Android

Sao chép Ứng dụng Android của bạn

Tạo một bản sao của thư mục dự án Android và đặt lại tên cho thư mục đó.
Mở dự án mới được sao chép trong Android studio.
Trong Android Studio, hãy mở rộng các thư mục cho đến khi bạn đến vị trí của gói.
Nhấp chuột phải vào tên gói, chọn Refactor (Tái cấu trúc) rồi Rename (Đổi tên).
Đổi tên gói.
Trong cấp ứng dụng build.grade, đổi applicationId thành tên gói mới.

Thêm ứng dụng thử nghiệm Android vào Appsflyer

Thực hiện theo chỉ dẫn để thêm một ứng dụng mới trong bảng điều khiển AppsFlyer của bạn. Đảm bảo rằng tên gói giống với tên gói của ứng dụng thử nghiệm mới được tạo và không phải là tên gói của ứng dụng gốc. Ngoài ra, đảm bảo thiết lập trạng thái ứng dụng thành Đang chờ phê duyệt hoặc chưa được công bố.

Bây giờ bạn có thể chạy các thử nghiệm trên ứng dụng thử nghiệm mới.

Tạo Ứng dụng Thử nghiệm iOS

Thêm ứng dụng thử nghiệm iOS vào bảng điều khiển AppsFlyer của bạn.
Làm theo hướng dẫn để thêm ứng dụng mới vào bảng điều khiển AppsFlyer. Hãy nhớ đặt trạng thái ứng dụng thành Pending approval (Đang chờ phê duyệt) hoặc Unpublished (Chưa xuất bản).

Trong lớp AppDelegate, bên trong didFinishLaunchingWithOptions, hãy thêm mã sau:

bool isDebugApplication = false;
...
if(isDebugApplication) {
    [AppsFlyerLib shared].isDebug = isDebugApplication;
    [AppsFlyerLib shared].appleAppID = @"11111xxxx"; // Testing app ID
  } else {
    [AppsFlyerLib shared].appleAppID = @"PROD_APP_ID"; // Production app ID
  }

var isDebugApplication = false
...
if(isDebugApplication) {
      AppsFlyerLib.shared().isDebug = isDebugApplication
      AppsFlyerLib.shared().appleAppID = "1111xxxx" // Testing app ID
    } else {
      AppsFlyerLib.shared().appleAppID = "PROD APP ID" // Production app ID
    }}

Lưu ý

ID ứng dụng là ID được cấp cho ứng dụng sau khi được xuất bản lên cửa hàng ứng dụng. Tuy nhiên, vì đây là một ứng dụng thử nghiệm, bạn có thể cung cấp cho nó bất kỳ ID nào bạn muốn miễn là ID đó không thuộc ứng dụng khác. Định dạng là 11111****. Ví dụ: 111117538.

Đảm bảo ID có 9 chữ số. Bắt đầu id với bốn số 1. Các con số còn lại phải là ngẫu nhiên. Xem ví dụ về ID ở trên.

Kiểm tra Sử dụng Liên kết Phân bổ

Phần này trình bày cách thử nghiệm tích hợp với sự trợ giúp của các liên kết phân bổ.

Trước khi bạn bắt đầu:

Đăng ký các thiết bị mà bạn sử dụng để thử nghiệm.
Khi thử nghiệm các lượt phân bổ lại, hãy nhớ xóa thiết bị đã đăng ký khỏi danh sách cho phép.
Nếu bạn đang thử nghiệm phân bổ các ứng dụng có sẵn qua các cửa hàng ứng dụng Android của bên thứ ba, bạn phải đặt thông số af_r trên đường dẫn phân bổ để tham chiếu đến cửa hàng ứng dụng cụ thể.

Bạn có thể thử nghiệm tích hợp SDK ngay cả khi ứng dụng vẫn đang chờ xử lý (nghĩa là, chưa được phát hành trên Google Play hoặc Apple Store)

Các chủ đề trong phần này:

Thử nghiệm Phân bổ Cài đặt
Thử nghiệm Sự kiện trong Ứng dụng
Thử nghiệm nhắm mục tiêu lại (phân bổ lại và thu hút lại)

Thử nghiệm Phân bổ Cài đặt

Thử nghiệm cài đặt cho phép bạn xác định rằng AppsFlyer SDK có thể phân bổ chính xác các lượt cài đặt tới các nguồn phương tiện khác nhau.

Bước 1:

Sao chép liên kết dưới đây:

https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

Thay đổi thông số app_id thành id ứng dụng của bạn (bao gồm cả tiền tố id. Ví dụ: id0123456789).

Thông số c chỉ rõ tên của chiến dịch.
Thông số pid chỉ định tên của nguồn phương tiện mà lượt cài đặt được phân bổ.
Nếu bạn đang thử nghiệm một ứng dụng có sẵn qua cửa hàng Android của bên thứ ba: hãy thêm thông số af_r vào đường dẫn phân bổ.

Nếu bạn thử nghiệm lượt nhấp từ máy tính, hãy thêm GAID đối với Android (ID Quảng cáo Google) hoặc IDFA đối với iOS.

Bước 2:

Sao chép liên kết, gửi liên kết đến thiết bị thử nghiệm và điều hướng đến liên kết bằng trình duyệt.

Lưu ý

Trong iOS, sử dụng iMessenger hoặc email để gửi liên kết đến thiết bị. Không dán liên kết trong ứng dụng iOS Notes và sau đó nhấp vào liên kết vì nó có thể làm hỏng liên kết.

Nếu ứng dụng đang hoạt động, hãy tiến hành cài đặt.
Nếu ứng dụng đang chờ xử lý, cài đặt ứng dụng từ môi trường phát triển của bạn:
-- Đối với Android - lượt cài đặt từ Android Studio hoặc ADB shell
-- Đối với iOS - lượt cài đặt từ XCode

Bước 3:

Cho phép tối đa hai phút để lượt cài đặt xuất hiện trong bảng điều khiển của ứng dụng. Bạn có thể nhìn thấy lượt cài đặt được phân bổ tới nguồn truyền thông Thử nghiệm theo chiến dịch Thử nghiệm.

Để xác minh kỹ hơn, hãy tải xuống báo cáo dữ liệu thô về cài đặt:

Trong AppsFlyer, đi tới Reports (Báo cáo) > Export Data (Xuất Dữ liệu).
Trong phần Báo cáo Dữ liệu Thô, hãy tải xuống báo cáo dữ liệu thô về Cài đặt.

Xem bài viết của chúng tôi về báo cáo dữ liệu thô về cài đặt để biết thêm thông tin.

Thử nghiệm Sự kiện trong Ứng dụng

Bạn có thể kiểm tra các sự kiện trong ứng dụng để thấy rằng các sự kiện này hiển thị doanh thu được liên kết với chúng và các sự kiện được phân bổ cho nguồn phương tiện tạo ra lượt cài đặt.

Sau khi cài đặt ứng dụng bằng liên kết phân bổ, hãy kích hoạt một vài sự kiện trong ứng dụng. Cho phép tối đa hai phút để các sự kiện xuất hiện trong bảng điều khiển. Mở bảng điều khiển của ứng dụng và đi đến Events trong menu bên trái.

Bạn sẽ thấy các sự kiện, doanh thu của sự kiện (nếu doanh thu được liên kết với các sự kiện) và nguồn phương tiện mà các sự kiện được liên kết.

Để xác minh kỹ lưỡng hơn, bạn có thể tải xuống báo cáo dữ liệu thô sự kiện trong ứng dụng.

Trong bảng điều khiển của ứng dụng, nhấp vào Xuất Dữ liệu dưới phần Báo cáo. Trong phần Báo cáo Dữ liệu Thô, vui lòng tải xuống báo cáo dữ liệu thô Sự Kiện Trong Ứng Dụng.

Xem bài viết của chúng tôi về báo cáo dữ liệu thô về sự kiện trong ứng dụng để biết thêm thông tin.

Thử nghiệm OneLink

OneLink™ cho phép bạn thiết lập một liên kết phân bổ duy nhất cho cả iOS và Android. OneLink nhận ra thiết bị của người dùng và chuyển hướng chúng đến cửa hàng ứng dụng có liên quan.

Bên cạnh đó, OneLink cho phép liên kết sâu (deeplinking). Liên kết sâu cho phép bạn mở ứng dụng trong một hoạt động ứng dụng cụ thể trong khi phục vụ nội dung tùy chỉnh.

Để biết thêm thông tin chi tiết, vui lòng xem hướng dẫn của chúng tôi về thử nghiệm các URL OneLink.

Thử nghiệm Nhắm mục tiêu lại

Điều kiện tiên quyết để Thử nghiệm Nhắm mục tiêu lại

Mẫu OneLink - xem cấu hình mẫu OneLink
Bật nhắm mục tiêu lại trong cài đặt của ứng dụng.
Trong bảng điều khiển ứng dụng, nhấp vào App Settings (Cài đặt Ứng dụng) và bật Enable Re-Targeting Campaign Measurement (Bật Đo lường Chiến dịch Nhắm mục tiêu lại).

Android iOS
Thiết bị chưa được đăng ký

Kiểm tra nhắm mục tiêu lại rất đơn giản. Tạo ra một liên kết phân bổ tùy chỉnh từ mẫu OneLink. Đảm bảo bật Chiến dịch Nhắm mục tiêu lại.

Khi liên kết phân bổ tùy chỉnh sẵn sàng, màn hình sau sẽ xuất hiện, tại đây bạn có thể truy xuất phiên bản URL:

Một cách khác để truy xuất phiên bản URL dài là thông qua trang Quản lý Liên kết.

Trong trang Link Management (Quản lý Liên kết), hãy xác định đường dẫn phân bổ.
Ở phía bên phải, nhấp vào ba dấu chấm dưới phần Actions (Thao tác).
Nhấp vào View Link Details (Xem Chi tiết Liên kết).
Sao chép Liên kết Đầy đủ.

Quan trọng!

Khi thử nghiệm nhắm mục tiêu lại (phân bổ lại và thu hút lại), ID quảng cáo phải được chỉ định trong URL đường dẫn phân bổ.
Không thể thử nghiệm các lượt cài đặt lại nhắm mục tiêu lại (còn gọi là phân bổ lại) bằng các thiết bị thử nghiệm đã đăng ký. Có nghĩa là, thiết bị người dùng có trong danh sách thiết bị thử nghiệm. Bạn có thể sử dụng bất kỳ thiết bị nào khác cho mục đích này.
Để xem GAID hoặc IDFA, hãy làm theo các hướng dẫn trong bài viết đăng ký thiết bị thử nghiệm. Lưu ý!

OneLink cuối cùng như sau:

https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

https://go.onelink.me/2rAD?pid=Test&c=Test&is_retargeting=true&idfa=<IDFA>

Thử nghiệm Phân bổ lại (Re-Attribution)

Bạn có thể kiểm tra phân bổ lại (re-attribution) để xác minh rằng bạn có thể ghi nhận các lượt cài đặt ứng dụng của mình bởi những người dùng đã cài đặt lại ứng dụng sau khi gỡ cài đặt ứng dụng này trước đây.

Đảm bảo rằng thiết bị thử nghiệm của bạn CHƯA được đăng ký.
Nếu ứng dụng vừa được cài đặt, hãy đợi trong vài phút.
Gỡ cài đặt ứng dụng khỏi thiết bị.
Lặp lại các bước tương tự để kiểm tra phân bổ cài đặt - sử dụng định dạng OneLink ở trên.
Cho phép tối đa hai phút để lượt cài đặt nhắm mục tiêu lại xuất hiện trong bảng điều khiển.
Mở bảng điều khiển của ứng dụng và nhấp vào Re-Targeting (Nhắm mục tiêu lại) trong menu bên phía tay trái.
Bạn có thể thấy lượt cài đặt phân bổ lại được phân bổ cho nguồn truyền thông Thử nghiệm với tên chiến dịch Thử nghiệm.

Để xác minh kỹ lưỡng hơn, bạn có thể tải xuống báo cáo dữ liệu thô chuyển đổi.

Trong bảng điều khiển của ứng dụng, nhấp vào Xuất Dữ Liệu trong phần Báo cáo. Trong phần Báo cáo Nhắm mục tiêu lại , tải xuống báo cáo dữ liệu thô Chuyển đổi.

Thử nghiệm Thu hút lại

Thu hút lại (Re-engagement) xảy ra khi người dùng đã cài đặt ứng dụng, tham gia vào chiến dịch nhắm mục tiêu lại và khởi chạy ứng dụng.

Thử nghiệm Thu hút lại (Re-Engagement) thông qua Mở Ứng dụng

Thu hút lại thông qua việc mở ứng dụng có nghĩa là người dùng được chuyển hướng đến cửa hàng ứng dụng nơi người đó nhìn thấy một nút mở ứng dụng. Nếu họ nhấp vào nút mở và khởi chạy ứng dụng, một lượt thu hút lại sẽ được ghi nhận.

Để thử nghiệm các lượt thu hút lại, hãy làm theo các bước dưới đây:

Đảm bảo ứng dụng được cài đặt trên thiết bị thử nghiệm của bạn và đã được khởi chạy nhiều lần.
Nếu ứng dụng vừa được cài đặt, hãy đợi trong vài phút.
Dùng cùng loại OneLink được sử dụng để kiểm tra phân bổ lại.
Thêm ID thiết bị vào liên kết và gửi đến thiết bị di động của bạn.
Điều hướng đến liên kết bằng trình duyệt.
Mở ứng dụng theo cách thủ công thông qua nút Open (Mở) trong cửa hàng hoặc từ bảng khởi chạy thiết bị.

Bạn có thể nhìn thấy lượt thu hút lại được phân bổ tới nguồn truyền thông Thử nghiệm theo tên chiến dịch Thử nghiệm.

Thử nghiệm Thu hút lại thông qua Liên kết Sâu

Thu hút lại thông qua liên kết sâu cho phép bạn khởi chạy ứng dụng ngay sau khi người dùng nhấp vào liên kết phân bổ. Những lợi ích của việc sử dụng thu hút lại với liên kết sâu:

Trải nghiệm người dùng tốt hơn - người dùng không được chuyển hướng đến cửa hàng và ứng dụng sẽ tự động khởi chạy
Các chiến dịch tốt hơn - bạn có thể mở một hoạt động liên quan đến chiến dịch cụ thể và cách này tối đa hóa kết quả của chiến dịch nhắm mục tiêu lại

Bạn có thể kiểm tra phân bổ lượt thu hút lại bằng cách sử dụng liên kết sâu. Đây là quy trình tương tự như thử nghiệm thu hút lại với một liên kết phân bổ. Sự khác biệt duy nhất là liên kết phân bổ chứa tham số af_dp chuyển hướng người dùng đến một hoạt động cụ thể trong ứng dụng.

Để thử nghiệm các lượt thu hút lại sử dụng liên kết sâu, hãy làm theo các bước dưới đây:

Hãy đảm bảo cấu hình ứng dụng của bạn cho liên kết sâu.
Đảm bảo ứng dụng được cài đặt trên thiết bị thử nghiệm của bạn và đã được khởi chạy nhiều lần.
Nếu ứng dụng vừa được cài đặt, hãy đợi trong vài phút.
Tạo liên kết nhắm mục tiêu lại với ID thiết bị.
Thêm thông số af_dp và thêm lược đồ mà bạn đã cấu hình ở bước 1 vào đó.
Điều hướng đến liên kết bằng trình duyệt.
Nếu ứng dụng được cài đặt, liên kết sẽ khởi chạy ứng dụng trong hoạt động được chỉ định trong liên kết.

Bạn có thể nhìn thấy lượt thu hút lại được phân bổ tới nguồn truyền thông Thử nghiệm theo tên chiến dịch Thử nghiệm.

Để biết thêm thông tin chi tiết, xem hướng dẫn của chúng tôi về Thử nghiệm Liên kết sâu.

Các Phương Thức Bổ Sung Để Thử Nghiệm Tích Hợp SDK

Có hai cách khác để kiểm tra tích hợp SDK:

Phần này trình bày cách gỡ lỗi tích hợp SDK. Tham khảo phần này để tiến hành thử nghiệm nâng cao và khắc phục sự cố khi tích hợp SDK.

Debug cho Android

Việc gỡ lỗi SDK cung cấp cho bạn một cái nhìn chuyên sâu về cách tích hợp với ứng dụng của bạn. Gỡ lỗi giúp bạn giải quyết các vấn đề với ghi nhận sự kiện trong ứng dụng, dữ liệu chuyển đổi và xác thực mua hàng.

Kích hoạt Chế độ Debug SDK cho Android

Để bắt đầu gỡ lỗi Android SDK, hãy thêm dòng sau vào lớp AFApplication:

AppsFlyerLib.getInstance().setDebugLog(true);

Cảnh báo!

Debug chỉ nên được giới hạn trong giai đoạn phát triển. Không phân phối ứng dụng cho các cửa hàng ứng dụng có bật gỡ lỗi. Điều này đặt ra những rủi ro lớn về bảo mật và quyền riêng tư.

Xem Đầu ra Gỡ lỗi

Để xem các đầu ra gỡ lỗi, mở thiết bị đầu cuối Logcat trong Android studio. Chọn tên gói ứng dụng là quy trình có thể sửa lỗi, thiết lập cấp độ đăng nhập để Debug và lọc theo "AppsFlyer_".

Khắc phục sự cố thường gặp với SDK Android

Lượt cài đặt luôn được phân bổ là Tự nhiên

Tình huống

Bạn đang kiểm tra phân bổ bằng cách sử dụng các liên kết phân bổ. Bạn đã triển khai trình nghe chuyển đổi SDK nhưng nhật ký luôn cho thấy lượt cài đặt là tự nhiên. Ngoài ra, không có cài đặt không tự nhiên nào được ghi lại trong bảng điều khiển.

Những lý do Khả quan

dev key của bạn chưa đúng - nếu bạn chỉ định một dev key không đúng, lượt cài đặt không thể được phân bổ.
Đường dẫn phân bổ bạn đang sử dụng là không chính xác. Xem hướng dẫn của chúng tôi về đường dẫn phân bổ.
Đảm bảo rằng thiết bị bạn dùng để thử nghiệm đã được đăng ký.
Một kênh không phù hợp được xác định trong tệp kê khai

Cài đặt không được Phát hiện hoặc Phân bổ

Tình huống

Bạn đang thử nghiệm phân bổ cài đặt nhưng nhật ký không hiển thị bất kỳ dữ liệu nào về cài đặt, chẳng hạn như loại cài đặt hay khởi chạy đầu tiên, v.v.

Những lý do Khả quan

Đảm bảo phương pháp startTracking và init được gọi trong lớp AFApplication.
Đảm bảo rằng thiết bị bạn dùng để thử nghiệm đã được đăng ký.

Tôi nhận được lỗi 404 về Cài đặt hoặc Ghi nhận Sự kiện

Tình huống

Bạn đang thử nghiệm các sự kiện trong ứng dụng để thấy rằng các sự kiện này được phân bổ cho nguồn phương tiện chính xác. Tuy nhiên, nhật ký hiển thị phản hồi 404 cho cả cài đặt và khi bạn gửi các sự kiện trong ứng dụng. Cả cài đặt lẫn sự kiện trong ứng dụng đều không xuất hiện trong bảng điều khiển.

Những lý do Khả quan

Phản hồi 404 cho biết ID ứng dụng không chính xác. Đảm bảo rằng ID ứng dụng trong thông số applicationId trong tệp build.gradle giống với ID trong bảng điều khiển của bạn.

Doanh thu không được ghi đúng cách

Tình huống

Bạn đang thử nghiệm các sự kiện trong ứng dụng với doanh thu. Các sự kiện xuất hiện trong bảng điều khiển nhưng doanh thu không được ghi lại

Những lý do Khả quan

Thông số doanh thu không được định dạng chính xác. KHÔNG định dạng giá trị doanh thu theo bất kỳ cách nào. Định dạng không nên chứa dấu phẩy phân tách, ký hiệu tiền tệ hoặc văn bản. Ví dụ một sự kiện doanh thu nên tương tự như 1234.56.

Nhật ký hiển thị "SDK của AppsFlyer không thể gửi bất kỳ sự kiện nào mà không cung cấp DevKey" khi tôi kiểm tra các sự kiện trong ứng dụng

Tình huống

Bạn đang cố gắng xem các sự kiện trong ứng dụng trong nhật ký. Khi bạn kích hoạt các sự kiện, nhật ký chỉ hiển thị "SDK của AppsFlyer không thể gửi bất kỳ sự kiện nào mà không cung cấp DevKey".

Những lý do Khả quan

Bạn gọi phương thức startTracking mà không chuyển dev key làm thông số. Chuyển dev key tới phương thức.

Nhật ký hiển thị "Chưa gửi dữ liệu, đang chờ dev key" trong Nhật ký khi tôi thử nghiệm các sự kiện trong ứng dụng

Tình huống

Bạn đang cố gắng thử nghiệm các sự kiện trong ứng dụng trong nhật ký. Khi bạn kích hoạt các sự kiện, nhật ký chỉ hiển thị "Chưa gửi dữ liệu, đang chờ dev key".

Những lý do Khả quan

Bạn gọi init và chuyển dev key như là một chuỗi rỗng. Chuyển dev key tới phương thức.

Tôi nhận được phản hồi 400 khi thử nghiệm các sự kiện trong ứng dụng

Tình huống

Bạn đang cố gắng thử nghiệm các sự kiện trong ứng dụng trong nhật ký. Khi bạn kích hoạt các sự kiện, bạn sẽ thấy phản hồi 400 trong nhật ký.

Những lý do Khả quan

Điều này cho biết có vấn đề với dev key. Kiểm tra xem dev key có chính xác không. Ngoài ra, hãy đảm bảo rằng dev chỉ chứa các ký tự chữ và số.

Nhật ký hiển thị "CẢNH BÁO: Dịch vụ Google Play bị thiếu"

Tình huống

Logcat hiển thị thông báo cảnh báo "CẢNH BÁO: Dịch vụ Google Play bị thiếu".

Những lý do Khả quan

Ứng dụng này thiếu các phần phụ thuộc của Google Play Services. Điều này có thể ngăn SDK thu thập GAID có thể gây ra sự cố với việc phân bổ.

Thêm những dòng sau

implementation 'com.google.android.gms:play-services-base:15.0.1'
implementation 'com.google.android.gms:play-services-ads:15.0.1'

Trong tệp cấp độ mô đun (ứng dụng) build.gradle.

Tôi nhận được lỗi 400 về Cài đặt hoặc Ghi nhận Sự kiện

Tình huống

Bạn đang cố gắng thử nghiệm lượt cài đặt và các sự kiện chuyển đổi khác trong nhật ký. Khi bạn kích hoạt các sự kiện này, bạn sẽ thấy phản hồi 403 (cấm) trong nhật ký.

Những lý do Khả quan

Điều này có thể là do gói Zero của bạn, gói này không bao gồm dữ liệu phân bổ mà chỉ có dữ liệu về lượt nhấp và hiển thị. Để bắt đầu nhận dữ liệu phân bổ, hãy tìm hiểu thêm về các gói khác của AppsFlyer và cập nhật nếu cần. Bạn cũng có thể liên hệ với nhóm quan hệ khách hàng của chúng tôi tại địa chỉ hello@appsflyer.com nếu bạn có thắc mắc về các gói của chúng tôi.

Gỡ lỗi cho iOS

Kích hoạt Chế độ Gỡ lỗi SDK cho iOS

Để bắt đầu gỡ lỗi SDK iOS, hãy thêm dòng sau trong phương thức didFinishLaunchingWithOptions:

Thêm dòng sau trong AppDelegate.m:

[AppsFlyerLib shared].isDebug = true;

Thêm dòng sau trong AppDelegate.swift:

AppsFlyerLib.shared().isDebug = true

Cảnh báo!

Gỡ lỗi chỉ nên được giới hạn trong giai đoạn phát triển. Không phân phối ứng dụng cho các cửa hàng ứng dụng có bật gỡ lỗi. Điều này gây ra những rủi ro lớn về bảo mật và quyền riêng tư.

Xem Đầu ra Gỡ lỗi

Để xem đầu ra gỡ lỗi, hãy mở thiết bị đầu cuối gỡ lỗi trong XCode và lọc theo "AppsFlyer".

Khắc phục sự cố thường gặp với SDK iOS

Các lượt cài đặt và sự kiện không được ghi lại

Có thể có một số lý do tại sao các lượt cài đặt và sự kiện không được ghi lại:

Nếu bạn chỉ định ID ứng dụng ở định dạng sai, các lượt cài đặt và sự kiện sẽ không được ghi nhận. Khi cài đặt ID ứng dụng trong tệp tin delegate, hãy đảm bảo ID chỉ bao gồm các số.

Bạn có thể thấy dev key trong Bảng điều khiển AppsFlyer bên trong Cài đặt Ứng dụng:

Chính xác:

[AppsFlyerTracker sharedTracker].appleAppID = @"340954503";

Không chính xác:

[AppsFlyerTracker sharedTracker].appleAppID = @"id340954503";

Không chính xác:

[AppsFlyerTracker sharedTracker].appleAppID = @"com.appslyer.sampleapp";

Trong trường hợp ID ứng dụng ở trong định dạng sai, nhật ký sẽ hiển thị lỗi sau:

[ERROR] AppsFlyer: -[AppsFlyerTracker validateAppID] 
AppsFlyer Error: appleAppID should be a number!

Nếu bạn chỉ định ID ứng dụng không tồn tại trong tài khoản của mình, các lượt cài đặt và sự kiện sẽ không được ghi lại. Nhật ký hiển thị lỗi sau:

AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:
completionHandler:]_block_invoke sent information to server, status = 404

Lỗi 404 cho biết SDK không thể tìm thấy ứng dụng trong tài khoản của bạn.

Nếu bạn chỉ định ID dev key không chính xác, các lượt cài đặt và sự kiện sẽ không được ghi lại. Nhật ký hiển thị lỗi sau:

AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:completionHandler:]
_block_invoke sent information to server, status = 400

Lỗi 400 cho biết SDK không thể xác thực yêu cầu ghi nhận các cài đặt và sự kiện. Kiểm tra xem dev key có chính xác không. Ngoài ra, hãy đảm bảo rằng dev chỉ chứa các ký tự chữ và số.

ID Ứng dụng và Dev Key chính xác nhưng Cài đặt không được ghi lại

Tình huống

Ứng dụng chứa ID ứng dụng và dev key chính xác nhưng cài đặt không được ghi lại.

Những lý do Khả quan

SDK không được khởi chạy chính xác. Hãy đảm bảo gọi phương thức trackAppLaunch trong applicationDidBecomeActive:

- (void)applicationDidBecomeActive:(UIApplication *)application { 
	[[AppsFlyerTracker sharedTracker] trackAppLaunch]; 
}

func applicationDidBecomeActive(application: UIApplication) { 
	AppsFlyerTracker.shared().trackAppLaunch() 
}

Nhật ký Hiển thị "Dev key của AppsFlyer bị thiếu hoặc trống. Hủy bỏ"

Tình huống

Bạn đang cố gắng xem các sự kiện trong ứng dụng trong nhật ký. Nhật ký hiển thị "Dev key của AppsFlyer bị thiếu hoặc trống. Hủy bỏ".

Những lý do Khả quan

Dev key không được cài đặt. Hãy thiết lập nó trong appDelegate trong phương thức didFinishLaunchingWithOptions:

[AppsFlyerTracker sharedTracker].appsFlyerDevKey = @"YOUR_DEV_KEY";

AppsFlyerTracker.shared().appsFlyerDevKey = "YOUR_DEV_KEY"

Lượt cài đặt luôn được phân bổ là Tự nhiên

Tình huống

Những lý do Khả quan

Đường dẫn phân bổ bạn đang sử dụng là không chính xác. Xem hướng dẫn của chúng tôi về đường dẫn phân bổ.
Đảm bảo rằng thiết bị bạn dùng để thử nghiệm đã được đăng ký.

Doanh thu không được ghi đúng cách

Tình huống

Bạn đang thử nghiệm các sự kiện trong ứng dụng với doanh thu. Các sự kiện xuất hiện trong bảng điều khiển nhưng doanh thu không được ghi lại

Những lý do Khả quan

Tôi nhận được lỗi 404 về Cài đặt hoặc Ghi nhận Sự kiện

Tình huống

Bạn đang thử nghiệm các lượt cài đặt và sự kiện trong ứng dụng để thấy rằng các chúng được phân bổ cho nguồn phương tiện chính xác. Tuy nhiên, phản hồi 404 xuất hiện cho cả cài đặt và sự kiện trong ứng dụng. Cả cài đặt lẫn sự kiện trong ứng dụng đều không xuất hiện trong bảng điều khiển.

Những lý do Khả quan

Phản hồi 404 cho biết ID ứng dụng không chính xác. Xem Lượt cài đặt và Sự kiện không được ghi nhận.

Tôi nhận được lỗi 400 về Cài đặt hoặc Ghi nhận Sự kiện

Tình huống

Bạn đang cố gắng thử nghiệm các sự kiện trong ứng dụng trong nhật ký. Khi bạn kích hoạt các sự kiện, bạn sẽ thấy phản hồi 400 trong nhật ký.

Những lý do Khả quan

Điều này cho biết có vấn đề với dev key. Kiểm tra xem dev key có chính xác không. Ngoài ra, hãy đảm bảo rằng dev key chỉ chứa các ký tự chữ và số. Xem Lượt cài đặt và Sự kiện không được ghi nhận.

Tôi nhận được lỗi 400 về Cài đặt hoặc Ghi nhận Sự kiện

Tình huống

Những lý do Khả quan

Gỡ lỗi cho Unity

Kích hoạt Chế độ Gỡ lỗi trong Unity

Để bắt đầu gỡ lỗi SDK Unity, hãy thêm dòng sau vào phương thức start trong AF GameObject

AppsFlyer.setIsDebug (true);

Cảnh báo!

Xem Đầu ra Gỡ lỗi

Xem đầu ra gỡ lỗi được thực hiện thông qua Android Studio hoặc XCode.

Khắc phục sự cố thường gặp với SDK Unity

Unity chỉ đơn giản xây dựng ứng dụng Android và iOS. Tham khảo các vấn đề phổ biến với mỗi nền tảng để biết thêm thông tin:

Các sự cố thường gặp với Android SDK
Các sự cố thường gặp với iOS SDK

Lưu ý

Khi bạn hoàn tất thử nghiệm và gỡ lỗi tích hợp SDK, hãy tắt nhật ký SDK.