Braze

Là một trong những giải pháp tương tác khách hàng hàng đầu, Braze cung cấp đa dạng công cụ cho push notification, email, SMS và tin nhắn trong ứng dụng. Bằng cách tích hợp Adapty với Braze, bạn có thể dễ dàng truy cập tất cả các sự kiện gói đăng ký của mình ở một nơi, từ đó có khả năng kích hoạt giao tiếp tự động dựa trên những sự kiện đó.

Adapty cung cấp đầy đủ dữ liệu giúp bạn theo dõi sự kiện gói đăng ký từ tất cả các cửa hàng ở một nơi, đồng thời có thể dùng để cập nhật hồ sơ người dùng trong Braze. Với Adapty, bạn dễ dàng nắm bắt hành vi của người dùng, hiểu họ quan tâm đến điều gì, rồi dùng thông tin đó để giao tiếp với họ theo cách có mục tiêu và hiệu quả. Nhờ tích hợp này, bạn có thể theo dõi các sự kiện gói đăng ký ngay trong Braze dashboard và liên kết chúng với chiến dịch thu hút người dùng.

Adapty gửi các sự kiện gói đăng ký, thuộc tính người dùng và lịch sử mua hàng sang Braze, giúp bạn xây dựng chiến dịch truyền thông có mục tiêu với khách hàng thông qua Braze push notifications sau khi tích hợp nhanh chóng và đơn giản như mô tả dưới đây.

Cách thiết lập tích hợp Braze

Để tích hợp Braze, vào Integrations -> Braze, bật toggle và điền vào các trường thông tin.

Bước đầu tiên của quá trình tích hợp là cung cấp các thông tin xác thực cần thiết để thiết lập kết nối giữa hồ sơ Braze và Adapty của bạn. Bạn sẽ cần REST API Key, Braze Instance ID và App IDs cho iOS và Android để tích hợp hoạt động đúng cách:

REST API Key có thể được tạo trong Braze Dashboard → Settings → API Keys. Đảm bảo key của bạn có quyền users.track khi tạo:

Để lấy Braze Instance ID, hãy ghi lại URL Braze Dashboard của bạn và truy cập phần Braze Docs nơi chỉ định instance ID. ID này có dạng khu vực như US-03, EU-01, v.v.
iOS và Android App IDs cũng có thể tìm thấy trong Braze Dashboard → Settings → API Keys. Sao chép chúng từ đây:

Sự kiện, thuộc tính người dùng và giao dịch mua

Bên dưới phần thông tin xác thực, có ba nhóm sự kiện bạn có thể gửi từ Adapty sang Braze. Chỉ cần bật những sự kiện bạn cần. Bạn cũng có thể thay đổi tên các sự kiện theo nhu cầu trước khi gửi sang Braze. Xem danh sách đầy đủ các sự kiện do Adapty cung cấp tại đây:

Adapty sẽ gửi các sự kiện gói đăng ký và thuộc tính người dùng sang Braze thông qua tích hợp server-to-server, cho phép bạn xem chúng trong Braze Dashboard và cấu hình các chiến dịch dựa trên đó.

Đối với các sự kiện có doanh thu, chẳng hạn như chuyển đổi dùng thử và gia hạn, Adapty sẽ gửi thông tin này sang Braze dưới dạng giao dịch mua.

Tại đây bạn có thể tìm thấy thông số kỹ thuật đầy đủ về các thuộc tính sự kiện được gửi sang Braze.

Các thuộc tính người dùng hữu ích

Adapty gửi một số thuộc tính người dùng cho tích hợp Braze theo mặc định. Bạn có thể tham khảo danh sách bên dưới để xác định thuộc tính nào phù hợp nhất với nhu cầu của bạn.

Thuộc tính người dùng	Loại	Giá trị
`adapty_customer_user_id`	String	Chứa giá trị của định danh duy nhất của người dùng do khách hàng định nghĩa. Có thể tìm thấy trong cả Adapty Dashboard và Braze.
`adapty_profile_id`	String	Chứa giá trị của định danh duy nhất Adapty User Profile ID của người dùng, có thể tìm thấy trong Adapty Dashboard.
`environment`	String	Cho biết người dùng đang hoạt động trong môi trường sandbox hay production. Giá trị là `Sandbox` hoặc `Production`
`store`	String	Chứa tên cửa hàng đã dùng để thực hiện giao dịch mua. Các giá trị có thể có: `app_store` hoặc `play_store`.
`vendor_product_id`	String	Chứa giá trị Product Id trong cửa hàng Apple/Google. Ví dụ: org.locals.12345
`subscription_expires_at`	String	Chứa ngày hết hạn của gói đăng ký mới nhất. Định dạng giá trị: YYYY-MM-DDTHH:mm:ss.SSS+TZ Ví dụ: 2023-02-15T17:22:03.000+0000
`active_subscription`	String	Giá trị sẽ được đặt thành `true` khi có bất kỳ sự kiện mua/gia hạn nào, hoặc `false` nếu gói đăng ký đã hết hạn.
`period_type`	String	Cho biết loại kỳ mới nhất cho giao dịch mua hoặc gia hạn. Các giá trị có thể có: `trial` cho kỳ dùng thử hoặc `normal` cho các trường hợp còn lại.

Tất cả giá trị float sẽ được làm tròn thành int. Chuỗi giữ nguyên.

Ngoài danh sách các tag được định nghĩa sẵn, bạn cũng có thể gửi thuộc tính tùy chỉnh bằng cách sử dụng tag. Điều này mang lại sự linh hoạt hơn trong loại dữ liệu có thể đưa vào tag và có thể hữu ích để theo dõi thông tin cụ thể liên quan đến sản phẩm hoặc dịch vụ. Tất cả các thuộc tính người dùng tùy chỉnh đều được gửi tự động sang Braze nếu người dùng đánh dấu vào checkbox ** Send user attributes** từ trang tích hợp.

Cấu hình SDK

Để liên kết hồ sơ người dùng trong Adapty và Braze, bạn cần cấu hình Braze SDK với cùng customer user ID như Adapty hoặc sử dụng phương thức .changeUser():

let braze = Braze(configuration: configuration)
braze.changeUser(userId: "adapty_customer_user_id")

Braze.getInstance(context).changeUser("adapty_customer_user_id")

Khắc phục 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.