Настройка трекинга рекламы в Discord по шагам

Перед началом

Вам потребуется учётная запись Discord с правом управления сервером (Manage Server) и рабочее пространство в Tellmetric. Сервер может быть новым или давно существующим; для текущих участников ничего не меняется. Почему используется ваше собственное приложение, а не общее: экран авторизации показывает ваше название и значок, и действия других клиентов никак не влияют на ваше приложение.

Шаг 1. Создайте приложение

1. Откройте Discord Developer Portal и нажмите New Application. Назовите приложение по имени вашего бренда: это название видят пользователи при авторизации.
2. В разделе OAuth2 скопируйте Client ID и нажмите Reset Secret, чтобы получить секрет клиента. Скопируйте его сразу: Discord показывает его один раз.
3. Там же, в OAuth2, добавьте в поле Redirects адрес перенаправления, указанный на странице Connections в Tellmetric, и сохраните. Скопируйте его со страницы, а не вводите вручную.
4. В разделе Bot нажмите Reset Token и скопируйте токен. Отключите Public Bot, если добавлять бота на серверы должны только вы.

Шаг 2. Введите данные приложения

В Tellmetric откройте Connections и карточку Discord. Вставьте Application ID, секрет клиента и токен бота в шаг 2 и нажмите Save. Tellmetric проверяет у Discord, что токен принадлежит приложению с указанным ID и что ID и секрет подходят друг к другу; значение из другого приложения или сброшенный секрет отклоняются с пояснением на соответствующем поле. Секрет и токен хранятся в зашифрованном виде и больше не показываются.

Шаг 3. Добавьте бота на сервер

Нажмите Add to Discord. В диалоге Discord выберите сервер; единственное запрашиваемое право — Create Invite, оставьте его включённым. Бот не читает сообщения, не управляет участниками и ничего не публикует. Вернувшись на Connections, вы увидите сервер в списке Servers the bot is in; нажмите Use this server. На тарифе Free отслеживается одно сообщество (группа или канал Telegram либо сервер Discord), на тарифах Pro и Agency — пять.

Шаг 4. Выберите, куда попадают новые участники

Для каждого сохранённого сервера выберите текстовый канал, который новый участник увидит первым, в поле Where people land, либо оставьте главную страницу сервера. В течение минуты Tellmetric проверяет, что бот находится на сервере с правом Create Instant Invite и что канал существует, и создаёт в этом канале резервную инвайт-ссылку для посетителей, у которых не удалось завершить авторизацию. Проверка «участник остаётся на сервере» использует то же число дней, что и для Telegram; оно задаётся в разделе Bot settings карточки Telegram.

Шаг 5. Создайте ссылку и проверьте её

1. На странице Links выберите Your Discord server, назовите ссылку по имени кампании и создайте её. При нескольких серверах укажите, какой из них она открывает.
2. Нажмите Test it либо откройте Test your setup на Connections. Отсканируйте QR-код телефоном.
3. Discord покажет экран авторизации вашего приложения. Нажмите Authorise. Вы окажетесь в выбранном канале, а страница по мере поступления отметит клик, вступление и передачу в Meta.

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

Что видит посетитель

Один экран: «название вашего приложения запрашивает доступ к вашей учётной записи Discord: знать ваше имя пользователя; присоединять вас к серверам» с кнопками Authorise и Cancel. После авторизации приложение или веб-версия Discord открывается на выбранном канале, и пользователь уже является участником. Тот, кто ранее авторизовал ваше приложение, этот экран не видит. Тот, кто нажал Cancel, получает страницу с обычной инвайт-ссылкой на сервер; такое вступление с объявлением не связывается.

Если что-то не работает

• «Этот токен бота принадлежит другому приложению». Скопируйте токен со страницы Bot того же приложения, чей Client ID вы указали.
• Сервера нет в списке Servers the bot is in. Нажмите Add to Discord ещё раз и выберите сервер в диалоге Discord; если бота удалили с сервера, добавьте его тем же способом.
• «Бот не может создавать приглашения». В Discord откройте Server Settings, Roles, роль бота и включите Create Invite. Затем нажмите Check connection.
• «Канал для новых участников удалён». Выберите другой канал в поле Where people land.
• Уведомление о том, что вступления в Discord не выполняются. Discord несколько раз за час отказался добавить посетителей. Check connection покажет, находится ли бот на сервере с нужным правом; посетители тем временем направлялись на сервер по резервной ссылке.

Как устроена вся цепочка, что получают рекламные системы и что пока не отслеживается: Discord conversion tracking (на английском языке).