用于 Singular 反作弊的发布商黑名单 API

关注
Avatar
Product Team
Updated

获取发布商黑名单

用途

使用此端点检索在 Singular 反作弊产品中配置的发布商黑名单。

方法 端点
GET https://api.singular.net/api/fraud/blacklists

查询参数

参数 是否必填 格式 描述 示例
api_key v String Singular 控制台中提供的 API 密钥
blacklist_type v String 黑名单类型。应设置为 "publisher" publisher
csv v String 如果为 "true",输出将以 csv 格式返回 true

输出示例 

{
  "data": {
    "Google AdWords": [
      {
        "publisher_name": "AdMob Publisher",
        "publisher_id": "ca-app-pub-123456789"
      },
      {
        "publisher_hashed_id": "abc123def456",
        "sub_publisher": "sub_pub_001"
      }
    ]
  }
}

设置发布商黑名单

用途

使用此端点上传供 Singular 反作弊产品使用的发布商黑名单。上传黑名单将覆盖现有黑名单。

要应用增量更改:

  1. 使用 GET 端点检索当前黑名单
  2. 修改检索到的 "data" 负载以反映您的更新
  3. 使用 POST 重新上传修改后的完整负载
方法 端点
POST https://api.singular.net/api/fraud/blacklists?api_key= [api_key] &blacklist_type=publisher
Body

请求体必须包含一个 "data" 对象。在此对象中,每个键代表一个合作伙伴名称(Singular 报告中的 "source"),值是与该合作伙伴关联的发布商对象的数组。每个发布商对象必须至少包含 "publisher_name" 和 "publisher_id" 中的一个或两个。 

{
  "data": {
    "<Partner Name>": [
      {
        "publisher_name": "<Publisher Name>",
        "publisher_id": "<Publisher ID>"
      },
      ..
    ],
    "<Another Partner Name>": [
      {
        "publisher_name": "<Publisher Name>",
        "publisher_id": "<Publisher ID>"
      },
      ..
  }
}

示例请求体 

{
  "data": {
    "Google AdWords": [
      {
        "publisher_name": "AdMob Publisher",
        "publisher_id": "ca-app-pub-123456789"
      },
      {
        "publisher_hashed_id": "abc123def456",
        "sub_publisher": "sub_pub_001"
      }
    ]
  }
}