Tạo đối tượng So khớp khách hàng

Tạo đối tượng So khớp khách hàng bằng cách gửi CreateUserListRequest.

Tạo nội dung yêu cầu

Tạo tài nguyên UserList. Sau đây là các trường phổ biến cần đặt.

displayName

Bắt buộc Tên hiển thị của danh sách. Tên này không được trùng với tên của bất kỳ danh sách nào khác mà tài khoản sở hữu.

description

Nội dung mô tả ngắn gọn về danh sách.

integrationCode

Mã nhận dạng trong hệ thống của bạn.

membershipDuration

Thời gian một thành viên trong phân khúc đối tượng vẫn nằm trong danh sách sau khi được thêm. Giá trị phải tương ứng với số ngày nguyên. Nếu không được đặt, giá trị mặc định sẽ là giá trị tối đa.

Nếu bạn sử dụng JSON, hãy tính số giây bằng cách nhân số ngày của thời lượng với 86400 (số giây mỗi ngày). Sau đó, đặt giá trị thành kết quả của phép nhân, theo sau là s. Ví dụ: nếu bạn muốn thời hạn thành viên là 90 ngày, hãy sử dụng giá trị 7776000s vì 90 * 86400 = 7776000.

Nếu sử dụng định dạng vùng đệm giao thức, hãy dùng phương thức thuận tiện để tạo đối tượng Duration dựa trên số ngày, nếu có phương thức thuận tiện như vậy. Ví dụ: thư viện protobuf-java-util cho Java có phương thức tiện lợi fromDays(). Nếu không, hãy tính số giây bằng cách nhân số ngày của thời lượng với 86400 (số giây mỗi ngày) và sử dụng kết quả để đặt trường seconds của đối tượng Duration.

Các trường bắt buộc cho tính năng So khớp khách hàng

Trường ingestedUserListInfo là trường bắt buộc đối với đối tượng So khớp khách hàng.

Dưới đây là các trường cần đặt trên IngestedUserListInfo dựa trên loại dữ liệu mà bạn muốn sử dụng để thêm thành viên trong phân khúc đối tượng vào danh sách.

Danh sách thông tin liên hệ

Đặt các trường sau nếu bạn muốn sử dụng thông tin liên hệ (địa chỉ email, số điện thoại hoặc địa chỉ đã băm) để xác định thành viên trong phân khúc đối tượng:

uploadKeyTypes

Đặt thành một danh sách chứa loại khoá tải lên CONTACT_ID.

Danh sách uploadKeyTypes chỉ được chứa một mục.

contactIdInfo

Đặt thành thông báo ContactIdInfo với dataSourceType được đặt thành giá trị thích hợp từ enum DataSourceType.

Danh sách Mobile ID

Đặt các trường sau nếu bạn muốn sử dụng Mobile ID để xác định thành viên trong phân khúc đối tượng:

uploadKeyTypes

Đặt thành một danh sách chứa loại khoá tải lên MOBILE_ID.

Danh sách uploadKeyTypes chỉ được chứa một mục.

mobileIdInfo

Đặt thành một MobileIdInfo thông báo:

• Đặt dataSourceType thành giá trị thích hợp từ enum DataSourceType.

• Đặt keySpace thành IOS hoặc ANDROID.

• Đặt appId thành chuỗi xác định duy nhất ứng dụng di động mà dữ liệu được thu thập.

  • Đối với iOS, chuỗi mã nhận dạng là chuỗi gồm 9 chữ số xuất hiện ở cuối URL của cửa hàng ứng dụng. Ví dụ: 476943146 cho ứng dụng "Flood-It!" có đường liên kết đến App Store là https://apps.apple.com/us/app/flood-it/id476943146.

  • Đối với Android, chuỗi mã nhận dạng là tên gói của ứng dụng. Ví dụ: com.labpixies.flood cho ứng dụng "Flood-It!" có đường liên kết đến Google Play là https://play.google.com/store/apps/details?id=com.labpixies.flood.

Danh sách mã nhận dạng người dùng

Đặt các trường sau nếu bạn muốn sử dụng mã nhận dạng người dùng để xác định thành viên trong phân khúc đối tượng:

uploadKeyTypes

Đặt thành một danh sách chứa loại khoá tải lên USER_ID.

Danh sách uploadKeyTypes chỉ được chứa một mục.

Tạo yêu cầu

Để tạo đối tượng So khớp khách hàng, hãy tạo một yêu cầu create cho tài nguyên UserList.

1. Đặt trường parent thành tên tài nguyên của tài khoản. Tên tài nguyên phải theo định dạng accountTypes/{accountType}/accounts/{account}.

2. Sử dụng UserList mà bạn đã tạo cho phần nội dung của yêu cầu.

3. Nếu thông tin đăng nhập của bạn không phải của một Tài khoản Google là người dùng trên parent, hãy đặt tiêu đề như mô tả trong phần Định cấu hình đích đến và tiêu đề.

Dưới đây là các yêu cầu mẫu ở định dạng JSON cho các loại thông tin người dùng khác nhau. Mỗi yêu cầu đặt membershipDuration thành 2592000s, trong đó 2592000 là số giây trong 30 ngày. Nhấp vào nút Open in API Explorer (Mở trong Trình khám phá API) để thử gửi một yêu cầu.

{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Gửi yêu cầu

Gửi yêu cầu và nếu cần, hãy thêm tiêu đề của yêu cầu, chẳng hạn như login-account hoặc linked-account.

Nếu yêu cầu thành công, phản hồi sẽ chứa UserList đã tạo, trong đó các trường chỉ có đầu ra id và name được điền sẵn.

Nếu yêu cầu không thành công, hãy kiểm tra lỗi để xác định nguyên nhân gây ra lỗi, cập nhật yêu cầu và tiêu đề để khắc phục mọi vấn đề, sau đó gửi yêu cầu và tiêu đề đã cập nhật.