> 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/publishers/pt/exoclick-agego.md).

# Como integrar o ExoClick com o AgeGO

Este guia pretende explicar:

* Como enviar um site para o AgeGO.
* Como passar parâmetros de verificação de idade ao ExoClick e bloquear anúncios em zonas de anúncios.
* Como integrar as zonas de anúncios do AgeGO e do ExoClick para apresentar anúncios SFW aos utilizadores antes de verificarem a idade.

## Como enviar um site para o AgeGO

Para enviar um site para o AgeGO, inicie sessão no [painel do AgeGO](https://dashboard.agego.com/login). Em seguida, aceda a «Os meus sites» e clique em «Novo site»:

![ExoClick AgeGO 1](https://content.gitbook.com/content/GoSwRYjxsR1XS6va6yLj/blobs/bB1LSjp55HpIccLbeC8G/assets/hires/agego-1.png)

Nestas definições, tem de adicionar, pelo menos, o **Nome** e o **Domínio de nível superior**. Depois de concluir estas definições, clique em «Criar». O site será adicionado à sua conta.

Por predefinição, todos os sites são criados com o estado «Pronto». No entanto, isso não significa que o seu site já possa utilizar o AgeGO. Para ativar o AgeGO no seu site, tem de [**contactar o AgeGO através do formulário de contacto**](https://www.agego.com/contact-us-business) **e indicar o ID do site correspondente ao seu site.**

Pode encontrar o ID do site junto ao nome do site:

![ExoClick AgeGO 2](https://content.gitbook.com/content/GoSwRYjxsR1XS6va6yLj/blobs/GMJYtpAAJvSxFMxPWlpc/assets/hires/agego-2.png)

Quando o seu site for aprovado, o respetivo estado mudará para «Em execução» e poderá seguir as instruções de integração para integrar o AgeGO no seu site. Esta solução oferece atualmente dois métodos: **Modal (simples ou avançado)** e **S2S**, e as instruções de configuração de cada método estão disponíveis no painel do AgeGO. Para efeitos deste guia, vamos abordar o método **Modal** .

## Como transmitir o estado da verificação de idade e apresentar anúncios SFW

Ao utilizar um sistema de verificação de idade (AgeGO ou outro fornecedor), poderá querer continuar a apresentar anúncios a todos os utilizadores (os que não verificaram a idade e os que a verificaram).

Para identificar se um utilizador passou ou não a verificação de idade, utilize o parâmetro `data-ex_av` nas suas zonas de anúncios. Este parâmetro aceita 3 valores:

* "0": Sem verificação de idade (indefinido)
* "1": Verificação de idade — verificado
* "2": Verificação de idade — não verificado

Em seguida, para bloquear anúncios para determinados utilizadores (neste contexto, os que não verificaram a idade), utilize o parâmetro `data-block-ad-types` Este parâmetro aceita vários valores, mas, para este guia, vamos utilizar apenas o valor `101`.

Assim, se quiser apresentar um anúncio SFW e identificar o utilizador como alguém que ainda não verificou a idade, integre os parâmetros da seguinte forma:

* **Formatos de anúncios assíncronos (banner, FPI, formato múltiplo, etc.):**

```html
<script async type="application/javascript" src="https://a.magsrv.com/ad-provider.js"></script> 
 <ins class="eas6a97888e2" data-zoneid="XXXXXXXX" data-ex_av="2"  data-block-ad-types="101"></ins> 
 <script>(AdProvider = window.AdProvider || []).push({"serve": {}});</script>
```

* **In-Stream**: `https://s.magsrv.com/v1/vast.php?idzone=XXXXXX&ex_av=2&block_ad_types=101`
* **Popunder (link)**: `https://s.pemsrv.com/v1/link.php?cat=&idzone=XXXXX&type=8&ex_av=2&block_ad_types=101`
* **Link direto**: `https://s.zlinkt.com/v1/d.php?z=XXXXXXX&ex_av=2&block_ad_types=101`

**Nota**: Tem de utilizar ambos `data-ex_av` e `data-block-ad-types` ao apresentar anúncios SFW; caso contrário, o utilizador não será devidamente identificado e os anúncios não serão bloqueados.

E, se quiser apresentar todos os tipos de anúncios a um utilizador verificado, faça-o da seguinte forma:

* **Formatos de anúncios assíncronos (banner, FPI, formato múltiplo, etc.):**

```html
<script async type="application/javascript" src="https://a.magsrv.com/ad-provider.js"></script> 
<ins class="eas6a97888e2" data-zoneid="XXXXXXX" data-ex_av="1"></ins> 
<script>(AdProvider = window.AdProvider || []).push({"serve": {}});</script>
```

* **In-Stream**: `https://s.magsrv.com/v1/vast.php?idzone=XXXXXXXX&ex_av=1`
* **Popunder (ligação)**: `https://s.pemsrv.com/v1/link.php?cat=&idzone=XXXXXXX&type=8&ex_av=1`
* **Ligação direta**: `https://s.zlinkt.com/v1/d.php?z=XXXXXXX&ex_av=`

## Como criar uma experiência SFW

O tutorial seguinte explica como criar uma «experiência SFW», ou seja, como garantir que só são apresentados anúncios SFW enquanto o utilizador ainda não tiver verificado a idade. Note que este método é apenas uma recomendação e que pode alterar a configuração se precisar de seguir um fluxo de utilizador diferente.

Para esta configuração, vamos precisar de criar um ficheiro de script separado. Neste exemplo, chamámos-lhe `main.js`:

```javascript
function getCookie(name) {
  const value = `${document.cookie};`;
  const parts = value.split(`${name}=`);
  if (parts.length !== 2) return false;
  const token = parts.pop().split(";").shift();
  const format = token.split(".");
  if (format.length !== 3) return false;
  try {
    format.slice(0, 2).forEach(part => {
      const padded = part + "=".repeat((4 - part.length % 4) % 4);
      atob(padded.replace(/-/g, "+").replace(/_/g, "/"));
    });
    return true; 
  } catch (e) {
    return false; 
  }
}

function verifier(event, container) {
    window.AGEGO = window.AGEGO || function () {
	(AGEGO.e = AGEGO.e || []).push(arguments)
	};
     AGEGO('configure', {
	siteId: XXXXXXX, // ID do site no AgeGo
	autoBlur: true,
	verifyMode: 'inline', 
	requireAgeVerification: true, 
	allowDirectContinue: false, 
	overlay: {
		logo: 'wlogo.png', // Logótipo do seu site
		theme: 'auto'
		},
	events: {
		onVerificationFlowEnd() {
			console.log("Verification successfull");
			window.location.reload();
			},
            	onVerificationFlowFailed() {
			console.log("Verification failed with errorcode:" + error);
			},
            	onAgeVerify() {
			console.log("Begin Age Verification process");
			},
            	onDirectContinue() {
			console.log("DirectContinue action");
			},
            	onUnderageSkip() {
			console.log("Skipped");
			},
            	onVerifiedBefore() {
			console.log("Verified Before");
			}
		}
	       }
	);

            var n = document.createEvent("Event");
            n.initEvent("DOMContentLoaded", !0, !0),
            document.dispatchEvent(n);
}

const TARGET_SELECTOR = '.main, .footer; // replace with classes where click will be intercepted

function intercept(e) {
   const container = e.target.closest(TARGET_SELECTOR);
   if (!container) return; 
        
   e.preventDefault();
   e.stopImmediatePropagation(); 
   e.stopPropagation();

   verifier(e, container);
}
```

Este ficheiro contém três funções: uma função para detetar cookies, uma função para carregar a sobreposição AgeGO e uma função para detetar cliques em classes específicas. Neste caso, estamos a utilizar as classes `.main` e `.footer`.

Em seguida, no HTML do seu site, coloque o seguinte:

```html
<!--Código do AgeGo-->
<script src="https://verifycdn.agego.com/v1/verify.js"></script>

<!-- Código com funções personalizadas-->
<script src="main.js"></script>

<!-- Código do fornecedor de anúncios-->
<script async type="application/javascript" src="https://a.magsrv.com/ad-provider.js"></script>

<!-- Zonas de anúncios. XXXX e YYYYY correspondem aos IDs da classe e da zona fornecidos pelo Painel de Administração. -->
<div id="videontv">
  <ins class="XXXXXX" data-zoneid="YYYYYY" data-block-ad-types="101"  data-ex_av="2"></ins> 
  <ins class="XXXXXX" data-zoneid="YYYYYY" data-block-ad-types="101"  data-ex_av="2"></ins> 
</div>

<!-- Código para apresentar anúncios com os parâmetros corretos-->
<script>
	const agegoValue = getCookie("agego_aver");
	if (agegoValue !== false)  {
               console.log("user verified");
        	   const adInsElements = document.querySelectorAll("ins");
        	   adInsElements.forEach(ins => {
            	ins.setAttribute("data-ex_av", "1");
            	ins.setAttribute("data-block-ad-types", "0");
        		});
    	   }
             else {
                 console.log("user not verified");
                 ['pointerdown', 'click', 'touchstart'].forEach(type => {
                 document.addEventListener(type, intercept, { capture: true });
                 });
             }
	(AdProvider = window.AdProvider || []).push({"serve": {}});
</script>
```

Neste exemplo, **os anúncios são SFW por predefinição até o utilizador confirmar a sua idade**. Quando o utilizador clica nas classes selecionadas que mencionámos anteriormente, a sobreposição AgeGO é apresentada. Depois de o utilizador confirmar a idade, **a página é carregada normalmente e, desta vez, não bloqueia quaisquer anúncios**.

***

Algumas notas sobre este tutorial:

1. Esta configuração depende do cookie `agego_aver` definido pelo AgeGO. No entanto, isto pode ser alterado: pode definir um valor no localStorage usando os eventos do script AgeGO e, em seguida, decidir que anúncios apresentar com base nesse valor.
2. Ambos os métodos se concentram apenas na apresentação de anúncios. Este código não tem em conta as miniaturas dos vídeos nem outros conteúdos do site.
3. Atualmente, o AgeGO não tem deteção de países integrada. Tem de decidir quando pretende apresentar este código.

***

Se quiser configurar `data-ex_av` e `data-block-ad-types` com base em diferentes eventos à sua escolha, consulte os nossos outros tutoriais: [bloquear tipos de anúncios dinamicamente](https://docs.exoclick.com/tutorials/pt/tutoriais/tutoriais-para-editores/dynamically-block-ads-using-data-block-ad-types.md), [bloquear dinamicamente tipos de anúncios em zonas de anúncios in-stream](https://docs.exoclick.com/tutorials/pt/tutoriais/tutoriais-para-editores/dynamically-block-ad-types-for-exoclick-in-stream-zones.md).

Por último, para uma integração mais genérica de zonas de anúncios com uma solução de verificação da idade, consulte [este outro tutorial.](https://docs.exoclick.com/tutorials/pt/tutoriais/tutoriais-para-editores/serve-sfw-ads.md)


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.exoclick.com/publishers/pt/exoclick-agego.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
