Руководство по интеграции сайта вуза с партнерской сетью Edulid

Этот способ подходит для учебных заведений, которые используют CRM-системы (Bitrix24, AmoCRM, RetailCRM и другие).

Шаг 1: Сохранение идентификатора партнера

1. Добавьте код для сохранения параметра click в cookies на 30 дней:
2. Код для сохранения click в cookies (нажмите, чтобы развернуть)

   <script>
   function setCookie(name, value, days) {
       let expires = "";
       if (days) {
           let date = new Date();
           date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
           expires = "; expires=" + date.toUTCString();
       }
       document.cookie = name + "=" + (value || "") + expires + "; path=/";
   }
   let urlParams = new URLSearchParams(window.location.search);
   let click = urlParams.get('click') || '';
   if (click) setCookie('click', click, 30);
   </script>

3. Попросите вашего технического специалиста вставить этот код перед закрывающим тегом </body> на всех посадочных страницах, куда могут приходить абитуриенты.
4. После установки кода, параметр click будет сохраняться в cookies и использоваться даже если пользователь вернется на сайт позже.

Шаг 2: Передача идентификатора партнера в CRM

1. Добавьте скрытое поле в форму заявки на вашем сайте:
2. Код для добавления скрытого поля в форму (нажмите, чтобы развернуть)

   <form>
       <!-- Ваши стандартные поля формы (имя, телефон и т.д.) -->
       <input type="hidden" name="click" id="click_input" value="">
       <script>
       function getCookie(name) {
           let matches = document.cookie.match(new RegExp(
               "(?:^|; )" + name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + "=([^;]*)"
           ));
           return matches ? decodeURIComponent(matches[1]) : '';
       }
       let click = getCookie('click') || new URLSearchParams(window.location.search).get('click') || '';
       document.getElementById('click_input').value = click;
       </script>
   </form>

3. Настройте вашу CRM-систему для приема и сохранения параметра click. В большинстве CRM это делается через создание дополнительного поля в карточке лида/клиента.
4. Проверьте, что значение click корректно сохраняется в CRM при отправке формы.

Шаг 3: Отправка информации о новом лиде в Edulid

1. Когда абитуриент отправляет заявку, необходимо передать информацию в Edulid:
2. PHP-код для отправки данных о лиде (нажмите, чтобы развернуть)

   <?php
   $token = '123-abcd'; // Ваш токен (получите у администратора)
   $click = $_POST['click']; // Идентификатор партнера из формы
   $exto = 'ORDER123'; // Номер заявки из вашей CRM
   $url = "https://edulids.com/api/site/click.json?token=$token&click=$click&exto=$exto&status=hold";
   file_get_contents($url);
   ?>

3. Python-код для отправки данных о лиде (нажмите, чтобы развернуть)

   import requests
   token = '123-abcd'  # Ваш токен (получите у администратора)
   click = '67890'     # Идентификатор партнера из формы
   exto = 'ORDER123'   # Номер заявки из вашей CRM
   url = f"https://edulids.com/api/site/click.json?token={token}&click={click}&exto={exto}&status=hold"
   requests.get(url)
   

4. Ваш технический специалист должен настроить автоматическую отправку этого запроса при создании новой заявки в CRM.

Шаг 4: Подтверждение успешной конверсии

1. Когда абитуриент выполняет целевое действие (оплачивает курс, зачисляется и т.д.), необходимо отправить подтверждение в Edulid:
2. PHP-код для подтверждения конверсии (нажмите, чтобы развернуть)

   <?php
   $token = '123-abcd'; // Ваш токен (получите у администратора)
   $click = '67890';    // Идентификатор партнера из CRM
   $exto = 'ORDER123';  // Номер заявки из вашей CRM
   $url = "https://edulids.com/api/site/status.json?token=$token&click=$click&exto=$exto&status=approved";
   file_get_contents($url);
   ?>

3. Python-код для подтверждения конверсии (нажмите, чтобы развернуть)

   import requests
   token = '123-abcd'  # Ваш токен (получите у администратора)
   click = '67890'     # Идентификатор партнера из CRM
   exto = 'ORDER123'   # Номер заявки из вашей CRM
   url = f"https://edulids.com/api/site/status.json?token={token}&click={click}&exto={exto}&status=approved"
   requests.get(url)
   

SELECT click, exto, status FROM leads WHERE status = 'approved';

Этот способ подходит для учебных заведений, у которых есть сайт с базой данных, но нет CRM-системы.

Шаг 1: Сохранение идентификатора партнера

1. Добавьте код для сохранения параметра click в cookies на 30 дней:
2. Код для сохранения click в cookies (нажмите, чтобы развернуть)

   <script>
   function setCookie(name, value, days) {
       let expires = "";
       if (days) {
           let date = new Date();
           date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
           expires = "; expires=" + date.toUTCString();
       }
       document.cookie = name + "=" + (value || "") + expires + "; path=/";
   }
   let urlParams = new URLSearchParams(window.location.search);
   let click = urlParams.get('click') || '';
   if (click) setCookie('click', click, 30);
   </script>

3. Попросите вашего технического специалиста вставить этот код перед закрывающим тегом </body> на всех посадочных страницах.

Шаг 2: Сохранение идентификатора партнера в базе данных

1. При получении заявки, сохраните идентификатор click вместе с другими данными абитуриента:
2. PHP-код для сохранения данных в базе (нажмите, чтобы развернуть)

   <?php
   $click = $_POST['click'];  // Получаем click из формы
   $name = $_POST['name'];    // Имя абитуриента
   $phone = $_POST['phone'];  // Телефон абитуриента
   
   // Подключение к базе данных
   $db = new PDO('mysql:host=localhost;dbname=your_db', 'user', 'pass');
   
   // Сохранение данных
   $stmt = $db->prepare("INSERT INTO leads (click, name, phone) VALUES (?, ?, ?)");
   $stmt->execute([$click, $name, $phone]);
   
   // Получаем ID новой записи для использования в качестве exto
   $exto = $db->lastInsertId();
   ?>

3. Python-код для сохранения данных в базе (нажмите, чтобы развернуть)

   import sqlite3
   
   click = '67890'            # Идентификатор партнера из формы
   name = 'Иван Иванов'       # Имя абитуриента
   phone = '+79991234567'     # Телефон абитуриента
   
   # Подключение к базе данных
   conn = sqlite3.connect('leads.db')
   cursor = conn.cursor()
   
   # Сохранение данных
   cursor.execute("INSERT INTO leads (click, name, phone) VALUES (?, ?, ?)", 
                 (click, name, phone))
   conn.commit()
   
   # Получаем ID новой записи для использования в качестве exto
   exto = cursor.lastrowid
   conn.close()
   

Шаг 3: Отправка информации о новом лиде в Edulid

1. После сохранения заявки в базе данных, передайте информацию в Edulid:
2. PHP-код для отправки данных о лиде (нажмите, чтобы развернуть)

   <?php
   $token = '123-abcd';       // Ваш токен (получите у администратора)
   $click = $_POST['click'];  // Идентификатор партнера из формы
   $exto = $db->lastInsertId(); // ID заявки в вашей базе
   
   $url = "https://edulids.com/api/site/click.json?token=$token&click=$click&exto=$exto&status=hold";
   file_get_contents($url);
   ?>

3. Python-код для отправки данных о лиде (нажмите, чтобы развернуть)

   import requests
   
   token = '123-abcd'     # Ваш токен (получите у администратора)
   click = '67890'        # Идентификатор партнера из формы
   exto = str(cursor.lastrowid)  # ID заявки в вашей базе
   
   url = f"https://edulids.com/api/site/click.json?token={token}&click={click}&exto={exto}&status=hold"
   requests.get(url)
   

Шаг 4: Подтверждение успешной конверсии

1. Когда абитуриент выполняет целевое действие, отправьте подтверждение в Edulid:
2. PHP-код для подтверждения конверсии (нажмите, чтобы развернуть)

   <?php
   $token = '123-abcd';   // Ваш токен (получите у администратора)
   $click = '67890';      // Идентификатор партнера из базы данных
   $exto = '123';         // ID заявки в вашей базе
   
   $url = "https://edulids.com/api/site/status.json?token=$token&click=$click&exto=$exto&status=approved";
   file_get_contents($url);
   ?>

3. Python-код для подтверждения конверсии (нажмите, чтобы развернуть)

   import requests
   
   token = '123-abcd'     # Ваш токен (получите у администратора)
   click = '67890'        # Идентификатор партнера из базы данных
   exto = '123'           # ID заявки в вашей базе
   
   url = f"https://edulids.com/api/site/status.json?token={token}&click={click}&exto={exto}&status=approved"
   requests.get(url)
   

Этот способ подходит для учебных заведений с простыми сайтами, без возможности настройки базы данных или CRM.

Как это работает

Вместо стандартного перехода на страницу "Спасибо" после отправки формы, абитуриент сначала перенаправляется на специальный URL Edulid, который регистрирует лид, а затем возвращается на вашу страницу "Спасибо".

Шаг 0: Использование собственного домена (опционально)

1. Если вы хотите использовать собственный домен для редиректа (например, https://track.university.edu/thanks), сообщите вашему администратору (@orlovee) желаемый домен.
2. Мы предоставим вам IP-адрес для настройки DNS-записи (A-запись).
3. После настройки ваш редирект будет работать через ваш домен.

Шаг 1: Настройка редиректа

1. После отправки формы, перенаправьте абитуриента на специальный URL:
2. PHP-код для редиректа (нажмите, чтобы развернуть)

   <?php
   // Номер заявки или любой другой идентификатор
   $exto = 'ORDER' . rand(1000, 9999);
   
   // URL вашей страницы "Спасибо"
   $redirect = urlencode('https://university.edu/thank-you');
   
   // Перенаправление
   header("Location: https://r.edulids.com/university-x-courses/thanks?redirect=$redirect&exto=$exto");
   exit;
   ?>

3. Python-код для редиректа (на примере Flask) (нажмите, чтобы развернуть)

   from flask import Flask, redirect
   import random
   
   app = Flask(__name__)
   
   @app.route('/submit', methods=['POST'])
   def submit():
       # Номер заявки или любой другой идентификатор
       exto = 'ORDER' + str(random.randint(1000, 9999))
       
       # URL вашей страницы "Спасибо"
       redirect_url = 'https://university.edu/thank-you'
       
       # Перенаправление
       return redirect(f"https://r.edulids.com/university-x-courses/thanks?redirect={redirect_url}&exto={exto}")
   

4. Если у вас нет возможности сгенерировать уникальный exto, используйте параметры phone или email абитуриента как идентификатор. Пример:
5. PHP-код с использованием телефона (нажмите, чтобы развернуть)

   <?php
   $phone = $_POST['phone']; // Телефон из формы
   $redirect = urlencode('https://university.edu/thank-you');
   header("Location: https://r.edulids.com/university-x-courses/thanks?redirect=$redirect&phone=$phone");
   exit;
   ?>

Шаг 2: Подтверждение успешной конверсии

1. Этот способ автоматически регистрирует лид в статусе hold. Для передачи статуса approved предоставьте доступ к вашей базе данных (по согласованию с администратором):
2. Пример SQL-запроса для передачи статусов (нажмите, чтобы развернуть)

   SELECT click, exto, status FROM leads WHERE status = 'approved';

3. Альтернативно, свяжитесь с администратором для настройки ручной передачи статусов.

Этот способ подходит для учебных заведений, которые могут добавить код только на страницу "Спасибо" и не имеют сложной серверной логики.

Как это работает

После отправки формы на странице "Спасибо" загружается невидимый пиксель (изображение 1x1 пиксель), который отправляет данные о лиде в Edulid.

Шаг 1: Добавление пикселя

1. Добавьте следующий код на страницу "Спасибо":
2. Код пикселя (нажмите, чтобы развернуть)

   <img src="https://r.edulids.com/pixel?exto=ORDER123&redirect=https://university.edu/thank-you" width="1" height="1" style="display:none;">

3. Реальный URL пикселя запросите у администратора (@orlovee).
4. Дополнительно можно передать параметры: fname (имя), email или phone. Пример:
5. Код пикселя с дополнительными параметрами (нажмите, чтобы развернуть)

   <img src="https://r.edulids.com/pixel?exto=ORDER123&fname=Иван&phone=+79991234567&redirect=https://university.edu/thank-you" width="1" height="1" style="display:none;">

6. Убедитесь, что пиксель загружается только после успешной отправки формы.

Шаг 2: Подтверждение успешной конверсии

1. Этот способ автоматически регистрирует лид в статусе hold. Для передачи статуса approved предоставьте доступ к вашей базе данных (по согласованию с администратором):
2. Пример SQL-запроса для передачи статусов (нажмите, чтобы развернуть)

   SELECT click, exto, status FROM leads WHERE status = 'approved';

3. Альтернативно, свяжитесь с администратором для настройки ручной передачи статусов.

После настройки интеграции важно убедиться, что всё работает корректно.

Как протестировать

1. Запросите тестовую ссылку у администратора (@orlovee). Пример: https://university.edu/signup?click=TEST123.
2. Перейдите по ссылке, заполните форму и отправьте заявку.
3. Сообщите администратору номер вашей тестовой заявки (exto) или другие идентификаторы (phone, email).
4. Администратор проверит, что данные о лиде дошли до системы Edulid, и сообщит вам результат.