Facebook Ads

Với tích hợp Facebook Ads, bạn có thể dễ dàng kiểm tra số liệu thống kê ứng dụng trong Meta Analytics. Adapty gửi các sự kiện đến Meta Ads Manager, giúp bạn tạo tệp đối tượng tương tự dựa trên gói đăng ký để đạt hiệu quả tốt hơn. Nhờ đó, bạn có thể theo dõi chính xác doanh thu quảng cáo từ các gói đăng ký.

Sự tích hợp giữa Adapty và Facebook Ads hoạt động theo cách sau: Adapty gửi tất cả các sự kiện gói đăng ký đã được cấu hình trong tích hợp của bạn đến Facebook Ads. Tích hợp này hữu ích để đánh giá hiệu quả của các chiến dịch quảng cáo.

Thiết lập tích hợp

Kết nối Adapty với Facebook Ads

Để tích hợp Facebook Ads và phân tích các chỉ số ứng dụng, bạn có thể thiết lập tích hợp với Meta Analytics. Bằng cách gửi sự kiện đến Meta Ads Manager, bạn có thể tạo đối tượng tương tự dựa trên các sự kiện gói đăng ký như gia hạn. Để cấu hình tích hợp này, hãy điều hướng đến Integrations > Facebook Ads trong Adapty Dashboard và cung cấp thông tin xác thực cần thiết.

1. Để tìm App ID, mở trang ứng dụng của bạn trong App Store Connect, vào trang App Information trong mục General, và tìm Apple ID ở góc dưới bên trái màn hình.
2. Bạn cần có ứng dụng trên nền tảng Meta for Developers. Đăng nhập vào ứng dụng của bạn rồi vào phần cài đặt nâng cao. Bạn có thể tìm thấy App ID ở phần tiêu đề.

3. Tắt tính năng theo dõi phía client trong cấu hình Meta SDK để tránh tính doanh thu hai lần trong Meta Ads Manager. Bạn có thể tìm thấy cài đặt này trong Meta Developer Console tại App Settings > Advanced Settings. Đặt Log in-app events automatically thành “No”. Điều này đảm bảo rằng sự kiện doanh thu chỉ được theo dõi thông qua tích hợp của Adapty.

   Để theo dõi sự kiện cài đặt và sử dụng, bạn cần kích hoạt Meta SDK trong mã nguồn của mình. Bạn có thể tìm thấy hướng dẫn triển khai trong tài liệu Meta SDK cho nền tảng của bạn:

   • iOS SDK
   • Android SDK
   • Unity SDK

Bạn cũng có thể sử dụng tích hợp này với ứng dụng Android. Nếu bạn đã thiết lập cấu hình Android SDK trong App Settings, chỉ cần thiết lập Facebook App ID là đủ.

Cấu hình sự kiện và thẻ

Adapty ánh xạ các sự kiện mua hàng của mình sang các sự kiện chuẩn của Meta mà Meta có thể tối ưu hóa chiến dịch: StartTrial, Subscribe, và fb_mobile_purchase — sự kiện mua hàng của Meta. Subscription started, Subscription renewed, Trial started, và Trial converted đều gửi một sự kiện Meta cho mỗi tên được chọn trong trường của sự kiện đó, và tất cả các tên đều được chọn theo mặc định. Ví dụ, một lần bắt đầu dùng thử sẽ đến Meta dưới dạng ba sự kiện. Để gửi ít hơn, hãy bỏ chọn các tên trong trường đó.

Meta không có sự kiện chuẩn cho các sự kiện còn lại, vì vậy Adapty gửi chúng dưới dạng sự kiện tùy chỉnh với tên Adapty của chúng. Để khớp với tên của bạn, hãy thay đổi tên trong trường của sự kiện đó.

Trial still active và Subscription still active là các sự kiện tổng hợp: Adapty gửi chúng đến Meta theo bộ hẹn giờ, và chỉ gửi nếu gói dùng thử hoặc gói đăng ký vẫn còn hoạt động khi bộ hẹn giờ kết thúc. Chúng không mang theo doanh thu, vì vậy Meta không tính chúng vào giá trị mua hàng. Cả hai đều tắt theo mặc định. Để gửi chúng, hãy bật lên và đặt thời gian trễ.

Kết nối ứng dụng của bạn với Facebook Ads

Nếu bạn thực hiện các bước trên, Facebook sẽ tự động nhận dữ liệu gói đăng ký từ Adapty.

Theo những thay đổi về IDFA trong iOS 14.5, chúng tôi khuyến nghị bạn yêu cầu facebookAnonymousId của người dùng từ Facebook. Như vậy, nếu IDFA của người dùng không khả dụng, tích hợp vẫn sẽ tiếp tục hoạt động. Hãy làm theo hướng dẫn cài đặt thuộc tính người dùng iOS, Android, React Native, Flutter và Unity để thiết lập thông số này.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "facebook_anonymous_id", 
        value: AppEvents.shared.anonymousID
    )
} catch {
    // handle the error
}

Adapty.setIntegrationIdentifier(
    "facebook_anonymous_id",
    AppEventsLogger.getAnonymousAppDeviceGUID(context)
) { error ->
    if (error != null) {
        // handle the error
    }
}

try {
  const anonymousId = await AppEventsLogger.getAnonymousID();

  await adapty.setIntegrationIdentifier("facebook_anonymous_id", anonymousId);
} catch (error) {
  // handle `AdaptyError`
}

There is no official SDK for Flutter

anonymousID is not available in the official SDK
https://github.com/facebook/facebook-sdk-for-unity/issues/676

Cấu trúc sự kiện

Adapty gửi sự kiện đến Facebook Ads (Meta) qua Graph API. Mỗi sự kiện có cấu trúc như sau:

{
  "event": "CUSTOM_APP_EVENTS",
  "app_user_id": "user_12345",
  "advertiser_id": "00000000-0000-0000-0000-000000000000",
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "custom_events": "[{\"_eventName\":\"Subscribe\",\"_logTime\":1709294400,\"fb_num_items\":1,\"fb_content_type\":\"in_app\",\"fb_content_id\":\"yearly.premium.6999\",\"fb_currency\":\"USD\",\"fb_order_id\":\"GPA.3383...\",\"fb_transaction_id\":\"GPA.3383...\",\"_valueToSum\":9.99}]",
  "extinfo": "[\"i2\",\"com.example.app\",\"1.0.0\",\"100\",\"17.0.1\",\"iPhone14,3\",\"en_US\",\"GMT+3\",\"\",0,0,0,0,0,0,\"GMT+3\"]",
  "anon_id": "facebook_anon_id_123"
}

Trong đó:

Tham số custom_events là một mảng JSON-encoded với một đối tượng cho mỗi sự kiện Meta mà sự kiện Adapty ánh xạ tới. Chỉ có StartTrial, Subscribe và fb_mobile_purchase mới chứa fb_content_id, fb_content_type, fb_num_items và fb_transaction_id. Mỗi đối tượng bao gồm:

Xử lý sự cố

access_level_updated hiển thị là thất bại trong Event Feed

access_level_updated là một sự kiện chỉ dành cho webhook. Adapty không bao giờ gửi sự kiện này đến tích hợp này. Tuy nhiên, Adapty ghi lại kết quả cho mọi tích hợp đã bật, và một sự kiện không được hỗ trợ sẽ được hiển thị là thất bại.