Cài đặt Epsilon

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

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

Trước khi bắt đầu

Yêu cầu

• Quyền truy cập Admin, Editor hoặc Custom Editor.
• Adjust SDK phiên bản 4.0.0 trở lên, để liên kết tham số SDK với tham số của Epsilon. Chọn hướng dẫn phù hợp với nền tảng đang sử dụng.

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

Thông tin tài khoản

Company ID và Company Magic

• Để được hỗ trợ tìm thông tin tài khoản, vui lòng liên hệ với đại diện Epsilon.

Chọn Epsilon và ứng dụng trên Campaign Lab

1. Tại mục Campaign Lab, chọn Đối tác.
2. Chọn Đối tác mới > Epsilon. Chọn Tiếp theo để chuyển sang màn hình kế tiếp.
3. Trên 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 Epsilon.
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à Epsilon. Để kích hoạt tính năng chia sẻ dữ liệu:

1. Nhập Company ID và Company Magic.

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

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 Epsilon.

• lượt cài đặt
• phiên truy cập
• lượt cài đặt lại
• sự kiện

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 Epsilon qua callback. Epsilon có thể sử dụng dữ liệu bạn chia sẻ để cải thiện dịch vụ.

1. Tại mục Bạn muốn chia sẻ nguồn dữ liệu nào?, chọn nguồn phân bổ của dữ liệu mà bạn đang chia sẻ cho Epsilon:

• Dữ liệu từ tất cả nguồn phân bổ
• Chỉ chia sẻ dữ liệu đã được phân bổ cho Epsilon

Phiên truy cập

Adjust không tự động gửi callback phiên truy cập, vì số lượng dữ liệu là rất lớn. Nếu bạn chọn chia sẻ dữ liệu phiên truy cập, Epsilon sẽ nhận được dữ liệu liên quan đến hoạt động truy cập ứng dụng.

Lượt gỡ cài đặt và cài đặt lại

Nếu bạn chọn chia sẻ dữ liệu lượt gỡ cài đặt (uninstall) hoặc cài đặt lại (reinstall), Epsilon sẽ nhận được tất cả dữ liệu liên quan đến lượt gỡ cài đặt và/hoặc lượt cài đặt lại do Adjust đo lường.

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

Nếu bạn chọn chia sẻ dữ liệu doanh thu in-app, Epsilon 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à Epsilon 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 Epsilon.

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 Epsilon 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 Epsilon, 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 Epsilon.

3. Tại mục Sự kiện đối tác , chọn sự kiện của Epsilon, đả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, Epsilon 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 Epsilon 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, Epsilon 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 Epsilon.

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 Epsilon. Như vậy, Epsilon 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 Epsilon, thực hiện các bước sau.

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

   • Xem mục Trước khi bắt đầu của tất cả liên kết nền tảng phát triển 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.

Định cấu hình cho liên kết và cài đặt

Bạn có thể cài đặt các thành phần sau:

• Cấu trúc liên kết (Link structure)
• Trang đến (User destination)
• Cài đặt phân bổ

Tạo liên kết và chia sẻ liên kết cho Epsilon

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
• Tham số cấu trúc (Link structure parameters)
• Trang đến (User destination)
• Cài đặt phân bổ

Chọn Tạo liên kết để tạo click URL, impression URL, mã QR và link token. Sau khi liên kết được tạo, tính năng chia sẻ dữ liệu và tích hợp Epsilon sẽ được kích hoạt.

Sau khi tạo xong liên kết, chia sẻ liên kết cho Epsilon để Epsilon đưa liên kết vào chiến dịch quảng cáo.

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

Epsilon 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 một 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 Epsilon. 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 Epsilon chấp nhận:

Parameter key> Value

• dtm_fid*> mã định danh biểu mẫu

• dtm_promo_id*> giá trị xác định loại trang

• dtm_email_hash> hàm băm SHA-256 của địa chỉ email khách hàng. Xóa khoảng trắng ở đầu hoặc ở cuối địa chỉ email, sau đó chuyển địa chỉ email về chữ thường trước khi chạy lệnh băm

• dtm_mobile_hash> hàm băm SHA-256 của số điện thoại di động khách hàng; định dạng số điện thoại: mã quốc gia + mã vùng không có số 0 đứng đầu + số thuê bao. Loại bỏ mọi ký tự đặc biệt.

• dtm_user_id> mã định danh duy nhất. Không thể là PII hay địa chỉ email đã được băm

• dtmc_tcf_string**> chuỗi cho biết sự đồng ý GDPR

• dtmc_department***> tên của gian hàng trong chế độ xem hiện tại

• dtmc_category***> tên của danh mục trong chế độ xem hiện tại

• dtmc_sub_category***> tên của danh mục phụ trong chế độ xem hiện tại

• dtmc_product_id****> product ID trong chế độ xem hiện tại

• dtmc_brand****> thương hiệu sản xuất

• dtmc_upc****> mã UPC của nhà sản xuất

• dtmc_mpn***> mã số linh kiện của nhà sản xuất

• dtmc_transaction_id*****> mã định danh của hệ thống khách hàng dành cho mỗi lượt chuyển đổi

• dtmc_items> tất cả mặt hàng liên quan đến lượt chuyển đổi, dạng mảng. Mỗi mặt hàng cần chứa các thông tin sau

  • product_id: SKU của mặt hàng
  • item_amount: giá của một mặt hàng
  • item_quantity: số lượng mặt hàng SKU trong giao dịch
  • item_discount: giá trị chiết khấu so với số tiền ban đầu

• dtmc_conv_type> phân biệt các loại sự kiện trong mua bán online: giao hàng, nhận hàng,...

• dtmc_conv_store_location> đối với loại nhận hàng, cho biết vị trí của cửa hàng nơi lấy hàng

** bắt buộc*

*** bắt buộc ở những khu vực bị áp dụng hạn chế theo quy định của GDPR*

**** áp dụng có điều kiện - chỉ bắt buộc nếu biết thông tin, bao gồm cả sự kiện sản phẩm*

**** Áp dụng có điều kiện - chỉ bắt buộc với sự kiện xem sản phẩm

****** Bắt buộc khi giao dịch*

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

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