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