Sự kiện trong ứng dụng không cần mã

Với Sự kiện trong ứng dụng không cần mã được giới thiệu trong v4.34, bạn có thể sử dụng Trình quản lý sự kiện để thêm hoặc gỡ các sự kiện trong ứng dụng mà không cần triển khai mã hay phát hành phiên bản mới của ứng dụng.

Android

Yêu cầu

Bạn phải có một trong những phiên bản sau:

• Facebook SDK dành cho Android - Phiên bản đầy đủ v4.34 trở lên
• Facebook SDK dành cho Android - Phiên bản Core v4.38 trở lên
• Facebook SDK dành cho Android - Phiên bản Core v4.34-v4.37 và Bộ công cụ marketing

Vui lòng xem Hướng dẫn về cách bắt đầu sử dụng Sự kiện trong ứng dụng dành cho Android để cài đặt phiên bản mới nhất của Facebook SDK dành cho Android, Hướng dẫn nâng cấp để nâng cấp lên phiên bản SDK mới nhất. Ngoài ra, nếu bạn đã cài đặt v4.34-4.37, hãy thêm Bộ công cụ marketing bằng cách mở <your_app> | Gradle Scripts | build.gradle (Module: app) và thêm dòng sau vào phần dependencies{}.

implementation 'com.facebook.android:facebook-marketing:[4,5)' 

Đừng quên tạo lại dự án của bạn.

Triển khai tính năng Sự kiện trong ứng dụng không cần mã

Để bật sự kiện gỡ lỗi Không cần mã, hãy thêm các dòng sau vào AndroidManifest.xml:

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

Thêm sự kiện trong ứng dụng

Chuyển đến Trình quản lý sự kiện để thêm các sự kiện trong ứng dụng bạn muốn theo dõi mà không cần mã.

1. Trong Trình quản lý sự kiện, hãy nhấp vào Thêm nguồn dữ liệu mới và chọn Sự kiện trong ứng dụng trong menu thả xuống.
2. Nhấp vào Dùng công cụ thiết lập sự kiện không cần mã của chúng tôi rồi chọn ứng dụng bạn muốn thêm sự kiện.
3. Chọn nền tảng bằng cách nhấp vào Bắt đầu thiết lập.
4. Nếu đây là lần đầu tiên thực hiện quy trình không cần mã, bạn sẽ thấy một hướng dẫn nhỏ. Sau khi xem hết hướng dẫn, hãy mở một phiên mới của ứng dụng trên thiết bị di động.
5. Lắc điện thoại cho đến khi phiên bản ứng dụng xuất hiện.
6. Nhấp vào bất kỳ thành phần nào để thêm sự kiện trong ứng dụng. Chuyển đến những trang khác của ứng dụng để chọn các thành phần trên toàn ứng dụng.
7. Nhấp vào Lưu trong menu bật lên hoặc nhấp vào Hủy để không thêm sự kiện.
8. Sau khi bạn thêm tất cả sự kiện, hãy nhấp vào Xem lại và hoàn tất.
9. Nhấp vào Thử nghiệm sự kiện hoặc nhấp vào Lưu và thoát.

Lưu ý: Sự kiện có thể mất tới 30 phút mới xuất hiện trong Trình quản lý sự kiện.

Xác minh quá trình tích hợp

Chuyển đến Trình trợ giúp quảng cáo ứng dụng.

• Chọn ứng dụng rồi nhấp vào Gửi.
• Cuộn xuống phần Công cụ dành cho nhà phát triển và nhấp vào Thử nghiệm sự kiện trong ứng dụng.
• Nếu ứng dụng của bạn đang gửi các sự kiện fb_codeless_debug, những sự kiện thử nghiệm mà bạn đã chọn sẽ có tên trong bảng.

Lưu ý: Chỉ hoạt động với Facebook SDK v4.35 trở lên.

iOS

Yêu cầu

• Facebook iOS Full SDK v4.34 đến v7.1.1
• Facebook iOS Core SDK v4.38 đến v7.1.1
• Facebook iOS Core SDK v4.34-4.37 đến v7.1.1 và Bộ công cụ marketing

Các giới hạn

• Tính năng này không khả dụng cho v8.0.0 trở lên. Tìm hiểu thêm.

Vui lòng truy cập vào Hướng dẫn về cách bắt đầu sử dụng Sự kiện trong ứng dụng dành cho iOS để cài đặt phiên bản mới nhất của iOS SDK, Hướng dẫn nâng cấp để nâng cấp lên phiên bản SDK mới nhất. Ngoài ra, nếu bạn chỉ mới cài đặt Core SDK v4.34-4.37, hãy thêm Bộ công cụ marketing bằng cách thêm dòng sau vào Podfile.

pod 'FBSDKMarketingKit' 

Đừng quên chạy pod update, sau đó chạy pod install --repo-update.

Triển khai tính năng Sự kiện trong ứng dụng không cần mã

Bật tính năng ghi sự kiện gỡ lỗi Không cần mã bằng cách mở .plist của ứng dụng dưới dạng mã trong Xcode và thêm XML sau vào từ điển tài sản:

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

Thêm sự kiện trong ứng dụng

Chuyển đến Trình quản lý sự kiện để thêm các sự kiện trong ứng dụng bạn muốn theo dõi mà không cần mã.

1. Trong Trình quản lý sự kiện, hãy nhấp vào Thêm nguồn dữ liệu và chọn Sự kiện trong ứng dụng trong menu thả xuống.
2. Nhấp vào Dùng công cụ thiết lập sự kiện không cần mã của chúng tôi rồi chọn ứng dụng bạn muốn thêm sự kiện.
3. Chọn nền tảng bằng cách nhấp vào Bắt đầu thiết lập.
4. Nếu đây là lần đầu tiên thực hiện quy trình không cần mã, bạn sẽ thấy một hướng dẫn nhỏ. Sau khi xem hết hướng dẫn, hãy mở một phiên mới của ứng dụng trên thiết bị di động.
5. Lắc điện thoại cho đến khi phiên bản ứng dụng xuất hiện.
6. Nhấp vào bất kỳ thành phần nào để thêm sự kiện trong ứng dụng. Chuyển đến những trang khác của ứng dụng để chọn các thành phần trên toàn ứng dụng.
7. Nhấp vào Lưu trong menu bật lên hoặc nhấp vào Hủy để không thêm sự kiện.
8. Sau khi bạn thêm tất cả sự kiện, hãy nhấp vào Xem lại và hoàn tất.
9. Nhấp vào Thử nghiệm sự kiện hoặc nhấp vào Lưu và thoát.

Lưu ý: Sự kiện có thể mất tới 30 phút mới xuất hiện trong Trình quản lý sự kiện.

Xác minh quá trình tích hợp

Chuyển đến Trình trợ giúp quảng cáo ứng dụng.

• Chọn ứng dụng rồi nhấp vào Gửi.
• Chuyển xuống dưới cùng và chọn Người dùng thử sự kiện trong ứng dụng.
• Nếu ứng dụng của bạn đang gửi các sự kiện fb_codeless_debug, những sự kiện này sẽ có tên trong bảng.

Unity

Chúng tôi yêu cầu Facebook Unity SDK v4.34 trở lên.

Hãy xem bài viết Bắt đầu sử dụng Facebook Unity SDK để cài đặt phiên bản mới nhất của Facebook Unity SDK và làm theo phần cài đặt dành riêng cho nền tảng Unity iOS hoặc Unity Android.

Bật Sự kiện trong ứng dụng không cần mã

Để bật tùy chọn này, trong Unity Editor, hãy chọn Facebook | Edit Settings rồi chọn Auto Logging App Events:

Thêm Sự kiện trong ứng dụng

Lúc này, bạn có thể thêm Sự kiện trong ứng dụng bằng Trình quản lý sự kiện:

1. Trong Add Data Source, hãy chọn App Events.

2. Nhấp vào User our codeless event setup tool

3. Chọn ứng dụng mà bạn muốn thêm sự kiện.

4. Nhấp vào Start Setup để chọn nền tảng. Nếu đây là lần đầu tiên thực hiện quy trình không cần mã, bạn sẽ thấy một hướng dẫn nhỏ.

5. Sau khi xem hết hướng dẫn, hãy mở một phiên mới của ứng dụng trên thiết bị di động.

6. Lắc thiết bị di động cho đến khi một phiên bản ứng dụng xuất hiện.

7. Nhấp vào bất kỳ thành phần nào trong ứng dụng để thêm một sự kiện trong ứng dụng. Chuyển đến những trang khác của ứng dụng để chọn các thành phần trên toàn ứng dụng.

8. Trong Unity Editor, hãy nhấp vào Save để thêm sự kiện.

9. Sau khi bạn thêm tất cả sự kiện, hãy nhấp vào Review and Finish.

10. Nhấp vào Test Events hoặc Save and Exit.

Sự kiện có thể mất tới 30 phút mới xuất hiện trong Trình quản lý sự kiện. Lặp lại các bước trên cho từng nền tảng, chẳng hạn như iOS hoặc Android mà game của bạn hỗ trợ.

Xác minh quá trình tích hợp

Chuyển đến Trình trợ giúp quảng cáo ứng dụng.

• Trong Select an App, hãy nhấp vào Submit.

• Chọn App Events Tester.

• Nếu ứng dụng của bạn gửi các sự kiện fb_codeless_debug, những sự kiện này sẽ xuất hiện trong bảng.

Câu hỏi thường gặp

CHUNG

Android

Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.

<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>

<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

[!] Unable to find a specification for FBSDKMarketingKit