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" の少なくとも 1 つまたは両方を含める必要があります。 

{
  "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"
      }
    ]
  }
}