腾讯广告

客户文件人群

客户文件人群（CUSTOMER FILE AUDIENCE）是指您可以将想要用于广告投放的用户的ID以TXT文件或压缩包的形式上传至DMP，随后即可在广告投放端对这些用户进行定向投放。目前支持的用户ID类型及说明如下表所示：

使用Marketing API实现客户文件人群来进行定向投放，您需要完成以下步骤：

• 1、使用custom_audiences/add 创建一个人群
• 2、往创建好的文件人群中上传数据文件
• 3、将人群用于定向

接下来，将详细介绍每个步骤的接口调用情况。

1、使用custom_audiences/add 创建一个人群

此时您需要指定人群类型为客户文件人群（CUSTOMER_FILE），例如创建一个名称为“100万加密IMEI”的文件人群，接口调用示例如下：

curl 'https://api.e.qq.com/v1.1/custom_audiences/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -H 'Content-Type: application/json' \
    -d '{
        "account_id" : <ACCOUNT_ID>,
        "name" : "100万加密IMEI",
        "description" : "100万加密IMEI测试",
        "type" : "CUSTOMER_FILE"
    }'

返回示例：

{
    "code": 0,
    "message": "",
    "data": {
        "audience_id": 2837392
    }
}

2、往创建好的文件人群中上传数据文件

你可以调用custom_audience_files/add接口往文件人群中上传数据文件，一个人群可以上传多个数据文件。例如往第1步创建的人群中上传一个加密IMEI号码包文件，请求示例如下：

curl 'https://api.e.qq.com/v1.1/custom_audience_files/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -F "account_id=<ACCOUNT_ID>" \
    -F "audience_id=2837392" \
    -F "user_id_type=HASH_IMEI" \
    -F "file=@<FILE_PATH>"  

注：数据文件上传完成后，需要等待服务端处理，通常情况我们会承诺会在24小时内处理完成。您可以随时通过查看该数据文件的status来了解是否处理完成。只是文件处理完成后，对应的人群覆盖人数才会符合您的预期。

3、将人群用于定向

例如创建一个新的定向，定向条件为前面创建的文件人群，其示例如下：

curl 'https://api.e.qq.com/v1.1/targetings/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -H 'Content-Type: application/json' \
    -d '{
        "account_id":<ACCOUNT_ID>,
        "targeting_name":"使用100万加密IMEI号码包",
        "targeting":{
            "custom_audience":[2837392]
        }
    }'

返回示例：

{
    "code":0,
    "message":"",
    "data": {
        "targeting_id": 12345
    }
}

如果您希望排除前面创建的文件人群，您可以创建如下定向：

curl 'https://api.e.qq.com/v1.1/targetings/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -H 'Content-Type: application/json' \
    -d '{
        "account_id":<ACCOUNT_ID>,
        "targeting_name":"排除使用100万加密IMEI号码包",
        "targeting":{
            "excluded_custom_audience":[2837392]
        }
    }'

返回示例：

{
    "code":0,
    "message":"",
    "data": {
        "targeting_id": 23456
    }
}

最后您可将创建好的定向（targeting_id）应用于一条或多条广告，即可实现广告的精准定向。

有关客户文件人群读写接口的更详细说明，可以参考 接口清单-Audience。

有关人群数据文件接口及人群增减的更详细说明，可以参考 接口清单-Custom Audience File。

有关人群定向接口的更详细说明，可以参考 接口清单-Targeting。