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 tích hợp độc lập Segment

Segment là đối tác phân tích của Adjust. Với tích hợp độc lập, Adjust SDK và Segment SDK sẽ hoạt động độc lập với nhau. Giải pháp này giúp bạn dễ dàng thêm các tính năng khác của Adjust SDK như deep link.

Cơ chế hoạt động

Adjust SDK và Segment SDK hoạt động độc lập nhau, do vậy, hoạt động của người dùng được ghi lại như sau:

  1. Ứng dụng trực tiếp khởi chạy Adjust SDK.
  2. Adjust SDK tự động ghi lại lượt cài đặt (install), phiên truy cập (session) và tái phân bổ (attribution).
  3. Segment SDK ghi lại sự kiện, sau đó máy chủ Segment gửi sự kiện đến máy chủ Adjust dưới dạng sự kiện S2S, theo Cloud Mode.
  4. Máy chủ Adjust gửi callback lượt cài đặt (install callback) đến máy chủ Segment. Segment ghi lại callback lượt cài đặt dưới dạng sự kiện track có tên Install Attributed.

Cài đặt tích hợp

Vui lòng thực hiện các bước sau để cài đặt giải pháp độc lập Adjust SDK với Segment.

1. Cài đặt cấu hình Adjust SDK và Segment SDK

Để xem hướng dẫn cài đặt cấu hình Adjust SDK và Segment SDK, tham khảo các tài liệu sau dành cho nhà phát triển, chọn tài liệu tương ứng với hệ điều hành bạn đang dùng:

📖 iOS / Android

2. Kích hoạt Segment trên Adjust

Để cài đặt Segment trên Adjust, thực hiện theo hướng dẫn tại đây.

Để lấy WRITE KEY, tham khảo hướng dẫn của Segment.

Segment sẽ nhận callback cho hoạt động cài đặt.

3. Tạo Adjust destination và thêm Adjust app token vào Segment

Vui lòng thực hiện các bước sau để thêm Adjust làm điểm đến trong Segment dashboard.

  1. Chọn Destinations > Add Destination .
  2. Tìm Adjust.
  3. Thêm Adjust làm điểm đến của nguồn dữ liệu.

Vui lòng thực hiện các bước sau để thêm Adjust app token vào Adjust destination.

  1. Chọn Destinations và chọn Adjust.
  2. Chọn App Token và nhập app token mà bạn đã tạo trên AppView.
  3. Chọn LƯU .

Bạn có thể sử dụng bảng sau để xem mối liên hệ giữa Adjust destination và nguồn (mối liên này phụ thuộc vào cách bạn cài đặt ứng dụng trên Adjust).

Segment SDK đã sử dụngCách ứng dụng được cài đặt trên AdjustAdjust destination trên Segment dashboard
Segment Android SDK và Segment iOS SDKỨng dụng đa nền tảng (multiplatform app) (ứng dụng Android và iOS sử dụng chung app token) 
  1. Thêm một Adjust destination vào nguồn iOS và một Adjust destination vào nguồn Android. 
  2. Sử dụng cùng một Adjust token để cài đặt cấu hình cho cả hai destination này.
Segment Android SDK và/hoặc Segment iOS SDKỨng dụng iOS và/hoặc ứng dụng Android (mỗi ứng dụng có app token riêng)
  1. Thêm một Adjust destination vào từng nguồn.
  2. Sử dụng Adjust token phù hợp để cài đặt cấu hình cho từng destination.
Segment React Native SDKỨng dụng đa nền tảng (multiplatform app) (ứng dụng Android và iOS sử dụng chung app token)
  1. Thêm một Adjust destination vào nguồn React Native.
  2. Sử dụng app token để cài đặt cấu hình cho app token.
Segment React Native SDKỨng dụng iOS và/hoặc ứng dụng Android (mỗi ứng dụng có app token riêng) 
  1. Thêm một Adjust destination dành cho iOS và một Adjust destination dành cho Android, vào nguồn React Native.
  2. Sử dụng app token phù hợp để cài đặt cấu hình cho từng destination.

4. Tạo event token trên nền tảng Adjust

Ở bước này, bạn cần xem xét và xác định, bạn muốn liên kết sự kiện nào trên Segment dashboard với Adjust.

Ở từng track call của Segment mà bạn muốn liên kết với Adjust, tạo một Adjust event token tương ứng và sao chép event token.

Cảnh báo:

Giải pháp này không hỗ trợ tham số đối tác. Nhưng để có thể gửi một số giá trị đến Adjust SDK, bạn lại cần đến một số tham số đối tác liên quan đến phiên truy cập. Vui lòng tham khảo tài liệu tương ứng với hệ điều hành:


📖 iOS / Android


Nếu bạn cần gửi sự kiện (cùng tham số tùy chỉnh) đến mạng quảng cáo (ví dụ, để phục vụ cho chiến dịch tái tương tác động - dynamic retargeting), thì bạn cần thiết lập các sự kiện này riêng trong Segment SDK và riêng trong Adjust SDK. Vui lòng không liên kết các sự kiện trong Segment dashboard với Adjust destination.

5. Nhập Adjust event token vào nền tảng Segment

  1. Chọn Destinations và chọn Adjust destination trên Segment dashboard.
  2. Chọn Map Your Events to Custom Adjust Event Tokens và nhập event token mà bạn sao chép từ nền tảng Adjust.
    Mỗi track event của Segment sẽ tương ứng với một Adjust event token. Không liên kết track call của Segment có các tên khác nhau với cùng một Adjust event token.
  3. Chọn LƯU .

6. Cài đặt bổ sung trên nền tảng Segment

  1. Chọn Destinations và chọn Adjust destination trên Segment dashboard.

  2. Tìm Track Attribution Data và bật ON .

  3. Tìm Send Event Creation Time và chọn các mục phù hợp:

    • ON - Segment gửi tham số created_at_unix theo sự kiện S2S. Nhưng vì Segment không đảm bảo sự kiện được gửi theo đúng thứ tự thời gian của tham số created_at_unix, nên rất có thể máy chủ của Adjust sẽ từ chối một số sự kiện.
    • OFF - Segment không gửi tham số created_at theo sự kiện S2S. Máy chủ của Adjust không từ chối sự kiện để đảm bảo yếu tố thời gian. Vì không nhận được tham số, nên Adjust lấy dấu thời gian received_at làm dấu thời gian created_at. Vậy có nghĩa là, dấu thời gian created_at không còn cho biết thời điểm thiết bị kích hoạt sự kiện trong Segment SDK.

  4. Ở phía trên đầu màn hình là Adjust Settings. Chọn ON để kích hoạt Destination.

Sau khi bạn đã sẵn sàng để khởi chạy tích hợp ở chế độ Production, tìm phần cài đặt Send to Production Environment on Adjust và bật ON .

A screenshot from the Segment dashboard of how to configure your Adjust settings.

Tham số được chuyển tiếp đến Segment

Dưới đây là danh sách tham số được gửi đến Segment qua callback của Adjust:

Trường dữ liệuThông tin
[anonymous_id]Segment anonymous_id
{adgroup_name}Tên adgroup, được lấy từ liên kết
{campaign_name}Tên campaign, được lấy từ liên kết
{creative_name}Tên creative, được lấy từ liên kết
{network_name}Tên network, được lấy từ liên kết
{tracker_name}Tên hiện tại của liên kết