API de lista negra de publishers para prevenção de fraude da Singular

Seguir
Avatar
Product Team
Updated

Obter lista negra de publishers

Uso

Use este endpoint para obter a lista negra de publishers configurada no produto de prevenção de fraude da Singular.

Método Endpoint
GET https://api.singular.net/api/fraud/blacklists

Parâmetros de consulta

Parâmetro Obrigatório Formato Descrição Exemplo
api_key v String Chave de API fornecida no console da Singular
blacklist_type v String O tipo de lista negra. Deve ser definido como "publisher" publisher
csv v String Formatará a saída em csv se for "true" true

Exemplo de saída 

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

Definir lista negra de publishers

Uso

Use este endpoint para fazer upload de uma lista negra de publishers para uso no produto de prevenção de fraude da Singular. O upload de uma lista negra substituirá a lista negra existente.

Para aplicar alterações incrementais:

  1. Use o endpoint GET para obter a lista negra atual
  2. Modifique o payload "data" obtido para refletir suas atualizações
  3. Faça o upload novamente do payload modificado completo usando POST
Método Endpoint
POST https://api.singular.net/api/fraud/blacklists?api_key= [api_key] &blacklist_type=publisher
Body

O corpo da solicitação deve incluir um objeto "data". Dentro desse objeto, cada chave representa o nome de um parceiro ("source" nos relatórios da Singular) e o valor é um array de objetos de publisher associados ao parceiro. Cada objeto de publisher deve incluir pelo menos um ou ambos de "publisher_name" e "publisher_id". 

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

Exemplo de corpo de solicitação 

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