Thử nghiệm tích hợp SDK cho nhà tiếp thị

Bắt đầu từ iOS 14.5, IDFA chỉ khả dụng nếu người dùng đồng ý thông qua lời nhắc Minh bạch về Theo dõi Ứng dụng (ATT). Nếu lời nhắc ATT được triển khai trên ứng dụng, bạn có thể chạy thử nghiệm với tư cách là người dùng đồng ý hoặc không đồng ý.  Để biết thêm thông tin, hãy xem hướng dẫn đăng ký thiết bị thử nghiệm của bạn có IDFA hoặc IDFV.

Chúng tôi khuyến cáo bạn nên bắt đầu bằng cách thử nghiệm lượt cài đặt tự nhiên.

Để thử nghiệm lượt cài đặt tự nhiên:

1. Cài đặt ứng dụng trên thiết bị thử nghiệm đã đăng ký.
2. Khởi chạy ứng dụng.

Bảng điều khiển của ứng dụng sẽ hiển thị một lượt cài đặt tự nhiên mới. Chờ tối đa 30 phút để xuất hiện lượt cài đặt.

Sử dụng trang Thử nghiệm Tích hợp SDK để thử nghiệm lượt cài đặt không tự nhiên, sự kiện trong ứng dụng và liên kết sâu (nhắm mục tiêu lại), đồng thời xác định bất kỳ sự cố tích hợp nào trong dự án của bạn.

Chỉ dành cho iOS: Trang SDK integration test chỉ áp dụng cho các ứng dụng iOS triển khai ATT. Bạn có thể thử nghiệm các ứng dụng không triển khai ATT bằng quy trình được nêu cụ thể tại đây.

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

1. Chuẩn bị một thiết bị (Android hoặc iOS) 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ị.
2. Đăng ký thiết bị làm thiết bị thử nghiệm.

Bước 1: Thử nghiệm lượt cài đặt không tự nhiên

1. Trong bảng điều khiển, hãy chọn ứng dụng.
2. Đ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. 
   
3. Chạy thử nghiệm Lượt Cài đặt Không Tự nhiên.
4. Chọn một thiết bị thử nghiệm trong danh sách. 
5. Chọn cửa hàng để cài đặt ứng dụng:
   • Đối với Android: 
     • Google Play
     • Khác (ví dụ: Ngoài cửa hàng, Android Studio, tệp tin APK) 
   • Đối với iOS:
     • Cửa hàng Ứng dụng
     • Khác (ví dụ: XCode, TestFlight)
6. 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ị.

   Lưu ý rằng đối với thiết bị Android, thử nghiệm này sử dụng phương thức người giới thiệu cài đặt và do đó, đường dẫn phân bổ không bao gồm GAID.

7. Nếu bạn đã chọn Khác, hãy cài đặt ứng dụng từ môi trường phát triển của bạn.
8. Đợ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, thì lý do có thể là:
   • IDFA khả dụng nhưng thiết bị thử nghiệm không được đăng ký với mã định danh này trên trang Thiết bị thử nghiệm.
   • Ứng dụng của bạn có nhiều hơn 1, ngoài ứng dụng thử nghiệm, được cài đặt trên thiết bị thử nghiệm nhưng thiết bị thử nghiệm chưa được đăng ký với IDFV trên trang Thiết bị thử nghiệm. 
   • Lượt cài đặt tự nhiên đã không được ghi nhận.
   • Thử nghiệm được thực hiện trên phiên bản ứng dụng không có SDK.

Đối với lỗi tích hợp, hãy liên hệ với nhà phát triển của bạn.

Bước 2: Thử nghiệm các sự kiện trong ứng dụng

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

• Đảm bảo rằng bạn sử dụng cùng một thiết bị thử nghiệm đã được sử dụng để ghi nhận lượt cài đặt không tự nhiên.

1. Chạy thử nghiệm Sự kiện trong Ứng dụng.
2. Chọn một thiết bị thử nghiệm trong danh sách, sau đó nhấp vào Next (Tiếp theo). 
3. 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.
4. 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.

   

Bước 3: Thử nghiệm liên kết sâu (nhắm mục tiêu lại)

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

• Đảm bảo rằng bạn sử dụng cùng một thiết bị thử nghiệm đã được sử dụng để ghi nhận lượt cài đặt không tự nhiên. 
• Khởi chạy ứng dụng thử nghiệm ít nhất 3 lần.
• Để thử nghiệm liên kết sâu (nhắm mục tiêu lại), OneLink phải được xác định cho ứng dụng của bạn. Để biết thêm thông tin, hãy xem hướng dẫn Thiết lập OneLink. 
• Xác nhận rằng tính năng nhắm mục tiêu lại đã được bật.

1. Chạy thử nghiệm Liên kết sâu.
2. Chọn một thiết bị thử nghiệm trong danh sách.
3. Chọn một loại thử nghiệm:
   • OneLink: Chọn OneLink. 
   • Lược đồ URI: Nhập lược đồ URI (ví dụ: greatapps://cars).
4. Nhấp vào Next (Tiếp theo).
5. 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 thử nghiệm kết thúc thì Thử nghiệm Liên kết Sâu sẽ được đăng ký là thành công.

   

Thử nghiệm lượt cài đặt cho phép bạn xác minh rằng SDK AppsFlyer đang phân bổ các lượt cài đặt một cách chính xác cho các nguồn truyền thông khác nhau.

Để thử nghiệm phân bổ lượt cài đặt:

1. Sao chép liên kết sau (Android hoặc iOS) và thực hiện các thay đổi sau đây:
   1. Giá trị app_id: Thêm ID ứng dụng của bạn vào AppsFlyer. 
   2. Thông số pid: Chỉ định tên của nguồn truyền thông mà lượt cài đặt được phân bổ đến.
   3. Thông số c: Chỉ định tên của chiến dịch.
   4. 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ổ. 
   5. Thay thế GAID, IDFA hoặc IDFV bằng mã định danh thiết bị cụ thể của bạn.
   Android iOS

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

   IDFA

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

   IDFV

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

   Dưới đây là các ví dụ về đường dẫn phân bổ với các giá trị cụ thể:

   Android iOS

   
   https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*

   
   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

2. Sao chép liên kết đã cập nhật của bạn, gửi đến thiết bị thử nghiệm, sau đó nhấp vào liên kết.

    Lưu ý

   Trong iOS, sử dụng iMessage hoặc email để gửi liên kết đến thiết bị. Không dán liên kết vào ứng dụng Ghi chú iOS và nhấp vào liên kết. Thao tác này có thể khiến liên kết bị lỗi.

3. Thực hiện một trong những việc sau:
   • Nếu ứng dụng đang hoạt động, hãy tiếp tục cài đặt.
   • Nếu ứng dụng đang chờ xử lý, thì sẽ xuất hiện thông báo: "The app you are looking for is not available in the market yet" (Ứng dụng bạn đang tìm kiếm hiện chưa có sẵn trên thị trường). Đây là kết quả trong dự kiến. Vì ứng dụng không hoạt động nên đường dẫn phân bổ không điều hướng đến bất kỳ cửa hàng ứng dụng nào. Tuy nhiên, đường dẫn phân bổ vẫn hợp lệ cho các mục đích phân bổ và bạn nên cài đặt ứng dụng như sau:
     • Đối với Android: Từ tệp tin APK (hoặc Android Studio dành cho nhà phát triển)
     • Đối với iOS: Từ TestFlight (hoặc Xcode dành cho nhà phát triển)

   Bạn sẽ thấy một lượt cài đặt được phân bổ cho chiến dịch thử nghiệm trong nguồn truyền thông được gọi là Test (Thử nghiệm). Chờ tối đa 30 phút để lượt cài đặt xuất hiện trong bảng điều khiển của ứng dụng.

Việc thử nghiệm sự kiện trong ứng dụng cho phép bạn xác nhận rằng doanh thu liên quan đến sự kiện được hiển thị và sự kiện trong ứng dụng được phân bổ cho nguồn truyền thông tạo ra lượt cài đặt.

Để thử nghiệm phân bổ sự kiện trong ứng dụng:

1. Khởi chạy ứng dụng, sau đó tạo một vài sự kiện trong ứng dụng.
2. Mở bảng điều khiển của ứng dụng và nhấp vào Events (Sự kiện).

   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 truyền thông mà các sự kiện được liên kết đến. Chờ tối đa 60-70 phút để các sự kiện xuất hiện trong bảng điều khiển.

   

Mẹo! Nên cân nhắc tải xuống báo cáo dữ liệu thô về sự kiện trong ứng dụng để xác minh rằng các sự kiện được phân bổ chính xác. Thời gian tải xuống báo cáo này sẽ là vài phút.

Để tải xuống báo cáo:

1. Trong bảng điều khiển, chuyển đến Reports (Báo cáo) > Export Data (Xuất Dữ liệu).
2. Trong phần Raw Data Reports (Báo cáo Dữ liệu Thô), hãy tải xuống báo cáo dữ liệu thô của sự kiện trong ứng dụng.

OneLink cho phép bạn đặt một đường dẫn phân bổ duy nhất cho cả Android và iOS. 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 thích hợp.

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.

Nhắm mục tiêu lại cho phân bổ xảy ra khi người dùng tương tác với chiến dịch nhắm mục tiêu lại bằng cách nhấp vào đường dẫn phân bổ nhắm mục tiêu lại. Điều này dẫn đến sự kiện phân bổ lại hoặc thu hút lại. Để biết thêm thông tin, hãy xem phần Hướng dẫn nhắm mục tiêu lại cho phân bổ.

Thử nghiệm nhắm mục tiêu lại bao gồm những thao tác sau:

• Đối với phân bổ lại: Gỡ cài đặt và cài đặt lại ứng dụng. Sau đó, xác minh trong bảng điều khiển rằng một lượt cài đặt đã được ghi nhận.
• Đối với thu hút lại: Nhấp vào đường dẫn phân bổ nhắm mục tiêu lại hoặc liên kết sâu, sau đó xác minh rằng lượt thu hút lại được phân bổ cho đúng nguồn truyền thông.

Trước khi chạy thử nghiệm nhắm mục tiêu lại, cần thiết lập như sau:

• Tính năng nhắm mục tiêu lại phải được kích hoạt cho ứng dụng bạn đang thử nghiệm.
• Tạo liên kết dành riêng cho ứng dụng hoặc truy xuất liên kết tùy chỉnh OneLink. Các liên kết này phải bao gồm thông số nhắm mục tiêu lại.

Để thiết lập thử nghiệm nhắm mục tiêu lại:

1. 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 của ứng dụng, nhấp vào App Settings (Cài đặt của Ứng dụng) và bật tùy chọn Enable retargeting attribution (Bật nhắm mục tiêu lại cho phân bổ).

   

2. Thực hiện một trong các thao tác sau: 
   • Tạo đường dẫn phân bổ dành riêng cho ứng dụng. Đảm bảo phải bao gồm thông số nhắm mục tiêu lại, is_retargeting=true và ID quảng cáo. Để xem GAID, IDFA hoặc IDFV, hãy làm theo hướng dẫn  Đăng ký thiết bị thử nghiệm.  
     Dưới đây là ví dụ về đường dẫn phân bổ bao gồm thông số dành riêng cho Android làm mã định danh thiết bị (GAID). Để biết thêm thông tin về cách thêm các thông số mã định danh thiết bị khác, chẳng hạn như IDFA hoặc IDFV, hãy xem phần Cấu trúc và thông số đường dẫn phân bổ. 

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

   • Truy xuất URL đầy đủ của liên kết tùy chỉnh từ mẫu OneLink. Đảm bảo kích hoạt Chiến dịch nhắm mục tiêu lại. Hình ảnh sau đây minh họa một ví dụ về URL đầy đủ tùy chỉnh:

     

Giờ đây, bạn có thể thử nghiệm phân bổ lại và thu hút lại.

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

• Thực hiện theo các hướng dẫn để thiết lập thử nghiệm nhắm mục tiêu lại.
• Đảm bảo rằng thiết bị thử nghiệm của bạn chưa được đăng ký.

Để thử nghiệm phân bổ lại:

1. Gỡ cài đặt ứng dụng khỏi thiết bị. Nếu bạn vừa cài đặt ứng dụng, hãy đợi trong vài phút.
2. Sao chép đường dẫn phân bổ bạn đã tạo trước đây, đường dẫn phân bổ dành riêng cho ứng dụng hoặc đường dẫn đầy đủ tùy chỉnh từ mẫu OneLink, gửi đường dẫn đó đến thiết bị thử nghiệm, sau đó nhấp vào đường dẫn.

    Lưu ý

   Trong iOS, sử dụng iMessage hoặc email để gửi liên kết đến thiết bị. Không dán liên kết vào ứng dụng Ghi chú iOS và nhấp vào liên kết. Thao tác này có thể khiến liên kết bị lỗi.

3. Thực hiện một trong những việc sau:
   • Nếu ứng dụng đang hoạt động, hãy tiếp tục cài đặt.
   • Nếu ứng dụng đang chờ xử lý, hãy cài đặt ứng dụng đó như sau:
     • Đối với Android: Cài đặt từ Android Studio hoặc tệp tin APK.
     • Đối với iOS: Cài đặt từ TestFlight.
4. Mở bảng điều khiển của ứng dụng và trong khung View type, hãy chọn Retargeting.
5. Trong khung Attribution type, hãy chọn Re-attributions.

   Bạn sẽ thấy lượt cài đặt được phân bổ cho nguồn truyền thông và chiến dịch. Cho phép tối đa 30 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.

   

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

• Thực hiện theo các hướng dẫn để thiết lập thử nghiệm nhắm mục tiêu lại. 
• Vì mục đích thử nghiệm, hãy đặt thời gian tối thiểu giữa các lần chuyển đổi thành None (Không). Điều này cho phép tất cả các lượt chuyển đổi thu hút lại được ghi nhận và phân bổ trong quá trình thử nghiệm.

  

• Đả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 bạn vừa cài đặt ứng dụng, hãy đợi trong vài phút.

Để thử nghiệm mức độ thu hút lại (liên kết sâu trực tiếp):

Đảm bảo rằng ứng dụng của bạn được cấu hình để liên kết sâu, sau đó làm theo quy trình này để thử nghiệm.

Để thử nghiệm thu hút lại (liên kết sâu gián tiếp):

1. Sao chép đường dẫn phân bổ bạn đã tạo trước đây, đường dẫn phân bổ dành riêng cho ứng dụng hoặc đường dẫn đầy đủ tùy chỉnh từ mẫu OneLink.
2. Gửi đường dẫn này đến thiết bị thử nghiệm của bạn, sau đó nhấp vào đường dẫn.
3. Để mở ứng dụng, hãy thực hiện một trong các thao tác sau:
   • Trong cửa hàng ứng dụng, nhấp vào Open (Mở).
   • Khởi chạy ứng dụng từ thiết bị của bạn.

   Trong bảng điều khiển, bạn sẽ thấy mức độ thu hút lại được phân bổ cho nguồn truyền thông và chiến dịch. Chờ tối đa 30 phút để hành động thu hút lại xuất hiện.

   

Mẹo! Nên cân nhắc tải xuống báo cáo dữ liệu thô về lượt chuyển đổi để xác minh rằng lượt thu hút lại được phân bổ cho đúng nguồn truyền thông. Thời gian tải xuống báo cáo này sẽ là vài phút.

Để tải xuống báo cáo:

1. Trong bảng điều khiển, chuyển đến Reports (Báo cáo) > Export Data (Xuất Dữ liệu).
2. Trong phần Retargeting (Nhắm mục tiêu lại), hãy tải xuống báo cáo Lượt chuyển đổi (thu hút lại và phân bổ lại).