In-Store Display Ads

Siga o passo-a-passo abaixo para implantar inventário de Telas Digitais junto a sua plataforma de Retail Media powered by Zaply Ads.

Documento em Revisão. Estamos trabalhando em novas funcionalidades na plataforma que irão impactar esta funcionalidade. Revise suas dúvidas de implantação de Display Ads e anúncios em Telas Digitais junto a  suporte@zaply.com.br 



1 - Crie os slots de inventário de Telas Digitais na plataforma Zaply Ads

Acesse a plataforma Zaply Ads e crie os slots de telas de suas lojas que deseja gerir via plataforma.


https://slite.com/api/files/SZtQ9NDLe9v2TP/2024-05-22_10-05.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiOEltdExsTTlxUm10Q00iLCJpYXQiOjE3Mjk1Njg1NjAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiaUlHc3ZMczVSR0RjNUEiLCJleHAiOjE3MzIxNjA1NjB9.2P-WKGv25t8rw47-Zp7k1HfHtOjaxZOkqMXz65HLXfk

Cada slot criado terá um identificador único (ID) que será utilizado nas requisições a API de Zaply Ads, para solicitar o resultado do leilão de anúncios, que definirá qual o anúncio ganhador e criativo que deverá aparecer.


https://slite.com/api/files/Dv7xNwJ3p30NXu/dashboard%20personalizado%20(18).png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiOEltdExsTTlxUm10Q00iLCJpYXQiOjE3Mjk1Njg1NjAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiaUlHc3ZMczVSR0RjNUEiLCJleHAiOjE3MzIxNjA1NjB9.2P-WKGv25t8rw47-Zp7k1HfHtOjaxZOkqMXz65HLXfk

Durante a configuração dos slots poderá ser definido um criativo padrão, que poderá ser utilizado como fallback para entregar um criativo específico caso aquele slot não tenha nenhum anúncio atribuído com campanha ativa.

Sugerimos criar nomes de fácil identificação que permita a identificação da loja, local/corredor, ou categoria/tipo, permitindo assim ao anunciante um mapeamento facilitado do targeting de suas campanhas.



2 - Integre via API os anúncios de Zaply Ads a sua plataforma de gestão de Telas Digitais

Para integração da camada de anúncios junto as Telas Digitais de suas lojas, é necessário uma requisição à API da Zaply Ads.

Tal infra-estrutura combinada ficará da seguinte forma:

This sketch cannot currently be displayed in exports

Abaixo um exemplo.

METHOD: POST
URL: https://staging.zaply.io
PATH: /digitalsignage/campaigns
HEADERS: {
  api-key: {API_TOKEN}
}
PAYLOAD: [
  {
    "slotId": "digital-signage-monitor-1",
    "quantity": 1
  }
]

O token a ser incluído nos cabeçalhos da requisição serão disponibilizados por Zaply Ads durante seu processo de integração.

Para o caso de criativos estáticos (um criativo único fixo) a resposta da API Zaply Ads consistirá no resultado único do leilão de anúncios para aquele slot, constando a url do criativo e demais parâmetros necessários a postagem e trackeamento do anúncio.

Para o caso de criativos em formato carrossel, deve-se informar a quantidade de banners desejados na resposta, assim a resposta da API Zaply Ads consistirá em uma lista constando todos os resultados de leilão de anúncios para aquele slot, constando a url dos criativos e demais parâmetros necessários a postagem e trackeamento dos anúncios.



{
    "creatives": [
    {       
        "CampaignId": "123",
        "partnershipId": 1,
        "campaignDescription": "Campanha de páscoa Nestlé",
        "creative": "https://test.com/1d1h345-campanha-de-pascoa-nestle-desktop.png"
    },
    {
        "CampaignId": "321",
        "partnershipId": 2,
        "campaignDescription": "Campanha Sadia",
        "creative": "https://test.com/554o4ji9-campanha-sadia-desktop.png"
    },
    {
        "CampaignId": "542",
        "partnershipId": 3,
        "campaignDescription": "Banner Pepsico",
        "creative": "https://test.com/0ip3k5-banner-pepsico-desktop.png"
    },
    ]
}


5 - Setar o disparo de Eventos de Acompanhamento de anúncios


Zaply Ads fornece um dashboard centralizado com dados de performance dos anúncios, que vão desde impressões até a conversão / sellout com acesso em tempo real tanto pelo gestor da Propriedade de Anúncio quanto pelos Anunciantes.

Para podermos coletar informações a respeito do desempenho das campanhas de anúncio exibidas, é necessário que alguns eventos sejam disparados para a API de Zaply Ads.

Os eventos são:


Ad View (opcional)

Evento que é disparado sempre que um anúncio é visualizado, com os atributos:
 ⁠⁠Dicionário de dados⁠  
METHOD: POST
URL: https://staging.zaply.io
PATH: /events-api
PAYLOAD: {
  event: "view",
  campaignId: INTEGER,
  partnershipId: INTEGER,
  device: "desktop",
  zaplyAdsCustomerId: STRING,
}


Dúvidas? Entre com contato com  suporte@zaply.com.br 

 Zaply Ads  é uma plataforma e marcas registrada da Zaply