A Empresa
Esperamos que aproveite!
03 - API Download de Cupons Download →
Afilio fornece aos seus afiliados, uma API que permite fazer o download do arquivo de cupons nos formatos:
- JSON
- XML
- CSV
- RSS
Para acessar a API o Afiliado deverá logar na Plataforma e ir na ferramenta Cupom, no menu Formatos.
A API pode ser utilizada pela seguinte URL:
Ao acessar a API, através da URL acima, será feito o download do arquivo com os cupons das campanhas que você está aceito e que possuem cupom.
Para divulgar o cupom basta copiar a URL da campanha desejada e inserir no seu site.
| Parâmetro | Descrição |
| token¹ | Token de autorização para utilizar a API |
| mode | Utilizar dl obrigatóriamente para baixar os cupons. |
| siteid² | ID do seu site. |
| affid | Seu ID dentro do Afilio. |
/ Retorno
O retorno do arquivo contém todos os dados, dentro do limite de data selecionado.
| Parâmetro | Descrição |
| id_couponoffer | Id do cupom na plataforma da Afilio |
| title | Título do cupom |
| startdate | Data de início do cupom (dd-mm-aaaa) |
| enddate | Data de término do cupom (dd-mm-aaaa) |
| url | Link de destino para página do produto do cupom |
| discount | Valor de desconto do cupom |
| progid | Id da campanha na plataforma do Afilio |
| rule | Regra para utilizar o cupom |
| code | Código do cupom utilizado para resgatar o desconto |
| description | Descrição do cupom ou produto |
| type | Tipo de desconto: p = Porcentagem; n = Moeda/Dinheiro |
/ Erro de códigos:
| Erro | Descrição |
| Token doesnt match. | O token no parâmetro está incorreto |
| No mode choosen. | O valor no parâmetro modo está incorreto |
/ Exemplos de Implementação:
Caso o Afiliado queira automatizar esta ferramenta, segue abaixo alguns exemplos de scripts feitos em PHP.
Observações:
/ ¹ Como gerar o Token?
1. Logar na Plataforma
2. Ir em Minha Conta, link Informações
3. Clicar em (1)
4. Clicar em Confirmar (2)
O código do token será disponibilizado no campo Login, em API token.
/² SiteID
O siteID é gerado automaticamente sempre que o Afiliado cadastrar um novo site na Plataforma.
Para consultar o siteID basta seguir os passos abaixo:
1. Logar na Plataforma
2. Ir em Formatos, link Tags únicas
3. Selecionar o site, em Site Selecionado (1) 
4. Selecionar a campanha (2)
5. Clicar em Pesquisar (3)
O siteID será disponibilizado dentro do link, em Resultados de sua pesquisa.
Manual de Criação de Deeplinks Download →
/ Ferramentas Deeplinks
Somente algumas campanhas liberam o acesso para criação de links através da ferramenta Deeplinks. Caso a campanha desejada não esteja liberada, entre em contato com o Gerente da Campanha solicitando a liberação.
Afilio oferece uma ferramenta que permite a criação de links personalizados que são trackeados automaticamente pela plataforma, e registram as vendas e cadastros realizados através da divulgação dos nossos publishers.
A ferramenta pode ser acessada através de um link localizado no menu à esquerda, após logado na plataforma, conforme indicado abaixo.
/ Criação Deeplinks
Ao acessar a ferramenta, você verá a tela abaixo:
Será necessário preencher os campos listados, conforme as instruções abaixo:
Campanha: Deve ser selecionada a campanha correspondente ao link a ser criado. Tome muito cuidado, pois a criação de um novo deeplink na campanha incorreta resultará em um link que não permitirá a captação das vendas ou cadastros.
Site: Deve ser selecionado o site para o qual você deseja gerar o novo link.
Título: Informações adicionais sobre a oferta/produto (preço, validade da promoção, desconto).
Descrição: Deve ser inserida uma chamada para a oferta/produto.
URL de destino: Neste campo você pode inserir o endereço para o qual será direcionado o link trackeado. O endereço não deve conter quaisquer parâmetros de acompanhamento de ferramentas terceiras, somente o endereço de destino.
Exemplo de link traqueado:
Antes de inserir a url na Plataforma, você deve remover todos os parâmetros de terceiros, a partir da interrogação, conforme abaixo.
Ao concluir o preenchimento dos campos, basta clicar no botão “Criar”
Para ter acesso ao novo link trackeado, você deverá selecionar a campanha na qual o link foi adicionado no menu exibido logo abaixo, na seção “Lista de Deeplinks”, e clicar em “Go”
Os links criados serão exibidos logo abaixo da seguinte forma:
A visualização inclui o nome da campanha, o site para qual o deeplink foi criado e a descrição, bem como o código referente ao link e uma representação visual do link código apresentado.
ATENÇÃO: O Afiliado só poderá gerar o link traqueado através da ferramenta Deeplink, na Plataforma Afilio. Ao tentar gerar o link manualmente, a venda/cadastro corre o risco de não ser validada pelo anunciante devido a falta ou erro de algum parâmetro utilizado na criação.
Server to Server Download →
Afilio agora suporta traqueamento server to server. Isto é muito útil quando a campanha está rodando, pode–se traquear toda conversão em tempo real.
É preciso apenas enviar seu link de postback S2S
Exemplo:
Para quaisquer dúvidas entre em contato com: lucas.montichel@afil.io
Parâmetro Aff_xtra Download →
A plataforma Afilio permite que informações adicionais sejam registradas em um parâmetro que pode ser adicionado aos trackers e posteriormente exibidas nos relatórios da veiculação.
Para a inclusão de informações adicionais, o parâmetro "aff_xtra" deve ser adicionado no final dos trackers extraídos da plataforma.
Exemplo Para adicionar as informações ao tracker:
Fazemos a adição de um novo parâmetro &aff_xtra no final, contendo a informação adicional que queremos ver registrada nos relatórios, o que resultará na URL abaixo:
Assim, quaisquer vendas ou cadastros gerados a partir deste tracker exibirão o conteúdo do parâmetro aff_xtra em seus relatórios, na coluna "Extra":
| ID Venda | ID Afil. | Nome sute | Unique ID | Com. R$ | Extra | Data Lead |
| 1234567 | 1 | Site Afiliado | ID Anunciante | R$ | Info | 01/01;13 11:00 |
Múltiplas informações adicionais Também é facultado ao publisher a adição de mais de um parâmetro adicional. Neste caso, os múltiplos parâmetros adicionais devem ser separados por ponto e vírgula dentro do parâmetro "aff_xtra".
/ Exemplo
Utilizando o mesmo tracker do exemplo anterior, podemos adicionar mais de uma informação no parâmetro adicional, separando-os com ponto e vírgula.
Guia do Novo Afiliado Download →
/Bem-vindo!
1
JÁ ME INSCREVI
NO PROGRAMA AFILIO,
E AGORA?
Depois de ser aceito
no programa Afilio,
você receberá um
e-mail com seu login
e senha de acesso à
plataforma.
Ao acessar a plataforma, basta
você escolher as campanhas que
quer participar.
O login é feito através do endereço
www.afilio.com.br no menu superior.
2
ESCOLHENDO AS CAMPANHAS QUE QUERO PARTICIPAR!
Dentro da plataforma, o primeiro passo é visualizar as campanhas, no menu esquerdo,
Todos os Programas, para solicitar a participação nas quais você deseja divulgar.
Importante: se você clicar no nome da campanha, ao lado esquerdo, poderá aceder a todas as informações, como comissão, formatos oferecidos, restrições. É fundamental que você conheça os detalhes da campanha antes de solicitar a participação. O não cumprimento das regras pode acarretar na sua retirada da campanha em questão.
Em até 48 horas após a sua solicitação de acesso, a uma
determinada campanha,
você receberá um e-mail confirmando
ou não sua aceitação.
Você pode não ser aceito em uma campanha:
- Que tenha restrições quanto aos formatos que você trabalha;
- Que tenha restrições de budget e número limitado de afiliados;
- Quando o conteúdo do seu site não estiver de acordo com o perfil do público da campanha
Após solicitar o ingresso, você poderá ver no menu Meus Programas todas as quais você já foi aprovado.
3
COMO PEGAR
MATERIAIS NA
PLATAFORMA?
Uma vez aceito no programa, você tem duas maneiras
principais de aceder ao material para publicar no seu site.
No menu esquerdo (em Formatos), selecione uma das opções a seguir:
1. Tags únicas:
Para acessar links, site under, bannerse banner html.
2. Deeplinks:
Ferramenta que facilita a divulgação
de ofertas customizadas, criando links
personalizados.
1. Tags únicas
Selecione, primeiramente a campanha e o tipo (banner de imagem,
banner html, link de texto, site under) e clicar em pesquisar.
Fique atento:
● Só aparecerá material das campanhas que você está aprovado.
● No caso de link de texto e site under: Selecionar a URL que se encontra no box, iniciando no http até o seu número de Site ID.
● No caso de banners: Selecionar a URL que se encontra entre aspas,
iniciando em http até o gif.
● No caso de banner html: Copiar todo o código, indicamos usar ctrl + A e ctrl + C para
selecionar todo o código.
1. Tags únicas
Exemplo de como buscar Link de Texto:
2. Deeplinks:
Primeiro selecione uma campanha que você já participa, crie um título
para sua oferta e a descrição que você quer utilizar e insira a URL de destino (da campanha selecionada) e clique em criar.
Seu link aparecerá como o último (mais atual) na barra de rolagem.
Algumas campanhas podem ter restrições quanto à criação de deeplinks, nesse caso elas não estarão disponíveis no painel de escolha de campanha. Em caso de dúvidas, consulte o gerente da campanha.
4
OUTRAS
FERRAMENTAS
AFILIO
Além das ferramentas aqui descritas, a plataforma Afilio oferece diversos outros recursos.
Dentro da própria plataforma, em cada seção é possível baixar um tutorial específico, para aprender a gerenciar melhor os recursos como API, Pixel Server to Server, troca de banners, entre outros.
5
RELATÓRIOS
As informações contidas nos nossos relatórios provem diretamente do site do
anunciante, a partir do momento que o usuário interagir com uma de suas peças
divulgadas no seu site, ou assim que ocorrer uma conversão (leads ou vendas)
os dados na plataforma são atualizados automaticamente.
Nas estatísticas, que se encontram no menu da esquerda, conforme imagem
abaixo, é possível realizar filtros por período, campanha, site.
6
APIS
As APIs são integrações para facilitar o acesso aos materiais sem necessidade de logar
na plataforma. No menu esquerdo você encontra o link para todos os manuais, contendo
as instruções detalhadas de todas as APIs disponíveis, conforme imagem.
7
PAGAMENTOS
Você será pago a cada 47 dias, contanto que atinja o valor mínimo de R$100,00 por pagamento.
O período de solicitação do pagamento é até o dia 17 e de recebimento a té 25
de cada mês (sendo que a solicitação deverá ser feita com no mínimo 8 dias de antecedência à
data de pagamento). A solicitação é feita através do botão "Solicitar Pagamento"
em sua página "Meus Pagamentos".
Agora basta escolher as suas campanhas e começar a gerenciar seus lucros!
O time da Afilio está sempre à disposição para lhe ajudar.
API SALES E LEADS Download →
/ API Sales e Leads
É uma API para acompanhamento das vendas e cadastros sem precisar consultar na Plataforma.
Para acessar a API é preciso copiar a URL abaixo e inserir as informações necessários, como:
Token¹: Token do Afiliado.
Aff ID: O ID do Afiliado.
Date Star: Data inicial do período que deseja obter as informações de vendas ou cadastro.
Date End: Data final do período que deseja obter as informações de vendas ou cadastro.
/ Exemplo de requerimento
Sales
Sales
Lista de Parâmetros
| Nome | Tipo | Obrigatório | Valor aceito | Exemplo |
| mode | String | X | List | ?mode=list |
| token | String | X | String | …&affid=1234 |
| affid | String | X | String | …&affid=1234 |
| progid | Afilio_id* | int or list (dois de int separado por “,”) | …&progid=1 …&progid=1,2, 3 | |
| type | String | X | Sale / Lead | …&type=sale …&type=lead |
| dateType | String | X | transaction / validation | …&dateType=tr ansaction …&dateType=v alidation |
| dateStart | Afilio_date** | X | Data no formato AAAA-MM-DD | …&dateStart= 20 14-11-3 |
| dateEnd | Afilio_date** | X | Data no formato AAAA -MM-DD | …&dateEnd= 20 14-12-31 |
| format | String | X | json (default) xml, csv, rss | …&format=xml |
| siteid | Afilio_id* | int or list (dois de int separado por “,”) | …&siteid=1 …&siteid=1,2, 3, 4,5,25 |
* AFILIO_ID: Significa que você pode usar um único valor ou múltiplos valores separados por “,”. ou seja, siteID=1235 ou siteID=1235,4564,5898
** AFILIO_DATE: A data apresenta o seguinte formato: AAAA-MMDD, onde:
- AAAA ano no formato de 4 dígitos
- MM mês no formato de 2 dígitos
- DD dia no formato de 2 dígitos
Resultado da Requisição
O resultado vai depender da sua requisição. Você pode ter requisições de cadastro (lead) ou venda (sale) que são explicadas abaixo.
Campos Principais
| Nome | Descrição | Tipo |
| root | Primeiro elemento | Object |
| list | Lista de todos os elementos | list object |
| Lead | sale | O lead object ou o sale object depende do tipo específicado na URL | lead object / sale object |
| next | Próxima página | url |
Cadastro (Lead)
| Nome | Descrição | Tipo | Exemplo |
| lead | Nome do cadastro | Object | Lead |
| leadid | ID do cadastro | Int | 123 |
| affid | ID do afiliado | Int | 123 |
| status | Os status do cadastro (lead): Pendente Aceito Recusado | String | Aceito |
| progid | ID da campanha | Int | 1234 |
| order_id | ID do pedido | Int | 12 |
| order_price | Valor do pedido | Double | 1.23 |
| comission | Comissão do Afiliado | Double | 9999.99 |
| date | Data e hora do pedido no formato AAAA-MMDD HH:MM:SS | DateTime | 2014-04-25 23:59:59 |
| payment | Verificar se o pagamento tiver sido pago ou não. Possíveis valores: Pago Não pago | String | Paid |
| xtra | Campo extra | String(255) | Xd12 |
Venda (Sale)
| Nome | Descrição | Tipo | Exemplo |
| sale | Nome da venda | Object | sale |
| saleid | ID da venda | Int | 123 |
| affid | ID do afiliado | Int | 123 |
| status | Status da venda: Possible Value: Pendente Aceito Recusado | String | Recusado |
| progid | ID da campanha | Int | 123564 |
| order_id | ID do pedido | Int | order_25046 |
| order_price | Valor do pedido | Double | 1.23 |
| comission | Comissão do Afiliado | Double | 9999.99 |
| date | Data e hora do pedido no formato AAAA-MMDD HH:MM:SS | DateTime | 2014-04-25 23:59:59 |
| payment | Verificar se o pagamento tiver sido pago ou não. Possíveis valores: Pago Não pago | String | Unpaid |
| xtra | Campo extra | String(255) | Xd12 |
Observação
/ ¹ Como gerar o Token?
1. Logar na Plataforma
2. Ir em Minha Conta, link Informações
3. Clicar em (1)
4. Clicar em Confirmar (2)
O código do token será disponibilizado no campo Login, em API token.
API Descrição de Campanhas Download →
/ API Descrição de Campanhas
É onde os Afiliados podem ter acesso as informações das suas Campanhas sem precisar acessar a Plataforma.
Para acessar a API Descrição Campanhas, é necessário copiar o link API DESCRIÇÃO CAMPANHAS. Deve-se inserir o token e o id do afiliado (affid).
/ Como gerar o Token?
1. Logar na Plataforma
2. Ir em Minha Conta, link Informações
3. Clicar em (1)
4. Clicar em Confirmar (2)
O código do token será disponibilizado no campo Login, em API token.
Após inserir o token e o id no local incicado, a API exibe os dados das campanhas as quais o Afiliado está aceito na Plataforma Afilio.
As informações a serem exibidas são:
ID: Número de identificação da Campanha.
Nome: O nome da Campanha.
URL: Site da Campanha.
Descrição: Descrição do site da Campanha.
Progdate: Data de criação da Campanha no sistema.
Progdeb: Data de ativação da Campanha.
Progfin: Data de desativação da Campanha.
SiteID¹: ID do site.
Cpmprice: Comissão por mil impressões.
Clicprice: Comissão por clique.
Dblclicprice: Comissão por duplo clique.
Leadprice: Comissão por cadastro.
Saleprice: Comissão por venda.
Downloadprice: Comissão por download.
Status: Status da Campanha.
/ Link API Descrição Campanhas
Este é o link onde você deverá inserir o código do seu token e o seu id, conforme indicado abaixo:
https://v2.afilio.com.br/api/prog_api.php?token=[insira_aqui_seu_token]&affid=[i nsira_aqui_seu_id]
/ Exemplo
Após inserir o token e o affid o link deverá ficar como o exemplo abaixo:
Detalhe ampliado da resposta da API:
Neste caso, o leadprice aparece com o valor “1” e o saleprice com valor “0”. Isso indica que, o tipo da campanha é Lead (Cadastro) e não Sale (Venda). Caso a campanha fosse Sale, o leadprice estaria zerado e o saleprice estaria com valor diferente de zero. Obs¹.:
/ SiteID
O siteID é gerado automaticamente sempre que o Afiliado cadastrar um novo site na Plataforma.
Para consultar o siteID basta seguir os passos abaixo:
1. Logar na Plataforma
2. Ir em Formatos, link Tags únicas
3. Selecionar o site, em Site Selecionado (1) 
4. Selecionar a campanha (2)
5. Clicar em Pesquisar (3)
O siteID será disponibilizado dentro do link, em Resultados de sua pesquisa.
Manual de Implementação FeedXML (Afiliado) Download →
O Afiliado deve consultar a url: v2.afilio.com.br/aff/aff_get_boutique.php passando os parâmetros necessários para consultar os produtos das campanhas, utilizando paginação..
Exemplo de chamadas GET
/ Consultar quantidade de produtos
|
v2.afilio.com.br/aff/aff_get_boutique.php?boutiqueid=1-895987&token=[TOKEN
AFILIADO]&progid=1010¶m=size
|
/ Listagem de produtos
|
v2.afilio.com.br/aff/aff_get_boutique.php?boutiqueid=1-895987&token=[TOKEN
AFILIADO]&progid=1010&format=JSON&offset=[QUANTIDADE]
|
|
OBTER TAMANHO DA LISTAGEM DE PRODUTOS
|
||
|
param = size (retorna quantidade de produtos do feed selecionado)
|
||
|
progid = id da campanha
|
||
|
boutiqueid = informação quanto ao feed consultado(Obter na V2)
|
||
|
token = Token do afiliado, (Obter na V2)
|
A consulta retorna um arquivo JSON informando o tamanho do feed.
|
CONSULTAR LISTAGEM DE PRODUTOS
|
||
|
progid = Id da campanha
|
||
|
boutiqueid = Identificador do feed consultado(Obter na V2)
|
||
|
token = Token do afiliado, (Obter na V2)
|
||
|
offset = Define qual página da lista de produtos deve ser retornada (1ª página: &offset=0)
|
||
|
format = Define o formato a ser retornado (JSON, XML e CSV)
|
||
Observação: Serão listados 1.000 produtos em cada página.
/ Exemplo de código php
|
</?php define("limit", 1000); /*Example URL: https://v2.afilio.com.br/aff/aff_get_boutique.php?boutiqueid=[ID_DO_FEED] &token=[SEU_TOKEN]&progid=[ID_DA_CAMPANHA]*/ $baseUrl = "https://v2.afilio.com.br/aff/aff_get_boutique.php?boutiqueid=[ID_DO_FEED] &token=[SEU_TOKEN]&progid=[ID_DA_CAMPANHA]"; //Count param $param = "¶m=size"; $curl = curl_init(); $curlUrl = $baseUrl.$param; curl_setopt($curl, CURLOPT_URL, $curlUrl); curl_setopt($curl, CURLOPT_RETURNTRANSFER , true); //Get Itens Count on feed. $countItens = curl_exec($curl); $countItens = json_decode($countItens); //Calculate interactions needed. $interactions = ( $countItens->size)/limit; $interactions = ceil($interactions); for ($i = 0; $i < $interactions; $i++) { $param = "&offset=".$i; $curlUrl = $baseUrl.$param; curl_setopt($curl, CURLOPT_URL, $curlUrl); curl_setopt($curl, CURLOPT_RETURNTRANSFER , true); $return = curl_exec($curl); //Code here.... } ?> |
Manual de Implementação Mastertag por imagem Download →
Definição da mastertag por imagem
A mastertag por imagem, é uma maneira segura desenvolvida pela AFILIO, para fornecer os dados de navegação de um usuário no site de um anunciante para nossos afiliados. Os afiliados cadastrados estarão recebendo diversas informações em tempo real para uma URL pré-definida e cadastrada como seu end-point na AFILIO.
Implementação da Mastertag por imagem
O Afiliado deve nos fornecer um end-point(url) que esteja pronto para receber todos os parâmetros via GET citados abaixo.
Características dos parâmetros:
Para garantir a integridade dos dados enviados, os textos que podem conter caracteres especiais como: Nome, Descrição, URLs serão enviados via parâmetro encodados, as demais descrições dos parâmetros estão na tabela no item 3.
|
Exemplo de chamada GET: https://www.afiliado.com.br/endpoint?progid=1&type=homepage&id_partner=campanha&url_product= http%3A%2F%2Fwww.campanha.com.br |
/ Listagem de produtos
Parâmetros normalmente enviados em cada página
|
HOME PAGE
|
||
|
progid = id da campanha
|
||
|
type = tipo da página, no caso é homepage
|
||
|
id_partner = nome da campanha
|
||
|
url_product = url da página da homepage
|
|
CATEGORIA
|
||
|
progid = id da campanha
|
||
|
type = category
|
||
|
id_partner = nome da campanha
|
||
|
id_category = id da categoria
|
||
|
url_product = url da página categoria
|
|
PRODUTO
|
||
|
progid = id da campanha
|
||
|
ttype = product
|
||
|
id_partner = nome da campanha
|
||
|
product_id1 = id do produto selecionado pelo cliente
|
||
|
id_category = id da categoria do produto
|
||
|
stock = preenchido com "1" para produto em estoque, ou "0" para
|
||
|
produto esgotado
|
||
|
product_sku = preenchido com o sku do produto (código do produto)
|
||
|
product_name = nome do produto
|
||
|
product_desc = descrição do produto (sem tag html na descrição)
|
||
|
product_photo = url da imagem do produto
|
||
|
price1 = preço atual do produto, com desconto (separador decimal por ponto)
|
||
|
price2 = preço original do produto, sem desconto (separador decimal por ponto)
|
||
|
product_currency = código de três dígitos da moeda correspondente ao valor (BRL para real)
|
||
|
url_product = url da página do produto
|
|
CARRINHO
|
||
|
progid = id da campanha
|
||
|
type=basket
|
||
|
id_partner = nome da campanha
|
||
|
product_id1 = id do produto selecionado pelo cliente. No caso de múltiplas ids, separar utilizando ","
|
||
|
amount = valor total da compra (separador decimal por ponto)
|
||
|
url_product = url da página Basket
|
||
|
transaction_id = id do pedido (número / código do pedido)
|
||
|
order_date = data da compra do produto
|
||
|
order_status = "Completed" para confirmado ou "Pending" para pendente
|
||
|
customer_id = id do cliente
|
||
|
customer_type = "New" para novo cliente ou "Old" para cliente antigo
|
|
PÁGINA DE CONFIRMAÇÃO
|
||
|
progid = id da campanha
|
||
|
type = transaction
|
||
|
id_partner = nome da campanha
|
||
|
amount = valor total da compra (separador decimal por ponto)
|
||
|
transaction_id = id do pedido (número / código do pedido)
|
||
|
customer_type = "New" para novo cliente ou "Old" para cliente antigo
|
||
|
product_id1 = id do produto selecionado pelo cliente. No caso de múltiplas ids, separar utilizando ","
|
||
|
url_product = url da página do transaction
|
||
|
order_date = data da compra do produto
|
||
|
order_status = "Completed" para confirmado ou "Pending" para pendente
|
||
|
customer_id = id do cliente
|
IMPORTANTE
uuid = id do usuário (essa informação é enviada via end-point e está disponível no navegador do usuário no formato de um cookie para leitura.)
Obs: Podem ser passado mais parâmetros que os informados acima em cada página a critério do anunciante.
/ Sumário dos Parâmetros
| Nome | Tipo |
| Progid | Id da campanha |
| Type | Tipo da página |
| id_partner | Nome da campanha. |
| url_product | Url da página da homepage (encodado) |
| id_category | Id da categoria |
| product_id1 | Id do produto selecionado pelo cliente |
| Stock | Preenchido com "1" para produto em estoque, ou "0" para |
| product_sku | Preenchido com o sku do produto (código do produto) |
| product_name | Nome do produto (encodado) |
| product_desc | Descrição do produto (sem tag html na descrição e encodado) |
| product_photo | Url da imagem do produto (encodado) |
| price1 | Preço atual do produto, com desconto (separador decimal por ponto) |
| price2 | Preço original do produto, sem desconto (separador decimal por ponto) |
| product_currency | Código de três dígitos da moeda correspondente ao valor (BRL para real) |
| Amount | Valor total da compra (separador decimal por ponto) |
| transaction_id | Id do pedido (número / código do pedido) |
| order_date | Data da compra do produto |
| order_status | "Completed" para confirmado ou "Pending" para pendente |
| customer_id | Id do cliente |
| customer_type | "New" para novo cliente ou "Old" para cliente antigo |
| uuid | Id único de usuário |
Recuperação do UUID
Os dados enviados para o end-point dos afiliados possuem um parâmetro chamado UUID. Esse UUID é criado pela Afilio e serve para identificar o usuário final.
Quando um usuário navega no site de um anunciante que possui a tag de imagem da AFILIO, acontece o seguinte fluxo:
1) É realizada uma verificação se o usuário possui um UUID no seu navegador
2) Caso contrário é gerado um UUID no seu navegador
A informação de UUID gerada é salva via cookie no navegador do usuário e enviada para o end-point cadastrado pela AFILIO do afiliado.
Uma que vez esses dados são enviados, os afiliados precisam recuperar o UUID para ser possível saber se o mesmo usuário final que navegou em um anunciante, agora está navegando em um site dos afiliados.
Nessa etapa é necessário usar API AFILIO de recuperação de UUID:
https://v2.afilio.com.br/return_uuid_cookie.php
Para o funcionamento dessa API é necessário adicionar os parâmetros de permissão
de leitura do cookie disponível no navegador do usuário final.
Pois o UUID é um cookie pertencente a AFILIO e para que o domínio do afiliado
consiga ler essa informação, é necessário incluir as seguintes informações na chamada da
URL:
crossDomain: true
xhrFields: { withCredentials: true }
Caso o afiliado esteja usando JQuery em seu site, segue um exemplo da chamada:
|
<script type="text/javascript" > $.ajax({ url:'https://v2.afilio.com.br/return_uuid_cookie.php', type:"get", crossDomain:true, xhrFields: { withCredentials: true }, success:function(data){ alert(data); } }); </ script > |
Com isso, o afiliado terá o retorno do UUID do usuário final.
Manual de ImplementaçãoFeed B2W Download →
/Implementação de Feed:
Afiliado deve consultar a url: v2.afilio.com.br/aff/aff_get_boutique.php passando os parâmetros necessários para consultar os produtos de B2W, utilizando paginação.
Exemplo de chamadas GET
Consultar quantidade de produtos:
|
v2.afilio.com.br/aff/aff_get_boutique.php?boutiqueid=1-895987&token=[TOKEN
AFILIADO]&progid=1010¶m=size
|
Listagem de produtos:
|
v2.afilio.com.br/aff/aff_get_boutique.php?boutiqueid=1-895987&token=[TOKEN
AFILIADO]&progid=1010&format=JSON&limit=100&offset=1
|
Parâmetros normalmente enviados por tipo de requisição:
Obter tamanho da listagem de produtos
| param | size - retorna quantidade de produtos do feed selecionado |
| progid | id da campanha |
| boutiqueid | informação quanto ao feed consultado(Obter na V2) |
| token | Token do afiliado, (Obter na V2) |
Consultar listagem de produtos
| progid | Id da campanha |
| boutiqueid = | Identificador do ao feed consultado(Obter na V2) |
| token | Token do afiliado, (Obter na V2) |
| limit | Quantidade de produtos a ser retornada (Deve ser Múltiplo de 100 Ex: 100, 200) |
| offset | Define qual parte da lista de produtos deve ser retornada |
| format | Define o formato a ser retornado (JSON, XML e CSV) |
Esqueceu sua senha? Download →
1. Entre no site Afilio: www.afilio.com.br;
2. Clique em “Login”;
3. Clique em “Esqueceu a senha?”;
4. Insira seu email de cadastro (o email que você inseriu no momento do cadastro em nossa plataforma);
5. A tela será atualizada para a mensagem abaixo:
6. Acesse seu email e clique no link que enviamos no corpo do email:
7. Ao clicar no link, você receberá a seguinte mensagem:
8. Você receberá um novo email, com a nova senha gerada:
9. Basta realizar o login utilizando a nova senha
Quero alterar minha senha:
Caso queria uma senha personalizada, siga os passos abaixo:
Lembrando que para uma senha segura, recomendamos que tenha:
- Pelo menos 8 dígitos;
- Pelo menos 1 letra maiúscula e 1 minúscula;
- Pelo menos 1 dígito;
- Pelo menos 1 caractere especial;
- Espaço.
1. Faça o login na plataforma, utilizando a nova senha;
2. No menu lateral - Minha conta, clique no link - Minhas informações:
3. Clique em Alterar senha:
4. Digite sua senha atual, a nova senha e clique no botão Salvar:
5. Faça o login na plataforma, utilizando a nova senha, para ter acesso a sua home.