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 (xóa) ứng dụng khỏi thiết bị.
- Đăng ký thiết bị làm thiết bị thử nghiệm. Lưu ý! iOS: Nếu bạn sử dụng TestFlight để cài đặt ứng dụng, không cần phải đăng ký thiết bị.
- Trong AppsFlyer, 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)
- iOS:
- Cửa hàng Ứng dụng
- XCode
- TestFlight
- Android:
- 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 cài đặt không tự nhiên được đăng ký trong 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 nhận lượt cài đặt không tự nhiên nào vào thời điểm đó, hãy tham khảo 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 Chạy thử nghiệm trong mục 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 Chạy thử nghiệm trong 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 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 studio Android
- Trong Android Studio, hãy mở rộng các thư mục cho đến khi bạn đạt được gói
- Nhấp chuột phải vào tên gói, chọn Tái cấu trúc và sau đó Đổi tên
- Đổi tên gói
- Trong cấp ứng dụng build.grade thay đổ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
Sao chép Ứng dụng iOS của bạn
- Mở thư mục dự án trong công cụ tìm kiếm - finder
- Sao chép thư mục
- Mở dự án được sao chép trong XCode
- Trong lớp
AppDelegate
, bên trong phương phápdidFinishLaunchingWithOptions
, thiết lập một ID ứng dụng mới:Objective C
Swift
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ố. Id bắt đầu với năm số 1. Các con số còn lại phải là ngẫu nhiên. Xem ví dụ về ID dưới đây.
Thêm Ứng dụng Thử nghiệm iOS vào Bảng điều khiển AppsFlyer của bạn
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 ID ứng dụng giống với ID ứng dụng của ứng dụng thử nghiệm mới được tạo ra. 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.
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ỉ định 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 Sự kiện 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
- Cho phép 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).
- 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 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 ứng dụng và nhấp vào Nhắm mục tiêu lại trong menu bên phía tay trái
- Bạn có thể thấy cài đặt phân bổ lại được phân bổ cho nguồn phương tiện Thử nghiệm trong 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
- Sử 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 vào tham số lược đồ mà bạn đã cấu hình ở bước 1
- Đ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 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 để Gỡ lỗi 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ớpAFApplication
. - Đả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
trongapplicationDidBecomeActive
:
- (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
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
- liên kết phân bổ bạn đang sử dụng là không chính xác. Tham khảo hướng dẫn của chúng tôi về các liên kết 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
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.
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
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 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!
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 đượ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:
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.