Bắt đầu sử dụng Sự kiện trong ứng dụng trên iOS

Hướng dẫn này sẽ chỉ cho bạn cách thêm Sự kiện trong ứng dụng vào ứng dụng mới hoặc ứng dụng hiện có của mình bằng cách tích hợp Facebook SDK rồi ghi lại những sự kiện này.

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

Bạn sẽ cần:

• Một Tài khoản nhà phát triển trên Facebook
• Một Tài khoản quảng cáo trên Facebook
• Một Hồ sơ doanh nghiệp trên Facebook (tạo một hồ sơ doanh nghiệp mới nếu bạn chưa có)
• Một ứng dụng trên Facebook

Bước 1: Đặt cấu hình ứng dụng trên Facebook

Chuyển đến Bảng điều khiển ứng dụng, nhấp vào Ứng dụng của bạn rồi tạo ứng dụng mới (nếu bạn chưa có ứng dụng). Chuyển đến phần Cài đặt > Cơ bản để xem Bảng điều khiển Chi tiết ứng dụng cùng với ID ứng dụng, Khóa bí mật của ứng dụng và những chi tiết khác về ứng dụng của bạn.

Cuộn xuống cuối trang rồi nhấp vào Thêm nền tảng. Chọn iOS, thêm chi tiết ứng dụng và lưu các thay đổi.

Thiết lập ứng dụng để quảng cáo bằng cách thêm những chi tiết sau:

• Miền ứng dụng - Cung cấp URL Apple App Store của ứng dụng.
• URL Chính sách quyền riêng tư - Cung cấp URL Chính sách quyền riêng tư. Bạn phải cung cấp URL này để ứng dụng có thể hiển thị công khai.
• URL Điều khoản dịch vụ - Cung cấp URL Điều khoản dịch vụ.
• Nền tảng - Cuộn xuống cuối bảng điều khiển Cài đặt để thêm Nền tảng iOS.

Để tìm hiểu thêm về cách thêm chi tiết cho ứng dụng của bạn như biểu tượng hoặc hạng mục, hãy xem tài liệu về Phát triển ứng dụng.

Bước 2: Liên kết quảng cáo và hồ sơ doanh nghiệp

Để chạy quảng cáo và đo lường lượt cài đặt trong Trình quản lý quảng cáo, hãy liên kết tối thiểu một tài khoản quảng cáo và hồ sơ doanh nghiệp với Ứng dụng của bạn.

1. Trong Bảng điều khiển ứng dụng, hãy nhấp vào Cài đặt > Nâng cao.
2. Trong trường ID tài khoản quảng cáo được ủy quyền, hãy thêm ID tài khoản quảng cáo của bạn. Bạn có thể lấy ID tài khoản quảng cáo này trong Trình quản lý quảng cáo.
3. Trong Bảng điều khiển Tài khoản quảng cáo, hãy nhấp vào Bắt đầu và làm theo hướng dẫn để kết nối ứng dụng với một Doanh nghiệp.

Bước 3: Thiết lập môi trường phát triển

Quy trình sau đây sử dụng Trình quản lý gói Swift để thiết lập môi trường phát triển của bạn bằng Xcode.

1. Trong Xcode, hãy nhấp vào File > Thêm gói....
2. Trong trường tìm kiếm xuất hiện, hãy nhập URL kho lưu trữ: https://github.com/facebook/facebook-ios-sdk.
3. Trong Quy tắc phần phụ thuộc, hãy chọn Tùy thuộc vào phiên bản chính tiếp theo và nhập một phiên bản gần đây. Các bản phát hành gần đây nhất được liệt kê tại https://github.com/facebook/facebook-ios-sdk/releases/
4. Chọn thư viện bạn định sử dụng và các đích mà bạn muốn thêm những thư viện đó.
5. Nhấp vào Thêm gói để hoàn tất quá trình thiết lập.

Bước 4: Đăng ký và đặt cấu hình ứng dụng của bạn với Facebook

Thêm thông tin nhận dạng gói và bật tính năng Đăng nhập một lần cho ứng dụng của bạn.

Bước 5: Đặt cấu hình dự án

Bước 6: Kết nối đối tượng ủy quyền của ứng dụng và đối tượng ủy quyền của cảnh

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

Bước 7: Thêm sự kiện trong ứng dụng

Bạn có thể theo dõi sự kiện trong ứng dụng của mình theo 3 cách sau:

• Sự kiện ghi tự động - Facebook SDK sẽ tự động ghi lại lượt cài đặt ứng dụng, lượt khởi chạy và lượt mua hàng trong ứng dụng.
• Công cụ Sự kiện trong ứng dụng không có mã - Dùng công cụ này để thêm Sự kiện tiêu chuẩn mà không cần thêm mã vào ứng dụng của bạn.
• Sự kiện ghi thủ công - Thêm mã vào ứng dụng của bạn để theo dõi Sự kiện tiêu chuẩn và Sự kiện tùy chỉnh.

Sự kiện ghi tự động

Được thiết bị chấp thuận

Kể từ phiên bản iOS 14.5, bạn cần đặt isAdvertiserTrackingEnabled và ghi lại mỗi khi bạn cho phép thiết bị chia sẻ dữ liệu với Facebook.

Nếu thiết bị cho phép, hãy đặt Settings.shared.isAdvertiserTrackingEnabled = true.

Nếu thiết bị không cho phép theo dõi, hãy đặt Settings.shared.isAdvertiserTrackingEnabled = false.

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

Sự kiện ghi thủ công

Để ghi một sự kiện tùy chỉnh, bạn chỉ cần chuyển tên của sự kiện đó dưới dạng AppEvents.Name:

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

Thông số sự kiện

Facebook đã tạo một tập hợp thông số sự kiện hữu ích để đưa vào sự kiện tiêu chuẩn hoặc sự kiện tùy chỉnh của riêng bạn. Bạn cũng có thể cung cấp thông số của riêng mình.

Những thông số xác định trước này nhằm cung cấp hướng dẫn về các mẫu ghi phổ biến và có thể có mẫu dễ đọc hơn trong báo cáo cũng như giao diện người dùng khác. Hãy ghi lại nhóm thông số mà bạn muốn xem chi tiết. Mô tả được đề xuất cho những thông số này chỉ nhằm mục đích hướng dẫn - bạn có thể sử dụng những thông số này cho bất kỳ nội dung nào phù hợp với ứng dụng của mình.

Các thông số được chuyển qua từ điển, trong đó khóa chứa tên thông số dưới dạng AppEvents.ParameterName và giá trị phải là String hoặc số (Int, Double, v.v.).

Bước 8: Thử nghiệm sự kiện

Với Trình trợ giúp quảng cáo ứng dụng, bạn có thể thử nghiệm sự kiện trong ứng dụng thuộc ứng dụng của mình để đảm bảo rằng ứng dụng đó đang gửi sự kiện đến Facebook.

1. Mở Trình trợ giúp quảng cáo ứng dụng.
2. Trong mục Chọn ứng dụng, hãy chọn ứng dụng của bạn rồi chọn Gửi.
3. Cuộn xuống cuối rồi chọn Sự kiện thử nghiệm.
4. Khởi động ứng dụng của bạn và gửi sự kiện. Sự kiện này sẽ hiển thị trên trang.

Tìm hiểu thêm

• Hướng dẫn về cách làm tốt nhất - Xem nhiều ứng dụng mẫu khác nhau và cách mỗi ứng dụng xử lý Sự kiện trong ứng dụng.
• Câu hỏi thường gặp - Xem các Câu hỏi thường gặp của chúng tôi.
• Khóa học Meta Blueprint: Đặt cấu hình SDK và Sự kiện trong ứng dụng dành cho iOS
• Khóa học Meta Blueprint: Sử dụng Sự kiện trong ứng dụng để nhắm mục tiêu, tối ưu hóa và đo lường

Ứng dụng mẫu

Chúng tôi đã tạo một số ví dụ về các loại ứng dụng khác nhau để bạn có thể sử dụng sự kiện trong ứng dụng một cách dễ dàng hơn. Mỗi ứng dụng mẫu cung cấp số liệu chia nhỏ theo từng màn hình về các sự kiện và thông số khác nhau có thể thu thập được. Cuối mỗi phần là một bảng liệt kê các sự kiện và thông số được đề xuất cho từng ứng dụng. Nếu cần, bạn có thể tạo các sự kiện và thông số của riêng mình.