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

Настройка Buzzvil

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

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

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

Требования

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

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

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

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

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

  1. Включите «Включено».

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

  • install
  • session
  • uninstall
  • reinstall
  • reattribution
  • event
  • rejectedInstall
  • rejectedReattribution

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

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

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

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

  • install
  • session
  • uninstall
  • reinstall
  • reattribution
  • event
  • rejectedInstall
  • rejectedReattribution

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

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

  1. В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Buzzvil:
  • Данные из всех источников атрибуции
  • Только данные, атрибутированные партнеру Buzzvil

Сессии

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

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

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

Примечание:

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

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

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

Сопоставление событий

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

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

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

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

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

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

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

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

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

      • Нажмите «Использовать сопоставление конкретной платформы», чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
      • Нажмите «Использовать глобальное сопоставление», чтобы отобразить одни и те же события для всех платформ.
    2. В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.

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

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

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

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

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

Сопоставьте параметры

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

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

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

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

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

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

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

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

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

Сконфигурируйте ссылки и настройки

Вы можете настроить следующие параметры:

Создайте ссылку и поделитесь ей с Buzzvil

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

  • Выбранное приложение
  • Параметры обмена данными
  • Параметры структуры ссылки
  • Места назначения пользователей
  • Настройки атрибуции

Нажмите Создать ссылку, чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с Buzzvil.

После того как ссылка создана, поделитесь ей с Buzzvil для размещения в кампании.

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

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

PlaceholderInformation
{api_level}API level (Android only)
{city}Device city
{click_attribution_window}Attribution window settings for device matching (hours)
{cost_amount}Cost of the user engagement (available for ad spend tracking only)
{cost_currency}ISO 4217 currency code of the cost data (available for ad spend tracking only)
{cost_type}The campaign pricing model (available for ad spend tracking only)
{country_subdivision}Device subdivision of country, e.g., state
{country}Device two-character country code
{deeplink}Deeplink URL appended to click URL
{device_name}Device model number
{device_type}Device type
{environment}Current Adjust SDK environment setting
{event_name}Event name, as set in the Dashboard
{gps_adid}Google Play Store advertising ID
{idfa}ID for advertisers (iOS only)
{idfv}Uppercase iOS ID for vendors
{impression_attribution_window}Attribution window settings for impression matching (hours)
{ip_address}Device IP address
{is_reattributed}1 if user was reattributed at least once from an earlier source. 0 if user has never been reattributed
{isp}Device internet service provider
{language}Device two-character language code
{lifetime_session_count}Number of sessions recorded across entire user lifetime
{match_type}Attribution method
{mcc}Mobile country code: three-digit code identifying a device's country. Use with the mobile network code to identify a device's carrier.
{mnc}Mobile network code: two-digit code. Use with the mobile country code to identify a device's carrier.
{os_name}Device operating system
{os_version}Operating system version number
{partner_parameters}Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks
{postal_code}Device postal code of IP address
{referrer}Google Play Store referrer (Android only)
{reftag}Random device reference tag
{region}Device region code
{reporting_cost}Cost of the user engagement converted to your app's reporting currency and as reported in the Adjust Dashboard (available for ad spend tracking only)
{reporting_currency}Dashboard reporting ISO 4217 currency code
{timezone}Device time zone
{tracking_enabled}1 if tracking is enabled, 0 if not
{tracking_limited}1 if tracking is limited, 0 if not
{user_agent}Incoming raw user agent
{activity_kind}Type of user activity
{adgroup_name}Adgroup name, as taken from the tracker
{app_id}Store App ID or Google Play Store
{app_name_dashboard}Name of the app in the Adjust Dashboard
{app_name}Name of the app
{app_version_raw}App version number (Android), build-version-number for the bundle (iOS)
{app_version_short}App version number (Android), release-version-number for the bundle (iOS)
{app_version}App version number (Android), build-version-number for the bundle (iOS)
{campaign_name}Campaign name, as taken from the tracker
{click_time}Attributed click timestamp
{connection_type}Internet connection type
{conversion_duration}Time between click and install or reattribution in seconds
{cpu_type}CPU type
{created_at}Activity timestamp
{creative_name}Creative name, as taken from the tracker
{device_manufacturer}Device manufacturer name
{engagement_time}Engagement timestamp
{first_tracker}6-character Adjust tracker token for a user's first attribution source
{hardware_name}Hardware name
{impression_based}1 if impression-based engagement, 0 if not
{impression_time}Attributed impression timestamp
{install_begin_time}App download began timestamp (Android and Google Play Store only)
{install_finish_time}App download completion timestamp
{installed_at}Install (i.e., first app open) timestamp
{is_organic}1 if organic traffic, 0 if non-organic
{last_tracker}6-character Adjust tracker token of a reattributed user's previous tracker
{network_name}Network name, as taken from the tracker
{network_type}Network type
{referral_time}User landed on app Play Store page timestamp (Android and Google Play Store only)
{reinstalled_at}Reinstall timestamp
{rejection_reason}Reason for a rejected attribution
{store}Target store of click
{tracker_name}Current tracker name
{proxy_ip_address}IP address of user's proxy