XML Shopping UOL para afiliados – documentação
Com o XML Shopping UOL você pode escolher as ofertas que deseja publicar em seu site e/ou blog, divulgando
ofertas relevantes ao público e conteúdo do seu site de forma customizada, e ainda otimizar mais seus ganhos
através do programa UOL Afiliados.
O conteúdo do Shopping UOL estará à sua disposição com informações completas de cada produto ou serviço
anunciado como: imagens, preços, lojas, descrição dos produtos, etc.
Tudo fácil e rápido para exibir as ofertas do Shopping UOL da maneira que você desejar em seu site e/ou blog,
contando sempre com a conveniência e segurança de um dos maiores comparadores de preço do Brasil.
O XML (Extensible Markup Language) é uma ferramenta avançada de distribuição automática – e em tempo real
– de informações. Caso você não tenha conhecimento em linguagem XML, você pode utilizar as peças prontas
disponibilizadas no site. Para isso, entre no site de Afiliados UOL (http://afiliados.uol.com.br), vá em “Inserir
anúncios XML Shopping UOL”, e selecione a opção “Peças prontas”.
1. Como utilizar o XML do Shopping UOL
Para utilizar o XML você precisa:
1.
Ter uma conta no UOL Afiliados. Se você ainda não é um afiliado UOL, cadastre-se em
http://afiliados.uol.com.br.
2. Conhecer alguma linguagem de programação e saber como processar documentos XML nessa
linguagem.
3. Criar um script para requisitar, ler e processar o XML.
O processo básico para utilização do XML do Shopping UOL tem os seguintes passos:
1.
2.
3.
4.
Fazer uma requisição HTTP GET para a URL do XML
O servidor enviará uma resposta em formato XML
Processar o XML para obter as informações sobre produtos e ofertas
Gerar o código HTML para exibição em seu site
2. Como montar URLs para requisição do XML
Existem três tipos de documentos XML que podem ser utilizados pelos afiliados:
1. Listagem de categorias
2. Listagem de ofertas de uma categoria específica
3. Listagem de ofertas contendo uma palavra-chave específica (busca)
Cada tipo de XML tem uma estrutura de URLs específica. Veremos em seguida como montar a URL correta para
cada tipo.
Código de site afiliado (idtURL)
Como afiliado Shopping UOL você pode ter diversos sites cadastrados. Cada site é identificado por nosso sistema
por um código único.
Você vai precisar deste código para montar as URLs para requisição dos documentos XML. Para obter o código
do seu site, entre no site de Afiliados UOL (http://afiliados.uol.com.br), vá em “Inserir anúncios XML Shopping
UOL”, selecione o site desejado em “3) SITE”, como pode ser visto na imagem 1.
Código de Identificador (idtLabel)
Este código pode ser usado pelo afiliado para identificar a origem dos cliques nos links obtidos com o XML
Shopping UOL. É um parâmetro opcional na URL e seu valor pode ser obtido seguindo os mesmos passos
descritos para obtenção do código de site afiliado, como pode ser visto na imagem 1 abaixo.
Imagem 1 – códigos de site e identificador
A seguir serão mostradas as URLs usadas para requisitar cada um dos três tipos de documentos XML.
2.1. Documentos XML de Listagem de categorias
Lista todas as subcategorias de uma determinada categoria do Shopping UOL.
URLS PARA REQUISITAR ESSE TIPO DE DOCUMENTO XML
http://xml.shopping.uol.com.br/categoria/index.html?idtURL=XXX
Obs.: Troque “categoria” pela categoria desejada e “XXX” pelo código do site afiliado
Ex.: http://xml.shopping.uol.com.br/eletronicos/index.html?idtURL=999
Para obter as URLs de XML de todas as categorias, acesse o XML:
http://xml.shopping.uol.com.br/todos.html?idtURL=XXX
ESTRUTURA DESSE TIPO DE DOCUMENTO
2.2. Documentos XML de Listagem de ofertas de uma categoria específica
Lista ofertas de produtos pertencentes a uma categoria.
URLS PARA REQUISITAR ESSE TIPO DE DOCUMENTO XML
http://xml.shopping.uol.com.br/categoria/subcategoria/index.html?idtURL=XXX
Obs.: Troque “subcategoria” pela subcategoria desejada, “categoria” pela categoria-mãe e “XXX” pelo código do
site afiliado
Ex.: http://xml.shopping.uol.com.br/eletronicos/tvs/index.html?num=50&idtURL=2820
Sobre o parâmetro num:
Parâmetro
Valores possíveis
Obrigatório
num
10, 25, 50, 100
Não
ESTRUTURA DESSE TIPO DE DOCUMENTO
Este XML é dividido em duas partes: filtros e ofertas
Filtros
Função
Quantidade de ofertas
exibidas por página
Ofertas
2.3. Documentos XML de Listagem de ofertas contendo uma palavra-chave específica
(busca)
Lista ofertas de produtos resultantes de uma busca por palavra-chave. Estas ofertas podem pertencer a até 3
categorias diferentes.
URLS PARA REQUISITAR ESSE TIPO DE DOCUMENTO XML
http://xml.shopping.uol.com.br/busca.html?q=termo+buscado&idtURL=XXX
Obs.: Troque “termo+buscado” pela palavra-chave desejada e “XXX” pelo código do site afiliado
Ex.: http://xml.shopping.uol.com.br/busca.html?q=tv+lcd&idtURL=2820
Sobre o parâmetro q:
Parâmetro
Valores possíveis
Obrigatório
q
Texto
Sim
ESTRUTURA DESSE TIPO DE DOCUMENTO
Função
Palavra-chave a ser
buscada