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

Để kết nối Adapty với Braze, mở Integrations → Braze trong Adapty Dashboard, bật toggle và điền thông tin xác thực:

REST API key và Braze Instance ID là bắt buộc.
iOS App ID và Android App ID là tùy chọn.

Để tạo REST API key, trong Braze dashboard, vào Settings → APIs and Identifiers và nhấp Create API Key. Trong phần quyền dữ liệu người dùng, chọn users.track. Braze không cho phép thay đổi quyền của key sau khi tạo, vì vậy key không có users.track phải được thay thế bằng key mới. Để biết thêm chi tiết, xem Creating REST API keys trong tài liệu Braze.
Để tìm Braze Instance ID, đối chiếu URL Braze dashboard của bạn với bảng instance trong tài liệu Braze. Instance ID có dạng theo khu vực, ví dụ như US-03 hoặc EU-01. Chẳng hạn, dashboard-03.braze.com tương ứng với US-03.
Để tìm iOS App ID và Android App ID, trong Braze dashboard, vào Settings → APIs and Identifiers → App Identifiers. Sao chép giá trị trong cột Identifier cho từng ứng dụng. Để biết thêm chi tiết, xem App identifier trong tài liệu Braze.

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 đến Braze dưới dạng giao dịch mua.

Warning

Adapty chỉ gửi doanh thu đến Braze dưới dạng sự kiện mua hàng legacy. Braze đã chuyển các sự kiện mua hàng legacy sang chế độ bảo trì và không kích hoạt chúng cho khách hàng mới. Nếu workspace Braze của bạn không chấp nhận chúng, Braze sẽ từ chối mọi sự kiện có doanh thu với HTTP 400 và thông báo Legacy purchase ingestion is disabled. Những sự kiện đó, chẳng hạn như lần mua đầu tiên, gia hạn, chuyển đổi dùng thử và hoàn tiền, sẽ không đến được Braze, không chỉ phần doanh thu của chúng.

Trước khi bật tích hợp, hãy đảm bảo workspace Braze của bạn chấp nhận các sự kiện mua hàng kiểu cũ. Để biết thêm chi tiết, xem Purchase events trong tài liệu Braze.

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

Note

Thuộc tính người dùng hữu ích

Adapty mặc định gửi một số thuộc tính người dùng cho tích hợp Braze. 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 mình.

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.