adjust сторонний инструмент для отслеживания установок относительно источников, используя технологию fingerprinting. Мы можем отслеживать установки на уровне баннеров и различного рода таргетинга (к примеру, по стране и устройству).

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

В этом видео мы познакомим вас с кабинетом для партнеров, где вы можете строить постбэки. Для более подробного объяснения и изучения всех опций, прочтите пожалуйста нашу документацию. Как только вы успешно протестировали сетап, вы можете запросить включение в список интегрированных партнеров. Тем не менее вы можете использовать API постбэков и запускать кампании, даже если вас еще не внесли в этот список.

1Отслеживание конверсий с помощью adjust

  1. URL для отслеживания будет предоставлен клиентом. Такой URL выглядит так - https://app.adjust.com/trackerid где trackerid это код отслеживания закрепленный за определенным источником траффика. Это всегда 6 цифр, написанных вместе с маленькими буквами или цифрами.

  2. Если вы хотите получать данные по конверсиям, свяжите ваши постбэки для отслеживания вместе с трекером URL adjust.

  3. Вам надо скопировать URL, а затем установить его для creative за которым надо следить.

  4. URL переведт в магазин приложений или напрямую в приложение.

  5. Постбэки будут отправляться если вы укажете это в трекер URL.

Вы можете воспользоватся нашим partners tool для создания URL с правильным кодированием.

2Настройка постбэков

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

Имейте в виду, что наше решение отличается от конкурентов, тем что мы позволяем динамично прикреплять URL постбэков к URL трекера вместо того, чтобы хардкодить их на сервере. Таким образом вы можете легко изменять или обновлять их как вам необходимо. Также благодаря API вы можете создавать новые кампании в течении пяти минут и более того для этого вам не понадобится помощь со стороны клиента.

Для того чтобы настроить ваш URL, воспользуйтесь нашим инструментом tool for partners с помощью его вы сможете добавить URL вашего постбэка и URL трекер клиента, тем самым сгенерировав URL для кампании. Также рекомендуем прочитать network integration brief.

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

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

2.1Плейсхолдеры

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

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

К примеру, для получения страны по каждому клику, установке или событию внутри приложения, вставьте плейсхолдер {country} как параметр в вашей трекинг системе. Добавьте несколько других параметров через знак аперсанды (&):

http://track.mymobilenetwork.com/click?country={country}
http://track.mymobilenetwork.com/install?country={country}&device_id={adid}
http://track.mymobilenetwork.com/event?country={country}&event_id={event}

Вот как они будут выглядеть, когда вы их закодируете согласно пункту 2.2:

http%3A%2F%2Ftrack.mymobilenetwork.com%2Fclick%3Fcountry%3D%7Bcountry%7D
http%3A%2F%2Ftrack.mymobilenetwork.com%2Finstall%3Fcountry%3D%7Bcountry%7D%26device_id%3D%7Badid%7D
http%3A%2F%2Ftrack.mymobilenetwork.com%2Fevent%3Fcountry%3D%7Bcountry%7D%26event_id%3D%7Bevent%7D

В заключении, добавьте соответствующие постбэки в трекер URL, чтобы они выглядели так:

https://app.adjust.com/trackerid?click_callback=http%3A%2F%2Ftrack.mymobilenetwork.com%2Fclick%3Fcountry%3D%7Bcountry%7D%0A
https://app.adjust.com/trackerid?install_callback=http%3A%2F%2Ftrack.mymobilenetwork.com%2Finstall%3Fcountry%3D%7Bcountry%7D%26device_id%3D%7Badid%7D
https://app.adjust.com/trackerid?event_callback=http%3A%2F%2Ftrack.mymobilenetwork.com%2Fevent%3Fcountry%3D%7Bcountry%7D%26event_id%3D%7Bevent%7D

В плейсхолдер страны будет вставлен код страны со знаками вопроса и это будет включено в виде параметра для вашего постбэка.

Ознакомьтесь с table of placeholders and their availability for different callbacks. Если плейсхолдер не доступен он будет заменен пустым значением (“”).

2.2Постбэки для событий внутри приложения

В дополнении к постбэкам установки, мы дополнительно даём возможность отслеживать события внутри приложения, вызванные пользователем после установки.

Любой постбэк прикрепленный к параметру event_callback получает запрос при совершении определенного события внутри приложения, но вы можете работать с разными событиями с помощью плейсхолдера {event}.

Прикрепите постбэк в соответствии с форматом ниже:

http://track.mymobilenetwork.com/event?id={event}

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

Вы также можете настроить отправку постбэка в для конкретного события, указав маркер этого события в URL постбэка. Это будет особенно полезно, если вы хотите отслеживать один тип конверсии или если ваш сервер относит конкретный URL к определенному событию. К примеру, один URL для события продажи, другой для регистрации и так далее. Ваш клиент должен предоставить вам маркер события, который сгенерировал adjust.

К примеру, если вам интересно только событие ‘sale’, маркер которого - abc123 – вы можете задать URL для конверсии в виде параметра event_callback_abc123:

https://app.adjust.com/trackerid?event_callback_abc123=encodedsaleurl

Постбэк encodedsaleurl будет вызываться только, когда будет происходит событие abc123. Конечно же вы можете добавить несколько постбэков на событие:

https://app.adjust.com/trackerid?event_callback_abc123=encodedsaleurl&event_callback_def456=encodedcallbackurl&event_callback_ghj789=encodedcallbackurl

Обозначение событий в постбэках позволяет большинству серверов рекламных сетей интегрироваться с adjust. Если у вас есть вопросы по поводу подобных настроек для вас, пожалуйста пишите нам на почту support@adjust.com.

2.3Тестирование

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

https://app.adjust.com/cbtest?callback=encodedcallbackurl

Это сразу же вызовет постбэк без необходимости установки. Вы можете использовать”callback”, “install_callback” или “event_callback” как параметры для тестирования. Если у вас возникли проблемы с интерфейсом для тестирования пожалуйста свяжитесь с нами по почте support@adjust.com.

Дополнительно, если вы хотите провести полный тест с настоящим трекером и приложением, вы можете попросить ссылку трекера у своего клиента и провести соответствующий тест. Он не будет ни чем отличаться от теста с cbtest. Делая это, имейте в виду, что adjust навсегда отнесет вашу установку к использованному трекеру.

Вам будет необходимо пользоваться новым устройством для каждого теста или удалить данные о девайса с нашего сервера перед каждым тестом. Удалить данные об устройстве можно перейдя по ссылкам следующего формата:

iOS 		https://app.adjust.com/forget_device?app_token= < app token >&idfa= < IDFA of your device >
Android 	https://app.adjust.com/forget_device?app_token= < app token >&gps_adid= < Advertiser ID of your device >
Android 	https://app.adjust.com/forget_device?app_token= < app token >&android_id= < Android ID of your device >
Android 	https://app.adjust.com/forget_device?app_token= < app token >&mac= < Wifi MAC of your device >

app token – уникальный идентификатор приложения, к которому есть доступ у вашего клиента. Пожалуйста попросите этот token напрямую у клиента и добавьте его в указанное место в URLе вверху. Вызов этого, к примеру, на компьютере должно вызвать следующее:

Forgot device
tracker: f0ob4r
event pingback: < optionally an associated event callback >

Если в ответ вы получаете “device not found”, пожалуйста повторно проверьте правильно ли введены все параметры, если проблема не разрешилась пожалуйста свяжитесь с нами по почте-support@adjust.com.

3Передача publisher IDs или creative IDs в контрольную панель клиента

Вы можете отправлять любые произвольные данные в контрольную панель клиента используя специальные параметры кампании в ссылке. Зачастую это используется для передачи publisher IDs или подобного. Это делается для того чтобы у клиента была возможность использовать эти данные для отчетов. Когда вы добавляете параметры кампании в ссылку, adjust сгруппирует пользователей под установленными лейблами. Обычно это означает установка макроса publisher ID в один из параметров кампании.

Доступные параметры кампаний:

campaign 	на один уровень ниже верхнего уровня трекера
adgroup 	на два уровня ниже верхнего уровня трекера
creative 	на три уровня ниже верхнего уровня трекера

Сегментация должна быть построена в убывающем порядке. К примеру, campaign должен использоваться для самого большого элемента сегментации (страна, кампания), adgroup для сегмента поменьше (таргетинг) и creative для самого маленького уровня (баннера и publisher IDs). Ваш клиент возможно уже использует некоторые уровни такой сегментации – перед началом работы, пожалуйста уточните это у клиента.

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

Если ваш макрос или плейсхолдер для publisher Ids - {publisher_id} - вы можете добавить его на самый последний уровень сегментации в параметр creative:

?creative={publisher_id}

Ваш сервер заменит макрос и отправит нам реальный publisher ID как последний уровень в сегментации. Таким образом ваш publisher ID будет доступен в отчетах клиента. При возникновении вопросов пожалуйста свяжитесь с нами по почте - support@adjust.com.

4Отправка ID устройства для улучшения отслеживания конверсий

adjust использует технологию digital fingerprinting для отслеживания конверсий. Данная технология основывается на временных переменных. Это может ухудшить показатели отчетов, когда доступное время пользования этими параметрами истечет.

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

Отправка параметр
Raw Google Advertising ID gps_adid
Google Advertising ID (Uppercase, MD5) gps_adid_upper_md5
Google Advertising ID (Uppercase, SHA1) gps_adid_upper_sha1
Google Advertising ID (Lowercase, SHA1) gps_adid_lower_sha1
Raw Android ID android_id
Android ID (Lowercase, MD5) android_id_lower_md5
Android ID (Lowercase, SHA1) android_id_lower_sha1
Android ID (Uppercase, MD5) android_id_upper_md5
Android ID (Uppercase, SHA1) android_id_upper_sha1
Raw IDFA idfa
IDFA (Lowercase, MD5 hash) idfa_lower_md5
IDFA (Lowercase, SHA1 hash) idfa_lower_sha1
IDFA (Uppercase, MD5 hash) idfa_upper_md5
IDFA (Uppercase, SHA1 hash) idfa_upper_sha1
IDFA (without colons) idfa_short
MAC (Uppercase, no colons, MD5) mac_upper_short_md5
MAC (Uppercase, no colons, SHA1) mac_upper_sha1

Имейте в виду, что индентификатор MAC используется только в хешированном виде по юридическим причинам. К примеру, добавьте параметр “ idfa_short “ (без кавычек) к вашему трекеру, добавьте в этот параметр DeviceID в URL по следующему формату:

https://app.adjust.com/trackerid?idfa_short=DeviceID

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

5Интеграции Сервер-Сервер на клик

adjust работает лучше когда пользователь полностью виден через перенаправление. В некоторых случаях, мы можем предложить интеграцию Сервер-Сервер на клик. Пожалуйста свяжетесь с нами по почте - support@adjust.com для старта любой подобной кампании.

Для того чтобы корректно анализировать эту интеграцию, вам надо сообщить adjust, что клик отсылается не от пользователя, а от сервера.

Дополнительно, сервер-сервер на клик должен работать по логике fingerprinting и вместе с этим должно быть доступно ID устройств для отслеживания, как приведено в примере выше. Правильный вызов сервер-сервер интеграции, должно выглядеть так:

https://app.adjust.com/f0ob4r?idfa={idfa}&s2s=1

Для того чтобы включить ID устройства, укажите в параметре s2s цифру 1 как в примере выше. Если данный параметр не будет указан, клики будут проигнорированы (для того чтобы не пропустить мошеничества с помощью ботов) и пользователи не будет отнесены к соответствующему источнику трафика.

6Отслеживание показов

По умолчанию adjust не поддерживает отслеживание показов, так как они сильно отличаются от кликов. Если необходимо мы можем приготовить специальное решение для клиента, к примеру отслеживание мобильной видео-рекламы. Для этого свяжитесь с нами support@adjust.com.

7Скрывание структуры постбэков

Если важно чтобы постбэк интеграция была секретной, мы можем предоставить вам плейсхолдер для статической части вашего URL. Просто свяжитесь с нами по почте support@adjust.com для того чтобы уточнить как выглядит ваш постбэк и какая его часть будет статичной. После того, как будет настроен плейсхолдер, вы сможете использовать URL, как для обычного для постбэка.

К примеру, ваш постбэк выглядит как:

http://mynetwork.com/secret_handler?track=1&install=1&click_id=100

клик click ID динамичная часть, мы можем создать плейсхолдер (mynetwork) который будет отвечать вашему первоначальному URL, тогда постбэк для установки будет выглядит так:

mynetwork?click_id=100

Полная ссылка будет выглядит так:

https://app.adjust.com/trackerid?callback=mynetwork%3Fclick_id%3D100

Это надстройка должна быть произведена на нашей стороне, поэтому сначала свяжитесь с нами по почте support@adjust.com.

8Безопасность

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

178.162.216.64/26
178.162.216.128/26

Имейте в виду, что это только обозначение полного списка IPs адресов. Свяжитесь с support@adjust.com для получение полного списка.

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

	location /callback {
        // add this condition to only check callbacks having an "adjust" parameter
        // set to 1 for the origin - if this location only processes adjust calls,
        // remove the condition
	if ($arg_adeven = 1) {
		allow 88.198.77.64/26; deny all;
	} }

Используя эту настройку просто добавьте “&adeven=1” в постбэк и они будут проверены на корректность IP, вызвать мошеннические постбэки будет невозможно. Если вам нужна помощь для настроек прокси, свяжитесь с нами по почте support@adjust.com.

9Интеграция SKStoreProductView

Если вы хотите пользоваться сервисом Apple iOS SKStoreProductView, он позволяет открывать приложения в App Store внутри другого приложения. Это значительно увеличивает рекламную конверсию. Для этого постбэк на клик должен быть установлен в ваш SDK.

Мы можем предоставить так называеммый wrapper, чтобы помочь с этой интеграцией. В нем и будет необходимый постбэк.