Method: accountTypes.accounts.insights.retrieve

Truy xuất thông tin chi tiết về dữ liệu tiếp thị cho một danh sách người dùng nhất định.

Tính năng này chỉ dành cho các đối tác dữ liệu.

Tiêu đề uỷ quyền:

Phương thức này hỗ trợ các tiêu đề không bắt buộc sau đây để xác định cách API cho phép truy cập vào yêu cầu:

  • login-account: (Không bắt buộc) Tên tài nguyên của tài khoản mà Tài khoản Google của thông tin đăng nhập là người dùng. Nếu không được đặt, giá trị mặc định sẽ là tài khoản của yêu cầu. Định dạng: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (Không bắt buộc) Tên tài nguyên của tài khoản có một đường liên kết đến sản phẩm đã thiết lập với login-account. Định dạng: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

Yêu cầu HTTP

POST https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/insights:retrieve

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Tài khoản mẹ sở hữu danh sách người dùng. Định dạng accountTypes/{accountType}/accounts/{account}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "baseline": {
    object (Baseline)
  },
  "userListId": string
}
Trường
baseline

object (Baseline)

Bắt buộc. Đường cơ sở cho thông tin chi tiết được yêu cầu.
userListId

string

Bắt buộc. Mã danh sách người dùng mà bạn yêu cầu thông tin chi tiết.

Nội dung phản hồi

Thông báo phản hồi cho DM API MarketingDataInsightsService.RetrieveInsights

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
Trường
marketingDataInsights[]

object (MarketingDataInsight)

Chứa thông tin chi tiết về dữ liệu tiếp thị.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/datamanager

Đường cơ sở

Tiêu chí cơ sở để so sánh thông tin chi tiết.

Biểu diễn dưới dạng JSON 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
Trường
Trường nhóm baseline. Vị trí cơ sở dùng để so sánh thông tin chi tiết. baseline chỉ có thể là một trong những trạng thái sau:
baselineLocation

object (Location)

Vị trí cơ sở của yêu cầu. Vị trí cơ sở là danh sách OR của các khu vực được yêu cầu.
locationAutoDetectionEnabled

boolean

Nếu được đặt thành true, dịch vụ sẽ cố gắng tự động phát hiện vị trí cơ sở cho thông tin chi tiết.

Thông tin vị trí

Vị trí cơ sở của yêu cầu. Vị trí cơ sở nằm trong danh sách OR của mã vùng ISO 3166-1 alpha-2 của các vùng được yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "regionCodes": [
    string
  ]
}
Trường
regionCodes[]

string

Danh sách mã vùng gồm 2 chữ cái theo định dạng ISO 3166-1.

MarketingDataInsight

Thông tin chi tiết về dữ liệu tiếp thị.

Tính năng này chỉ dành cho các đối tác dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "attributes": [
    {
      object (MarketingDataInsightsAttribute)
    }
  ]
}
Trường
dimension

enum (AudienceInsightsDimension)

Phương diện mà thông tin chi tiết thuộc về.
attributes[]

object (MarketingDataInsightsAttribute)

Thông tin chi tiết về các giá trị của một phương diện nhất định.

AudienceInsightsDimension

Các phương diện có thể dùng để tạo thông tin chi tiết.

Enum
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Chưa chỉ định.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Giá trị không xác định trong phiên bản này.
AFFINITY_USER_INTEREST UserInterest có mối quan hệ liên kết.
IN_MARKET_USER_INTEREST UserInterest đang cân nhắc mua hàng.
AGE_RANGE Độ tuổi.
GENDER Một giới tính.

MarketingDataInsightsAttribute

Thông tin chi tiết cho một tập hợp các thuộc tính có liên quan của cùng một phương diện.

Biểu diễn dưới dạng JSON 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
Trường
userInterestId

string (int64 format)

Mã nhận dạng mối quan tâm của người dùng.
lift

number

Mức tăng mà đối tượng có được cho giá trị thuộc tính so với đường cơ sở. Phạm vi [0-1].
ageRange

enum (AgeRange)

Phạm vi độ tuổi của đối tượng mà mức tăng được cung cấp.
gender

enum (Gender)

Giới tính của đối tượng mà mức tăng được cung cấp.

Độ Tuổi

Phạm vi độ tuổi nhân khẩu học

Enum
AGE_RANGE_UNSPECIFIED Chưa chỉ định.
AGE_RANGE_UNKNOWN Không xác định.
AGE_RANGE_18_24 Từ 18 đến 24 tuổi.
AGE_RANGE_25_34 Từ 25 đến 34 tuổi.
AGE_RANGE_35_44 Từ 35 đến 44 tuổi.
AGE_RANGE_45_54 Từ 45 đến 54 tuổi.
AGE_RANGE_55_64 Từ 55 đến 64 tuổi.
AGE_RANGE_65_UP Từ 65 tuổi trở lên.

Giới tính

Loại giới tính nhân khẩu học (ví dụ: nữ).

Enum
GENDER_UNSPECIFIED Chưa chỉ định.
GENDER_UNKNOWN Không xác định.
GENDER_MALE Nam.
GENDER_FEMALE Nữ.