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

Настройка KARTE

KARTE — партнёр по аналитике, интегрированный с Adjust. Интеграция с нашей системой позволяет KARTE получать данные, отслеживаемые в Adjust, посредством автоматических колбэков. Обрабатывая эти данные при помощи своих инструментов, партнеры предоставляют вам более подробные сведения и аналитику.

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

Перед началом работы

Требования

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Учетные данные

API KEY

  • Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю KARTE.

Выберите KARTE и свое приложение в Campaign Lab

  1. В разделе Campaign Lab выберите Партнеры .
  2. Выберите Новый партнер > KARTE . Выберите Далее , чтобы перейти к следующему экрану.
  3. На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с KARTE.
  4. Нажмите Далее .

Включение обмена данными

Включите обмен данными, чтобы активировать интеграцию с KARTE. Чтобы включить обмен данными

  1. Введите API KEY.

После включения обмена данными с KARTE, Adjust автоматически отправляет KARTE следующие данные (по умолчанию).

  • Установка
  • Переустановка
  • повторная атрибуция переустановки
  • реатрибуция
  • событие

Настройте параметры обмена данными

При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:

  1. Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
  2. Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .

В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать KARTE по умолчанию:

  • Установка
  • Переустановка
  • повторная атрибуция переустановки
  • реатрибуция
  • событие

Отправка дополнительных данных

Выберите объем и тип данных для передачи KARTE посредством колбэков. KARTE может использовать эту информацию для оптимизации производительности.

Для отправки дополнительных данных можно просмотреть и настроить следующие параметры:

Удаления или повторные установки

Передача данных об удалениях и переустановках позволяет KARTE получать данные об удалениях и переустановках вашего приложения, измеренные Adjust.

Примечание:

Для приложений под управлением iOS можно ожидать небольшого количества удалений и/или переустановок. Дополнительные сведения см. в разделе Оценка удалений и переустановок.

Доход в приложении (от покупок в приложении)

Передача данных о доходе в приложении позволяет KARTE получать данные не только о сумме дохода, но и о событии дохода. Чтобы делиться этими данными, необходимо сопоставить события, генерирующие доход.

Сопоставьте события

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

Составить отдельные события

Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими KARTE. Это позволяет вам:

  • настроить отдельные события для управления стратегиями кампаний для каждой платформы;
  • настроить обмен данными для каждой платформы.

В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать KARTE:

  1. Выберите Сопоставить событие .

  2. В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с KARTE.

  3. В разделе Событие партнера необходимо выбрать событие KARTE, соответствующее событию Adjust.

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

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

    2. В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.

  4. Нажмите Применить .

Теперь KARTE будет получать данные о событии в приложении по каждому связанному событию.

Сопоставить все события

Если KARTE поддерживает автоматическое сопоставление всех событий, в разделе Сопоставление событий нажмите Сопоставить все события . Это экономит время при сопоставлении отдельных событий.

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

Сопоставление параметров

Чтобы делиться настраиваемыми данными с KARTE, обычно требуется сопоставить параметры.

Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно KARTE. Таким образом KARTE будет получать указанные сведения по каждому связанному событию.

Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.

Чтобы передавать KARTE параметры партнера, выполните следующие действия.

  1. Настройте параметры партнера в Adjust SDK.

    • Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.

  2. В разделе Выберите параметры обмена данными нажмите Параметры .

  3. В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:

    1. Выберите Сопоставить параметр .
    2. В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
    3. В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание:

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

Включите KARTE для своего приложения

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

  • Выбранное приложение
  • Параметры обмена данными

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

Инструкции по настройке для конкретных партнеров

Предопределенные параметры

Karte позволяет отправлять наборы предопределенных параметров. Если прикрепить любой из этих параметров к событию в SDK Adjust, они будут переданы в Karte. Узнать больше о присоединении параметров партнеров можно в файле readme в SDK, с которым вы работаете. Ниже приведен список определенных параметров, которые принимает Karte.

Ключ параметра> Значение

  • Параметр visitor_id> обязателен для отправки колбэков в Karte.

Для отправки колбэков событий в Karte необходимо добавить visitor_id в качестве партнерского параметра сессии и события в Adjust SDK. В панели управления Adjust нужно включить Передачу параметра .

За дополнительной информацией обращайтесь на Страницу поддержки Karte (JP).

Список всех параметров, передаваемых KARTE

KARTE требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:

ПлейсхолдерИнформация
{adid}Идентификатор устройства Adjust (все платформы)
{android_id}Android ID (только для Android)
{api_level}Уровень API (только Android)
{city}Город устройства
{click_attribution_window}Настройки окна атрибуции для сопоставления устройства (часы)
{cost_amount}Стоимость вовлечения пользователя (доступна только для отслеживания расходов на рекламу)
{cost_currency}Валютный код ISO 4217 для данных о расходах (доступен только для отслеживания расходов на рекламу)
{cost_type}Модель ценообразования кампании (доступна только для отслеживания расходов на рекламу)
{country_subdivision}Подраздел устройства по стране, например штат или область
{country}Код страны устройства из двух символов
{currency}Исходный валютный код ISO 4217, отправленный из Adjust SDK
{deeplink}URL диплинка, добавленный в конец URL клика
{device_name}Номер модели устройства
{device_type}типа устройства
{environment}Текущая настройка среды Adjust SDK
{fire_adid}Рекламный идентификатор Fire OS
{gps_adid_md5}Шестнадцатеричный хэш MD5 рекламного идентификатора Google Play Store в нижнем регистре
{gps_adid}Рекламный идентификатор магазина Google Play Store
{idfa}Идентификатор IDFA (только для iOS)
{idfv}Идентификатор iOS для поставщиков в верхнем регистре
{impression_attribution_window}Настройки окна атрибуции для сопоставления показов (часы)
{inactive_user_definition}Период бездействия, требуемый для реатрибуции (часы)
{ip_address}IP-адрес устройства
{isp}Интернет-провайдер устройства
{language}Код языка устройства из двух символов
{last_time_spent}Длительность последнего сеанса пользователя в секундах
{lifetime_session_count}Количество сеансов, зарегистрированных за весь жизненный цикл пользователя
{match_type}метод атрибуции
{nonce}Случайная буквенно-цифровая строка в нижнем регистре (уникальная в рамках колбэка)
{os_name}Операционная система устройства
{os_version}Номер версии операционной системы
{partner_parameters}Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков
{postal_code}Почтовый индекс IP-адреса устройства
{random_user_id}Случайный идентификатор пользователя (на устройство)
{random}Случайное число (уникальное в рамках колбэка)
{reattribution_attribution_window}Настройки окна атрибуции для реатрибуции (часы)
{reftag}Случайный исходный тег устройства
{reporting_cost}Стоимость вовлечения пользователя, преобразованная в валюту отчетности вашего приложения, в том виде, в котором она указывается на панели управления Adjust (доступна только для отслеживания расходов на рекламу)
{reporting_currency}Код валюты отчетности панели управления по ISO 4217
{reporting_revenue}Доход по данным панели управления Adjust, в целых валютных единицах
{revenue_float}Доход в том виде, в котором он отправлен из Adjust SDK, в целых валютных единицах
{revenue}Доход в том виде, в котором от отправлен из Adjust SDK, в центах
{session_count}Количество сеансов, записанных текущим Adjust SDK
{time_spent}Продолжительность сеанса текущего пользователя в секундах
{timezone}Часовой пояс устройства
{tracking_enabled}1 — если отслеживание включено, 0 — если нет
{tracking_limited}1 — если отслеживание ограничено, 0 — если нет
{user_agent}Входящий необработанный user agent
{activity_kind}Тип действия пользователя
{adgroup_name}Название группы объявлений (как прописано в трекере)
{app_id}Идентификатор App Store или Google Play Store
{app_name_dashboard}Имя приложения на панели Adjust
{app_version_raw}Номер версии приложения (Android), номер версии сборки комплекта (iOS)
{app_version_short}Номер версии приложения (Android), номер конечной версии комплекта (iOS)
{app_version}Номер версии приложения (Android), номер версии сборки комплекта (iOS)
{attribution_updated_at}Обновленная временная отметка атрибуции
{campaign_name}Название кампании (как прописано в трекере)
{click_time}Временная отметка атрибуцированного клика
{connection_type}Internet connection type
{conversion_duration}Время между кликом и установкой или реатрибуцией в секундах
{created_at}Временная отметка действия
{creative_name}Название креатива (как прописано в трекере)
{engagement_time}Временная отметка вовлечения
{impression_based}1, если вовлечение на основе показов, 0, если нет
{impression_time}Временная отметка атрибуцированного просмотра
{install_begin_time}Временная отметка начала загрузки приложения (только Android и Google Play Store)
{install_finish_time}Временная отметка окончания загрузки приложения
{installed_at}Временная отметка установки (т. е. первого открытия приложения)
{is_organic}1 – если трафик органический, 0 – если неорганический
{last_session_time}Временная отметка последнего сеанса
{network_name}Название сети (как прописано в трекере)
{reattributed_at}Временная отметка реатрибуции
{referral_time}Временная отметка регистрации пользователя на странице Play Store приложения (только Android и Google Play Store)
{reinstalled_at}Временная отметка переустановки
{store}Целевой магазин клика
{time_to_reinstall}Время между последним удалением приложения и последующей переустановкой в секундах
{time_to_uninstall}Время между установкой приложения (или последней переустановкой) и последующим удалением в секундах
{tracker_name}Текущее название трекера
{uninstalled_at}Временная отметка удаления приложения (оценка, основанная на времени последнего сеанса)
{google_ads_creative_id}Идентификатор креатива Google Ads