Incorporar Publicidad a mi Pagina
Este documento tiene como fin dar una guía para que un programador pueda incluir Publicidad Integrada de Tuidd en su sitio.
Se debe incluir el siguiente código:
|
|
Incluir un contenedor con el siguiente código fuente de ejemplo:
|
<div class='tuidd-embedded-advertising' data-slot='457ay33i633992k13m817431v1z38hb2' data-layout='300x250' data-sitekey='18CBB71C-81FB-8B2D-5B64-E399275752AF' data-source='ANY' data-filter='{ "gender":"M", "language":"es", "age_range":[4,5,6], "category":["18"], "exception":["Nike"]}' > </div >
|
|
Campo |
Tipo |
Requerido |
Descripción |
|
class |
String |
Obligatorio |
'tuidd-embedded-advertising' |
|
data-layout |
String |
Obligatorio |
Indica el tamaño del anuncio. Los valores posibles:
|
|
data-source |
String |
Opcional |
Restringe el origen de la publicidad, para indicar si se desea recibir publicidad propia solamente o también de terceros. Los valores posibles son:
Si no se especifica este campo, el valor por defecto es ANY . |
|
data-slot |
String |
Obligatorio |
Es un identificador del espacio destinado para la publicidad. |
|
data-sitekey |
String |
Obligatorio |
Token de publicidad del sitio, obtenido desde el portal de gestión de Tuidd, cuando se registra el sitio. |
|
data-filter |
Object |
Opcional |
JSON con los filtros para personalizar los tipos de publicidad a mostrar.
|
Para la selección de la publicidad a mostrar tuidd realiza un filtrado de las publicidades disponibles. Para ello tuidd utiliza los datos del perfil del usuario que vienen en el request (ej edad, ciudad, etc) más la información que tuidd almacena. Esto se combina con la configuración de filtrado (segmentación) cargada en cada publicidad, que define el target al cual está dirigida (Por ej: personas entre 18 y 55 años, que vivan en asunción o ciudad del este).
Existen 3 etapas, dos de filtrado y otra de selección de publicidad basada en el orden de relevancia.
La Fase I se realiza usando filtros estáticos". Un filtro estático es un filtro que permite hacer una primera preselección del set de publicidades a elegir de forma rápida (algunos de ellos son por ej: edad y genero).
La Fase II de filtrado se usa un criterio de filtro llamado "filtros duros y blandos". Este segundo proceso de filtrado se llama filtrado dinámico y se hace recorriendo el set de datos obtenido en la Fase I. Todas las condiciones de filtros duros que no coincidan hacen que esa publicidad se descarte, mientras que los filtros blandos que machean se asigna un puntaje que se computa en la fase III. Cuando no coincide un dato del usuario con la segmentación de la publicidad, resta puntaje de relevancia a dicha publicidad. (Algunos filtros blandos son ej: idioma, región, dispositivo, etc)
Fase III Al finalizar la fase II cada publicidad del set tiene un puntaje que representa el valor de relevancia de esa publicidad, basado en la coincidencia o no entre los datos del usuario y la segmentación de cada publicidad. Donde las publicidades que más puntaje tienen son las más relevantes. La publicidad que se elige es la más relevante de todas. Si hay más de una publicidad con el mismo valor de relevancia se toma una al azar.
Clasificacion de filtros
(E)Estatico/ Dinamico: (S)Blando/(H)Duro
-
País (E): País en el que se encuentra el usuario (valor único)
-
Idioma (E): Idioma del país o del usuario si está definido
-
Rubro (S): Identifica el tipo de publicidad, ejemplo: Electrónica, Retail, etc
-
Genero (S): Hombre o Mujer. Si no se pasa es indistinto
-
Región (H): Región pude ser una provincia o distrito dependiendo del país (valor único)
-
Ciudad (H): Ciudad en el que se encuentra el usuario (valor único)
-
Edad (S): Valor por rango de edades
-
Dispositivo (S): Compara el dispositivo (Tablet, Celuar, etc) por el cual el usuario accede a la publicidad.
-
MesCumpleanos (S): Mes informado por el usuario si existe.
-
PoderAdquisitivo (S): Valor cuantitativo basados en la escala estándar de poder adquisitivo
-
Excepciones (H): Indica las marcas (brands) que serán excluidas. Esto es para evitar que aparezca una publicidad de la competencia en su página.
Los campos son:
|
Campo |
Tipo |
Requerido |
Descripción |
|
gender |
String |
Opcional |
Valores posibles: "M": Masculino; "F": Femenino;
Valor por defecto es "todos".
|
|
language |
String |
Opcional |
Códigos de idioma según la ISO 639-1. Ej: "es": español "en": inglés "pt": portugués
|
|
age |
Arreglo |
Opcional |
Rangos de edades, según la siguiente lista:
|
|
category |
Arreglo |
Opcional |
IDs de los rubros de las publicidades que quiero incluir. Sólo soporta 3 IDs . A partir del tercero serán ignorados. Ver listado de category abajo.
|
|
purchasing_power |
Entero |
Opcional |
Poder adquisitivo del usuario. Los valores posibles son:
|
|
location |
Location |
Opcional |
Ubicación del usuario. Es un elemento de tipo Location (definido en esta sección).
|
|
exception |
Arreglo |
Opcional |
Listado de marcas anunciantes a exceptuar. |
Listado de rubros para el filtro de las publicidades:
|
ID |
Descripcion |
|
1 |
Administración Publica |
|
2 |
Agro e Industria |
|
3 |
Animales y Mascotas |
|
4 |
Arte y Cultura |
|
5 |
Automóviles y Vehículos |
|
6 |
Belleza y Fitness |
|
7 |
Ciencia y Técnica |
|
8 |
Computación y Electrónica |
|
9 |
Contenido para Adultos |
|
10 |
Deportes |
|
11 |
Educación y Carrera Profesional |
|
12 |
Entretenimiento |
|
13 |
Gastronomía |
|
14 |
Hogar y Jardín |
|
15 |
Indumentaria y Calzado |
|
16 |
Inmobiliaria y Contrucción |
|
17 |
Internet y Telecomunicaciones |
|
18 |
Negocios y Finanzas |
|
19 |
Noticias y Media |
|
20 |
Personas y Sociedad |
|
21 |
Productos alimenticios |
|
22 |
Recreación y Hobbies |
|
23 |
Red Social y Blog |
|
24 |
Referencia y Documentación |
|
25 |
Salud y Servicios Sociales |
|
26 |
Shopping y Comercios |
|
27 |
Transporte y Logística |
|
28 |
Viajes y Alojamiento |
|
29 |
Videojuegos |
|
64 |
Otros |
Representa una forma de identificar la ubicación del usuario. La misma contiene diversas formas de localización según la información disponible. Si se incluye la localización al menos uno de los campos debe estar presente. Si ambos campos tienen valores se tomará el de geoloc.
|
Campo |
Tipo |
Requerido |
Descripción |
|
geoloc |
Geoloc |
Opcional |
Localización por coordenadas. Es un elemento de tipo Geoloc. |
|
georef |
Georef |
Opcional |
Localización por nombre de referencia. Es un elemento de tipo Georef |
Localización definida como un par de coordenadas latitud (lat) - longitud (lon) en formato wgs84 (World Geodetic System).
|
Campo |
Tipo |
Requerido |
Descripción |
|
lat |
String |
Requerido |
Formato (wgs84) Ej: 42.54391 |
|
long |
String |
Requerido |
Formato (wgs84) |
Localización a través de referencia de ubicaciones conocidas. La misma se puede dar por alguno de estos los 2 métodos:
1- El nombre de la ciudad en idioma inglés.
2- El ISO (3166) correspondiente a la región.
|
Campo |
Tipo |
Requerido |
Descripción |
|
city |
String |
Opcional |
Nombre de la ciudad en inglés Ej: Beijing |
|
Region |
String |
Opcional |
ISO-3166 puede ser: 1 [Código de país] Donde: Ejemplo: |