Перейти к основному содержимому

Отправка из Segment

Prodantix понимает HTTP API отслеживания Segment, поэтому события, которые вы уже отправляете через Segment, RudderStack или Jitsu, приходят без изменения кода отслеживания. Вызовы приходят так же, как их отправляют SDK Prodantix: track как событие, page как $pageview, screen как $screen, identify как человек, group как группа и alias как объединённая личность.

Через назначение Webhooks в Segment

В Segment добавьте назначение Webhooks, укажите в качестве URL адрес ниже и добавьте заголовок Authorization с публичным ключом проекта в виде токена Bearer.

Bash
URL:           https://eu.api.prodantix.com/segment/v1/webhook
Authorization: Bearer pdx_pub_live_…

Из analytics.js

Направьте analytics.js на Prodantix через параметр apiHost и используйте публичный ключ проекта как ключ записи.

TypeScript
import { AnalyticsBrowser } from '@segment/analytics-next';

export const analytics = AnalyticsBrowser.load({
  writeKey: 'pdx_pub_live_…',
  cdnSettings: {
    integrations: {
      'Segment.io': { apiKey: 'pdx_pub_live_…', apiHost: 'eu.api.prodantix.com/segment/v1' },
    },
  },
});

Из RudderStack или Jitsu

Оба отправляют данные в формате Segment. Укажите в качестве URL назначения адрес ниже, а в качестве ключа записи публичный ключ проекта.

Bash
Endpoint:  https://eu.api.prodantix.com/segment/v1
Write key: pdx_pub_live_…

Как приходят вызовы

Человек определяется по userId, иначе по anonymousId. Имена событий записываются в форме Prodantix строчными буквами, а исходное имя из Segment сохраняется в $segment_event. Повторно доставленное сообщение учитывается один раз по его messageId. Адрес и браузер человека берутся из context.ip и context.userAgent. Группы получают тип segment_group, если в их traits не указан group_type. Действуют ограничения Segment: вызов до 32 КБ, пакет до 500 КБ.