> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/advertisers/pt/campanhas/third-party-adserving.md).

# Ad Serving de terceiros

A veiculação de anúncios por terceiros permite que os anunciantes hospedem, entreguem e rastreiem eventos a partir do seu próprio servidor, em vez de depender exclusivamente da ExoClick para realizar essas tarefas. Ao nível da campanha, isso é conseguido tirando partido de **tags de banner HTML** e **URLs de iframe**.

Algumas das vantagens das tags de banner HTML e das URLs de iframe são que a maioria das atualizações recorrentes da campanha, como alterar e atualizar criativos, pode ser feita diretamente a partir do próprio servidor do anunciante. Além disso, esta abordagem também é útil porque permite automatização, tornando tarefas como rastreamento, testes A/B e segmentação mais fáceis de gerir.

## Inserir uma tag de banner HTML ou uma URL de iframe numa campanha

Se **HTML / iframes** forem permitidos na sua conta, vá para **Passo 2 - Anúncios** na sua janela de criação de campanha. A partir daí, escolha Banners HTML ou URL de iframe e clique no **+ VARIAÇÕES DE ANÚNCIO** botão para adicionar a tag ou URL à sua campanha.

Atualmente, a ExoClick usa **banner HTML** tags para **todos os formatos de banner**, e **URL do iframe** para **Intersticial** e **anúncios nativos**.

Os banners HTML aceitarão tags HTML como entrada. Pode criar o seu criativo diretamente na caixa de entrada usando tags HTML ou pode adicionar um iframe apontando para a sua página anfitriã:

<figure><img src="/files/eeb6a3793e5103bf315ee131349e55cf57f05d1d" alt=""><figcaption></figcaption></figure>

Com a URL de iframe, só precisa fornecer a origem do iframe:

<figure><img src="/files/a04f5611d669de9c113fbd710d2e4326e6c7d08e" alt=""><figcaption></figcaption></figure>

## Registar cliques e conversões em campanhas HTML

Como as campanhas de Banner HTML e URL de iframe são veiculadas através de um servidor de terceiros, o Painel de Administração não registará quaisquer ***cliques*** ou ***conversões*** por defeito. Se quiser rastrear estes eventos, terá de seguir estes passos:

### Passo 1: Adicione os parâmetros {click\_url} e {conversions\_tracking} ao seu código HTML/iFrame

Adicione {click\_url} e {conversions\_tracking} à tag do anúncio, como mostrado neste exemplo:

```js
<body style="margin: 0px"><iframe id='a628d52a' name='a628d52a' src='https://ad.third-party-server.com/iframe?tag={conversions_tracking}&click_url={click_url}' frameborder='0' scrolling='no' width='300' height='250'></iframe></body>
```

### Passo 2: Adicione à sua página anfitriã o código para detetar o valor {click\_url}

A sua página anfitriã precisa de ser capaz de detetar o valor {click\_url} para gerar o clique e a string {conversions\_tracking} para registar a conversão no Painel de Administração. A forma como obtém estes valores depende da linguagem de programação com que a sua página anfitriã foi construída. Aqui estão alguns exemplos:

**JavaScript:**

```js
<div id="anchor"></div>
<script src="https://code.jquery.com/jquery-3.6.0.min.js" integrity="sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4=" crossorigin="anonymous"></script>
<script type="text/javascript">
//obter parâmetros da URL do iframe
function paramFetch(name)
{
  name = name.replace(/[\[]/, "\\\[").replace(/[\]]/, "\\\]");
  var regex = new RegExp("[\\?&]" + name + "=([^&#]*)"),
  results = regex.exec(location.search);
  return results == null ? "" : decodeURIComponent(results[1].replace(/\+/g, " "));
}
//criar banner
  var tag = paramFetch('tag');
  var clickid = paramFetch('click_url');
  if (!clickid.endsWith(';')) {
            clickid += ';';
        }
  var link = document.createElement('a');
  link.href = clickid + 'https://www.mylandingpage.com?tag=' + tag ;
  link.target = '_blank';
  link.innerHTML = '<img src=\"banner300x250.jpg\">';
  document.getElementById('anchor').appendChild(link);
</script>
```

Neste script, pode adicionar qualquer variável que possa precisar de rastrear através do seu iframe, desde que especifique o parâmetro da URL que precede este valor. Por exemplo, se quiser rastrear **Sub IDs**, pode usar o seguinte código:

```js
<div id="anchor"></div>
<script src="https://code.jquery.com/jquery-3.6.0.min.js" integrity="sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4=" crossorigin="anonymous"></script>
<script type="text/javascript">
//obter parâmetros da URL do iframe
<script type="text/javascript">
function paramFetch(name)
{
  name = name.replace(/[\[]/, "\\\[").replace(/[\]]/, "\\\]");
  var regex = new RegExp("[\\?&]" + name + "=([^&#]*)"),
  results = regex.exec(location.search);
  return results == null ? "" : decodeURIComponent(results[1].replace(/\+/g, " "));
}
  var tag = paramFetch('tag');
  var subid = paramFetch('subid'); // Obter o valor do parâmetro 'subid' da URL
  var link = document.createElement('a');
  link.href= 'https://www.mylandingpage.com?tag=' + tag + '&subid=' + subid ; // Rastrear o parâmetro subid
  link.target= '_blank';
  link.innerHTML = '<img src=\"banner300x250.jpg\">';
  document.getElementById('anchor').appendChild(link);
</script>
```

O rastreamento de Sub ID é uma forma de adicionar informação extra aos seus links para que possa compreender melhor de onde provém o tráfego do seu site. Ao adicionar parâmetros Sub ID aos seus URLs, pode rastrear detalhes específicos como qual anúncio, plataforma ou campanha trouxe um visitante ao seu site.

**PHP:**

```php
<?php
$tag_tracker = isset($_GET['tag']) ? $_GET['tag'] : '';
$click_url = isset($_GET['click_url']) ? $_GET['click_url'] : '';
?>

if (substr($click_url, -1) !== ';') {
  $click_url .= ';';
}

<a target="_blank" href='<?php echo $click_url ?>https://ad.third-party-server-ad.com/click?tag=<?php echo $tag_tracker ?>' >
```

O resultado final da ligação deve ser:

```js
{click_url}https://ad.third-party-server-ad.com/click?tag={conversions_tracking}
```

Quando um utilizador clica neste anúncio, o nosso servidor removerá automaticamente o valor {click\_URL} e redirecionará o visitante para a página, ao mesmo tempo que regista o clique e fornece os detalhes da conversão.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/advertisers/pt/campanhas/third-party-adserving.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
