API Chuyển đổi cho Sự kiện trong ứng dụng

Với API Chuyển đổi, nhà quảng cáo có thể gửi cho Meta các sự kiện trên web, sự kiện trong ứng dụng, sự kiện ở cửa hàng thực và sự kiện nhắn tin kinh doanh thông qua một điểm cuối duy nhất thay vì qua nhiều nguồn. Việc hợp nhất này sẽ tinh giản nhóm công nghệ của nhà quảng cáo và tạo ra chế độ xem toàn diện hơn trong Trình quản lý sự kiện trên Meta dựa trên các tập dữ liệu.

Tài liệu này hướng dẫn tích hợp sự kiện trong ứng dụng với API Chuyển đổi.

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

1. Tập dữ liệu

Những sự kiện trong ứng dụng được gửi qua API Chuyển đổi phải được liên kết với một tập dữ liệu.

Bạn có thể thực hiện lệnh gọi GET đến https://graph.facebook.com/v16.0/{ads-pixel-id}/is_consolidated_container để phát hiện xem tập dữ liệu của nhà quảng cáo có được hợp nhất hay không và do đó có đủ điều kiện để chuyển các sự kiện trong ứng dụng qua API Chuyển đổi hay không.

2. Quyền

• Để tích hợp trực tiếp làm nhà quảng cáo, hãy làm theo hướng dẫn về quyền và điều kiện tiên quyết tại đây.

• Để tích hợp nền tảng đối tác, vui lòng làm theo hướng dẫn về quyền và điều kiện tiên quyết tại đây.

Cấu hình

Gửi sự kiện trong ứng dụng đến API Chuyển đổi

a. Liên kết ID tập dữ liệu và ID ứng dụng

Trong Trình quản lý sự kiện, bạn có thể liên kết ứng dụng của mình với một tập dữ liệu theo 2 cách sau đây:

• Chọn tab "Nguồn dữ liệu", tìm tab "Cài đặt" trên ứng dụng của bạn và tiến hành liên kết.
• Chọn tab "Nguồn dữ liệu", ở tab "Tổng quan" trên ứng dụng của bạn, hãy sử dụng nút "Liên kết đến tập dữ liệu" trong phần "Tất cả hoạt động".

Sau khi bạn liên kết xong, tập dữ liệu sẽ chứa ứng dụng đã kết nối.

b. Trường bắt buộc

Bạn có thể tham khảo tại đây để biết nhóm thông số hiện tại gửi được qua API Chuyển đổi. Để gửi sự kiện trong ứng dụng, bạn có thể chia sẻ các trường server_event sau đây trong phần tải dữ liệu:

• Thông số action_source phải chứa giá trị app cho sự kiện trong ứng dụng.
• event_id là bắt buộc đối với trường hợp thiết lập cơ chế bỏ trùng lặp.
• Các trường app_data
• Các trường user_data
• Các trường custom_data

Trường dữ liệu ứng dụng

Thông số thông tin khách hàng

Dữ liệu tùy chỉnh

Tóm lại, những sự kiện trong ứng dụng được chia sẻ qua API Chuyển đổi sẽ cần có các thông số dữ liệu sau đây:

• action_source: Phải được đặt là "app" (ứng dụng). (Bằng cách sử dụng API Chuyển đổi, bạn đồng ý rằng thông số action_source là chính xác theo hiểu biết của bạn)
• event_id: Bắt buộc khi thiết lập cơ chế bỏ trùng lặp, hãy xem chi tiết trong phần "Thiết lập cơ chế bỏ trùng lặp cho nhiều kênh".
• advertiser_tracking_enabled
• application_tracking_enabled
• extinfo

Dưới đây là ví dụ về extinfo. Đảm bảo rằng tất cả thông số phụ bên dưới đều được điền giá trị và theo tuần tự. Nếu thiếu giá trị nào, hãy dùng một chuỗi trống làm phần giữ chỗ.

c. Thiết lập cơ chế bỏ trùng lặp cho nhiều kênh

Bạn sẽ cần có cơ chế bỏ trùng lặp để loại bỏ lưu lượng truy cập sự kiện trùng lặp giữa quá trình tích hợp API Chuyển đổi và mọi quá trình tích hợp hiện có khác mà bạn có sự kiện trong ứng dụng, bao gồm cả SDK, MMP và API Sự kiện trong ứng dụng.

Đối với sự kiện trong ứng dụng, chúng tôi áp dụng chức năng bỏ trùng lặp tương tự như đối với sự kiện trên web. Logic này tận dụng chức năng bỏ trùng lặp dựa trên trường event_id và event_name (sự kiện API Chuyển đổi và SDK/API Sự kiện trong ứng dụng có cùng một event_id). Thông số event_id là thông tin nhận dạng có thể phân biệt rõ giữa các sự kiện tương tự nhau. ID sự kiện không chính xác có thể khiến hệ thống loại bỏ trùng lặp nhầm lượt chuyển đổi, do đó ảnh hưởng đến báo cáo lượt chuyển đổi và hiệu quả chiến dịch.

Bạn có thể tham khảo tài liệu dành cho nhà phát triển dưới đây để triển khai cách thiết lập cơ chế bỏ trùng lặp:

• Cách thiết lập sự kiện trong ứng dụng
• Ví dụ về cách thiết lập cơ chế bỏ trùng lặp

Dưới đây là ví dụ về cách ghi sự kiện tùy chỉnh. Để làm như vậy, hãy chuyển tên của sự kiện dưới dạng AppEvents.Name vào iOS SDK:

AppEvents.shared.logEvent(.achievedLevel, parameters: [AppEvents.ParameterName(rawValue: "event_id"): "123"])

Đối với sự kiện cài đặt ứng dụng, hiện đã có cơ chế bỏ trùng lặp để đảm bảo rằng chỉ ghi nhận 1 lượt cài đặt trong khoảng thời gian 90 ngày qua. Chúng tôi giữ lại sự kiện đầu tiên và bỏ các sự kiện sau này, bất kể sự kiện đến từ nguồn hành động nào. Không có yêu cầu khi triển khai cơ chế bỏ trùng lặp cho các sự kiện trong ứng dụng liên quan đến sự kiện cài đặt.

d. Gửi sự kiện

Để gửi sự kiện mới, hãy gửi yêu cầu POST đến API Chuyển đổi từ đường dẫn sau: https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}. Khi bạn gửi đến cạnh này, Meta sẽ tạo sự kiện mới trên máy chủ ứng dụng. Để biết thêm chi tiết, hãy tham khảo tài liệu dành cho nhà phát triển dưới đây.

Sau đây là thông tin tổng quan về cách sắp xếp thông số theo lược đồ chung trong phần tải dữ liệu:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1684389752,
            "action_source": "app",
            "user_data": {
                "em": [
                    "30a79640dfd8293d4f4965ec11821f640ca77979ca0a6b365f06372f81a3f602"
                ],
                "ph": [
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b",
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b"
                ],
                "madid": "bbbbbbbbbbbb",
      "anon_id": "cccccccc"
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            },
            "app_data": {
                "advertiser_tracking_enabled": "True",
                "application_tracking_enabled": "True",
                "campaign_ids": "aaaaaaaaa",
                "extinfo": [
                    "a2",
                    "com.some.app",
                    "771",
                    "Version 7.7.1",
                    "10.1.1",
                    "OnePlus6",
                    "en_US",
                    "GMT-1",
                    "TMobile",
                    "1920",
                    "1080",
                    "2.00",
                    "2",
                    "128",
                    "8",
                    "USA/New York"
                ]
            }
        }
    ]
}

Khắc phục sự cố

Bạn có thể dùng công cụ Trình trợ giúp phần tải dữ liệu để tạo dữ liệu cho phần tải dữ liệu:

• Chọn nguồn hành động app, nếu có
• Điền thông tin cho các sự kiện sẽ được gửi đến Meta
• Thao tác này sẽ tạo phần tải dữ liệu sự kiện mà bạn có thể dùng làm mẫu để tích hợp API Chuyển đổi

Sử dụng công cụ Thử nghiệm sự kiện trong Trình quản lý sự kiện để thử nghiệm.

Xem thêm

• Tổng quan về API Chuyển đổi
• Sử dụng API Chuyển đổi
• Thông số API Chuyển đổi
• Cách làm tốt nhất