API de lista negra de publishers para la prevención de fraude de Singular

Seguir
Avatar
Product Team
Updated

Obtener lista negra de publishers

Uso

Usa este endpoint para obtener la lista negra de publishers configurada en el producto de prevención de fraude de Singular.

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

Parámetros de consulta

Parámetro Obligatorio Formato Descripción Ejemplo
api_key v String Clave de API proporcionada en la consola de Singular
blacklist_type v String El tipo de lista negra. Debe establecerse en "publisher" publisher
csv v String Formateará la salida en csv si es "true" true

Ejemplo de salida 

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

Establecer lista negra de publishers

Uso

Usa este endpoint para subir una lista negra de publishers que se usará en el producto de prevención de fraude de Singular. Al subir una lista negra se sobrescribirá la lista existente.

Para aplicar cambios incrementales:

  1. Usa el endpoint GET para obtener la lista negra actual
  2. Modifica el payload "data" obtenido para reflejar tus actualizaciones
  3. Vuelve a subir el payload modificado completo usando POST
Método Endpoint
POST https://api.singular.net/api/fraud/blacklists?api_key= [api_key] &blacklist_type=publisher
Body

El cuerpo de la solicitud debe incluir un objeto "data". Dentro de este objeto, cada clave representa el nombre de un partner ("source" en los reportes de Singular) y el valor es un array de objetos de publisher asociados al partner. Cada objeto de publisher debe incluir al menos uno o ambos de "publisher_name" y "publisher_id". 

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

Ejemplo de cuerpo de solicitud 

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