Настройка Pinterest
Pinterest — рекламная сеть, интегрированная с Adjust. Интеграция с нашей системой позволяет передавать в Pinterest данные об атрибуции и событиях в приложении посредством автоматических колбэков.
Из этой статьи вы узнаете, как настроить измерение с помощью Pinterest для вашего приложения. Речь пойдет об активации интеграции, создании ссылки на кампанию и выборе данных, которые Adjust может передавать Pinterest.
Перед началом работы
Требования
- Доступ к администрированию, редактированию или настраиваемый доступ к редактированию в Adjust.
- Adjust SDK версии 4.0.0 и более поздних версий для сопоставления параметров SDK с параметрами Pinterest. Для использования этой функции следуйте приведенным ниже инструкциям.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Учетные данные
TAG ID (required for events), Pinterest Account ID и Pinterest Authentication Token
- Чтобы узнать, как найти ваши учетные данные, обратитесь к своему представителю Pinterest.
В панели управления Pinterest:
Ссылки межсерверных кликов Adjust следует настроить как параллельные трекеры кликов ( parallel click trackers ) в Pinterest. Более подробную информацию вы можете найти здесь.
Выберите Pinterest и свое приложение в Campaign Lab
- В разделе Campaign Lab выберите Партнеры .
- Выберите Новый партнер > Pinterest . Выберите Далее , чтобы перейти к следующему экрану.
- На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Pinterest.
- Нажмите Далее .
Включение обмена данными
Включите обмен данными, чтобы активировать интеграцию с Pinterest. Чтобы включить обмен данными:
- Введите TAG ID (required for events), Pinterest Account ID и Pinterest Authentication Token.
После включения обмена данными с Pinterest, Adjust автоматически отправляет Pinterest следующие данные (по умолчанию).
- событие
Настройте параметры обмена данными
При работе с мультиплатформенными приложениями с возможностью совместного использования данных для нескольких платформ вы можете:
- Разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы .
- Установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки .
В разделе К чему будет предоставлен доступ? отметьте действия, которые Adjust будет передавать Pinterest по умолчанию.
- событие
Отправка дополнительных данных
Выберите объем и тип данных для передачи Pinterest посредством колбэков. Pinterest может использовать эту информацию для оптимизации производительности.
- В разделе Какими источниками данных вы хотите поделиться? выберите источник атрибуции данных, которые вы хотите передавать Pinterest:
- Данные из всех источников атрибуции
- Только данные, атрибутированные партнеру Pinterest
Доход в приложении (от покупок в приложении)
Передача данных о доходе в приложении позволяет Pinterest получать данные не только о сумме дохода, но и о событии дохода. Чтобы делиться этими данными, необходимо сопоставить события, генерирующие доход.
Сопоставление событий
Сопоставьте события, которые хотите передавать, со значениями, которые Pinterest может получать. Данные событий, которые вы не сопоставили, не могут быть переданы Pinterest.
Составить отдельные события
Если у вас мультиплатформенное приложение, вы можете выбрать разные события для каждой платформы и поделиться ими Pinterest. Это позволяет вам:
- настроить отдельные события для управления стратегиями кампаний для каждой платформы;
- настроить обмен данными для каждой платформы.
В разделе Сопоставление событий выполните следующие действия, чтобы выбрать события в приложении, данные о которых следует передавать Pinterest:
Выберите Сопоставить событие .
В списке Событие Adjust выберите событие Adjust, которым вы хотите поделиться с Pinterest.
В разделе «Событие партнера» необходимо выбрать событие Pinterest, соответствующее событию Adjust.
Для одноплатформенных и многоплатформенных приложений, в которых обмен данными включен только для одной платформы, выполняется сопоставление событий только для этой платформы. Для мультиплатформенных приложений с возможностью совместного использования данных для нескольких платформ вы можете:
- Нажмите «Использовать сопоставление конкретной платформы» , чтобы сопоставить отдельные события на уровне платформы или не сопоставлять события для определенных платформ.
- Нажмите «Использовать глобальное сопоставление» , чтобы отобразить одни и те же события для всех платформ.
В списке Событие партнера выберите или введите имя настраиваемого события, которое нужно сопоставить с событием Adjust.
Нажмите Применить .
Теперь Pinterest будет получать данные о событии в приложении по каждому связанному событию.
Сопоставить все события
Если Pinterest поддерживает автоматическое сопоставление всех событий, в разделе «Сопоставление событий» нажмите «Сопоставить все события». Это экономит время при сопоставлении отдельных событий.
Теперь Pinterest будет получать данные о событии в приложении по каждому из ваших связанных событий.
Сопоставьте параметры
Чтобы делиться настраиваемыми данными с Pinterest, обычно требуется сопоставить параметры.
Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно Pinterest. Таким образом Pinterest будет получать указанные сведения по каждому связанному событию.
Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.
Чтобы передавать Pinterest параметры партнера, выполните следующие действия:
Настройте параметры партнера в Adjust SDK.
- Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.
В разделе Выберите параметры обмена данными нажмите Параметры .
В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:
- Выберите Сопоставить параметр .
- В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
- В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание. Если параметры партнера настроены в Adjust SDK без настройки передачи параметров на панели управления, Adjust будет передавать эти параметры с тем же названием, что и в Adjust SDK.
Сконфигурируйте ссылки и настройки
Вы можете настроить следующие параметры:
Создайте ссылку и поделитесь ей с Pinterest
На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:
- Выбранное приложение
- Параметры обмена данными
- Параметры структуры ссылки
- Места назначения пользователей
- Настройки атрибуции
Нажмите Создать ссылку , чтобы создать URL клика, URL показа, QR-код и токен ссылки. При создании ссылки также включается обмен данными и интеграция с Pinterest.
После того как ссылка создана, поделитесь ей с Pinterest для размещения в кампании.
Инструкции по настройке для конкретных партнеров
Обзор
Учетные данные, которые требуются для отправки в Pinterest событий в приложении, зависят от используемой вами версии API:
API вер. 5 (рекомендуется):
- Идентификатор рекламного аккаунта
- Токен доступа
Устаревший API:
- Идентификатор тега
Токен доступа можно получить в Pinterest Ads Manager : Обзор рекламного аккаунта > Конверсии> Настройка API
Более подробную информацию вы можете найти здесь
Переход с устаревшего API на API вер. 5
Pinterest отказывается от своего устаревшего API в пользу API v5 . В этой документации описывается процесс настройки, включая аутентификацию, сопоставление событий и удаление устаревших конфигураций.
1. Ввод учетных данных
После выбора Pinterest и своего приложения в Campaign Lab предоставьте следующие данные:
- Идентификатор аккаунта
- Токен доступа
Оба поля являются обязательными для API вер. 5. Инструкции о том, где найти токены доступа для правильного идентификатора аккаунта, приведены здесь.
2. Сопоставление событий
Что такое поля сопоставления событий
- Имя (устаревшее) : используется только с устаревшим API.
- Новое имя (API вер. 5) : значения событий, необходимые для API вер. 5.
В Adjust в поле «Событие Adjust» выберите событие в приложении, которое вы хотите сопоставить, и сопоставьте его со значением из раскрывающегося списка Новое имя .
Рекомендации по сопоставлению имен событий из устаревшего API («Имя») в API вер. 5 («Новое имя») приведены ниже. Вы также можете свободно сопоставлять для Pinterest события устаревшего API («Имя») с другими доступными событиями API вер. 5 («Новое имя»).
Имя (устаревший API) | Новое имя (API вер. 5) |
Add to cart | Add to cart |
Purchase | Checkout |
Registration | Signup |
Search | Search |
Lead | Lead |
Page visit | Page visit |
3. Удаление устаревшего идентификатора тега (необязательно)
В API вер. 5 идентификатор тега больше не требуется. Его можно безопасно удалить из вашей конфигурации. Если вместе с идентификатором аккаунта , токеном доступа и значением для поля Новое имя вы по-прежнему указываете идентификатор тега, система отдаст приоритет API вер. 5 и проигнорирует идентификатор тега для устаревшего API.
лучшая практика, рекомендация
Pinterest поддерживает кампании по повышению конверсии с использованием диплинков как для iOS , так и для Android . Прежде чем включить интеграцию, свяжитесь с Pinterest , чтобы они помогли вам с настройкой кампании.
Предопределенные параметры
Используя Adjust SDK, можно отправлять предварительно определенные параметры вместе с вашими событиями. При правильном подключении эти параметры передаются в Pinterest.
Информацию о правильном способе присоединения параметров партнера к вашим событиям см. в документации по SDK.
Параметр | Описание | Поддерживается в API вер. 5 | Формат/примечания |
external_id | Внешний идентификатор пользователя | ✅ | Список строк, разделенных запятыми или точкой с запятой |
event_source_url | URL веб-страницы, где произошло событие | ✅ | Строка (в формате URL) |
em | Хэши адреса электронной почты | ✅ | Хэш SHA256 адреса электронной почты, указанного с использованием символов нижнего регистра |
ph | Хэши телефонных номеров | ✅ | Хэш SHA256 номера телефона, указанного с использованием только цифр, с кодом страны и города |
event_id | Уникальный идентификатор события | ✅ | Строка |
content_ids | Идентификаторы продукта или контента | ✅ | Список строк, разделенных запятыми или точкой с запятой |
order_id | Идентификатор заказа | ✅ | Строка |
значение | Стоимость покупки или добавления в корзину | ✅ | Число (поддерживается также в старом API) |
currency | Валюта для поля значения | ✅ | Код ISO 4217 (например, USD, EUR) — поддерживается также в старом API |
Более подробную информацию о форматировании external_id
, em
и ph
см. в документации по API Pinterest.
Значения параметров стоимости и валюты используются как резервные значения и передаются в Pinterest только в том случае, если Adjust не получает никаких данных о доходах для события в приложении напрямую из SDK.
Дополнительную информацию см. в документации Adjust по регистрации доходов от событий.
Сгруппированные параметры на уровне элементов
Следующие параметры описывают метаданные на уровне элементов и должны быть упорядочены в полезной нагрузке события.
Параметр | Описание | Формат/примечания |
ID | Уникальные идентификаторы элементов | Упорядоченный список строк (разделенных запятыми или точкой с запятой) |
quantity | Количество каждого элемента | Упорядоченный список строк |
item_name | Название каждого элемента | Упорядоченный список строк |
item_price | Цена каждого элемента | Упорядоченный список строк |
item_category | Категория каждого элемента | Упорядоченный список строк |
item_brand | Бренд каждого элемента | Упорядоченный список строк |
Порядок расстановки значений должен совпадать во всех этих полях.
(Например, первое значение в поле item_price
должно совпадать с первым значением в полях item_name
, id
и т. д.)
Список всех параметров, передаваемых Pinterest
Pinterest требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:
Плейсхолдер | Информация |
{city} | Город, в котором используется устройство |
{country} | Код страны устройства из двух символов |
{currency} | Исходный валютный код ISO 4217, отправленный из Adjust SDK |
{device_name} | Номер модели устройства |
{gps_adid} | Рекламный идентификатор магазина Google Play |
{idfa} | Идентификатор IDFA (только для iOS) |
{ip_address} | IP-адрес устройства |
{isp} | Поставщик услуг интернета для устройства |
{language} | Код языка устройства из двух символов |
{os_name} | Операционная система устройства |
{os_version} | Номер версии операционной системы |
{partner_parameters} | Пользовательские параметры партнера, собираемые запросом Adjust SDK или S2S и передаваемые сторонним поставщикам с помощью постбэков |
{revenue_usd} | Доход в долларах США |
{revenue} | Доход в том виде, в котором он отправлен из Adjust SDK, в центах |
{sdk_version} | Версия SDK Adjust (для приложения) |
{tracking_limited} | 1 — если отслеживание ограничено, 0 — если нет |
{user_agent} | Входящий необработанный user agent |
{app_id} | Идентификатор App Store или Google Play Store |
{app_name} | Имя приложения |
{app_version_short} | Номер версии приложения (Android), номер конечной версии пакета (iOS) |
{created_at} | Временная отметка действия |
{impression_based} | 1 — если вовлечение на основе просмотра, 0 — если нет |