Dữ liệu thô API Pull

Cao cấp

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.

PullAPIRaw_us-en.png

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:

  1. AppsFlyerAdmin_us-en.pngNhận mã thông báo API. Quản trị viên cần truy xuất mã thông báo.
  2. 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.
  3. 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.
  4. 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ừ
  • Phạm vi ngày bao gồm thông số ngày bắt đầuvà ngày kết thúc. Ngày tháng liên quan đến ngày hoạt động.
  • Định dạng: yyyy-mm-ddyyyy-mm-dd hh:mm hoặc yyyy-mm-dd hh:mm:ss Lưu ý: Dấu cách cần được mã hóa như được trình bày tại đây from=2020-04-01%2001:00:00 - Thông thường, các trình duyệt sẽ mã hóa dấu cách. 
  • Ví dụ: 2010-01-01 hoặc 2010-01-01 20:15 (Thông số giờ và phút khả dụng cho báo cáo dữ liệu thô). 
tới Ngày kết thúc. Đối với from

media_source

media_source: Để giới hạn (lọc) lệnh gọi trong một nguồn truyền thông cụ thể.

Đặt cả thông số media_source và category như sau:

  • Đối với quảng cáo Meta, hãy đặt danh mục và nguồn truyền thông thành facebook
  • Đối với Twitter, hãy đặt danh mục và nguồn truyền thông thành twitter
  • Đối với tất cả các nguồn truyền thông khác, hãy đặt danh mục thành tiêu chuẩn và nguồn truyền thông thành tên của nguồn truyền thông.
  • Ví dụ:
    • media_source=facebook&category=facebook
    • media_source=abc_example&category=standard
maximum_rows

Số hàng tối đa được trả về bởi một lệnh gọi API.

  • [Mặc định] nếu không gửi giá trị nào, tối đa 200K hàng
  • 200000: Trả về tối đa 200 nghìn hàng
  • 1000000: Trả về tối đa 1 triệu hàng
  • Ví dụ: maximum_rows=1000000 cho phép tối đa 1 triệu hàng. 
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ụevent_name=af_purchase,ftd 

reattr

Đặt dữ liệu nhắm mục tiêu lại cho phân bổ.

  • [Mặc định] Nếu false, sẽ trả về các chiến dịch dữ liệu thu hút người dùng (UA).
  • Nếu true, sẽ trả về dữ liệu nhắm mục tiêu lại cho phân bổ.
  • Ví dụ:reattr=true
additional_fields

Để có được các trường bổ sung ngoài các trường mặc định. 

Ví dụ: additional_fields=device_download_time,deeplink_url

tiền tệ

Đơn vị tiền tệ của doanh thu và chi phí

  • [Mặc định] Nếu thông số không được gửi đi, dữ liệu sẽ trả về là USD. Có nghĩa là, kết quả sẽ trả về bằng USD nếu bạn không cần thực hiện bất kỳ thao tác nào.
  • Nếu bạn gửi, currency=preferred thì đơn vị tiền tệ dành riêng cho ứng dụng sẽ được sử dụng. Nghĩa là đơn vị tiền tệ được đặt trong phần cài đặt của ứng dụng.

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 currency=preferredthì các giá trị trả về bằng EUR.

Múi giờ

[Mặc định] Dữ liệu trả về bằng cách sử dụng UTC.

  • Để lấy được dữ liệu trong múi giờ dành riêng cho ứng dụng, hãy thêm múi giờ như được trình bày trong phần này vào lệnh gọi: 
  •  timezone=[Numerical value] 
  • Ví dụ: Đối với múi giờ UTC+10:00, hãy sử dụngtimezone=+10:00 Lưu ý+,- và : cần được mã hóa. Ví dụ: +10:00 mã hóa thành %2B10%3A00
đị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ụ: geo=ZA

from_install time
  • Phạm vi ngày bao gồm thông số ngày bắt đầuvà ngày kết thúc. Ngày tháng liên quan đến ngày hoạt động.
  • Định dạng: yyyy-mm-dd
  • Ví dụ: 2010-01-01 
to_install_time

Ngày kết thúc. Cho from_install time

đại lý

Để giới hạn (lọc) lệnh gọi chỉ một đại lý cụ thể.

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

  • from=2019-12-29
  • Bắt đầu vào ngày này, vào đầu ngày lúc 00:00

ngày kết thúc=yyyy-mm-dd 12:00

Ví dụ:

  • to=2019-12-29 12:00
  • Tiếp tục đến 11:59:59, không gồm 12:00 

Tùy chọn A: Lệnh gọi API thứ hai 

 

Ví dụ: 

&from=2019-12-29 12:00&to=2019-12-29

  • Bắt đầu từ trưa ngày 29 tháng 12 năm 2019
  • Kết thúc vào lúc nửa đêm ngày 29 tháng 12 năm 2019
 

from=yyyy-mm-dd 12:00

Ví dụ:

  • from=2019-12-29 12:00
  • Bắt đầu từ và gồm cả 12:00

 

to=yyyy-mm-dd

Ví dụ:

  • to=2019-12-29
  • Kết thúc vào lúc nửa đêm

 

Tùy chọn B: Lệnh gọi API thứ hai

from=yyyy-mm-dd 12:00

Ví dụ:

  • from=2019-12-29 12:00
  • Bắt đầu từ và gồm cả 12:00

to=yyyy-mm-dd+1 00:00

+1 = ngày hôm sau lúc 00:00

Ví dụ:

  • to=2019-12-30 00:00
  • Có nghĩa là trước bất kỳ thời điểm nào đã qua trong ngày 30 tháng 12.

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.

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 AppsFlyerAdmin_us-en.pngMã thông báo V2.0
Truy cập mạng quảng cáo Không
Truy cập đại lý
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 
Múi giờ riêng cho ứng dụng
Tính cập nhật của dữ liệu
  • Tương đương với tính khả dụng của dữ liệu trong bảng điều khiển tổng quan.
  • Các báo cáo được cập nhật với độ trễ vài giờ:
    • Sự kiện trong ứng dụng
      tự nhiên
  • Báo cáo được cập nhật Hàng ngày:
    • Gỡ cài đặt
    • Sự kiện trong ứng dụng hậu phân bổ
    • Doanh thu Quảng cáo
Dữ liệu lịch sử Có.  Theo các chính sách giữ chân người dùnggiới hạn lưu lượng
Dữ liệu không tự nhiên
Dữ liệu tự nhiên
Giới hạn tỷ lệ

Giới hạn API cho dữ liệu thô

Hạn chế về kích thước
  • Các lệnh gọi API trả về số hàng tối đa là 200K/1M.
  • Nếu một báo cáo có đúng 200K/1M hàng, thì giả sử là có các hàng bị thiếu.
  • Sử dụng thông số maximum_rows để chọn số hàng tối đa.
  • Thực hiện nhiều lệnh gọi API, sử dụng thông số bắt đầu/kết thúc bao gồm cả thời gian trong ngày.
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ố timezone. Nếu không, dữ liệu sẽ được gửi bằng UTC chứ không phải múi giờ ứng dụng của bạn.