Bài viết liên tục được cập nhật, và những phần được cập nhật rất có thể chưa được dịch sang ngôn ngữ của bạn. Để xem thông tin mới nhất, vui lòng chọn ngôn ngữ Tiếng Anh.

Cài đặt Braze

Braze là mạng quảng cáo (ad network) và mạng phân tích (analytics) có tích hợp với Adjust. Sau khi tích hợp với Adjust, Braze sẽ nhận được dữ liệu phân bổ và dữ liệu sự kiện in-app qua callback tự động.

Dưới đây là hướng dẫn cài đặt tính năng đo lường Braze. Hướng dẫn gồm các bước kích hoạt tích hợp, gửi callback cho Braze, và xác định loại dữ liệu mà Adjust có thể chia sẻ cho Braze.

Trước khi bắt đầu

Yêu cầu

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade / Xamarin | Cocos2d-x | Titanium | Corona

Trên Braze dashboard

Trước khi kích hoạt tích hợp Adjust với Braze, bạn cần hoàn tất các bước sau:

1. Liên kết device ID

Android

Nếu ứng dụng của bạn là Android, thì bạn cần gửi Braze device ID cho Adjust. Gọi phương thức addSessionPartnerParameter() trong Adjust SDK để gửi giá trị. Trước khi khởi tạo Braze Android SDK trên Adjust.onCreate(), bạn cần thêm code snippet sau.

Adjust.addSessionPartnerParameter("braze_device_id", Braze.getInstance(getApplicationContext()).getDeviceId()););

iOS

Objective-C

Adjust thu thập IDFV của ứng dụng iOS và gửi đến Braze. Braze sẽ liên kết ID này với device ID của Braze.

Braze sẽ lưu IDFA nếu người dùng opt-in, tức đồng ý để Braze thu thập IDFA. Nếu người dùng không đồng ý, IDFV sẽ được sử dụng thay — trở thành mã định danh dùng để liên kết người dùng.

Swift

Nếu ứng dụng của bạn là iOS, thì bạn có thể đặt trường useUUIDAsDeviceId trên Braze Swift SDK thành false để thu thập IDFV. Nếu bạn không thực hiện bước này, thì Adjust khó có thể phân bổ iOS chính xác cho Braze. Để biết thêm thông tin, vui lòng tham khảo tài liệu Collecting IDFV in Braze.

2. Tạo data import key cho Braze

  1. Trên nền tảng Braze, chọn Technology Partners , sau đó chọn Adjust.
  2. Tìm REST Endpoint và tạo Data Import Key của Braze.

Sau khi data import key được tạo, bạn có tạo key mới hoặc vô hiệu hóa key đang dùng. Sử dụng data import key và REST endpoint để cài đặt tích hợp giữa Adjust và Braze. Để biết thêm thông tin chi tiết, vui lòng tham khảo tài liệu của Braze.

Chọn Braze và ứng dụng của bạn trên Campaign Lab

  1. Tại mục Campaign Lab , chọn Đối tác.
  2. Chọn Đối tác mới > Braze. Chọn Tiếp theo để chuyển sang màn hình kế tiếp.
  3. Tại màn hình Lựa chọn ứng dụng , chọn ứng dụng mà bạn muốn tạo liên kết, sau đó kích hoạt tích hợp để chia sẻ dữ liệu cho Braze.
  4. Chọn Tiếp theo.

Kích hoạt tính năng chia sẻ dữ liệu

Kích hoạt tính năng chia sẻ dữ liệu để kích hoạt tích hợp giữa Adjust và Braze. Để kích hoạt tính năng chia sẻ dữ liệu:

  1. Nhập data import key và endpoint.

Sau khi bạn kích hoạt tính năng chia sẻ dữ liệu cho Braze, Adjust sẽ mặc định gửi các dữ liệu sau cho Braze:

  • Lượt cài đặt

Lưu ý: Sau khi Braze nhận được dữ liệu do Adjust gửi (dữ liệu về lượt cài đặt được phân bổ), thì trạng thái kết nối của Adjust trên nền tảng Braze sẽ chuyển từ "Not Connected" thành "Connected". Thời điểm được ghi lại là lần cuối gửi yêu cầu thành công.

Cài đặt tính năng chia sẻ dữ liệu

Nếu ứng dụng của bạn là đa nền tảng (multi-platform app), và tính năng chia sẻ dữ liệu đã được kích hoạt cho các nền tảng này, thì bạn có thể thực hiện các thao tác sau:

  1. Chọn Sử dụng cài đặt riêng của nền tảng nếu bạn muốn cài đặt tính năng chia sẻ dữ liệu khác nhau cho mỗi nền tảng.
  2. Chọn Sử dụng cài đặt chung nếu bạn muốn cài đặt tính năng giống nhau cho tất cả nền tảng.

Tại mục Dữ liệu nào sẽ được chia sẻ mặc định? , kiểm tra lại các dữ liệu mà Adjust mặc định chia sẻ cho Braze.

  • Lượt cài đặt

Gửi dữ liệu bổ sung

Chọn số lượng và loại dữ liệu mà bạn muốn chia sẻ cho Braze qua callback. Braze có thể sử dụng dữ liệu bạn chia sẻ để cải thiện dịch vụ.

Doanh thu in-app (từ giao dịch in-app)

Nếu bạn chọn chia sẻ dữ liệu doanh thu, Braze sẽ nhận được dữ liệu số tiền và sự kiện doanh thu. Bạn cần liên kết sự kiện để có thể chia sẻ dữ liệu này; lưu ý, sự kiện phải tạo doanh thu.

Liên kết event

Liên kết sự kiện mà bạn muốn chia sẻ, với giá trị mà Braze có thể nhận được. Đối với sự kiện không được liên kết, dữ liệu liên quan đến sự kiện sẽ không được chia sẻ cho Braze.

Liên kết các sự kiện riêng lẻ

Nếu bạn sở hữu ứng dụng đa nền tảng (multi-platform app), thì có thể chia sẻ cho Braze các sự kiện khác nhau tùy theo từng nền tảng. Tức bạn có thể:

  • Cài đặt sự kiện riêng lẻ để quản lý chiến dịch theo từng nền tảng.
  • Điều chỉnh tính năng chia sẻ dữ liệu của từng nền tảng.

Để chọn in-app event mà muốn bạn muốn gửi trực tiếp cho Braze, thực hiện các bước sau tại mục Liên kết sự kiện .

  1. Chọn Liên kết sự kiện.

  2. Mở danh sách Sự kiện của Adjust , chọn sự kiện mà bạn muốn chia sẻ cho Braze.

  3. Tại mục Sự kiện đối tác , chọn sự kiện của Braze, đảm bảo sự kiện đó tương ứng với sự kiện của Adjust.

    1. Đối với ứng dụng đơn nền tảng và ứng dụng đa nền tảng nhưng chỉ bật tính năng chia sẻ dữ liệu cho một nền tảng, thì bạn chỉ cần liên kết sự kiện cho nền tảng đó. Còn đối với ứng dụng đa nền tảng nhưng bật tính năng chia sẻ dữ liệu cho nhiều nền tảng, thì bạn có các lựa chọn sau:

      • Chọn Sử dụng biểu đồ liên kết riêng của nền tảng để liên kết sự kiện theo từng nền tảng một, hoặc để không liên kết sự kiện cho một số nền tảng nhất định.
      • Chọn Sử dụng biểu đồ liên kết chung để liên kết chung sự kiện cho tất cả nền tảng.

    2. Trong danh sách Sự kiện của đối tác , chọn sự kiện có sẵn hoặc nhập sự kiện do bạn đặt tên - sự kiện này sẽ liên kết với sự kiện của Adjust.

  4. Chọn Áp dụng .

Giờ đây, Braze sẽ nhận được dữ liệu về in-app event của từng sự kiện được liên kết.

Liên kết tất cả sự kiện

Nếu Braze cho phép liên kết tự động tất cả sự kiện, thì tại mục Liên kết sự kiện , chọn Liên kết tất cả sự kiện. Như vậy bạn đỡ mất thời gian liên kết từng sự kiện một.

Sau bước trên, Braze sẽ nhận được dữ liệu sự kiện in-app của tất cả sự kiện được liên kết.

Liên kết tham số

Bạn cần liên kết tham số để gửi dữ liệu tùy chỉnh cho Braze.

Với tham số đối tác (khả dụng trên Adjust SDK phiên bản 4.0 trở lên), Adjust có thể thu thập và trực tiếp gửi các điểm dữ liệu tùy chỉnh từ ứng dụng đến Braze. Như vậy, Braze có thể nhận được dữ liệu chi tiết cho từng sự kiện được liên kết.

Trước khi thêm tham số đối tác mới vào SDK, vui lòng đảm bảo rằng, các tham số đối tác hiện có không đáp ứng được yêu cầu.

Để chia sẻ tham số đối tác cho Braze, thực hiện các bước sau.

  1. Cài đặt tham số đối tác trong Adjust SDK.

  2. Tại mục Cài đặt tính năng chia sẻ dữ liệu , chọn Tham số.

  3. Đến mục Liên kết tham số , chọn tham số mà bạn muốn gửi đến mạng quảng cáo:

    1. Chọn Liên kết tham số.
    2. Tại trường Tham số SDK , nhập tên tham số SDK mà bạn muốn chia sẻ cho mạng quảng cáo.
    3. Tại trường Tham số đối tác , nhập tham số mạng quảng cáo tương ứng với tham số SDK.
Lưu ý:

Nếu bạn cài đặt tham số đối tác trong Adjust SDK nhưng không cài đặt tính năng liên kết tham số đối tác, thì Adjust sẽ chuyển tiếp tham số theo tên được ghi trong Adjust SDK.

Kích hoạt Braze cho ứng dụng

Trên màn hình Kiểm tra lại cài đặt , kiểm tra lại các thao tác đã thực hiện. Bạn có thể quay lại để thực hiện thay đổi nếu cần:

  • Ứng dụng đã chọn
  • Cách chia sẻ dữ liệu

Chọn Kích hoạt đối tác để kích hoạt Braze cho ứng dụng. Đối tác phân tích không dùng liên kết cho chiến dịch. Sau khi kích hoạt tích hợp, chúng tôi sẽ gửi dữ liệu phân bổ và dữ liệu in-app event cho đối tác qua callback tự động.

Hướng dẫn cài đặt đối tác

Lưu ý: kKông nên nhập giao thức Endpoint; không nên thêm https:// vào trường kích hoạt. Cuối cùng, Braze yêu cầu các tham số cụ thể để nhận dữ liệu callback.

Tham số có sẵn

Braze cho phép bạn gửi một tập hợp tham số có sẵn (predefined parameter). Nếu bạn gán tham số bất kỳ trong tập hợp này vào một sự kiện trong Adjust SDK, thì tham số sẽ được chuyển tiếp đến Braze. Bạn có thể tìm thêm thông tin về cách gán tham số đối tác trong SDK Readme. Bên dưới là danh sách các tham số có sẵn và được Braze chấp nhận:

Parameter key> Value

  • external_id > tham số bắt buộc để gửi sự kiện đến Braze.
  • braze_device_id > tham số bắt buộc để gửi bất kỳ dữ liệu Android nào đến Braze.
  • product_id > tham số bắt buộc để gửi sự kiện doanh thu đến Braze. Để gửi callback sự kiện đến Braze, bạn cần sử dụng external_id làm tham số đối tác trong Adjust SDK. Để chuyển tiếp dữ liệu về sự kiện doanh thu, bạn cũng cần đặt product_id làm tham số đối tác.

Đối với ứng dụng Android, bạn cần bổ sung braze_device_id làm tham số đối tác cho sự kiện và phiên truy cập. Để chuyển tiếp dữ liệu về sự kiện doanh thu, bạn cũng cần đặt product_id làm tham số đối tác. Lưu ý rằng, Braze không hỗ trợ dữ liệu tự nhiên (organic), dữ liệu Facebook và dữ liệu Twitter. Do vậy, callback cho các chiến dịch này sẽ không được gửi đi.

Callback
Hiện Adjust không chuyển tiếp dữ liệu tự nhiên, dữ liệu Facebook và dữ liệu Twitter đến Braze.

Nếu bạn muốn tìm hiểu thêm chức năng của tích hợp, vui lòng xem bài viết về Braze. Nếu bạn có bất kỳ câu hỏi nào liên quan đến thông tin trong bài viết, vui lòng liên hệ với partners@adjust.com.

Danh sách tất cả tham số được chuyển tiếp đến Braze

Braze yêu cầu Adjust gửi các tham số (điểm dữ liệu) sau trong callback:

Trường dữ liệuThông tin
{currency}Mã tiền tệ gốc theo ISO 4217, do Adjust SDK gửi đến
{idfa}ID dành cho nhà quảng cáo (advertiser) (chỉ áp dụng với iOS)
{partner_parameters}Tham số đối tác tùy chỉnh do Adjust SDK hoặc yêu cầu S2S thu thập được, sau đó gửi đến nhà cung cấp dịch vụ bên thứ ba qua postback
{revenue}Doanh thu được gửi từ Adjust SDK, tính theo cent
{win_adid}Windows advertising identifier
{adgroup_name}Tên adgroup
{app_id}Store App ID hoặc Google Play Store
{campaign_name}Campaign name
{created_at}Thời gian của hoạt động
{creative_name}Creative name
{network_name}Network name