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 nhiều công cụ đa dạng cho push notification, email, SMS và in-app messaging. 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, cho phép kích hoạt giao tiếp tự động dựa trên các sự kiện đó.

Adapty cung cấp bộ dữ liệu đầy đủ 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 và có thể dùng để cập nhật hồ sơ người dùng trong Braze. Với Adapty, bạn có thể dễ dàng theo dõi hành vi của người dùng, tìm hiểu sở thích của họ và sử dụng thông tin đó để giao tiếp theo cách có mục tiêu và hiệu quả. Do đó, tích hợp này cho phép bạn theo dõi các sự kiện gói đăng ký trong Braze dashboard và liên kết chúng với các 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à giao dịch mua sang Braze, giúp bạn xây dựng giao tiếp có mục tiêu với khách hàng qua push notification của Braze sau một quá trình tích hợp ngắn gọn và đơn giản như mô tả bên dưới.

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() của nó:

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

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