Adam

Схемный трафик (ч. 2): Построение командной структуры на основе связки Keitaro + PuzzleBot

2023-07-02T19:26:16.382Z

В предыдущей статье (ч. 1) мы разобрали как связать партнерку => Keitaro => PuzzleBot в единую "триаду" для построения автоворонок внутри Telegram. Уверен, многие посыпались от технических сложностей и по итогу забили на подобный способ пролива. Возможно кого-то не убедили плюсы высказанные в пользу бота и все как лили на тг-каналы, так и льют.

Использование PuzzleBot в схемном трафике позволяет снизить нагрузки на обработчиков и сделать контент персонализированным (подробнее о всех плюсах в первой части). Помимо этого существуют плюсы "второго уровня", которые снимают головняки как с овнеров, так и с обработчиков.

Для того чтобы увидеть эти возможности, необходимо обладать чуть бОльшим количеством знаний в программировании, чем нам требовалось в ч.1. Но даже если вы ими не обладаете, всегда есть Chat GPT, в котором можно собрать все что угодно букавально в пару кликов. К слову код приведенный ниже, "блочно" собран именно в нейронке GPT.

Плюсы тг-ботов для овнеров:

Невозможность повторно записать деп к себе в стату, если этот деп уже присвоен другому обработчику (обмануть / украсть). В связи с этим не нужен спец. человек, который будет заниматься проверкой и подсчетом депов и выплат каждому из обрабов (считается автоматически ботом).
Полная изолированность сотрудников от внутренних процессов / доступа в партнерки / трекеры. Обработчики в лучшем случае будут иметь доступ в Кейтаро, но и без этого можно обойтись с помощью персонального бота под каждого обработчика (пример кода приведен ниже в статье).

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

Плюсы тг-ботов для обработчиков:

Легкая, интуитивно-понятная запись депа к себе в стату обработчиком. Больше не надо просить юзера прислать его ID на платформе казино, у нас вся привязка осуществляется по chat_id юзера в Telegram
Легкая доступность статистики для обработчика через персонального бота обработчика + автоматический рассчет выплаты / прямого доступа в Кейтаро (по усмотрению овнера)

Общие минусы:

Всех юзеров надо регистрировать через специальную ссылку на бота с параметром ?start=имя_обраба. Не обязательно заливать конкретно на бота, можно и на канал, но ссылка с канала должна вести на бота со специальным параметром, чтобы бот сразу же скидывал ссылку для регистрации юзеру, вместо обычных постов на команде start

Объяснение реализации

Прежде чем реализовать подобную схему, необходимо понять как это работает и что на что влияет с технической точки зрения. Рекомендую обратить внимание на названия параметров, это особенно важно. Набросал небольшую схему в Miro, чтобы было проще сложить паззл в голове, настоятельно рекомендую ознакомиться:

Я специально создал схему с логикой работы скрипта, чтобы команды могли отдать это своим штатным кодерам. Мой код ниже - это лишь пример возможностей не претендующий на лучшее качество и тд.

Требования

- Наличие редакции Keitaro с admin api
- Базовое понимание работы трекера
- Базовое понимание кода и работы с python

Настройка скрипта

1. У меня код стоит на винде, поэтому и рассказывать я буду про винду. Для начала нам надо накатить python 3й версии. Далее устанавливаем переменные среды для удобной работы. После этого открываем cmd и ставим библиотеки requests и aiogram следующими командами:
- pip install requests
- pip install aiogram

2. Когда пайтон и библиотеки установлены, можно приступить к настройке кода. Создаем папку в любом месте системы и в ней создаем текстовик с содержимым указанным ниже. Далее файл нужно будет переименовать в .py вместо .txt.

Код приведенный ниже полностью написан с помощью Chat GPT точечными запросами. Т.е я писал его не целиком, а именно блочно, соединяя потом эти блоки воедино. По сути это демонстрирует возможности, которые открываются буквально всем, было бы время и желание в этом развиваться. Поэтому enjoy, можно писать все что угодно для командной структуры затрачивая минимум времени.

import requests
from aiogram import Bot, Dispatcher, types
from aiogram.contrib.fsm_storage.memory import MemoryStorage
from aiogram.dispatcher import FSMContext
from aiogram.dispatcher.filters import Command
from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton, CallbackQuery
import datetime
import os

# ==================== CONFIG ====================
# Настройки телеграм
bot_token = 'from_botfather_token' # Тут указываем токен бота созданного в @botfather_bot

# Настройки кейтаро
kt_address = 'https://domain.com' # Необходимо указать домен привязанный в Кейтаро на ssl сертификате (обязательно!)
kt_token = 'keitaro_token' # Получаем админский токен от Кейтаро тут - keitarodomain.com/admin/#!/profile/admin_api_keys
kt_timezone = 'Europe/Moscow' # От часового пояса будет зависеть разбивка статы у обработчика

# Внутренние переменные бота
admin = '@admin' # Здесь необходимо указать ник юзера, отвечающего за тех. обслуживание ботов для обработчиков. В случае ошибки, обработчик будет знать кому переслать ошибку выданную ботом
chat_id = '' # Оставляем пустым, не обращаем внимание
handler_name = 'az' # Это метка обработчика, которая будет записываться в Кейтаро. Не указывайте длинные метки, пусть лучше будут 2-3 символа
aff_links = [{'Grecia - GR':'https://my.links'}] # Тут можно указывать список ссылок в формате json array. Все эти ссылки будут присылаться обработчику после вызова команды /links. Бот будет подставлять метку handler_name в каждую из ссылок

# Путь к файлу с логами chat_id
chat_ids_file = 'chat_ids.txt' # Если для вас название файла лога не имеет значение, оставляем все как есть
# ==================== CONFIG ====================

# Инициализируем бота и диспетчера
bot = Bot(token=bot_token)
storage = MemoryStorage()
dp = Dispatcher(bot, storage=storage)

# Подпись в консоли чей бот
print(f'============== {handler_name} ==============')

# Проверка наличия chat_id в файле
def check_chat_id(chat_id):
    if os.path.isfile(chat_ids_file):
        with open(chat_ids_file, 'r') as file:
            return str(chat_id) in file.read()
    else:
        return False

def clear_text_file():
    # Открытие файла в режиме записи (существующий файл будет перезаписан)
    with open(chat_ids_file, 'w') as file:
        # Запись пустой строки в файл
        file.write('')

# Запись chat_id в файл
def write_chat_id(chat_id):
    with open(chat_ids_file, 'a') as file:
        file.write(str(chat_id) + '\n')

def calculate_payment(client_count):
    if client_count <= 15:
        payment = 1 * client_count
    elif client_count <= 30:
        payment = (1 * 15) + (2 * (client_count - 15))
    elif client_count <= 45:
        payment = (1 * 15) + (2 * 15) + (3 * (client_count - 30))
    else:
        payment = (1 * 15) + (2 * 15) + (3 * 15) + (3 * (client_count - 45))

    return payment

periods = [
    {"today": "За сегодня"},
    {"yesterday": "За вчера"},
    {"last_monday": "Текущая неделя"},
    {"7_days_ago": "За последние 7 дней"},
    {"first_day_of_this_month": "Текущий месяц"},
    {"previous_month": "Предыдущий месяц"},
    {"1_month_ago": "За последние 30 дней"}
]

# Обработчик команды /stats
@dp.message_handler(Command('stats'))
async def process_stats_command(message: types.Message, state: FSMContext):
    # Отправляем сообщение с просьбой ввести текст
    await message.reply("Форматы дат: \n"+'\n'.join([f"{list(period.keys())[0]}: {list(period.values())[0]}" for period in periods]))

    # Устанавливаем состояние 'answer' для данного пользователя
    await state.set_state('answer')

# Обработчик ответа с текстом
@dp.message_handler(state="answer", content_types=types.ContentTypes.TEXT)
async def process_text_answer(message: types.Message, state: FSMContext):
    # Получаем текст из ответа
    interval = message.text
    
    if any(interval in item for item in periods):
        body = {
          "range": {
            "interval": interval,
            "timezone": kt_timezone
          },
          "columns": [
            "datetime",
            "campaign",
          ],
          "metrics": [],
          "grouping": [],
          "filters": [
            {
              "name": "is_sale",
              "operator": "IS_TRUE",
              "expression": None
            },
            {
              "name": "sub_id_7",
              "operator": "CONTAINS",
              "expression": handler_name
            }
          ],
          "sort": [
            {
              "name": "datetime",
              "order": "desc"
            }
          ],
          "summary": True,
          "limit": 500,
          "offset": 0
        }

        result = requests.post(f'{kt_address}/admin_api/v1/clicks/log', json=body, headers={'Api-key': kt_token})

        if(result.status_code == 200):
            json = result.json()
            
            results = {}

            for row in json['rows']:
                campaign = row['campaign']
                click_datetime = row['datetime']
                click_date = datetime.datetime.strptime(click_datetime, '%Y-%m-%d %H:%M:%S').strftime('%Y-%m-%d')
                
                if campaign not in results:
                    results[campaign] = {}
                
                if click_date not in results[campaign]:
                    results[campaign][click_date] = 0 
                
                results[campaign][click_date] += 1

            # Сортировка результатов по дате
            sorted_results = {}
            for campaign, dates in results.items():
                sorted_dates = dict(sorted(dates.items(), key=lambda x: datetime.datetime.strptime(x[0], '%Y-%m-%d')))
                sorted_results[campaign] = sorted_dates

            # Форматированный вывод результатов
            for campaign, dates in sorted_results.items():
                output = f"Campaign: {campaign}\n"
                summ_sales = 0
                summ_payout = 0
                
                for date in dates.items():
                    sales = date[1]
                    payout = calculate_payment(date[1])
                    
                    summ_sales += sales
                    summ_payout += payout
                    
                    output += f"  {date[0]}:\n"
                    output += f"    Sales: {sales}\n"
                    output += f'    Payout: {payout}$\n\n'
                
                output += f'------------\nTotal:\nSales: {summ_sales}\nPayout: {summ_payout}$'
                await message.reply(output)
        else:
            print(f'Ошибка запроса {result.status_code}')
    else:
        await message.reply('Неверный формат даты')

    # Сбрасываем состояние 'answer' для данного пользователя
    await state.finish()


@dp.message_handler(Command('links'))
async def links(message: types.Message):
    for link in aff_links:
        key = next(iter(link.keys()))
        await bot.send_message(message.chat.id, f'{key}:')
        await bot.send_message(message.chat.id, f'{link[key]}?start={handler_name}')

# Обработчик команды /help
@dp.message_handler(Command('help'))
async def start(message: types.Message):
    await message.reply(f'''
/help - получить список команд
/links - получить список твоих ссылок
/stats - получить статистику
''')

# Обработчик команды /clear_log
@dp.message_handler(Command('clear_log'))
async def clear_log(message: types.Message):
    clear_text_file()
    await message.reply(f'Файл лога {chat_ids_file} очищен')

# Обработчик пересланных сообщений
@dp.message_handler(content_types=types.ContentType.TEXT, is_forwarded=True)
async def forwarded_message(message: types.Message, state: FSMContext):
    global chat_id
    if message.forward_from:
        chat_id = str(message.forward_from.id)

        if not check_chat_id(chat_id):
            write_chat_id(chat_id)
            await message.reply(f'Запрос на запись юзера {chat_id} на ваше имя {handler_name} в обработке ⚙️') #message.chat.id, 

            # Выполнение указанного кода с тремя попытками
            # tries = 5
            try:
            # for i in range(tries):
                # print(f'Попытка получить данные из трекера по chat_id {chat_id} №{i}')
            
                data = {
                    "range": {
                        "interval": "1_month_ago",
                        "timezone": kt_timezone
                    },
                    "columns": [
                        "sub_id"
                    ],
                    "metrics": [],
                    "grouping": [],
                    "filters": [
                        {
                            "name": "sub_id_9",
                            "operator": "CONTAINS",
                            "expression": chat_id
                        }
                    ],
                    "sort": [
                        {
                            "name": "datetime",
                            "order": "desc"
                        }
                    ],
                    "summary": True,
                    "limit": 250,
                    "offset": 0
                }

                response = requests.post(f'{kt_address}/admin_api/v1/clicks/log', json=data, headers={"Api-Key": kt_token})
                
                # success = False
                
                if response.status_code == 200:
                    rows = response.json().get('rows', [])
                    print(f'Ответ на получение subid\'s по chat_id {chat_id}: {rows}')
                    
                    if len(rows) > 0:
                        completed_subids = []
                    
                        for row in rows:
                            subid = row.get('sub_id')
                              
                            print(f'Началась обработка {subid}')
                            
                        # for _ in range(tries):
                            result = requests.get(f'{kt_address}/?_update_tokens=1&sub_id={subid}&sub_id_7={handler_name}')
                            if result.status_code == 200:
                                completed_subids.append(subid)
                                print(f'Запрос по обновление токенов по {subid} обработан успешно')
                                
                                # break
                            else: 
                                await bot.send_message(message.chat.id, f'Запрос на обновление токена по {subid} завершился ошибкой ❌. Перешли эту ошибку админу бота {admin}')
                        # break
                        
                        completed_subids_str = '\n'.join(completed_subids)
                        await bot.send_message(message.chat.id, f'Все {len(completed_subids)+1} кликов юзера {chat_id} записаны на {handler_name}✅\r\n\r\nСписок subid\'s:\r\n{completed_subids_str}')
                    else:
                        # success = True
                        print(f'Юзер с id {chat_id} не найден в системе трекера')
                        await bot.send_message(message.chat.id, f'Юзер с id {chat_id} не найден в системе трекера 📔. Необходимо чтобы этот юзер был зарегистрирован по одной из трекинговых ссылок. Полный список ссылок по команде /links')
                else:
                    print(f'Не удалось получить данные от keitaro по chat_id {chat_id}. Status code: {response.status_code}')
                    
                # if success:
                    # break
            except Exception as e:
                await bot.send_message(message.chat.id, f"Произошла ошибка при выполнении запроса: {str(e)}. Перешли эту ошибку админу бота {admin}")
        else:
            await message.reply(f'Этот chat_id {chat_id} юзера уже присвоен одному из обработчиков 😔') #message.chat.id,
    else:
        await message.reply('Пересланное сообщение не из чата') #message.chat.id, 

# Запускаем бота
if __name__ == '__main__':
    from aiogram import executor
    executor.start_polling(dp, skip_updates=True)

3. Заменяем все данные в переменных в блоке CONFIG, предварительно внимательно прочитав комментарии к каждой переменной (после #)!

Если все сделано правильно, можно запустить код двумя нажатиями на файл, который вы переименовали в .py во 2-ом шаге. Но лучший вариант запустить отдельно cmd, перейти в папку со скриптом командов cd C:\\путь_до_папки_со_скриптом и только потом через команду python code.py запустить скрипт. Так вы сможете видеть ошибки (traceback's), появляющиеся в момент выполнения скрипта.

Нюансы по работе кода:

Для работы кода выше, необходимо чтобы юзер переходил на регистрацию по вашей трекинговой ссылке кампании с подставленным параметром keitarodomain.com/?chat_id={{USER_ID_TEXT}} - Такую ссылку должен выдавать ваш бот для регистрации. О том как настроить источник и его параметры в ч.1
Источник в кейтаро должен иметь параметр для хранения метки оператора. У меня к примеру это sub_id_7 и код под это заточен. Если вы хотите изменить метку в которой у вас будет храниться параметр с именем оператора, измените его в источнике, затем в кампании и в коде в 266 строчке {kt_address}/?_update_tokens=1&sub_id={subid}&sub_id_7={handler_name} (sub_id_ваш_id_метки)
Запись лида на юзера производится в клики Кейтаро, не в конверсии. Т.е мы не можем обновить параметры внутри конверсий, тк. будет повторная отработка s2s если таковые в кампании имеются. Соотв. смотреть стату по конверсиям не получится, но нам доступна стата кампании.
Каждый файл с таким кодом = 1 новый бот из botfather + новое название обработчика в переменной handler_name. Простыми словами у каждого обработчика должен быть свой бот, со своими токеном и со своим названием переменной handler_name
Все файлы всех ботов должны находиться в одной папке, тк. файл с логом ботов и все боты ориентируются на него. Если расположить их по разным папкам, будет недоступна функция проверки записан ли юзер уже на одного из обработчиков или нет.

Настройка PuzzleBot

Теперь стоит сказать пару слов о том, как сделать, чтобы бот Puzzle отправлял сразу ссылку на регистрацию с подставленными параметрами сразу после вызова команды start.

В конструкторе бота создаем условную конструкцию, которая будет проверять на пустоту переменную start_payload и если она пустая - отрабатывать обычный скрипт бота. Если не пустая - отправлять юзеру сразу текст с ссылкой для регистрации с параметрами, по примеру https://keitaro-campaign-domain.com/?chat_id={{USER_ID_TEXT}}

У меня пост с регистрацией выглядит так:

url_first_play - в этой переменной хранится ссылка на кампанию кейтаро, которая делает редирект уже на оффер
start_payload - в этой метке я передаю метку обработчика. Он кидает юзеру ссылку на бота в таком формате https://t.me/mybot?start=handler, где handler это метка обработчика
user_id_text - это переменная содержащая внутри себя chat_id телеграма этого юзера. Этот id нужен для работы скрипта приведенного выше

Таким образом из всех этих переменных собирается ссылка для регистрации:
https://mydom.com/hanler=az&chat_id=9445674&registred=0

После проделанных выше действий, при переходе юзером в бота с подставленным параметром start, вызывается действие, которое присылает юзеру пост с готовой ссылкой для регистрации с необходимыми нам параметрами.

Осталось лишь объяснить обработчикам для чего подставлять ?start= к ссылке бота и где брать сслки для залива :) (PS: в боте командой /links, если они там указаны предварительно конечно).

Послесловие

Так выглядит работа правильно настроенного бота. Если не видно что написано ПКМ => открыть изображение в новом окне

Вот и все :) Теперь вы можете заливать как с канала в бот, так и с лички в бот, имея при этом полный трекинг всего что вам нужно. Выше показан пример работы бота и какие команды за что отвечают.

Если вы читали первую статью и делали все точь в точь как в ней, то эта часть должна встать в вашу систему как влитая. Если же вы делали изменения, меняли метки и пр., необходимо адаптировать код под это дело / написать новый под свои задачи.

Что будет дальше этой статьи?

Отбив статуса lead в Facebook с помощью Conversion Api

По сути хотел остановиться на этом, но перая часть статьи вызвала бурный интерес к теме, поэтому я буду отталкиваться от реакций и просмотров данной части. Если продолжение будет вам интересно, напишу еще пару статей про залив за подписки в тг и оптимизацию за ФД / РД.

На данный момент найден способ отбивать лиды при подписке на канал, но выглядит он громоздко, хоть и работает как часы. Рекомендую тем кто шарит заливать просто на ФД, РД, благо сделать это гораздо проще чем при заливах за подписки

Немного о спонсорах

Как вы сами убедились из серии статей, Keitaro невероятно эффективный инструмент в работе с трафиком. Как раз сейчас выходит новая версия 10.1, в которой будут значительные улучшения опыта работы с трекером. Советую лично от себя обновиться прямо сейчас. А чтобы обновление не вышло в копеечку, предоставляю вам промо adamblog с 20% скидкой для новых участников. Перейди на зеленую сторону и увеличь свой ROI кратно вместе с Keitaro

Для тех кому интересно, выкладываю список новых функций:
⚡️Интеграции по автоматической передаче расходов с Google Ads и TikTok
⚡️Режим чтения кампаний/лендингов/офферов для отдельных пользователей
⚡️Новые статусы конверсий Reg & Dep для работы с гемблингом
⚡️Новые метрики в отчетах от уникальных кликов (uCPC, uEPC и др)
⚡️Новый редактор лендингов (обновленный функционал и дизайн)
⚡️Совместимость с Bearer token
⚡️Обновленная цветовая гама Dashboard

Схемный трафик (ч.1): Автоворонка в боте

2023-06-12T23:08:50.364Z

Предыстория

Еще год-полтора назад появилось такое понятие как "Схемный трафик" и изначально им пользовались исключительно гемблисты. Позже этим же способом начали лить бинарки, крипту, нутру и все прочее. Сейчас схемный находится в топе, все больше аффов адаптируют свои классические воронки под работу с мессенджерами в связке с чат-операторами.

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

О чем эта статья

Сегодня речь пойдет об автоворонке и ее реализации с помощью сервиса PuzzleBot. Кто не в курсе, Puzzle - это no-code конструктор чат ботов Telegram, обладающий практически неограниченными возможностями.

Почему я выбрал именно PuzzleBot?
- Стабильность
- Наличие входящего и исходящего API
- Наличие сценариев / постинга
- Возможность интеграции WebApp в бота

Сразу скажу, в данной статье я не буду разбирать конкретные примеры воронок (текст, визуал), а лишь покажу возможности, которые открываются при использовании связки партнерки + трекера + пазла. Для кого-то информация изложенная внизу может показаться банальной, для кого-то это будет откровением.

Чтобы было проще понять о чем идет речь, я сделал пример такого бота специально для вас: ➡️https://t.me/scheme_traffic_bot⬅️. Потыкайтесь и вернитесь в статью.

Немного о минусах и плюсах

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

Главный и самый существенный минус бота - это неумение аудитории пользоваться кнопками и прочим функицоналом ТГ. Среди всего прочего, этот минус выделяется и бьет по шарам. Тем не менее, этот "острый угол" можно сгладить с помощью сценариев / событий / контента внутри бота.

Плюсы бота:

Полный трекинг всего что можно оттрекать
Сигментирование аудитории на всех этапах
Сохранение контактов юзера, если они регнулись через ссылку на бота из канала (вместо прямых ссылок, размещаем ссылки на бота в канале и юзеры делают регу через него)
Скрытость воронки (контента) от посторонних глаз
Процент отписки (блокировки) от бота ~25% от общего числа подписавшихся за счет персонализированного контента. Тогда как в канале этот процент может достигать 55-60%.
Автоматическая работа с юзером на основе S2S постбэков из Keitaro \ Binom
Возможность встраивания WebApp (сайт) прямо внутрь бота
Возможность использования Conversion API Facebook для трекинга различных событий

Минусы бота:

Отсутствие соц. подтверждения в виде количества подписчиков на канале \ количестве просмотров и лайков на постах
Безграмотность аудитории и не понимание как работать с ботом (зависит от гео и от вашего поясняющего этот момент контента)
Не у всех партнерок есть настройка постбэков в трекер на каждое из событий

Как сделать подобное

Если вы протыкали все кнопки в тестовом боте и дошли до этой главы, то вы готовы немного напрячь мозги и сделать красиво. Ниже будет приведена пошаговая инструкция для реализации. Сразу скажу, для того чтобы пройтись по руководству и нигде не ошибиться, нужно ознакомиться хотя бы с базой функционала вашего трекера и сервиса PuzzleBot. Без этого фундамента, вряд ли у вас получится собрать "пазл" воедино и получить что-то рабочее на выходе.

Бот который был приведен в пример выше собран в связке ПП + Keitaro + PuzzleBot. Соотв. все что приведено ниже, будет сделано на примере Keitaro. Если у вас Binom - курите их доку.

Из тех знаний, которые пригодятся в работе:

Я не буду рассказывать как работает тот или иной сервис / как подцепить бота в Puzzle или как добавить в бота ресурс (канал или чат). Читайте их доку / смотрите поясняющие видосы на их Youtube-канале. Там все / обо всем подробно расписано.

Настроим PuzzleBot

1. После подключения бота и нужных ресурсов в него, зайдем в раздел Модерация и создадим следующие категории:

Зарегистрирован
Сделал Sale
Сделал Rebill

В моем примере они указаны так. Вы конечно же можете назвать их как вам заблагорассудиться. Главное чтобы эти категории отображали смысл полученного постбэка от трекера (lead/sale/rebill).

Категории будут присваиваться юзерам автоматически (если это нстроено в конструкторе) после прохождения определенных команд в боте (рега, деп, редеп). Далее мы сможем смотреть стату, "разбивать" их по статусам и пр. Создавать категории можно не только под постбэки, но и под любые другие действия в боте - тут все зависит от ваших целей.

2. Зайдем в Конструктор Puzzle и создадим 3 базовые команды, которые будут вызываться по API PuzzleBot с помощью настроеного S2S постбэка в кампании Keitaro. У меня эти действия называются registred, deposited, redeposited. Вы же можете назвать их как вам угодно, главное что бы было понимание что эти названия команд, в дальнейшем необходимо будет указывать при обращении к апи паззла.

Так выглядит базовая конструкция бота, для работы с постбэками из Keitaro TDS. От этих 3х действий можно строить дальнейшие логические цепочки и планировать воронку.

Рассмотрим подробнее как выглядят эти команды внутри:

Остальные действия deposited, rediposited настроены аналогичным образом, как на скриншоте выше, но категории там присваиваются юзеру уже совсем другие, которые отвечают отработке постбэков на sale / rebill.

В каждой команде я поставил доп. действие при срабатывании команды. Первое действие что мы делаем - меняем категорию для юзера, у которого сработала команда registred . По желанию делаем уведомление в спец. группу о переходе юзера из одной категории в другую. Это уже по желанию, но мне так удобнее, потому что я и моя команда всегда видим кто/что/когда сделал и можем по одному клику найти этот диалог в тг.

3. Создадим токен от нашего Puzzle бота для доступа к внешнему API и сохраним его к себе в блокнотик. Он нам пригодится, когда будем настраивать S2S внутри кампании KT.

Созданные токены всегда доступны в настройках бота, в разделе "Интеграции".

На этом настройка базы для автобота завершена. После настройки других компонентов (пп, трекера) этого большого пазла, можно будет вернуться и "обвесить" этот каркас контентом и пр. лабудой.

Настройка Партнерской сети

Практически в каждом трекере уже имеются готовые шаблоны для прокидывания постбэков из ПП. Все что вам надо сделать, зайти в раздел Партнерские сети (/admin/#!/affiliate_networks/) в трекере, нажать на кнопку "Создать" и выбрать готовый шаблон постбэка. Далее вам выпадет готовая ссылка для вставки в настройки партнерской сети. Мы ее копируем, идем в настройки нашей ПП и вставляем в настройки постбэков.

Но что делать, если среди шаблонов не оказалось нужной ПП? - Не отчаиваться и запастись терпением. Для начала рекомендую прочесть FAQ от КТ по созданию Партнерской сети в трекере.

Для успешного создания своей ПП в Keitaro, необходимо знать 1 фундаментальную вещь: Все данные синхронизируются с помощью subid (в биноме это clickid) трекера. Сабайди это уникальный идентификатор клика, который у каждого юзера, при каждом заходе на ссылку кампании разный. Я специально выделил жирным что это именно ссылка кампании, а не прямая на лендинг, тк. subid попросту не присваивается юзеру, если вы заливаете напрямую ссылку на ленд! Этот subid мы обязаны передать в партнерку, чтобы в дальнейшем, после целевого действия юзера партнерка смогла забрать этот subid из своей БД и отправить постбэк в трекер. Звучит сложно, но на самом деле все гораздо проще чем кажется.

Mindmap с объяснением взаимодействия ПП и трекара и роли Subid в этом взаимодействии:

Еще одна важная деталь состоит в том, что для каждого события свой статус. В кейтаро есть 3 основных статуса: lead(конверсия), sale(продажа), rebill(на самом деле sale + tid, но в БД КТ это пишется как rebill- допродажа).

Хвост постбэка на lead:
postback/?subid={subid}&status=lead&payout={payout}

Хвост постбэка на sale:
postback/?subid={subid}&status=sale&payout={payout}

Хвост постбэка на rebill:
postback/?subid={subid}&status=sale&payout={payout}&tid={tid}

По поводу статуса lead, все понятно. Но есть некоторая путаница по поводу sale & rebill. Смотрите, если мы отправляем постбэк только с 3 метками subid / status / payout - то все это считается продажей, но если к этому хвосту добавить tid (transaction id) - то этот постбэк будет считаться допродажей. По этой логике можно быстро собирать свои постбэки для любого из событий, для любой из ПП, где есть возможность настраивать постбэки.

Настроим источник в Keitaro:

Зайдем в "Источники" (/admin/#!/traffic_sources/) в трекере и выберем источник с которого будем заливать схемный трафик, в моем случае это Facebook. Пропишем метку, в которую будет записываться chat_id(уникальный идентификатор пользователя Telegram). По этому параметру в дальнейшем будет происходить синхронизация с ботом юзера. Если не передать chat_id, мы не сможем сделать S2S запрос на API PuzzleBot с названием команды для ее запуска у юзера.

Поэтому настраиваем либо как на скрине, либо в таком порядке:
Моя метка (Название метки для отображения в стате) | my_metka | {my_metka} (в виде макроса).

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

Так выглядит у меня настройка кампании. Остальные метки замазаны. Вы можете проставить свои метки в ближайшее свободное поле

Параметры должны проставиться в каждой кампании, которую вы собираетесь заливать в связке с ботом.

Настройка S2S постбэков внутри кампании Keitaro

Вот тут-то нам и пригодится созданный токен от PuzzleBot и их дока. Из их руководства следует: Для того чтобы вызвать команду у конкретного пользователя, мы обязаны сделать запрос с указанием его chat_id Telegram и названием запускаемой команды:

method: sendCommand
params:
command_name - string, name of command ot condition
tg_chat_id - number, Telegram id of resource or user

success result: code = 0, data = "ok"

URL для запуска команды registredв моем случае будет выглядеть вот так:
https://api.puzzlebot.top/?token=LF4cRL0ZXmV2S6SXUCMYJmkVHIZ&method=sendCommand&command_name=registred&tg_chat_id={sub_id_9}

Я скопировал заранее созданный api-ключ из сервиса PuzzleBot и подставил его в метку token=. Затем в метку command_name= прописал название команды так, как она называется у меня в конструкторе внутри PuzzleBot. Ну и конечно же вставил метку от трекера, в которой у меня хранится chat_id человека, который совершил целевое действие на моей ссылке кампании.

Небольшая путаница возникает у людей, когда они сталкиваются с настройкой S2S в КТ. Почему я поставил макрос с названием {sub_id_9} вместо {chat_id}? - Все просто: Для БД трекера "chat_id" - это лишь пользовательское название метки sub_id_№ с порядковым номером 9. Если вы поставите в S2S ваше пользовательское название (у меня это chat_id), то трекер попросту не найдет такой метки, не сможет испольнить макрос и получить значение из БД.

Найти свой порядковый номер sub_id_ очень легко. Достаточно зайти в кампанию и посчитать сверху вниз по нарастающей, как указано это на скриншоте снизу:

Исходя из этой логики, нужное мне значение лежит в метке sub_id_9

1. С собранной ссылкой для S2S, идем во вкладку S2S Postback внутри настраиваемой кампании, создаем перый наш постбэк для события lead и вписываем собранную ссылку в поле URL:

2. Далее я создаю еще один постбэк с помощью кнопки "Добавить", заменяю в URL в метке command_name= значение на следующую мою пользовательскую команду из конструктора PuzzleBot - у меня это deposited:

3. Те же действия проделываем с 3им постбэком: создаем, заменяем на соотв. команду (у меня это redeposited) и снимаем галки как показано на скрине:

Проставляем ссылки в бот

Копируем ссылку из кампании, убираем все ненужные метки из ссылки, оставляем только те что действительно нужны (chat_id). Можете конечно и не убирать, но те же макросы от Facebook тут работать не будут (вообще лучше создать отдельный источник в КТ и проставить кастом параметры там).

В метку где будет храниться наш chat_id, пишем внутренний макрос PuzzleBot в виде chat_id={{USER_ID_TEXT}}:

Поздравляю, с этого момента, любое целевое действие совершенное пользователем на нашей трекинговой ссылке КТ, будет передаваться по API в Puzzle и для пользователя будет запускаться команда указанная в command_name=.

Подитог

С виду все выглядит невероятно сложно, но если разобраться в этом всего лишь один раз - можно будет творить все что придет в голову. Возможности современных сервисов это позволяют.

На описанный выше "каркас" можно навешать любой контент. В общем можно все это оформить интуитивно для пользователя и вывести для себя идеальную формулу автобота. Ну а если аудитория безграмотная, можно наполнить бот визуалом, объясняющим как с ним взаимодействовать (прямо показывать что можно тыкать на кнопки в видео).

В таком сетапе латам у нас шел замечательно, а вот Индия в дикий минус, потому что индусы не очень грамотные и очень ленивые, тупо не хотят разбираться с тем как это работает. В общем все зависит от гео и от вашего подхода / инструкций в визуале.

О чем будет следующая статья

В след. теме, я разберу возможности пролива на канал и регистрации юзеров через бот, а так же создание персональных ботов для каждого обработчика и снятие 50% существующих головняков у команд.

С помощью регистрации юзеров через бота, мне удалось выстроить систему, при которой обработчики могут записывать юзеров пришедших им в личку просто переслав сообщение этого юзера в свой персональный бот (красное выделение).

Так же за счет интеграции персональных ботов с трекером, у обработчика появляется возможность смотреть свою стату с подсчетом их заработка даже не заходя в трекер (синее выделение):

Немного о партнерах

Моим верным партнером и незаменимым инструментом в работе все так же остается трекер Keitaro. Совсем недавно разработчики полностью обновили внутрянку трекера, сделав его еще быстрее и функциональнее.

Настоятельно рекомендую сделать апдейт и перейти на новую, 10ую версию Keitaro TDS. Ну а по промокоду adamblog, вы сможете это сделать с выгодой -20%. Регистрируйтесь https://keitaro.io/89119/info и переходите на "зеленую" сторону.

Универсальный конструктор апи и настройка лендинга за 2 минуты

2022-11-02T15:28:10.956Z

Конструктор

Список ПП доступных для сборки конструткором:
- aff1
- terraleads
- lemonad
- leadtrade
- leadrock
- leadreaktor
- leadbit
- kma
- cpagetti
- adcombo

Настройка
1. Размещаем папку thanks и apis в корне своего трекера
2. Заходим в папку apis, находим файлик config.php и вставляем туда свои API-токены от партнерок (где найти токены в каждой из пп, можно посмотреть там же).
3. Находим в этом же файлике переменную $custom, в ней прописываем название меток, из которых будут передаваться данные в партнерки.

Для ссылки такого вида:https://mydom.com/?buyer=zeliboba&account=bm45&domain=mydom.com&pixel=9999999999999

Переменная $custom должна иметь след. вид:
$custom = [ "sub_id_1" =>"buyer", "sub_id_2" =>"account", "sub_id_3" =>"domain", "sub_id_4" =>"pixel", "clickid" =>"subid" ];

Если у вас нет меток для передачи в пп, то просто оставим эти поля пустыми:

$custom = [ "sub_id_1" =>"", "sub_id_2" =>"", "sub_id_3" =>"", "sub_id_4" =>"", "clickid" =>"subid" ];Поле clickid называем так, как у вас в трекере называется макрос для передачи сабайди (нужен для постбэка с пп в трекер). В данном случае это Кейтаро, поэтому оставляем subid.

После настройки имеем пути с которыми мы будем работать:
https://yourdomain.com/apis/index.php - тут мы собираем код для интеграции в форму лендинга

Пример сборки в конструкторе и последующая отправка лида:

https://yourdomain.com/apis/logs/index.php - тут мы можем в удобном виде читать логи отправленных заявок за каждый день из каждой пп

https://yourdomain.com/thanks/contacts/get.php - здесь мы можем посмотреть собранные данные пользователей в формате name - phone - mail (если скопировать это в таблицу, то все встанет по ячейкам автоматически).

Страница спасибо

Я уже выкладывал у себя на канале эту штуку и довольно подробно описывал принцип ее работы. Не вижу смысла расписывать заново что куда, поэтому просто скопирую текст сюда:

Логика работы:
1) С помощью метки country передаем в формате iso страну mydom.com/thanks?country=RU
2) Если перевод для этой страны имеется — покажет перевод под эту страну
2.1) Если такой страны с переводом нет в source/iso — покажет страницу спасибо на английском языке.

Возможности:
- Содержит в себе практически все языки перевода и автоматически определяет на какой перевод отправить пользователя.

- Можно вписывать свой js код, который будет подгружаться на всех переводах страницы спасибо. Делается это по пути: thanks/source/js/script.js. Внутри этого файла так же присутствует пиксель. Все что вам надо сделать - вписать имя метки в которой вы его передаете в переменную let pxname = 'pixel';.

- Если пользователь вписывает свой email, его данные попадают в файлик в формате name:phone:email. Сам файл имеет название по передаваемым на страницу спасибо меткам country_vertical_date.txt.

Настройка:
- Грузим архив в корень трекера (keitaro/binom) и распаковываем (не в lander / landers а именно в корень сервера).

- Если вы используете универсальную страницу спасибо вместе с конструктором апи, то больше ничего делать не надо. Нужно лишь вписать метку в которой передается ваш пиксель в файл thanks/source/js/script.js.

- Если вы используете свой апи файл для передачи лидов:

Ставим редирект на нашу страницу спасибо в апи файле в таком формате
header('Location:https://domain.com/thanks/?name='.$_POST['name'].'&phone='.$_POST['name'].'&country='.$_POST['country'].'&vertical='.$_POST['vertical'].'&pixel='.$_POST['pixel'].');
На лендинг ставим импуты для передачи всех данных для корректной работы страницы спасибо:
<input name="name" type="hidden" value="vasya"> <input name="phone" type="hidden" value="9999999999"> <input name="vertical" type="hidden" value="adult"> <input name="country" type="hidden" value="{country}"> <input name="vertical" type="hidden" value="{pixel}">

Настраиваем лендинги на COD офферы за 1 минуту

2022-10-24T13:54:54.739Z

Видеодемонстрация работы

В очередной раз выкладываю то что когда-то писал для себя, но так и не внедрил в оборот (лол). Наверное я один остался из альтруистов кто что-то выкладывает в плане технички, чувствую себя белой вороной. Ну да ладно.

Не буду долго расписывать, это простой скрипт для быстрой настройки лендингов под COD-товарку. Настраивается 1 раз, а лендингов в последствии настроит сотни и тысячи (если вы этого захотите). Если не понятно что это и зачем, смотрите видео выше ⬆️⬆️⬆️

Благодаря этой небольшой системке, не надо подбирать страницу спасибо, тк. она универсальная и к слову говоря умеет собирать контакты людей, которые оставили свой мэйл на ней.

Список ПП доступных для сборки конструткором:
- terraleads
- lemonad
- aff1
- leadtrade
- leadrock
- leadreaktor
- leadbit
- kma
- cpagetti
- adcombo

Настройка конструктора
1. Размещаем папку thanks и apis в корне своего трекера
2. Заходим в папку apis, находим файлик config.php и вставляем туда свои API-токены от партнерок (где найти токены в каждой из пп, можно посмотреть там же).
3. Находим в этом же файлике переменную $custom, в ней прописываем название меток, из которых будут передаваться данные в партнерки.

Для ссылки такого вида:
https://mydom.com/?buyer=zeliboba&account=bm45&domain=mydom.com&pixel=9999999999999

Если у вас нет меток для передачи в пп, то просто оставим эти поля пустыми:

После настройки имеем пути с которыми мы будем работать:
https://yourdomain.com/apis/index.php - тут мы собираем код для интеграции в форму лендинга
https://yourdomain.com/apis/logs/index.php - тут мы можем в удобном виде читать логи отправленных заявок за каждый день из каждой пп

О том как работать с конструктором, можно посмотреть в видео в самом начале поста.

Не забудь подписаться - https://t.me/adamusfb