Licitadores: servicio de perfil de anuncios

Artículo
05/18/2024

Es posible que un miembro propietario del inventario quiera crear "perfiles de aprobación de anuncios" para definir qué tipos de anuncios pueden y no pueden ejecutarse en sus páginas con fines de control de calidad. Ad Profile Service te permite crear tus perfiles de aprobación de anuncios. Una vez creado un perfil de anuncio, puede asociarse a tinyTags individuales a través del servicio TinyTag o establecerse ampliamente en el nivel de miembro a través del Servicio de miembros.

Los perfiles de aprobación constan de tres elementos: miembros, marcas y creativos. Al crear un perfil de anuncio, puedes aprobar o prohibir cada creatividad del sistema individualmente, pero puedes preferir ahorrar tiempo si apruebas o prohíbes marcas o miembros enteros.

Un miembro debe ser de confianza si cree que sus anuncios siempre serán aceptables. Por ejemplo, puede "confiar" en medios específicos para ejecutar anuncios de calidad, de modo que pueda mitigar la necesidad de auditar cada una de sus creatividades.
Una marca debe ser de confianza si cree que los anuncios de esta marca casi siempre serán aceptables. Sin embargo, siempre tendrá la capacidad de prohibir una creatividad específica incluso si forma parte de una marca de "confianza". Si la creatividad específica no está prohibida, se ejecutará de forma predeterminada.
Una marca debe prohibirse si cree que los anuncios de esta marca nunca serán aceptables. No tendrá la capacidad de aprobar una creatividad específica asignada por una marca "prohibida".
El perfil predeterminado (en blanco o id. establecido en 0) prohibirá los anuncios no auditados de otros miembros (es decir, donde el member_id de la creatividad es diferente member_id al de TinyTag).

Rest API

Http (método)	Endpoint	Description
GET	`https://api.adnxs.com/ad-profile/MEMBER_ID`	Ver todos los perfiles de anuncio de un miembro.
GET	`https://api.adnxs.com/ad-profile/MEMBER_ID/AD_PROFILE_ID`	Ver un perfil de anuncio determinado.
POST	`https://api.adnxs.com/ad-profile/MEMBER_ID`	Agregue un nuevo perfil de anuncio.
PUT	`https://api.adnxs.com/ad-profile/MEMBER_ID/AD_PROFILE_ID`	Modifique un perfil de anuncio existente.
DELETE	`https://api.adnxs.com/ad-profile/MEMBER_ID/AD_PROFILE_ID`	Elimine un perfil de anuncio existente.

Campos JSON

Nota:

"Marcas" y "creativos" componen subsecciones del perfil del anuncio.

Perfil de anuncio

Campo	Tipo	Descripción
`active`	booleano	Valor predeterminado: true Estado del perfil de anuncio (activo/inactivo).
`default_brand_status`	enum ('trusted', 'banned')	Estado de marca que se usará de forma predeterminada cuando no se realice ninguna selección explícita.
`description`	string	Descripción opcional
`id`	Entero	Obligatorio activado: actualización Identificador Xandr asignado por la API para hacer referencia a este ad_profile.
`last_activity`	Timestamp	Marca de tiempo de la última modificación de este perfil de anuncio.
`member_id`	Entero	Required Identificador de miembro propietario de esta ad_profile.

Marcas

Campo	Tipo	Description
`id`	Entero	Required Identificador de la marca dentro de la lista de marcas de Xandr.
`status`	enum ('trusted', 'banned')	Required Valor de confianza para la marca especificada. Nota: Si se establece `"trusted"`en `statusbrand`, las creatividades asociadas a esa marca servirán incluso si la categoría general de la marca es `"banned"`. Por ejemplo, si marca la marca "1 y 1 Internet" (id. 17310) como de confianza, las creatividades asociadas a esa marca servirán aunque prohíba su categoría, "Telecomunicaciones" (id. 27). Para obtener identificadores de marca y ver a qué categoría pertenece una marca, use el Servicio de marca. Para los identificadores de categoría, use el servicio category.

Creativos

Campo	Tipo	Descripción
`approved`	booleano	Required Si la creatividad especificada es aprobada o prohibida.
`id`	Entero	Required Identificador de la creatividad dentro del conjunto Xandr de creativos de intercambio.

Members

Campo	Tipo	Description
`id`	Entero	Id. de miembro.
`status`	enum ('trusted', 'banned')	Acción que se usará para las creatividades de un miembro dentro del perfil de anuncio.

Ejemplo

Para crear un nuevo perfil de anuncio, cree un archivo de texto en formato JSON.

A continuación, hemos usado el comando "cat" para generar un archivo JSON de perfil de anuncio de ejemplo.

$ cat ad_profile
{
   "ad_profile":{
      "member_id":25,
      "brands":[
         {
            "id":23,
            "status":"trusted"
         },
         {
            "id":120,
            "status":"banned"
         },
         {
            "id":123,
            "status":"banned"
         }
      ],
      "creatives":[
         {
            "id":4,
            "approved":true
         },
         {
            "id":12,
            "approved":true
         },
         {
            "id":123,
            "approved":false
         }
      ]
   }
}

Agregue este perfil de anuncio a su miembro (25) con una solicitud POST.

$ curl -b cookies -c cookies -d @ad_profile  "https://api.adnxs.com/ad-profile/25"
{
    "response": {
        "status": "OK",
        "id": "50"
    }
}

El identificador del perfil de anuncio es 50. Puede verlo con una solicitud GET.

$ curl -b cookies -c cookies "https://api.adnxs.com/ad-profile/25/50"
{
   "response":{
      "ad_profile":[
         {
            "id":50,
            "member_id":25,
            "brands":[
               {
                  "id":"23",
                  "status":"trusted"
               },
               {
                  "id":"120",
                  "status":"banned"
               },
               {
                  "id":"123",
                  "status":"banned"
               }
            ],
            "creatives":[
               {
                  "id":"4",
                  "approved":"true"
               },
               {
                  "id":"12",
                  "approved":"true"
               },
               {
                  "id":"123",
                  "approved":"false"
               }
            ],
            "active":true,
            "last_activity":"2009-01-03 05:29:57"
         }
      ],
      "status":"OK"
   }
}

Compartir a través de