受众共享——用户特征

假设您负责以下应用营销工作：

• game_a和game_b两个游戏的运营维护
• game_c的上线发布
• 基于下列用户特征向现有用户定向投放广告：
  • 最喜欢的运动：板球
  • 当前游戏得分：在当前游玩的游戏中获得15分及以上

下表为您CRM中的用户特征数据。创建人群包规则组合时需要这些数据的访问权限。  

在规则组合中使用CRM数据

在受众共享面板中创建用户特征（基于最喜欢的运动以及游戏得分），该操作会向规则组合开放CRM数据的访问权限。 

此场景中的用户特征

规则组合中的用户特征

用户特征在受众共享面板的人群包规则组合中用作用户筛选条件。此示例场景中使用的是营销人员设置的标准（“最喜欢的运动”和“游戏得分”）。 

前期准备：

如需管理应用层级的用户特征，账户下的用户必须获得相关应用的权限。 

请按以下流程设置用户特征：

1. 添加用户特征

2. 完成以下任一操作：

   • 通过CSV文件导入用户特征数据

   • 通过API导入用户特征数据

3. 在规则组合中使用用户特征

请按以下方式添加用户特征：

1. 从AppsFlyer后台的侧边栏中选择互动 > 受众共享。
2. 点击用户特征选项卡。
3. 点击添加用户特征。
   

   

4. 填写下列字段。各字段说明详见下表。 
   
   • 用户特征名称
   • 格式
   • 层级
5. 点击保存。

如需管理用户特征配置，请进入受众共享 > 用户特征选项卡。

仅限账户管理员可以删除用户特征。

从规则组合中删除特定用户特征的方法如下：

1. 将相关用户特征从规则组合中移除。
2. 删除该用户特征。

通过CSV文件添加或移除用户特征数据。以下CSV示例文件符合上文所述的示例场景。

User-attribute-example.csv

CSV文件要求

• 无标题行
• 包含上表中列出的所有字段（列）。 

通过CSV文件导入用户特征数据的方式如下：

1. 进入受众共享 > 用户特征选项卡。
2. 点击导入数据。
3. 选择CSV。
4. 选择以下任一选项：
   • 通过CSV文件
   • 移除数据
5. 选择要导入的CSV文件。 
6. 点击上传，界面会弹出上传状态消息。

请注意：导入用户特征时，AF会使用该用户特征来标记所有关联到同一个CUID的已知设备。举例来说，假设您导入了10个设备（以customer_id区分），并使用“游戏得分”（Game score）标记其用户特征。其中，有一个customer_id关联到了2个设备（即2个GAID带有同一个CUID），则此次数据导入会产生11条用户特征记录。

使用此导入方式时需要准备一条请求路径（Request URL）以及带有用户特征数据的JSON。

1. 在面板中复制现成的API调用请求以及JSON模板。
2. 根据字段要求说明在JSON模板中填入您的数据。 

API请求路径和JSON模板的生成方式如下：

1. 点击导入数据。
2. 选择API。
3. 选择所需操作：
   
   • 更新用户特征：覆盖或添加。
   • 移除用户特征。
   • 移除用户数据：移除于某个特定用户相关的所有数据。AF通过AppsFlyer ID识别用户。
   • 移除应用数据：删除应用级别的所有数据。 
4. 复制生成的API请求路径（Request URL）。
5. 复制生成的API请求体（Request Body）。
6. 按照上文所述的JSON格式准备带有相关用户特征数据的JSON。对于账户层级的用户特征，请将应用ID设置为"app_ids": ["*"]
7. 以上述Request URL和Request Body为基础，编写API请求。
8. 以程序化方式发送该请求。

https://hq1.appsflyer.com/api/user-attributes-import-api/set-user-data
{
  "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
  "attributes_values": [
    {
      "device_id": "",
      "customer_id": "",
      "app_ids": [],
      "attributes": [
        {
          "attribute_key": "",
          "attribute_value": ""
        }
      ]
    }
  ]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "2222222",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 5
                }
                ,
                {
                    "attribute_key": "favorite_sport",
                    "attribute_value": "cricket"
                }
            ]
        }
        ,
        {
            "device_id": "555555-d1d1-d1d1-555-fffffffff",
            "customer_id": "111111",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "order",
                    "attribute_value": 7
                }
                ,
                {
                    "attribute_key": "number",
                    "attribute_value": 8
                }
            ]
        }]
}

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "12345678",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 90
                }
                ,
                {
                    "attribute_key": "favorite-sport",
                    "attribute_value": "cricket"
                }
                ,
                {
                    "attribute_key": "orderNumber",
                    "attribute_value": 93
                }
                ,
                {
                    "attribute_key": "netPromoterScore",
                    "attribute_value": 94
                }
            ]
        }
    ]
}

一般局限性

• CSV/API数据导入方式仅支持整数，不支持小数型数值。举例来说，“score”（得分）参数的值可以是90，但不能是90.5。
• 用户特征数据无法打印或下载。 

• 用户特征的参数值限制：

  • 参数值内不能包含逗号、点或其他特殊字符。
  • 字符串形式的参数值不能超过40个字符。
  • 参数值不能以0开头。

API导入限制

• 每分钟最多可请求350次，每次请求的有效信息（payload）展平后的数据量为10K个设备（若导入1个用户特征，可包含10K个设备；若导入2个用户特征，可包含5K个设备，以此类推）。
• 每个导入请求都必须同时包含device_id和customer_id这两个参数。如果您需要导入的用户特征数据仅包含其中一种标识符，相关调用请求中仍须包含另一种标识符的“header”，并以空字符串填充。比如，假设您需要按device_id导入用户特征数据，但其中不含customer_id信息，则调用请求如下：

"attributes_values": [
{
"device_id": "39e123.......",
"customer_id": "",

详情请见局限性说明部分。

• 添加用户特征值时，每个CSV文件中最多可包含1千万行数据。