Busca Patrocinada

A solução de Busca Patrocinada permite que você anuncie seus produtos de forma destacada nos resultados de Busca do seu ambiente, oferecendo visibilidade superior aos produtos. Esse modelo propõe maior destaque e aumenta a chance de cliques em comparação com os resultados orgânicos. Melhore ainda mais a experiência do usuário e tenha resultados reais com métricas que acompanham desde a visualização do anúncio até a finalização da compra, oferecendo a você uma visão clara de retorno sobre investimento (ROI).

Identificando o produto patrocinado

Todo produto patrocinado retornará com uma URL diferente do padrão do Produto. Para identificar um produto patrocinado em nossos responses, basta verificar se o link contém a URL api-ads.percycle.com. Abaixo listamos algumas sugestões de funções para essa identificação:

javaScript
  function hasAds(product) {
      return product.url.includes("api-ads");
  }

  const product = { url: "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING" };
  console.log(hasAds(product));
python
  def has_ads(product):
      return "api-ads" in product["url"]

  product = {"url": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING"}
  print(has_ads(product))
php
  function hasAds($product) {
      return strpos($product['url'], 'api-ads') !== false;
  }

  $product = ["url" => "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING"];
  echo hasAds($product) ? "true" : "false";

Após identificar o produto patrocinado, siga as orientações abaixo:

Mantenha a ordenação padrão

A nossa Busca tem uma ordenação padrão que você deve usar ao enviar seus produtos. Certifique-se de aplicar essa ordenação ao configurar seus anúncios patrocinados. É de suma importância que a Busca siga a ordenação recomendada. Através dela, conseguimos organizar os melhores resultados de forma otimizada, garantindo que seu produto tenha a melhor chance de ser visualizado nas posições corretas. Não use ordenações personalizadas, pois isso pode afetar o desempenho do seu anúncio.

Utilize a URL do produto corretamente

Quando um produto for patrocinado, será necessário enviar a URL correta que direcionará os usuários diretamente para a página do produto. Assim como na Busca, é necessário incluir o tracking. No caso da Busca Patrocinada, deve ser enviado também o evento de ADs, a URL que redireciona o produto estará na API da Busca, porém com um formato diferente. Esta é a URL que será utilizada tanto no redirecionamento quanto no envio do evento.

API
"url": "https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING"


Garanta que o clique contenha informações do usuário

Ao configurar o link de clique para seu anúncio, é essencial associar a informação do usuário. Envie o id do usuário que permitirá que a plataforma de Busca Patrocinada reconheça e registre a interação de forma correta. Ao incluir essa informação, você ajuda a rastrear os cliques de forma personalizada e pode associá-los diretamente ao usuário que realizou a Busca, permitindo uma análise mais precisa de comportamento e conversão.


Destaque seu produto patrocinado

Ao adicionar os produtos patrocinados no seu resulado de Busca, é necessário incluir a flag indicando que se trata de um produto patrocinado. A flag deve destacar o produto nos resultados de Busca, em posições privilegiadas. Sem essa flag, o produto será tratado como um item normal, sem o destaque necessário.

💡 A flag pode ser feita a seu critério, entretanto é recomendado utilizar como base os exemplos abaixo.

HTML
<div class="card">
  <div class="sponsored">Produto patrocinado</div>
</div>
CSS
.card {
  max-width: 100%;
  position: absolute;
  left: 0;
  top: 0;
  z-index: 1;
}

.sponsored {
  width: 170px;
  height: 50px;
  text-align: center;
  font-size: 12px;
}
LightDark
Flag Patrocinada LightFlag Patrocinada Dark


Evento de Clique

Ao clicar no produto patrocinado, precisamos que a chamada seja feita passando os headers, conforme exemplo abaixo:

curl
curl 'https://api-ads.percycle.com/click/?hash=CLICK_LONG_STRING' \
  -H 'Accept: application/json, text/plain, */*' \
  -H 'Referer: dominio.com.br' \
  -H 'User-Agent: axios/1.3.5 ou http/456' \
  -H 'X-User-Id: <user-id>' \
Você pode modificar o comportamento do retorno do clique, utilizando o parâmetro redirect=0. Com ele a request retorna o status code 200 e não o 302 (redirect para a página do produto).

Evento de Conversão

Certifique-se de que a conversão seja registrada corretamente

Sendo objetivo da apresentação do produto, a conversão está relacionada diretamente com o retorno financeiro do seu e-commerce. É fundamental que possamos garantir que o evento de conversão esteja associado ao pedido de forma correta. Para isso, siga para a documentação sobre o c.gif, responsável pela coleta dessas informações.

Edit this page on GitHub
Table of Contents