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 server callback

Bạn có thể cài đặt server callback để nhận advertising ID, thông tin phân bổ, dữ liệu ứng dụng và nhiều dữ liệu khác — các dữ liệu này được gửi trực tiếp đến máy chủ của bạn dưới dạng dữ liệu thô (raw data).

Trước khi bắt đầu

Trước khi bắt đầu, vui lòng tham khảo các thông tin sau.

Yêu cầu

  • Quyền truy cập Admin, Editor và Custom Editor
  • Bạn cần có sẵn giải pháp BI hoặc kho dữ liệu để nhận yêu cầu dạng callback. Vui lòng đảm bảo rằng máy chủ của bạn có thể nhận tất cả tham số và lưu trữ tất cả dữ liệu đến. Số lượng người dùng bạn hiện có trong ứng dụng sẽ quyết định đến tốc độ máy chủ bạn cần. Trong trường hợp bạn theo dõi các sự kiện chỉ diễn ra một lần, ví dụ đăng ký (registration), thì bạn sẽ nhận được một callback khi có một người dùng thực hiện sự kiện chuyển đổi đó. Callback cho sự kiện chuyển đổi thường không tác động nhiều đến băng thông máy chủ.
  • Để đảm bảo bạn chỉ nhận dữ liệu từ Adjust, vui lòng đưa IP máy chủ của chúng tôi vào danh sách cho phép (allowlist).

Loại callback

Bạn có thể cài đặt callback cho các trigger sau:

Danh sách trigger

Global callback

Global callback là lệnh callback chính cho mọi trigger mà Adjust đo lường (ví dụ: lượt click, lượt cài đặt, phiên truy cập, v.v.). Đây là cách nhanh nhất để nhận về các điểm dữ liệu giống nhau cho mọi hoạt động mà Adjust đo lường – vì chỉ có duy nhất một URL thay vì nhiều URL.

Lưu ý:
Global callback không bao gồm các thông tin sau:
  • Doanh thu quảng cáo (Ad revenue)
  • Lượt click từ SAN
  • Lượt hiển thị từ SAN
  • Lượt cài đặt SKAdNetwork
  • Sự kiện SKAdNetwork
Bạn cần cài đặt callback hoạt động đơn (single activity callback) cho các thông tin này.

Callback hoạt động đơn

Callback hoạt động đơn (single activity callback) là callback dành cho một hoạt động cụ thể (ví dụ: click). Đây là một lựa chọn tối ưu nếu bạn chỉ cần dữ liệu cho một số hoạt động nhất định. Vì trong một số trường hợp, global callback có thể tạo rất nhiều dữ liệu, nhất là dữ liệu lượt hiển thị và lượt click. Cho nên, nếu bạn muốn giảm số lượng dữ liệu mà Adjust gửi về hệ thống BI, hãy cân nhắc sử dụng callback hoạt động đơn.

Lưu ý:
Nếu cài đặt đồng thời global callback và callback hoạt động đơn, thì bạn sẽ nhận được hai callback cho cùng một hoạt động: mỗi callback được gửi đến endpoint tương ứng.

Nhiều callback cho cùng một hoạt động

Adjust có thể gửi callback hoạt động đơn đến nhiều endpoint tùy ý. Bạn chỉ cần tách từng URL bằng một dấu cách ( ).

Cài đặt server callback

Có hai cách cài đặt server callback: cài đặt có hướng dẫn (guided setup) hoặc cài đặt truyền thống (classic setup). Bạn nên sử dụng cài đặt có hướng dẫn để tạo callback URL.

Để biết cần sử dụng trường dữ liệu nào, vui lòng tham khảo danh sách trường dữ liệu đề xuất của chúng tôi.

Cài đặt có hướng dẫn (Guided setup)

  1. Sử dụng thẻ ứng dụng (app card) hoặc tab Quản lý dữ liệu để cài đặt server callback.

    • (Admin, Editor và Custom Editor) Để cài đặt server callback bằng thẻ ứng dụng, tại mục AppView , chọn Tất cả ứng dụng. Tìm ứng dụng của bạn và chọn Server callback.
    • Để cài đặt server callback bằng tab Quản lý dữ liệu , tại mục AppView , chọn Tất cả ứng dụng. Tìm ứng dụng của bạn, sau đó chọn tab Quản lý dữ liệu.

  2. Tại mục Server callback , chọn Thêm callback > Guided setup.

  3. Mở danh sách Callback trigger , chọn hoạt động (activity) hoặc sự kiện (event) sẽ kích hoạt callback.

  4. Nhập endpoint URL — nơi bạn muốn nhận dữ liệu — vào trường Server endpoint.

  5. (Tùy chọn) Chọn Thêm điều kiện để thêm điều kiện (dưới dạng trường dữ liệu hoặc giá trị). Callback chỉ được kích hoạt khi điều kiện được đáp ứng.

  6. Tại mục Phương thức gửi yêu cầu , chọn phương thức mà bạn muốn callback sử dụng (GET hoặc POST). GET là phương thức mặc định.

    • Nếu bạn chọn POST, bạn có thể nhập các cặp key-value trong phần body của yêu cầu, theo định dạng key=value. Adjust sẽ mã hóa và gửi phần body dưới dạng đối tượng JSON phẳng.

  7. Chọn Thêm trường dữ liệu để linh động thêm dữ liệu người dùng hoặc dữ liệu tương tác vào callback. Bạn có thể thêm nhiều trường dữ liệu cùng lúc.

  8. Chọn Tạo callback URL để tạo và mã hóa callback.

Cài đặt truyền thống (Classic setup)

Khi bạn sử dụng mô hình cài đặt truyền thống (classic setup), bạn có thể trực tiếp chỉnh sửa toàn bộ chuỗi callback. Hệ thống hiện đã có thể nhận dạng cả hai định dạng GET và POST:

  • <method>,<conditions>,<url>[,<body>]
  • Body của yêu cầu POST sử dụng key1=value1&key2=value2, sau đó Adjust sẽ chuyển đổi thành dạng JSON phẳng.

Bạn có thể nhập nhiều callback, cách nhau bằng dấu cách. GET sẽ được mặc định sử dụng, trừ phi bạn thay đổi phương thức gửi yêu cầu thành POST.

Quản lý callback

Sau khi tạo xong callback URL, bạn có thể xem lại URL tại trang Server callback. Bạn có thể thực hiện các thao tác sau đối với callback:

  • Chọn (biểu tượng sao chép) để sao chép callback URL.
  • Chọn (biểu tượng tạo bản sao) để tạo bản sao cho callback và mở trang cài đặt cũ.
  • Chọn (biểu tượng xóa) để xóa callback.
  • Chọn (biểu tượng chỉnh sửa) để chỉnh sửa callback URL trên trang cài đặt cũ.