Настройка ответных вызовов

Последнее обновление:

Ответные вызовы – это уведомления о событиях (клики, просмотры видео или преобразованные установки).

Панель пользователя Chartboost позволяет задавать и запускать ответные вызовы в очень короткие сроки. Начните работу со страницы об управлении ответными вызовами и нажмите «Добавить новый ответный вызов» в верхнем углу справа. Откроется форма «Новый ответный вызов»:

Вот ее краткое описание:

Основы

Укажите название ли описание своего ответного вызова, а также свою роль (рекламодатель или публикатор).

Выберите шаблон третьей стороны

Chartboost предлагает заранее сконфигурированные шаблоны настройки ответных вызовов для большинства сторонних поставщиков и поддерживаемых ими параметров. При выборе шаблона все обязательные параметры и компоненты настройки ответного вызова заполняются автоматически. Во многих случаях вам будет предложено указать конкретные данные, связанные с тем или иным поставщиком (например, отслеживающий URL, Bundle ID, ид. рекламы и т. п.). Вы также можете добавлять в эти настройки другие параметры, пользуясь приведенными ниже описаниями.

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

Базовый URL

«Базовый URL» – это конечная точка на вашем сервере или отслеживающем стороннем сервере, куда будет направляться ответный вызов, – например, https://myserver.com/tracker. Наша система добавит к указанному URL статические переменные и параметры.

Статические переменные

Поле «Статические переменные» позволяет добавлять к каждому ответному вызову тэг в соответствии с требованиями вашего сервера или службы. Чтобы включить такую, например, статическую переменную, как network=chartboost, добавьте network в поле «Ключ» и chartboost – в поле «Значение».

Динамические параметры

Следующим идет раскрывающийся список «Динамические параметры», где можно выбирать передаваемую информацию о событии. Полный список параметров ответных вызовов поможет выбрать нужный пункт раскрывающегося списка.

Обратите внимание на то, что при добавлении параметров им можно давать любые названия: мы передаем значения, а вы можете указать название параметра в поле «Ключ».

Проверка связи

Указав конечную точку, статические переменные и динамические параметры, можно перейти к вашему URL.

Вы можете заметить, что в разделе «URL ответного вызова» отображаются построенные вами ответные вызовы; нажмите «Проверить сейчас», чтобы убедиться в том, что конечная точка работает корректно. Для активации вашего ответного вызова нам нужно получить успешные результаты проверки! Ниже приведен пример информации, которую мы пересылаем при проверке связи:

{
    "from" : "TestPublisherGame",
    "uuid" : "5555555555555555",
    "campaign" : "TestCampaign",
    "campaign_id" : "444444444444444444444444",
    "to" : "TestAdvertiserGame",
    "ifa" : "66666666666666666666666666666666",
    "type" : "click"
}
Ответный вызов Chartboost post возвращается в заголовке URL как вызов get.
Закрепление ответных вызовов за учетной записью, приложениями или кампаниями

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

  • Ответные вызовы на уровне кампании передают данные о кликах или преобразованных установках в рамках кампании и имеют приоритет над другими ответными вызовами.
  • Ответные вызовы на уровне приложения передают данные о кликах и установках во всех кампаниях, работающих в данной игре; они имеют приоритет над ответными вызовами на уровне учетной записи. Обратите внимание на то, что это относится и кампаниям публикатора.
  • Ответные вызовы на уровне учетной записи относятся ко всем играм и кампаниям, за исключением тех, за которыми закреплены ответные вызовы более высокого уровня.  (НЕ РЕКОМЕНДУЕТСЯ)

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

Учтите, что ответные вызовы можно также закреплять за кампаниями через пункт «Изменить кампанию» > «Расширенные настройки»...

...а за приложениями – через страницу «Настройки приложения», раздел «Расширенные настройки»:

Дублирование ответного вызова

Chartboost облегчает клонирование ответных вызовов для использования в разных играх или кампаниях. Если вашей системе или сторонней службе нужно получать одинаковые или сходные параметры, встроенные в существующий ответный вызов, перейдите на страницу «Список ответных вызовов» и нажмите на названии ответного вызова:

После этого просто нажмите «Дублировать» в верхней части формы «Изменить ответный вызов»:

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

 

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

  • Изменить существующий ответный вызов
  • Удалить существующий ответный вызов
  • Приостановить существующий ответный вызов
  • Дублировать ответный вызов для использования в другой игре или кампании (сначала нажмите «Изменить»)
  • Добавить новый ответный вызов