Бюллетень: Миграция на новый конечный пункт постбэка Pinterest

Раздел Подробности
Что нового? Pinterest перешёл на новый конечный пункт на базе собственной инфраструктуры API конверсий (CAPI). Вам необходимо обновить настройки, чтобы продолжать отправлять события вашего приложения в Pinterest. Поддержка устаревшего конечного пункта будет прекращена 30 сентября 2025 года.
Дата вступления в силу 23 июля 2025 года
Самое важное

Примечание

Этот бюллетень содержит информацию, относящуюся к фазе миграции на CAPI. Общую информацию об интеграции с Pinterest смотрите в этой статье

Обновление в соответствии с новыми настройками внутренних событий приложения обеспечит непрерывность измерения в Pinterest. Это обновление также включает в себя:

  • Большее типов «событий»: отслеживание дополнительных событий, чтобы обеспечить достижение поставленных целей по таким показателям, как: лид, поиск, просмотр категории, визит страницы, пользовательские события и др.
    • Примечание: названия событий для нового конечного пункта Pinterest V5 изменились. Если вы не обновите настройки в дэшборде, в отчёте о событиях будет отображено значение «неизвестно». Пожалуйста, ознакомьтесь с новыми названиями событий ниже.
  • Улучшение качества данных: более точное сопоставление и более высокая точность атрибуции.

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

Как узнать идентификатор рекламного аккаунта AppsFlyer для Pinterest
Вы можете найти текущий идентификатор рекламного аккаунта для отчётности по конверсиям AppsFlyer в Pinterest в разделе «Бизнес-менеджер» или в отчётах Pinterest по конверсиям.

  1. Войдите в свой бизнес-аккаунт Pinterest (чтобы увидеть параметры хаба вам нужно войти в бизнес-профиль).
  2. Введите или вставьте в ваш браузер https://www.pinterest.com/business/hub/ и нажмите «Ввод».
  3. Посмотрите на навигационную панель тёмно-серого цвета слева. Если панель свёрнута, нажмите на значок «≡» (три полоски) в верхнем левом углу, чтобы развернуть её.
  4. Прокрутите немного вниз, пока не увидите раздел с заголовком «Управление бизнесом».
  5. Нажмите на Конверсии (находится прямо под «Управление бизнесом»). Откроется дэшборд конверсий, где вы можете просмотреть конверсии AppsFlyer, отправленные в Pinterest.
  6. Идентификатор рекламного аккаунта будет содержаться в URL.
  7. Если несколько идентификаторов рекламных аккаунтов Pinterest получают дубликаты конверсий от AppsFlyer, проверьте все существующие идентификаторы рекламных аккаунтов с конверсиями в разделе Pinterest «Бизнес-менеджер». Пожалуйста, убедитесь, что выбран оригинальный родительский идентификатор рекламного аккаунта для конверсий AppsFlyer.

Как узнать токен доступа AppsFlyer для Pinterest
Пожалуйста, следуйте инструкции в справочном центре Pinterest по этой ссылке. После перехода в Конверсии Pinterest, нажмите на API конверсий > Настроить API и сгенерируйте новый токен доступа для аккаунта.

Важно! Если вы уже настроили API конверсий для Pinterest отдельно вне AppsFlyer, используйте тот же токен доступа здесь для конверсий AppsFlyer.

Что необходимо сделать:

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

  1. Настройки внутренних событий приложения и обработка параметров дэшборда
    В настоящее время мы поддерживаем следующие параметры дэшборда для сопоставления ваших событий AppsFlyer с Pinterest:

    • Идентификатор рекламного аккаунта (видимый)
    • Токен доступа (видимый)
    • Идентификатор тега (не виден на панели управления, но поддерживается на серверной стороне для помощи в переходе на новую версию V5. Как только переход на конечную точку V5 будет полностью поддерживаем, идентификатор тега также будет удалён в бэкенде)

    Обратите внимание:
    Для новой настройки постбэка необходимо ввести как идентификатор рекламного аккаунта, так и токен доступа (их можно получить в Pinterest, если это ещё не было сделано). Если одно из этих значений отсутствует, постбэк не будет отправлен. Проверьте, чтобы оба параметра были правильно заполнены на странице Активная интеграция в Pinterest. Для получения дополнительной информации смотрите статью в Центре поддержки.
    Ваше сотрудничество важно для обеспечения плавного перехода. Спасибо за вашу поддержку!

  2. Сопоставление внутренних событий приложения и настроек постбэков
    1. Пожалуйста, замените и сопоставьте текущие названия событий Pinterest с новыми названиями событий API конверсий Pinterest для раздела Название событий у партнёра. Например, если в настоящее время вы используете pin_add_to_cart в разделе событий партнёра, замените это на add_to_cart. Для получения дополнительной информации смотрите статью в Центре поддержки.

      название события (устаревшее) название события (новый API конверсий)
      pin_add_to_cart add_to_cart
      pin_purchase checkout
      pin_search search
      pin_registration signup
      pin_sign_up signup
      pin_category_view view_category
      add_cart add_to_cart
      start_checkout checkout
      content_view view_category

      Примечание: Если вы не замените устаревшие названия событий для API конверсий обновлёнными, это приведёт к тому, что вместо правильного названия события в Pinterest будет отображаться значение «Other» (Другое).

    2. Выберите дляокна постбэка внутреннего события приложения, значение Lifetime (Всегда), чтобы Pinterest мог получить максимальное количество конверсий для оптимизации рекламы.
    3. Выберите для Пользователи из значение Все источники медиа, включая органические, чтобы Pinterest мог получить максимальное количество конверсий для оптимизации рекламы. Для получения дополнительной информации смотрите статью в Центре поддержки.
  3. Процесс отката в случае возникновения проблем
    Рекламодателям рекомендуется следить за конверсиями приложений от AppsFlyer на Pinterest, чтобы своевременно выявлять проблемы или неисправности, связанные с миграцией. Вам необходимо будет подождать до 30 минут, чтобы данные о конверсиях AppsFlyer появились в Pinterest, затем обеспечьте регулярный мониторинг в течение нескольких дней для проверки, был ли процесс миграции успешным.

    Рекламодатели могут вернуться к старой конечной точке, пропустив account_id и/или access_token в настройках интеграции. 
     

    Правила:

    • Отсутствует и account_id, и access_token → Постбэки отправляются на устаревшую (старую) конечную точку.
    • Есть только account_id (т.е. access_token пусто) → Постбэки отправляются на устаревшую конечную точку.
    • Есть только access_token (т.е. account_id пусто) → Постбэки отправляются на устаревшую конечную точку.
    • Есть и account_id, и access_token → Постбэки отправляются на новую конечную точку.

    Если у вас возникли какие-либо проблемы, свяжитесь с поддержкой AppsFlyer по адресу support@appsflyer.com. По любым вопросам по Pinterest, обращайтесь по адресу api-support@pinterest.com или свяжитесь со своим представителем в Pinterest.