Cài đặt Ogury

Ogury là mạng quảng cáo có tích hợp với Adjust. Sau khi tích hợp với Adjust, Ogury 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 Ogury. 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 Ogury.

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 Ogury. Chọn hướng dẫn phù hợp với nền tảng đang sử dụng.

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

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

Bật nút Kích hoạt

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

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:

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

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

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 Ogury:

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

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, Ogury 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à Ogury 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 Ogury.

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 Ogury 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 Ogury, thực hiện các bước sau tại mục Liên kết sự kiện .

Chọn Liên kết sự kiện.
Mở danh sách Sự kiện của Adjust , chọn sự kiện mà bạn muốn chia sẻ cho Ogury.
Tại mục Sự kiện đối tác , chọn sự kiện của Ogury, đả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.
Chọn Áp dụng .

Giờ đây, Ogury 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 Ogury 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, Ogury 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.

Đị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:

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

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 Ogury sẽ được kích hoạt.

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

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

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

Trường dữ liệu	Thông tin
`{adid}`	Adjust device ID (tất cả nền tảng)
`{android_id}`	Android ID (chỉ áp dụng với Android)
`{click_attribution_window}`	Khung thời gian phân bổ được cài đặt cho device matching (tính theo giờ)
`{country}`	Mã quốc gia gồm hai ký tự
`{currency}`	Mã tiền tệ gốc theo ISO 4217, do Adjust SDK gửi đến
`{device_name}`	Số hiệu của thiết bị
`{gps_adid}`	Google Play Store advertising ID
`{idfa}`	ID dành cho nhà quảng cáo (advertiser) (chỉ áp dụng với iOS)
`{impression_attribution_window}`	Khung thời gian phân bổ được cài đặt cho impression matching (tính theo giờ)
`{ip_address}`	Địa chỉ IP của thiết bị
`{label}`	Giá trị của tham số "label", đây là tham số của Adjust và được gửi khi xảy ra lượt click
`{language}`	Mã ngôn ngữ gồm hai ký tự
`{match_type}`	Phương pháp phân bổ
`{mcc}`	Mã quốc gia thông tin di động (MCC): gồm ba chữ số, dùng để nhận dạng quốc gia nơi thiết bị được đăng ký sử dụng. Sử dụng thêm mã mạng di động (MNC) để nhận dạng nhà cung cấp dịch vụ trên thiết bị.
`{mnc}`	Mã mạng di động (MNC): bao gồm hai chữ số. Sử dụng thêm mã quốc gia thông tin di động (MCC) để nhận dạng nhà cung cấp dịch vụ trên thiết bị.
`{os_name}`	Hệ điều hành của thiết bị
`{os_version}`	Số phiên bản của hệ điều hành
`{revenue_float}`	Doanh thu được gửi từ Adjust SDK, đã được làm tròn theo quy ước của đơn vị tiền tệ
`{sdk_version}`	Phiên bản Adjust SDK (của từng ứng dụng)
`{timezone}`	Múi giờ
`{adgroup_name}`	Tên adgroup, được lấy từ trình theo dõi
`{click_time}`	Dấu thời gian của lượt click được phân bổ
`{connection_type}`	Loại kết nối internet
`{created_at}`	Dấu thời gian của hoạt động
`{creative_name}`	Tên creative, được lấy từ trình theo dõi
`{impression_based}`	1 nếu là tương tác đến từ việc xem quảng cáo, 0 nếu không phải
`{impression_time}`	Dấu thời gian của lượt hiển thị được phân bổ
`{install_begin_time}`	Thời điểm ứng dụng bắt đầu được tải xuống (chỉ áp dụng với Android và Google Play Store)
`{install_finish_time}`	Thời điểm ứng dụng được tải xuống hoàn tất
`{installed_at}`	Dấu thời gian của lượt cài đặt (tức là, lần mở ứng dụng đầu tiên)
`{tracker_name}`	Tên hiện tại của trình theo dõi