Передача данных в Linkodium Analytics

API URI

https://a.linkodium.com/submit/API_KEY/

Формат

www-form-urlencoded, метод POST

Где API_KEY — ключ проекта из личного кабинета (где его взять).

<?php
    $api_key  = "aaeaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee";

    $crm_data = [
        'name'       => "Иван Иванов",
        'phone'      => "+7 (999) 999-99-99",
        'email'      => "test@example.com",
        'message'    => "Тестовое сообщение",
        'ip'         => "127.0.0.1",
        'user_agent' => "Mozilla/5.0 (Linux; Android 6.0.1; SM-G532F)",
        'start_url'  => "https://example.com/?utm_source=yandex",
        'order_url'  => "https://example.com/order",
        'referer'    => "https://yandex.ru"
    ];

    $ch = curl_init("https://a.linkodium.com/submit/$api_key/");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $crm_data);
    $response = curl_exec($ch);
    curl_close($ch);
?>

При успешной обработке заявки в теле ответа будет передано:

{"status":"success"}

В противном случае:

{"status":"error"}

Ответ со статусом error означает, что заявка не сохранена, — например, ключ проекта неверен или проект отключён. Если сервис временно недоступен, отдаётся код ответа 503: такой запрос имеет смысл повторить, в отличие от error.

Рекомендации

При каждом визите пользователя рекомендуется создавать сессию, в которую сохранять следующие параметры — они будут переданы в Linkodium Analytics в случае успешной отправки заявки:

• IP-адрес пользователя
• User-agent
• URL входа
• URL заявки
• Реферер

Пример PHP-скрипта для сохранения необходимых данных — можно разместить в index.php:

<?php
    # Linkodium Analytics
    session_start();
    if (!isset($_SESSION['start_url'])) {
        $_SESSION['start_url'] = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on' ? "https" : "http")
                               . "://" . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];

        if (isset($_SERVER['HTTP_REFERER'])) {
            $_SESSION['referer'] = $_SERVER['HTTP_REFERER'];
        } else {
            $_SESSION['referer'] = "";
        }

        $_SESSION['user_agent'] = $_SERVER['HTTP_USER_AGENT'];
    }
    # /Linkodium Analytics
?>

Сессия нужна именно потому, что источник визита известен только на первой странице: к моменту отправки формы пользователь может уйти на десятую, и реферер с UTM-метками там уже не увидеть. Подробнее об этом — в статье про URI fragment.