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

# Как интегрировать ExoClick с AgeGO

В этом руководстве объясняется:

* как добавить сайт в AgeGO;
* как передавать параметры проверки возраста в ExoClick и блокировать рекламу в рекламных зонах;
* как совместно интегрировать AgeGO и рекламные зоны ExoClick, чтобы показывать пользователям рекламу категории SFW до подтверждения возраста.

## Как добавить сайт в AgeGO

Чтобы добавить сайт в AgeGO, войдите в [панель управления AgeGO](https://dashboard.agego.com/login). Затем перейдите в раздел «Мои сайты» и нажмите «Новый сайт»:

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

В этих настройках необходимо как минимум указать **название** и **домен верхнего уровня**. Заполнив эти настройки, нажмите «Создать». Сайт будет добавлен в ваш аккаунт.

По умолчанию после создания всем сайтам присваивается статус «Готов». Однако это не означает, что сайт уже может использовать AgeGO. Чтобы включить AgeGO на сайте, необходимо [**связаться с AgeGO через форму обратной связи**](https://www.agego.com/contact-us-business) **и указать идентификатор сайта (Site ID), присвоенный вашему сайту.**

Идентификатор сайта указан рядом с его названием:

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

После одобрения сайта его статус изменится на «Работает», и вы сможете воспользоваться инструкциями по интеграции AgeGO на сайте. Сейчас доступны два способа интеграции: **модальное окно (простой или расширенный вариант)** и **S2S**. Инструкции по настройке каждого способа доступны в панели управления AgeGO. В этом руководстве мы рассмотрим способ **с модальным окном** .

## Как передавать статус проверки возраста и показывать рекламу категории SFW

При использовании системы проверки возраста (AgeGO или другого поставщика) вы можете продолжать показывать рекламу всем пользователям — как тем, кто не подтвердил возраст, так и тем, кто его подтвердил.

Чтобы указать, прошёл ли пользователь проверку возраста, используйте параметр `data-ex_av` в рекламных зонах. Этот параметр принимает три значения:

* "0": проверка возраста не проводилась (не задано)
* "1": проверка возраста — пройдена
* "2": проверка возраста — не пройдена

Затем, чтобы блокировать рекламу для определённых пользователей (в данном случае — для тех, кто не подтвердил возраст), используйте параметр `data-block-ad-types` Этот параметр принимает несколько значений, но в этом руководстве мы будем использовать только значение `101`.

Итак, чтобы показывать рекламу категории SFW и обозначить пользователя как ещё не подтвердившего возраст, передайте параметры следующим образом:

* **Асинхронные форматы рекламы (баннер, FPI, мультиформат и т. д.):**

```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 (ссылка)**: `https://s.pemsrv.com/v1/link.php?cat=&idzone=XXXXX&type=8&ex_av=2&block_ad_types=101`
* **Прямая ссылка**: `https://s.zlinkt.com/v1/d.php?z=XXXXXXX&ex_av=2&block_ad_types=101`

**Примечание**: необходимо использовать оба параметра `data-ex_av` и `data-block-ad-types` при показе рекламы SFW, иначе пользователь не будет корректно идентифицирован, а реклама не будет заблокирована.

А если вы хотите показывать проверенному пользователю рекламу всех типов, настройте её следующим образом:

* **Асинхронные форматы рекламы (баннер, FPI, мультиформат и т. д.):**

```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>
```

* **Видеореклама в потоке**: `https://s.magsrv.com/v1/vast.php?idzone=XXXXXXXX&ex_av=1`
* **Попандер (ссылка)**: `https://s.pemsrv.com/v1/link.php?cat=&idzone=XXXXXXX&type=8&ex_av=1`
* **Прямая ссылка**: `https://s.zlinkt.com/v1/d.php?z=XXXXXXX&ex_av=`

## Как создать среду SFW

В следующем руководстве объясняется, как создать «среду SFW», то есть настроить показ только рекламы SFW, пока пользователь не подтвердил свой возраст. Обратите внимание: этот способ — лишь рекомендация. При необходимости вы можете изменить настройки, чтобы реализовать другой сценарий взаимодействия с пользователем.

Для этого нам потребуется создать отдельный файл скрипта. В этом примере мы назвали его `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 of your 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);
}
```

Этот файл содержит три функции: функцию для обнаружения файлов cookie, функцию для загрузки оверлея AgeGO и функцию для обнаружения кликов по определённым классам. В данном случае мы используем классы `.main` и `.footer`.

Затем в HTML-коде сайта разместите следующее:

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

<!-- Код с пользовательскими функциями-->
<script src="main.js"></script>

<!--Код рекламного провайдера-->
<script async type="application/javascript" src="https://a.magsrv.com/ad-provider.js"></script>

<!-- Рекламные зоны. XXXX и YYYYY соответствуют идентификаторам класса и зоны, указанным в панели администратора. -->
<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>

<!-- Код показа рекламы с нужными параметрами-->
<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>
```

В этом примере **по умолчанию показывается реклама для всех аудиторий, пока пользователь не подтвердит свой возраст**. При нажатии пользователем на упомянутые выше выбранные классы появится оверлей AgeGO. После подтверждения возраста **страница загрузится как обычно, и на этот раз показ рекламы не будет заблокирован**.

***

Несколько замечаний по этому руководству:

1. В этой настройке используется `agego_aver` cookie, устанавливаемая AgeGO. Однако это можно изменить: вы можете задать значение в localStorage с помощью событий скрипта AgeGO, а затем выбирать показываемую рекламу на основе этого значения.
2. Оба метода касаются только показа рекламы. Миниатюры видео и другой контент сайта в этом коде не учитываются.
3. В настоящее время в AgeGO нет встроенного определения страны. Вам нужно самостоятельно решить, когда показывать этот код.

***

Если вы хотите настраивать `data-ex_av` и `data-block-ad-types` в зависимости от выбранных вами событий, ознакомьтесь с другими нашими руководствами: [динамическая блокировка типов рекламы](https://docs.exoclick.com/tutorials/ru/uchebnye-materialy/uchebnye-materialy-dlya-izdatelei/dynamically-block-ads-using-data-block-ad-types.md), [динамическая блокировка типов рекламы в зонах показа рекламы в потоке видео](https://docs.exoclick.com/tutorials/ru/uchebnye-materialy/uchebnye-materialy-dlya-izdatelei/dynamically-block-ad-types-for-exoclick-in-stream-zones.md).

Наконец, руководство по более универсальной интеграции рекламной зоны с решением для проверки возраста см. [в этом руководстве.](https://docs.exoclick.com/tutorials/ru/uchebnye-materialy/uchebnye-materialy-dlya-izdatelei/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/ru/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.
