API Nhóm người

Tiêu đề yêu cầu

Sử dụng các thông số bộ lọc sau để có được dữ liệu cần thiết. 

Sử dụng các thông số nhóm sau để gộp các cột bổ sung và giúp báo cáo của bạn ít chi tiết hơn.

• Bảng liệt kê các KPI có sẵn và các chức năng liên quan của chúng. Khi bạn gọi ra một KPI, tất cả các chức năng của API đó sẽ trả về.
• Các KPI sau luôn trả về: người dùng, ecpi và chi phí 
• Chọn một KPI bổ sung cho mỗi lệnh gọi.

Trình bày các hàm KPI

Các thông số định dạng KPI sau đây đặt định dạng của KPI được trả về. 

Ví dụ này chứa lệnh gọi API hoàn chỉnh.

curl -L -X POST 'https://hq1.appsflyer.com/api/cohorts/v1/data/app/<insert your app_id here>?format=<insert results format here>' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <cohort_api_token_placeholder. Note the token has more than 700 characters.>' \
-H 'Accept: application/json' \
--data-raw '{
    "cohort_type": "user_acquisition",
    "min_cohort_size": 1,
    "preferred_timezone": false,
    "from": "2020-01-01",
    "to": "2020-01-31",
    "filters": {
        "period": [
            0,
            1,
            2,
            10,
            30,
            60
        ],
        "geo": [
            "US",
            "CN"
        ],
        "pid": [
            "Meta ads",
            "googleadwords_int"
        ]
    },
    "preferred_currency": true,
    "aggregation_type": "on_day",
    "per_user": false,    
    "groupings": [
        "pid",
        "date"
    ],
    "kpis": [
        "sessions"
    ]
}'

import http.client
import mimetypes
conn = http.client.HTTPSConnection("hq1.appsflyer.com")
payload = "{\r\n    \"cohort_type\": \"user_acquisition\",\r\n    \"min_cohort_size\": 1,\r\n    \"preferred_timezone\": false,\r\n    \"from\": \"2020-05-01\",\r\n    \"to\": \"2020-05-10\",\r\n    \"preferred_currency\": true,\r\n    \"aggregation_type\": \"cumulative\",\r\n    \"per_user\": false,   \r\n     \"groupings\": [\r\n               \"pid\",\r\n         \"date\"\r\n        ],\r\n    \"kpis\": [\r\n        \"roas\"\r\n    ]\r\n}"
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer [Enter token here]',
  'Accept': 'application/json',
  'Content-Type': 'application/json'
}
conn.request("POST", "/api/cohorts/v1/data/app/[My App ID here]?format=csv", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
   

Ví dụ 1: Giữ chân

Tỷ lệ giữ chân nguồn phương tiện (phiên) của người dùng đã cài đặt ứng dụng trong tháng 1 vào ngày 7, 14 và 28 

{
  "per_user": false,
  "groupings": [
    "pid"
  ],
  "filters": {
    "period": [
      7, 14, 28
    ]
  },
  "partial_data": false,
  "aggregation_type": "on_day",
  "min_cohort_size": 1,
  "cohort_type": "user_acquisition",
  "from": "2021-01-01",
  "to": "2021-01-30",
  "kpis": [
    "sessions"
  ]
}

Ví dụ 2: Giao dịch mua trong chiến dịch

Doanh thu sau cài đặt nhóm người của ngày 3 trên mỗi chiến dịch

{  
  "per_user": false,
  "groupings": [
    "c"
  ],
  "filters": {
    "period": [
      3
    ],
    "c":[
        "example_campaign_name"
    ]
  },
  "partial_data": false,
  "aggregation_type": "cumulative",
  "min_cohort_size": 1,
  "cohort_type": "user_acquisition",
  "from": "2021-01-01",
  "to": "2021-01-30",
  "kpis": [
    "Checkout Start"
  ]
}

Ví dụ 3: Hoạt động ngày hôm qua
Người dùng đã chuyển đổi (cài đặt, tương tác lại, phân bổ lại) trong khoảng thời gian chuyển đổi nhất định đã thực hiện hoạt động gì vào ngày hôm qua? 

Dữ liệu sử dụng có sẵn qua Nhóm người cho Data Locker. Khoảng thời gian chuyển đổi được giới hạn trong 360 ngày trước đó. 

Tên được phân bổ cho tệp CSV trả về được tạo từ truy vấn API. Cấu trúc được trình bày chi tiết trong bảng sau.

Tên tệp CSV mẫu

cohort_aggregation_type_per_user_kpi_report_app_id_from_to_timezone_currency_hash.csv

Khoảng thời gian đề cập đến ngày sau phân bổ, trong đó khoảng thời gian 0 là ngày phân bổ. Ví dụ, người dùng cài đặt ứng dụng vào ngày 1 tháng 1. Đây là ngày phân bổ. Giao dịch mua được thực hiện vào khoảng thời gian 0 có nghĩa là giao dịch được thực hiện vào ngày 1 tháng 1. Giao dịch mua được thực hiện vào khoảng thời gian 3 có nghĩa là giao dịch mua đó được thực hiện vào ngày 4 tháng 1. Tương tự, người dùng cài đặt vào ngày 11 tháng 1 thì đây là khoảng thời gian 0. Giao dịch mua được thực hiện vào ngày 14 tháng 1 sẽ là khoảng thời gian 3.

Nếu phạm vi ngày báo cáo của bạn là từ ngày 1 tháng 1 đến ngày 11 tháng 1 thì những người dùng được phân bổ (đã cài đặt) trong khoảng thời gian này sẽ được đưa vào báo cáo. Không đưa vào các dữ liệu khác. 

• Giá trị của khoảng thời gian có thể là một hoặc nhiều giá trị từ 0-180 sau đây. Ví dụ: 0, 1, 2, 30, 180. 
• Nếu không có khoảng thời gian nào được chỉ định, thì các giá trị mặc định là 0, 1, 2, v.v. cho đến 30, 60, 90 và 180 sẽ được trả về.  

{
    "cohort_type": "user_acquisition",
    "min_cohort_size": 1,
    "preferred_timezone": false,
    "from": "2019-12-01",
    "to": "2020-01-01",
    "filters": {
        "period": [
            0,
            1,
            2
        ]
    },
    "aggregation_type": "on_day",
    "per_user": false,
    "groupings": [
        "pid"
    ],
    "kpis": [
        "revenue"
    ]
}

Các số liệu tiếp theo ánh xạ giao diện người dùng phân tích Nhóm người với các thông số API. Hai giải pháp - API và giao diện người dùng tương tự nhau nhưng không tương đồng. 

Phiên bản API có các tùy chọn bổ sung sau:

• Lựa chọn tiền tệ
• Lựa chọn múi giờ
• Lọc theo khoảng thời gian

Điểm khác biệt giữa các loại tổng hợp