Bắt đầu sử dụng Sự kiện trong ứng dụng (Android)

Vô hiệu hóa sự kiện được ghi tự động

Để vô hiệu hóa sự kiện ghi tự động, bạn cần thêm nội dung sau vào file AndroidManifest.xml:

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
           android:value="false"/>
  ...
</application>

Trong một số trường hợp, bạn nên trì hoãn việc thu thập sự kiện ghi tự động – chẳng hạn như để nhận được sự đồng ý của người dùng hoặc thực hiện các nghĩa vụ pháp lý – thay vì vô hiệu hóa sự kiện này. Trong trường hợp này, hãy gọi phương thức setAutoLogAppEventsEnabled() thuộc lớp FacebookSDK và đặt là true để bật lại tính năng ghi sự kiện sau khi người dùng cuối đồng ý.

setAutoLogAppEventsEnabled(true);

Nếu bạn lại muốn tạm ngừng ghi sự kiện vì bất cứ lý do nào, hãy đặt phương thức setAutoLogAppEventsEnabled() là false.

setAutoLogAppEventsEnabled(false);

Bạn cũng có thể vô hiệu hóa tính năng tự động ghi sự kiện Mua hàng trong ứng dụng thông qua bảng điều khiển ứng dụng. Hãy chuyển đến thẻ Android trong phần Cơ bản > Cài đặt rồi chuyển nút thành Không.

Vô hiệu hóa tính năng tự động khởi tạo SDK

Để vô hiệu hóa tính năng tự động khởi tạo SDK, bạn cần thêm nội dung sau vào file AndroidManifest.xml:

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoInitEnabled"
           android:value="false"/>
  ...
</application>

Trong một số trường hợp, bạn nên trì hoãn việc khởi tạo SDK – chẳng hạn như để nhận được sự đồng ý của người dùng hoặc thực hiện các nghĩa vụ pháp lý – thay vì vô hiệu hóa tính năng này. Trong trường hợp này, hãy gọi phương thức lớp setAutoInitEnabled rồi đặt phương thức này là true để khởi tạo SDK theo cách thủ công sau khi người dùng cuối đồng ý.

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

Vô hiệu hóa tính năng thu thập ID nhà quảng cáo

Để vô hiệu hóa tính năng thu thập advertiser-id, bạn cần thêm nội dung sau vào file AndroidManifest.xml:

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AdvertiserIDCollectionEnabled"
           android:value="false"/>
  ...
</application>

Trong một số trường hợp, bạn nên trì hoãn việc thu thập advertiser_id - chẳng hạn như để nhận được sự đồng ý của Người dùng hoặc thực hiện các nghĩa vụ pháp lý - thay vì vô hiệu hóa tính năng này. Trong trường hợp này, hãy gọi phương thức setAdvertiserIDCollectionEnabled() thuộc lớp FacebookSDK rồi đặt phương thức này là true để bật lại tính năng thu thập advertiser_id sau khi người dùng cuối đồng ý.

setAdvertiserIDCollectionEnabled(true);

Nếu bạn muốn tạm ngừng thu thập vì bất cứ lý do nào, hãy đặt phương thức setAdvertiserIDCollectionEnabled() là false.

setAdvertiserIDCollectionEnabled(false);

Ghi sự kiện theo cách thủ công

Hãy tạo đối tượng AppEventsLogger bằng các phương thức trình trợ giúp để ghi sự kiện của bạn, trong đó this là Activity mà phương thức của bạn đang sử dụng.

AppEventsLogger logger = AppEventsLogger.newLogger(this);

Sau đó, bạn có thể ghi sự kiện của mình vào logger, trong đó AppEventConstants.EVENT_NAME_X là một trong những hằng số có trong bảng Sự kiện tiêu chuẩn hoặc từ mã trong Trình tạo mã.

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

Bạn cũng có thể chỉ định một nhóm thông số trong thuộc tính Bundle và valueToSum, đây là một số tùy ý có thể biểu thị bất cứ giá trị nào (ví dụ: giá hoặc số lượng). Khi được báo cáo, tất cả thuộc tính valueToSum sẽ được cộng lại với nhau. Ví dụ: nếu 10 người mua một mặt hàng và mỗi mặt hàng có giá 10 USD (và đã chuyển vào valueToSum), họ sẽ được cộng lại với nhau để báo cáo là 100 USD.

Lưu ý rằng cả valueToSum và parameters đều không bắt buộc.

Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT, "[{\"id\": \"1234\", \"quantity\": 2}, {\"id\": \"5678\", \"quantity\": 1}]");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASE,
                54.23,
                params);
Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "HDFU-8452");

logger.logEvent(AppEventsConstants.EVENT_NAME_ADDED_TO_CART,
                54.23,
                params);