Tiện ích mở rộng Adobe Launch SDK

Sơ lược: Gửi dữ liệu đến Adobe Launch SDK và AppsFlyer SDK chỉ bằng một lần triển khai Tiện ích mở rộng AppsFlyer Adobe Launch SDK.

Tổng quan

Adobe Launch SDK là một phần không thể thiếu của Nền tảng Adobe Experience. Nền tảng Adobe Experience giúp các doanh nghiệp thu thập, hợp nhất và phân tích dữ liệu từ nhiều ứng dụng và nền tảng. Nền tảng này giúp chủ doanh nghiệp và nhà phát triển hiểu rõ hơn về hành vi của khách hàng để tối ưu hóa trải nghiệm và phân phối nội dung. Nếu ứng dụng của bạn triển khai cả Adobe Launch SDK và AppsFlyer SDK, bạn có thể gửi dữ liệu đến cả hai chỉ bằng một lần triển khai Tiện ích mở rộng AppsFlyer Adobe Launch SDK. Điều này giúp bạn đơn giản hóa tổng thể quá trình phát triển cũng như giúp cơ sở trở nên gọn gàng và có thể duy trì.

 Lưu ý

Nếu bạn đang sử dụng tiện ích mở rộng Adobe Launch thì không cần tích hợp Adobe Analytics tiêu chuẩn.

Điều kiện tiên quyết

Một vài điểm cần thực hiện trước khi tích hợp Tiện ích mở rộng AppsFlyer Adobe SDK.

Nhận dev key AppsFlyer của bạn

dev_key.png

  1. Trong bảng điều khiển ứng dụng của bạn, nhấp vào App Settings trong phần Configuration ở menu bên trái.
  2. Trong phần SDK Installation, hãy sao chép Dev Key.

Lấy ID ứng dụng của bạn

  • Đối với Android - ID ứng dụng là tên gói, ví dụ như example.com.app.
  • Đối với iOS - ID ứng dụng là ID iTunes của ứng dụng không có tiền tố id ví dụ: 123456748.

Bước 1: Định cấu hình Adobe Launch

Làm theo hướng dẫn dưới đây để định cấu hình Adobe Launch.

1.1 Tạo thuộc tính mới trong Adobe Launch

  1. Đăng nhập vào Adobe Experience Cloud.
  2. Chọn Launch.
  3. Nhấp vào Go to Launch.
  4. Nhấp vào New Property.
  5. Đặt tên cho thuộc tính rồi chọn Mobile.
  6. Nhấp vào Save.

1.2 Cài đặt các tiện ích mở rộng Adobe Launch cần thiết

Cài đặt các tiện ích mở rộng sau vào Adobe Launch:

adboe_extensions.png

  • Adobe Analytics - kết nối dữ liệu ghi được từ SDK với mô-đun Adobe Analytics.
  • Tiện ích mở rộng AppsFlyer SDK - gửi dữ liệu và sự kiện đến cả Adobe và AppsFlyer bằng Adobe Launch SDK.
  • Adobe Profile - cho phép SDK lưu trữ dữ liệu vào hồ sơ phía máy khách.
  • Adobe Mobile Core - cho phép cấu hình SDK của thiết bị di động và cung cấp quyền truy cập vào các sự kiện và điều kiện vòng đời mặc định.

Cài đặt tiện ích mở rộng Adobe Analytics

  1. Đăng nhập vào Adobe Analytics.
  2. Tạo bộ báo cáo.
  3. Đăng nhập lại vào Adobe Launch.
  4. Từ danh sách thuộc tính, hãy nhấp vào thuộc tính mà bạn đã tạo trước đó.
  5. Nhấp vào Extensions.
  6. Tìm kiếm và cài đặt Adobe Analytics.
  7. Trong Report Suites, chỉ định bộ báo cáo mà bạn đã tạo ở bước 2.
  8. Nhấp vào Save.

Cài đặt Tiện ích mở rộng AppsFlyer SDK

  1. Chọn Extensions lại lần nữa.
  2. Tìm kiếm và cài đặt AppsFlyer SDK Extension.
  3. Trong AppsFlyer iOS App ID, hãy chỉ định ID ứng dụng iOS mà bạn nhận được trong bước điều kiện tiên quyết.
  4. Trong AppsFlyer Dev Key, hãy chỉ định dev key mà bạn nhận được trong bước điều kiện tiên quyết.
  5. Bật tùy chọn Send attribution data to Adobe Analytics. Lưu ý rằng có một số hạn chế về việc chia sẻ dữ liệu cấp người dùng với các nền tảng phân tích của bên thứ 3.
  6. Nhấp vào Save.

Cài đặt tiện ích mở rộng Profile và Mobile Core

  1. Chọn Extensions lại lần nữa.
  2. Tìm kiếm và cài đặt Profile.
  3. Tìm kiếm và cài đặt Mobile Core.
    • Khi cài đặt Mobile Core, chỉ cần lưu nguyên trạng tiện ích mở rộng. Không cần chỉ định Máy chủ Experience Cloud.

Bước 2: Triển khai Tiện ích mở rộng AppsFlyer Adobe SDK

Làm theo hướng dẫn trong phần này để triển khai Tiện ích mở rộng Adobe SDK vào ứng dụng của bạn.

2.1 Thêm SDK vào ứng dụng

adobe_sdk.png

  1. Bên trong thuộc tính Adobe của bạn, hãy chọn Environments.
  2. Chọn môi trường mà bạn muốn triển khai SDK.
  3. Ở phía bên phải, nhấp vào biểu tượng hộp.
  4. Sao chép đoạn mã từ cửa sổ mở ra và làm theo hướng dẫn. Nếu bạn là nhà tiếp thị đang định cấu hình Adobe, hãy gửi các đoạn mã này cho nhà phát triển ứng dụng của bạn.

2.2 Phát hành môi trường

Để hoàn tất việc triển khai SDK, bạn cần phát hành môi trường lên thư viện.

adobe_publishing.png

  1. Bên trong thuộc tính Adobe, hãy chọn Publishing.
  2. Nhấp vào Add New Library.
  3. Đặt tên cho thư viện và trong mục Environment, hãy chọn Development.
  4. Nhấp vào Save & Build for Development
  5. Sau khi bản dựng hoàn tất, trong mục Development, nhấp vào ba dấu chấm bên cạnh thư viện và chọn Submit for Approval.
  6. Trong mục Submitted, nhấp vào ba dấu chấm bên cạnh thư viện và chọn Build for Staging.
  7. Sau khi bản dựng hoàn tất, hãy nhấp vào ba dấu chấm bên cạnh thư viện và chọn Approve for Publishing.
  8. Trong mục Approve, nhấp vào ba dấu chấm bên cạnh thư viện và chọn Build & Publish to Production.

2.3 Thêm liên kết giới thiệu cài đặt Android vào ứng dụng của bạn

Liên kết giới thiệu cài đặt Android cải thiện độ chính xác phân bổ, bảo vệ khỏi gian lận cài đặt và hơn thế nữa. Liên kết này được hỗ trợ từ Android SDK của AppsFlyer phiên bản 4.8.6.

 Lưu ý

Google đã ngừng hỗ trợ BroadcastReceiver vào tháng 3 năm 2020. 

  • Thay đổi này không ảnh hưởng đến ứng dụng.
  • Bạn vẫn có thể cần BroadcastReceiver để thực hiện phân bổ ngoài cửa hàng. Để chắc chắn, hãy kiểm tra với cửa hàng nơi đăng ứng dụng đó. 
  • Việc triển khai liên kết thiệu cài đặt hiện là bắt buộc. 

Có hai cách để thêm liên kết giới thiệu cài đặt vào ứng dụng của bạn:

  • Sử dụng Gradle (được đề xuất)
  • Thêm thủ công liên kết giới thiệu cài đặt
Thêm liên kết giới thiệu cài đặt bằng Gradle Thêm thủ công liên kết giới thiệu cài đặt

 Thêm Liên kết giới thiệu cài đặt Android làm phần phụ thuộc. Bạn có thể tìm thấy phiên bản mới nhất tại đây.

  1. dependencies {
    //make sure to use the latest SDK version: https://mvnrepository.com/artifact/com.appsflyer/af-android-sdk
    	implementation 'com.appsflyer:af-android-sdk:5.+'
    	implementation 'com.android.installreferrer:installreferrer:1.1'
    }
  2. Đồng bộ hóa dự án để truy xuất các phần phụ thuộc - xem ảnh chụp màn hình sau:

    android_af_sdk_sync_gradle.png

Nếu bạn đang sử dụng ProGuard và muốn sử dụng API liên kết giới thiệu mới của Google, hãy đặt quy tắc ProGuard sau: -dontwarn com.android.installreferrer

2.4 Thiết lập các quyền bắt buộc

Thêm quyền truy cập giúp tăng tỷ lệ Phân bổ mô hình xác suất. Nó cũng cho phép SDK gửi thêm dữ liệu như Wifi và dữ liệu mạng của nhà mạng. Bạn có thể tìm thấy dữ liệu này trong báo cáo dữ liệu thô và sử dụng nó để phân tích và tối ưu hóa các chiến dịch.

Thêm Quyền truy cập Bắt buộc

  1. Thêm các quyền truy cập sau vào AndroidManifest.xml:
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <!-- Optional : -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    

Sử dụng tiện ích mở rộng Adobe SDK

Đến đây, bạn có thể bắt đầu sử dụng tiện ích mở rộng Adobe SDK để gửi dữ liệu đến Adobe và AppsFlyer.

 Lưu ý

Hiện tại, tiện ích mở rộng Adobe Launch SDK chỉ hỗ trợ nhận dữ liệu chuyển đổi và gửi sự kiện. Tuy nhiên, khi bạn thêm tiện ích mở rộng Adobe Launch SDK vào ứng dụng của mình, AppsFlyer SDK cũng sẽ được thêm vào. Do đó, bất kỳ chức năng nào hiện đang bị thiếu trong tiện ích mở rộng Adobe SDK đều có thể được triển khai bằng AppsFlyer SDK.

Gửi sự kiện

Các sự kiện trong ứng dụng cung cấp thông tin chi tiết về những gì đang xảy ra trong ứng dụng của bạn. Bạn nên dành thời gian và xác định các sự kiện bạn muốn ghi nhận. Việc ghi nhận sự kiện trong ứng dụng cho phép bạn đo lường các KPI như ROI (Lợi tức Đầu tư) và LTV (Giá trị Vòng đời).

Tiện ích mở rộng Adobe Launch SDK cho phép bạn gửi dữ liệu sự kiện trong ứng dụng đến cả Adobe và AppsFlyer. Sau đó, bạn có thể sử dụng Adobe Analytics để phân tích hành vi của người dùng và AppsFlyer để phân tích ROI và LTV.

Android iOS
final Map<String,String> eventMap = new HashMap<>();  
eventMap.put("currency", "USD");  
eventMap.put("revenue", "200");  
eventMap.put("freehand", "param");

MobileCore.trackAction("af_purchase", eventMap);

Gửi các sự kiện như được chỉ định trong mã ở trên sẽ tạo ra một sự kiện trong bảng điều khiển AppsFlyer tên là af_purchase với doanh thu 200 USD. Sự kiện này cũng được gửi đến và xuất hiện trong Adobe Analytics.

Tất cả dữ liệu chuyển đổi được gửi cùng với các sự kiện đều có tiền tố là appsflyer. Xem các ví dụ trong bảng sau:

Biến dữ liệu chuyển đổi có tiền tố
appsflyer.af_click_lookback
appsflyer.install_time
appsflyer.cost_cents_USD
appsflyer.media_source
appsflyer.af_adset
appsflyer.click_time
appsflyer.orig_cost
appsflyer.campaign

Dữ liệu chuyển đổi được sử dụng trong ứng dụng mà bạn tạo trong Dịch vụ Adobe Mobile. Có thể có các tham số khác xuất hiện trong dữ liệu chuyển đổi. Để tìm hiểu thêm, hãy nhấp vào đây.

Lấy dữ liệu cho liên kết sâu và liên kết sâu gián tiếp

Liên kết sâu và liên kết sâu gián tiếp cho phép bạn cải thiện trải nghiệm người dùng của mình. Chúng cho phép bạn mở ứng dụng trong các hoạt động cụ thể và tùy chỉnh nội dung theo dữ liệu chiến dịch.

Để lấy dữ liệu từ liên kết sâu, hãy triển khai lệnh gọi lại tiện ích mở rộng.

Android iOS

Trong lớp ứng dụng toàn cục, hãy triển khai mã sau:

AppsFlyerAdobeExtension.registerAppsFlyerExtensionCallbacks(new AppsFlyerExtensionCallbacksListener() {
		@Override
		public void onCallbackReceived(Map<String, String> callback) {
			Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
			if(callback.get("callback_type").equals("onConversionDataReceived")){
				// conversion data returned 
				if(callback.get("is_first_launch").equals("true")){
					String af_status = callback.get("af_status");
					if(af_status.equals("Non-organic")){
						Log.d(AppsFlyerLibCore.LOG_TAG, "this is first launch and a non organic install!");
					}
				}
			} else if(callback.get("callback_type").equals("onAppOpenAttribution")){
				// direct deeplink - redirect user
				Log.d(AppsFlyerLibCore.LOG_TAG, callback.toString());
			}
		}
		@Override
		public void onCallbackError(String errorMessage) {
			Log.d("TAG", errorMessage);
		}
	});

Kết nối dữ liệu chuyển đổi AppsFlyer

Dữ liệu chuyển đổi được gửi cùng với các sự kiện đến nền tảng Adobe. Các biến này cho phép bạn áp dụng logic và quy tắc đối với các phương diện, chỉ số hoặc bộ lọc báo cáo.

adobe_analytics.png

  1. Đăng nhập vào Dịch vụ Adobe Mobile.
  2. Chọn ứng dụng có liên quan và vào trang Manage Variables & Metrics.
  3. Chọn tab Custom Variables và định cấu hình các biến để ánh xạ dữ liệu AppsFlyer SDK tới hệ thống Adobe.
  4. Đối với mỗi biến tùy chỉnh, hãy nhập một tên có nghĩa.
  5. Chọn hoặc nhập dữ liệu chuyển đổi AppsFlyer đã ánh xạ và chọn phạm vi Độ toàn vẹn mong muốn.

Xem bảng sau để ánh xạ các biến ngữ cảnh AppsFlyer:

Tên được đề xuất để ánh xạ

Dữ liệu chuyển đổi

Khung thời gian Xem lại AppsFlyer

appsflyer.af_click_lookback

Thời gian Cài đặt AppsFlyer

appsflyer.install_time

Chi phí AppsFlyer tính bằng Cent Mỹ

appsflyer.cost_cents_USD

AppsFlyer MediaSource

appsflyer.media_source

Bộ quảng cáo AppsFlyer

appsflyer.af_adset

Thời gian Nhấp chuột của AppsFlyer

appsflyer.click_time

Chi phí Ban đầu của AppsFlyer

appsflyer.orig_cost

Chiến dịch AppsFlyer

appsflyer.campaign

Sử dụng dữ liệu chuyển đổi được AppsFlyer ánh xạ cho Giải tích và Phân tích

Tất cả dữ liệu đến từ SDK đều có sẵn trong bộ báo cáo Adobe Analytics được kết nối với ứng dụng.

Bạn có thể sử dụng dữ liệu cũng như các phương diện và chỉ số liên quan trên các báo cáo và bảng điều khiển của Adobe Analytics đã tạo của mình. Dữ liệu này cũng có sẵn trong bảng điều khiển AppsFlyer dùng để phân bổ và phân tích sự kiện trong ứng dụng.