Submenu desarrolladores

Incorporar publicidade

 

Introdução

O objetivo deste documento é fornecer um guia para um programador para incluir a Publicidade Integrada da Tuidd em seu site.

 

Inclusão da biblioteca

O código a seguir deve ser incluído:

 

 

<script type="text/javascript" src="https:// <dominio >/jsservice/public/js/tuidd-emb-ad-v1.0.0.min.js />

 

 

Consumo de Serviço

Inclua um contêiner com o seguinte código-fonte de exemplo:

 

 

 

<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 >

 

 

Detalhe dos campos

 

Campo

Tipo

Requerido

Descripción

class

String

Obligatorio

'tuidd-embedded-advertising'

data-layout

String

Obligatorio

Indica o tamanho do anúncio. Os valores possíveis:

 

  • 300x250

  • 728x90

  • 160x600

  • 468x60

  • 120x600

  • 300x100

  • 88x31

  • 300x600

  • 336x280

  • 320x50

 

 

data-source

String

Opcional

Restringir a origem da publicidade, para indicar se você deseja receber apenas sua própria publicidade ou também de terceiros.

Os valores possíveis são:

  • OWN : publicidad propia.

  • THIRD_PARTY : publicidad de terceros.

  • ANY : cualquier tipo de publicidad.

Se este campo não for especificado, o valor padrão será ANY .

data-slot

String

Obligatorio

É um identificador do espaço destinado à publicidade.

data-sitekey

String

Obligatorio

Token de publicidade do site, obtido do portal de gerenciamento da Tuidd, quando o site é registrado.

data-filter

Object

Opcional

JSON com filtros para personalizar os tipos de publicidade a serem exibidos.

 

 

Filtro

Para selecionar os anúncios a serem exibidos, o tuidd filtra os anúncios disponíveis. Para isso, o tuidd utiliza os dados do perfil do usuário incluídos na solicitação (por exemplo, idade, cidade, etc.), além das informações armazenadas pelo tuidd. Isso é combinado com as configurações de filtragem (segmentação) carregadas em cada anúncio, que definem o público-alvo ao qual ele é direcionado (por exemplo, pessoas entre 18 e 55 anos, residentes em Assunção ou Ciudad del Este).

Existem três etapas: duas para filtragem e outra para seleção de anúncios com base na relevância.

 

A Fase I é realizada com filtros estáticos. Um filtro estático é um filtro que permite uma pré-seleção inicial rápida do conjunto de anúncios a serem escolhidos (alguns dos quais são, por exemplo, idade e sexo).

 

A Fase II da filtragem utiliza um critério de filtragem denominado "filtros rígidos e flexíveis". Este segundo processo de filtragem é denominado filtragem dinâmica e é realizado analisando o conjunto de dados obtido na Fase I. Todas as condições do filtro rígido que não correspondem fazem com que o anúncio seja descartado, enquanto os filtros flexíveis que correspondem atribuem uma pontuação que é calculada na Fase III. Quando os dados de um usuário não correspondem à segmentação do anúncio, a pontuação de relevância do anúncio é subtraída. (Alguns filtros suaves são, por exemplo, idioma, região, dispositivo, etc.)

 

Fase III: Ao final da Fase II, cada anúncio do conjunto recebe uma pontuação que representa seu valor de relevância, com base na correspondência ou não dos dados do usuário com a segmentação do anúncio. Os anúncios com a pontuação mais alta são os mais relevantes. O anúncio selecionado é o mais relevante de todos. Se houver mais de um anúncio com o mesmo valor de relevância, um será escolhido aleatoriamente.

Classificação do filtro

(E)Estático/Dinâmico: (S)Suave/(H)Difícil

  • País (E): País onde o usuário está localizado (valor único)

  • Idioma (E): Idioma do país ou do usuário, se definido

  • Campo (S): Identifica o tipo de publicidade, por exemplo: Eletrônicos, Varejo, etc.

  • Gênero (S): Masculino ou Feminino. Se não for aprovado, não importa.

  • Região (H): A região pode ser uma província ou distrito, dependendo do país (valor único)

  • Cidade (H): Cidade onde o usuário está localizado (valor único)

  • Idade (I): Valor por faixa etária

  • Dispositivo (I): Compara o dispositivo (Tablet, Celular, etc.) pelo qual o usuário acessa o anúncio.

  • Mês de Aniversário (I): Mês informado pelo usuário, se existir.

  • Poder de Compra (P): Valor quantitativo baseado na escala padrão de poder de compra

  • Exceções (H): Indica as marcas que serão excluídas. Isso evita que anúncios de concorrentes apareçam em sua página.

 

 

Os campos são:

 

Campo

Tipo

Obrigatório

Descrição

gender

String

Opcional

Valores possíveis:

“M”: Masculino;

“F”: Feminino;

 

O valor padrão é "all".

 

language

String

Opcional

Códigos de idioma de acordo com a norma ISO 639-1.

Ex:

“es”: Espanhol

Ej:

“es”: español

“en”: inglés

"pt": Português

 

age

Arranjo

Opcional

Faixas etárias, de acordo com a lista a seguir:

  • 1: "0–14",

  • 2: "15–18",

  • 2: "15-18",

  • 4: "25-34",

  • 5: "35-44",

  • 6: "45–59",

  • 7: "60+"

 

category

Disposição

Opcional

IDs das categorias dos anúncios que desejo incluir. Só suporta 3 IDs. . Após o terceiro, eles serão ignorados. Veja a lista de categorias abaixo.

 

purchasing_power

Integer

Opcional

Poder de compra do usuário. Os valores possíveis são:

  • 1: "Baixo-Baixo",

  • 2: "Baixo",

  • 3: "Médio-Baixo",

  • 4: "Médio 4",

  • 5: "Médio-Alto",

  • 6: "Alto",

 

location

Localização

Opcional

Localização do usuário. É um elemento do tipo Localização (definido nesta seção).

 

exception

Arranjo

Opcional

Lista de marcas de publicidade a serem excluídas.

 

Category

Lista de itens para o filtro de publicidade:

 

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

 

 

Localização

Representa uma maneira de identificar a localização do usuário. Contém várias formas de localização, dependendo das informações disponíveis. Se a localização for incluída, pelo menos um dos campos deve estar presente. Se ambos os campos tiverem valores, o campo geoloc será usado.

Campo

Tipo

Obrigatório

Descrição

geoloc

Geolocalização

Opcional

Localização por coordenadas. É um elemento do tipo Geoloc.

georef

Georef

Opcional

Nome da localização por referência. É um elemento do tipo Georef

 

 

Geoloc

Localização definida como um par de coordenadas de latitude (lat) - longitude (lon) no formato wgs84 (World Geodetic System).

Campo

Tipo

Obrigatório

Descrição

lat

String

Obrigatório

Formato (wgs84)

Ex: 42.54391
Ex: -43.251

long

String

Obrigatório

Formato (wgs84)
Ex: 138.5167

 

 

Georef

Localização por referência a locais conhecidos. Isso pode ser feito por um destes 2 métodos:

1- O nome da cidade em inglês.

2- A norma ISO (3166) correspondente à região.

Campo

Tipo

Obrigatório

Descrição

City

String

Opcional

Nome da cidade em inglês

Ex: Pequim

Region

String

Opcional

ISO-3166 pode ser:

1 [Código do país]
2 [Código do país]-[Código da região]

Onde:
[Código do país]: Dois caracteres (consulte o padrão)
[Código da região]: 1 a 3 caracteres

Exemplo:
Para a Argentina, o código será “AR”
Para a Argentina, província de Buenos Aires “AR-B”

 

 

Entity Pager Example