创建目标客户匹配受众群体

通过发送 CreateUserListRequest创建目标客户匹配受众群体。

构建请求正文

创建 UserList 资源。以下是要设置的常用字段。

displayName
必需 ：名单的显示名称。该名称在账号拥有的所有名单中必须是唯一的。
description
名单的简要说明。
integrationCode
来自您系统的 ID。
membershipDuration

受众群体成员添加到名单后在名单中保留的时长。该值必须对应于完整的天数。如果未设置，则默认为最大值。

如果使用 JSON，请将时长天数乘以 86400（每天的秒数）来计算秒数。然后将该值设置为乘法结果，后跟 s。例如，如果您希望成员资格有效期为 90 天，请使用值 7776000s，因为 90 * 86400 = 7776000。

如果使用协议缓冲区格式，请使用便捷方法根据天数构建 Duration 对象（如果存在此类便捷方法）。例如，适用于 Java 的 protobuf-java-util 库具有 fromDays() 便捷方法。否则，请将时长天数乘以 86400（每天的秒数）来计算秒数，并使用该结果设置 Duration 对象的 seconds 字段。

目标客户匹配的必填字段

对于目标客户匹配受众群体，ingestedUserListInfo 字段是必填字段。

以下是根据您要用于向名单中添加受众群体成员的数据类型，在 IngestedUserListInfo 上设置的字段。

联系信息名单

如果您想使用联系信息（经过哈希处理的电子邮件地址、电话号码或地址）来定义受众群体成员，请设置以下字段：

uploadKeyTypes

设置为包含 CONTACT_ID 上传密钥 类型的列表。

uploadKeyTypes 列表必须仅包含一个条目。

contactIdInfo

设置为 ContactIdInfo 消息，并将 dataSourceType 设置为 DataSourceType 枚举中的相应值。

移动 ID 名单

如果您想使用移动 ID 来定义受众群体成员，请设置以下字段：

uploadKeyTypes

设置为包含 MOBILE_ID 上传密钥 类型的列表。

uploadKeyTypes 列表必须仅包含一个条目。

mobileIdInfo

设置为 MobileIdInfo 消息：

用户 ID 名单

如果您想使用用户 ID 来定义受众群体成员，请设置以下字段：

uploadKeyTypes

设置为包含 USER_ID 上传密钥 类型的列表。

uploadKeyTypes 列表必须仅包含一个条目。

构建请求

如需创建目标客户匹配受众群体，请为 UserList 资源构建 create 请求。

  1. 将 parent 字段设置为账号的资源名称。资源名称必须采用 accountTypes/{accountType}/accounts/{account_id} 格式。

  2. 将您构建的 UserList 用于请求的正文。

  3. 如果您的凭据不适用于作为 parent的用户的 Google 账号，请按照配置目标位置和 标头中的说明设置标头。

以下是针对不同类型的用户信息提供的 JSON 格式的请求示例。 每个请求都将 membershipDuration 设置为 2592000s，其中 2592000 是 30 天的秒数。点击 Open in API Explorer 按钮即可试用请求。

联系信息

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

移动 ID

在 API Explorer 中打开 
{
    "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"
}

用户 ID

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

发送请求

发送请求，并在需要时添加 请求标头。

如果请求成功，响应将包含已创建的 UserList，其中填充了 id 和 name。请记下这些字段中的值，因为您需要在向受众群体添加受众群体成员的请求中使用这些值。

如果请求失败，请检查错误以确定失败原因 ，更新请求和标头以解决任何问题，然后发送 更新后的请求和标头。

上一页
概览
下一页
向受众群体上传成员