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

# Come integrare ExoClick con AgeGO

Questa guida spiega:

* Come inviare un sito ad AgeGO.
* Come passare i parametri di verifica dell’età a ExoClick e bloccare gli annunci nelle zone pubblicitarie.
* Come integrare le zone pubblicitarie di AgeGO ed ExoClick per mostrare annunci SFW agli utenti prima che verifichino la propria età.

## Come inviare un sito ad AgeGO

Per inviare un sito ad AgeGO, accedi alla [dashboard di AgeGO](https://dashboard.agego.com/login). Quindi vai su “I miei siti” e fai clic su “Nuovo sito”:

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

In queste impostazioni, devi aggiungere almeno il **Nome** e il **Dominio di primo livello**. Dopo aver completato queste impostazioni, fai clic su “Crea”. Il sito verrà aggiunto al tuo account.

Per impostazione predefinita, al momento della creazione tutti i siti hanno lo stato “Pronto”. Tuttavia, questo non significa che il tuo sito possa già usare AgeGO. Per attivare AgeGO sul tuo sito, devi [**contattare AgeGO tramite il relativo modulo di contatto**](https://www.agego.com/contact-us-business) **e fornire l’ID sito associato al tuo sito.**

Puoi trovare l’ID sito accanto al nome del sito:

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

Una volta approvato il sito, il suo stato diventerà “In esecuzione” e potrai seguire le istruzioni di integrazione per integrare AgeGO nel tuo sito. Questa soluzione offre attualmente due metodi, **Modalità (semplice o avanzata)** e **S2S**, e le istruzioni di configurazione per ciascun metodo sono disponibili nella dashboard di AgeGO. In questa guida parleremo del metodo **Modalità** .

## Come passare lo stato della verifica dell’età e mostrare annunci SFW

Quando usi un sistema di verifica dell’età (AgeGO o un altro fornitore), potresti voler continuare a mostrare annunci a tutti gli utenti, sia a quelli che non hanno verificato la propria età sia a quelli che l’hanno fatto.

Per identificare un utente come qualcuno che ha (o non ha) superato la verifica dell’età, usa il parametro `data-ex_av` nelle zone pubblicitarie. Questo parametro accetta 3 valori:

* "0": Nessuna verifica dell’età (non definita)
* "1": Verifica dell’età: verificata
* "2": Verifica dell’età: non verificata

Per bloccare gli annunci per determinati utenti (in questo caso, quelli che non hanno verificato la propria età), usa il parametro `data-block-ad-types` che accetta più valori. In questa guida, tuttavia, useremo solo il valore `101`.

Quindi, se vuoi mostrare un annuncio SFW e identificare l’utente come qualcuno che non ha ancora verificato la propria età, integra i parametri in questo modo:

* **Formati pubblicitari asincroni (banner, FPI, multi-formato ecc.):**

```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 diretto**: `https://s.zlinkt.com/v1/d.php?z=XXXXXXX&ex_av=2&block_ad_types=101`

**Nota**: Devi usare entrambi `data-ex_av` e `data-block-ad-types` quando si pubblicano annunci SFW, altrimenti l’utente non verrà identificato correttamente e gli annunci non verranno bloccati.

Se invece vuoi pubblicare tutti i tipi di annunci per un utente verificato, procedi così:

* **Formati pubblicitari asincroni (banner, FPI, multi-formato ecc.):**

```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 (link)**: `https://s.pemsrv.com/v1/link.php?cat=&idzone=XXXXXXX&type=8&ex_av=1`
* **Link diretto**: `https://s.zlinkt.com/v1/d.php?z=XXXXXXX&ex_av=`

## Come creare un’esperienza SFW

Il tutorial seguente spiega come creare un’«esperienza SFW», ovvero come assicurarsi che vengano pubblicati solo annunci SFW finché l’utente non ha ancora verificato la propria età. Tieni presente che questo metodo è solo un consiglio e che puoi modificare la configurazione se devi seguire un flusso utente diverso.

Per questa configurazione, dovremo creare un file di script separato. In questo esempio, lo abbiamo chiamato `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, // Site ID of your site in AgeGo
	autoBlur: true,
	verifyMode: 'inline', 
	requireAgeVerification: true, 
	allowDirectContinue: false, 
	overlay: {
		logo: 'wlogo.png', // Logo del tuo sito
		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);
}
```

Questo file contiene tre funzioni: una funzione per rilevare i cookie, una per caricare la schermata sovrapposta di AgeGO e una per rilevare i clic su classi specifiche. In questo caso, usiamo le classi `.main` e `.footer`.

Poi, nell'HTML del tuo sito, inserirai quanto segue:

```html
<!--Codice di AgeGo-->
<script src="https://verifycdn.agego.com/v1/verify.js"></script>

<!-- Codice con funzioni personalizzate-->
<script src="main.js"></script>

<!-- Codice del fornitore di annunci-->
<script async type="application/javascript" src="https://a.magsrv.com/ad-provider.js"></script>

<!-- Zone pubblicitarie. XXXX e YYYYY corrispondono alla classe e agli ID delle zone forniti dal pannello di amministrazione. -->
<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>

<!-- Codice per pubblicare gli annunci con i parametri corretti-->
<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>
```

In questo esempio, **gli annunci sono sicuri per tutti (SFW) per impostazione predefinita, finché l'utente non verifica la propria età**. Quando l'utente fa clic sulle classi selezionate menzionate in precedenza, verrà visualizzata la schermata sovrapposta di AgeGO. Dopo aver verificato la propria età, **la pagina si caricherà normalmente e, questa volta, non bloccherà alcun annuncio.**.

***

Alcune note su questo tutorial:

1. Questa configurazione si basa sul cookie `agego_aver` impostato da AgeGO. Tuttavia, è possibile modificarla: puoi impostare un valore in localStorage utilizzando gli eventi dello script AgeGO e poi decidere quali annunci mostrare in base a tale valore.
2. Entrambi i metodi si concentrano esclusivamente sulla pubblicazione degli annunci. In questo codice non vengono presi in considerazione le miniature dei video né gli altri contenuti del sito web.
3. Al momento, AgeGO non dispone di una funzionalità integrata per rilevare il paese. Devi decidere quando mostrare questo codice.

***

Se vuoi impostare `data-ex_av` e `data-block-ad-types` in base a diversi eventi a tua scelta, dai un'occhiata agli altri tutorial: [bloccare dinamicamente i tipi di annunci](https://docs.exoclick.com/tutorials/it/tutorial/tutorial-per-publisher/dynamically-block-ads-using-data-block-ad-types.md), [bloccare dinamicamente i tipi di annunci nelle aree pubblicitarie in-stream](https://docs.exoclick.com/tutorials/it/tutorial/tutorial-per-publisher/dynamically-block-ad-types-for-exoclick-in-stream-zones.md).

Infine, per un'integrazione più generica tra un'area pubblicitaria e una soluzione di verifica dell'età, consulta [quest'altro tutorial.](https://docs.exoclick.com/tutorials/it/tutorial/tutorial-per-publisher/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/it/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.
