Khái quát: Sử dụng API này để truy cập các báo cáo dữ liệu thô trong tệp tin CSV.
Dữ liệu thô API Pull
- API Pull cho phép bạn truy cập các báo cáo dữ liệu thô trong tệp tin CSV. Tìm hiểu thêm về báo cáo dữ liệu thô
- Bộ lọc theo các tùy chọn có sẵn: Nguồn truyền thông, phạm vi ngày, tên sự kiện trong ứng dụng, và địa lý.
- Các khả năng khác trong API Pull là:
- Chọn đơn vị tiền tệ
- Chọn múi giờ
Báo cáo dữ liệu thô có sẵn qua API Pull
Báo cáo | Mô tả | Tần suất làm mới |
---|---|---|
Báo cáo dữ liệu thô (không tự nhiên) | ||
Lượt cài đặt | Ghi nhận lượt cài đặt không tự nhiên. Bản ghi được tạo khi người dùng mở ứng dụng lần đầu. |
Thời gian thực |
Sự kiện trong Ứng dụng | Ghi nhận các sự kiện được người dùng thực hiện. |
Thời gian thực |
Gỡ cài đặt | Ghi nhận khi người dùng gỡ cài đặt ứng dụng. |
Hàng ngày |
Lượt cài đặt lại |
Ghi nhận những người dùng mà sau khi gỡ cài đặt ứng dụng sẽ tương tác với nguồn truyền thông UA và cài đặt lại ứng dụng trong khung thời gian phân bổ lại. | Thời gian thực |
Báo cáo dữ liệu thô (tự nhiên) |
||
Lượt cài đặt tự nhiên |
Ghi nhận khi người dùng mở ứng dụng lần đầu. |
Liên tục |
Sự kiện trong ứng dụng tự nhiên |
Ghi nhận thông tin chi tiết về các sự kiện do người dùng thực hiện. |
Liên tục |
Các lượt gỡ cài đặt tự nhiên |
Ghi nhận người dùng gỡ cài đặt ứng dụng. |
Hàng ngày |
Lượt cài đặt lại tự nhiên |
Ghi nhận doanh thu quảng cáo cho người dùng được phân bổ cho nguồn truyền thông nhắm mục tiêu lại trong khung thời gian thu hút lại. |
Hàng ngày |
Dữ liệu thô về doanh thu quảng cáo |
||
Doanh thu quảng cáo được phân bổ |
Ghi nhận doanh thu quảng cáo cho người dùng được phân bổ cho một nguồn truyền thông. | Hàng ngày |
Doanh thu quảng cáo tự nhiên | Ghi nhận doanh thu quảng cáo cho người dùng không được phân bổ cho nguồn truyền thông. | Hàng ngày |
Gian lận Protect360 | ||
Lượt cài đặt | Ghi nhận lượt cài đặt được xác định là gian lận và do đó không được phân bổ cho bất kỳ nguồn truyền thông nào. | Thời gian thực |
Lượt cài đặt hậu phân bổ | Ghi nhận các sự kiện trong ứng dụng từ các lượt cài đặt gian lận và do đó hoàn toàn không được phân bổ. | Thời gian thực |
Sự kiện trong Ứng dụng | Ghi nhận các sự kiện trong ứng dụng được Protect360 xác định là gian lận. | Hàng ngày |
Sự kiện trong ứng dụng hậu phân bổ | Ghi nhận các sự kiện trong ứng dụng đối với các lượt cài đặt được xác định là gian lận sau khi được phân bổ cho một nguồn truyền thông hoặc bị đánh giá là gian lận mà không liên quan đến chính lượt cài đặt đó. | Hàng ngày |
Lượt nhấp | Ghi nhận các lượt nhấp được người dùng thực hiện bị Protect360 chặn. | Hàng ngày |
Postback lượt cài đặt bị chặn | Ghi nhận các bản sao của các đăng lại được gửi đến nguồn truyền thông dẫn đến lượt cài đặt bị chặn. | Thời gian thực |
Đăng lại | ||
Các đăng lại lượt cài đặt | Ghi nhận các sự kiện cài đặt được tạo khi người dùng mở ứng dụng lần đầu. | Hàng ngày |
Postback Sự kiện trong Ứng dụng | Ghi nhận các đăng lại sự kiện trong ứng dụng được gửi đến nguồn truyền thông. | Hàng ngày |
Nhắm mục tiêu lại các đăng lại sự kiện trong ứng dụng | Ghi nhận các sự kiện trong ứng dụng mà người dùng đã thực hiện trong khung thời gian thu hút lại. | Thời gian thực |
Đăng lại lượt chuyển đổi nhắm mục tiêu lại | Ghi nhận các sự kiện trong ứng dụng mà người dùng đã thực hiện trong khung thời gian thu hút lại. | Thời gian thực |
Sử dụng dữ liệu thô API Pull
Để sử dụng dữ liệu thô API Pull:
- Nhận mã thông báo API. Quản trị viên cần truy xuất mã thông báo.
- Cung cấp cho nhà phát triển của bạn mã thông báo API cần dùng trong tiêu đề xác thực.
- Cung cấp cho nhà phát triển các thông số đầu vào khi họ thực hiện lệnh gọi API, như được mô tả trong phần tiếp theo. Các thông số xác định nội dung chính trong báo cáo, cách tổ chức báo cáo và cung cấp khung thời gian báo cáo.
- Yêu cầu nhà phát triển làm theo hướng dẫn về dữ liệu thô API Pull trong trung tâm nhà phát triển.
Tham số
Tham số | Mô tả |
---|---|
từ |
|
tới |
Ngày kết thúc. Đối với from
|
media_source |
Đặt cả thông số
|
maximum_rows |
Số hàng tối đa được trả về bởi một lệnh gọi API.
|
event_name |
Lọc sự kiện trong ứng dụng theo các sự kiện được chỉ định. Chọn nhiều sự kiện bằng cách sử dụng danh sách được phân tách bằng dấu phẩy. Ví dụ: |
reattr |
Đặt dữ liệu nhắm mục tiêu lại cho phân bổ.
|
additional_fields |
Để có được các trường bổ sung ngoài các trường mặc định. Ví dụ: |
tiền tệ |
Đơn vị tiền tệ của doanh thu và chi phí
Ví dụ: Nếu đơn vị tiền tệ dành riêng cho ứng dụng là EUR, bằng cách gửi |
Múi giờ |
[Mặc định] Dữ liệu trả về bằng cách sử dụng UTC.
|
địa lý |
Lọc dữ liệu theo mã quốc gia. Giới hạn: Bạn chỉ có thể đặt một bộ lọc mã quốc gia cho mỗi lệnh gọi API. Ví dụ: |
from_install time |
|
to_install_time |
Ngày kết thúc. Cho |
đại lý |
Để giới hạn (lọc) lệnh gọi chỉ một đại lý cụ thể. |
Trường Protect360
Trường Khung thời gian
Nếu kết quả API vượt quá mức tối đa, hãy chia báo cáo theo giờ và phút. Áp dụng những điều sau:
- from/to: yyyy-mm-dd hh:mm
-
from:
- Chỉ ngày = từ đầu (00:00) của ngày đã chọn
- Ngày và giờ = từ và bao gồm cả 00:00
-
Thông số to:
- Chỉ ngày = đến cuối (24:00) của ngày đã chọn
- Ngày và giờ = đến, nhưng không bao gồm, thời gian hiển thị
Ví dụ: Chủ sở hữu ứng dụng có 1300K lượt cài đặt hàng ngày từ tất cả các nguồn. Để vượt qua giới hạn 1 triệu hàng, chủ sở hữu ứng dụng chia ngày thành hai lệnh gọi URI 12 giờ. Xem các tùy chọn trong bảng sau.
Gọi API | Ngày bắt đầu | Đến |
---|---|---|
Lệnh gọi API thứ nhất |
from=yyyy-mm-dd Ví dụ:
|
ngày kết thúc=yyyy-mm-dd 12:00 Ví dụ:
|
Tùy chọn A: Lệnh gọi API thứ hai
Ví dụ:
|
from=yyyy-mm-dd 12:00 Ví dụ:
|
to=yyyy-mm-dd Ví dụ:
|
Tùy chọn B: Lệnh gọi API thứ hai |
from=yyyy-mm-dd 12:00 Ví dụ:
|
to=yyyy-mm-dd+1 00:00 +1 = ngày hôm sau lúc 00:00 Ví dụ:
|
Lưu ý: Sử dụng tùy chọn A hoặc B vì cả hai đều có cùng kết quả. |
Các Trưởng Bổ Sung
Các trường báo cáo bổ sung không được thêm vào danh sách trường mặc định để các trường mới không ảnh hưởng đến quá trình nhập và xử lý của bạn. Sử dụng thông số additional_fields
để truy cập các trường không phải trường mặc định.
- Mỗi lần chỉ liệt kê một trường.
- Xem danh sách các trường khả dụng.
-
Ví dụ:
additional_fields=device_download_time,deeplink_url
Trường mặc định
Các trường API Pull mặc định |
---|
Thời gian tiếp xúc được phân bổ |
Thời gian cài đặt |
Thời gian sự kiện |
Tên của sự kiện |
Giá trị của sự kiện |
Doanh thu sự kiện |
Tiền tệ doanh thu sự kiện |
Doanh thu sự kiện USD |
Nguồn sự kiện |
Biên nhận đã được xác nhận chưa |
Đối tác |
Nguồn truyền thông |
Kênh |
Từ khóa |
Chiến dịch |
ID Chiến dịch |
Bộ quảng cáo |
ID Bộ quảng cáo |
Quảng cáo |
ID Quảng cáo |
Loại Quảng cáo |
ID trang |
ID Trang phụ |
Thông số phụ 1 |
Thông số phụ 2 |
Thông số phụ 3 |
Thông số phụ 4 |
Thông số phụ 5 |
Mô hình Chi phí |
Giá trị Chi phí |
Đơn vị tiền tệ của chi phí |
Đối tác Người đóng góp 1 |
Nguồn phương tiện Người đóng góp 1 |
Chiến dịch Người đóng góp 1 |
Loại tương tác Người đóng góp 1 |
Thời gian tương tác Người đóng góp 1 |
Đối tác Người đóng góp 2 |
Nguồn phương tiện Người đóng góp 2 |
Chiến dịch Người đóng góp 2 |
Loại tương tác Người đóng góp 2 |
Thời gian tương tác Người đóng góp 2 |
Đối tác Người đóng góp 3 |
Nguồn phương tiện Người đóng góp 3 |
Chiến dịch Người đóng góp 3 |
Loại tương tác Người đóng góp 3 |
Thời gian tương tác Người đóng góp 3 |
Vùng |
Mã quốc gia |
Bang |
thành phố |
Mã bưu chính |
DMA |
ip |
wifi |
người điều hành |
nhà cung cấp dịch vụ |
ngôn ngữ |
ID AppsFlyer |
ID quảng cáo |
IDFA |
ID Android |
Customer User ID |
imei |
IDFV |
nền tảng |
Loại thiết bị |
Phiên bản hệ điều hành |
Phiên bản ứng dụng |
Phiên bản SDK |
ID ứng dụng |
Tên ứng dụng |
ID gói |
Đang nhắm mục tiêu lại |
Loại lượt chuyển đổi nhắm mục tiêu lại |
Xem lại phân bổ |
Cửa sổ Tương tác lại |
Là phân bổ chính |
Tác nhân người dùng |
Liên kết giới thiệu HTTP |
URL gốc |
Thông tin bổ sung
Đặc điểm và hạn chế
Đặc điểm | Nhận xét |
---|---|
Loại mã thông báo API bắt buộc | Mã thông báo V2.0 |
Truy cập mạng quảng cáo | Không |
Truy cập đại lý | Có |
Tính minh bạch của agency | Có. Tuy nhiên, xin lưu ý rằng nếu bạn sử dụng cả bộ lọc đại lý và bộ lọc nguồn truyền thông, thì bộ lọc nguồn truyền thông không áp dụng cho các đại lý không minh bạch. Điều này có nghĩa là đối với các đại lý không minh bạch, tất cả dữ liệu đều được đưa vào; không chỉ dữ liệu từ các nguồn truyền thông được lọc. |
Tiền tệ dành riêng cho ứng dụng | Có |
Múi giờ riêng cho ứng dụng | Có |
Tính cập nhật của dữ liệu |
|
Dữ liệu lịch sử | Có. Theo các chính sách giữ chân người dùng và giới hạn lưu lượng. |
Dữ liệu không tự nhiên | Có |
Dữ liệu tự nhiên | Có |
Giới hạn tỷ lệ |
Giới hạn API cho dữ liệu thô. |
Hạn chế về kích thước |
|
Install_date from và install_date_to | Phạm vi ngày cài đặt phải trước phạm vi ngày hoạt động. |
Xử lý sự cố
Dấu hiệu/thông báo | Giải pháp |
---|---|
Báo cáo không chứa dữ liệu được dự kiến theo phạm vi thời gian được chọn hoặc có sự khác biệt giữa báo cáo dữ liệu thô và báo cáo dữ liệu hợp nhất. |
Xác minh rằng bạn đã đặt thông số |