Обзор

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

Через API Pinterest для конверсий рекламодатели могут отправлять:

  • конверсии в Интернете;
  • конверсии в приложении;
  • офлайн-конверсии.
  • События могут быть получены в режиме реального времени или в течение часа после события и его регистрации. События, полученные в другое время, а также задержка пакетных событий относятся к категории офлайн-конверсий.

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

    API Pinterest

    API Pinterest для конверсий является одним из нескольких продуктов экосистемы API Pinterest. Владельцы бизнес-аккаунтов Pinterest могут использовать API Pinterest для конверсий. Однако это не предоставляет им автоматический доступ к более многофункциональному API Pinterest. 

    Информация обо всех продуктах API Pinterest доступна на платформе для разработчиков Pinterest.

    Первые шаги

    Владельцы бизнес-аккаунтов Pinterest могут использовать API Pinterest для конверсий.

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

    Чтобы создать маркер доступа: 

  • Войдите в свой бизнес-аккаунт Pinterest.
  • В меню сверху выберите Объявления и нажмите Конверсии.
  • Нажмите Маркер доступа к данным конверсии на панели навигации слева.
  • Нажмите кнопку Создать новый маркер.
  • Скопируйте новый маркер доступа и вернитесь к настройке.
  • Если вы пытаетесь получить доступ к аккаунту, который вам не принадлежит, сначала нужно будет настроить Бизнес-доступ.

    Реализация

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

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

  • Знакомство разработчика с интеграцией API. Если ваш разработчик никогда раньше не выполнял интеграцию API, ему придется проделать необходимую работу.  Если у вас уже были другие API для конверсий, разработчику необходимо будет внести несколько изменений.
  • Количество отслеживаемых событий и на каком этапе процесса данные будут отправляться нам.
  • Рекламодатель хочет или должен использовать третью сторону для интеграции (например, Shopify, GTM, Tealium).
  • Если вы уже используете тег Pinterest

    Мы настоятельно рекомендуем использовать API Pinterest для конверсий в дополнение к тегу Pinterest, чтобы максимально увеличить количество конверсий.

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

    Для этого убедитесь, что параметр event_id передается с конверсиями, отслеженными как тегом Pinterest, так и API Pinterest для конверсий.

    Тогда наша система распознает параметры event_id как дубликаты и сохранит только первую полученную конверсию. Чтобы удаление дубликатов выполнялось успешно:

  • Параметры event_id у одинаковых конверсий должны совпадать. Предположим, пользователь переходит на веб-страницу, а конверсия посещения страницы активирует как тег Pinterest, так и API Pinterest. Чтобы наша система распознала эти конверсии как дубликаты, они должны отправить одинаковые параметры event_id. 
  • Параметры event_id у разных конверсий должны отличаться. Допустим, при переходе пользователя на веб-страницу конверсия посещения страницы активирует как тег Pinterest, так и API Pinterest. Затем, когда пользователь добавляет в корзину футболку, срабатывает событие «Добавление в корзину». Оно также активирует как тег Pinterest, так и API Pinterest. Параметры event_id одинаковых событий должны совпадать. Однако параметры event_id событий «Посещение страницы» и «Добавление в корзину» должны отличаться. Так наша система распознает их как разные события.
  • На основе параметров event_id и event_name Pinterest удалит все повторяющиеся события при условии, что событие не было совершено офлайн (для параметра action_source не указано «Офлайн») и наша система получила такие события в течение 48 часов после их совершения.

    Подтверждение настроек

    Завершив настройку API, вы сможете убедиться, что события конверсии регистрируются успешно. Для этого проверьте следующее:

  • Коды ответов — разработчик, настроивший вашу интеграцию API, может проверить коды ответов, возвращаемые с каждым запросом, отправленным после активации конверсии.
  • Страницу «Дедупликация» в менеджере объявлений — конверсии, дубликаты которых были удалены, показываются на странице «Дедупликация» в менеджере объявлений. Чтобы открыть эту страницу:
    • Войдите в свой бизнес-аккаунт Pinterest.
    • В меню сверху выберите Объявления и нажмите Конверсии.
    • На панели навигации слева выберите «Дедупликация».
  • Качество и устойчивость

    Устойчивость — это статус настройки API для конверсий, который обеспечивает самый высокий уровень сопоставления и атрибуции сигнала. По мере изменения и усовершенствования политик в рекламной индустрии такие дополнительные данные помогут нам предоставлять более точные отчеты.

    Статус устойчивости

    Существует две категории статуса устойчивости: высокая и низкая. Статус устойчивости отображается в разделе «Состояние конверсии» менеджера объявлений.

    Высокая устойчивость

    Вариант 1: охват конкретных идентификаторов

  • Охват идентификаторов
    • Не менее 90 % событий должны иметь IP/UA, 
    • не менее 10 % событий нижней воронки должны иметь хэшированные электронные адреса или идентификаторы MAID, 
    • 10 % или более событий должны иметь внешний идентификатор.
  • Совпадение с данными тегов (где применимо)
    • Не менее 90 % * событий тегов должны поступать через CAPI 
  • Или:

    Вариант 2: достижение базового коэффициента соответствия

  • Коэффициент соответствия пользователей CAPI не менее 60 %
  • Совпадение с данными тегов (где применимо)
  • Не менее 90 % * событий тегов должны поступать через CAPI 


  • Низкая устойчивость

    Любая настройка, не обладающая высокой устойчивостью.

    Идентификаторы и сигналы устойчивости

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

    Идентификаторы/сигналы API. Вес/рейтинг.
    client_ip_address + client_user_agent Высокий
    em. Высокий
    external_id. Высокий
    hashed_maid. Высокий
    click_id. Высокий
    fn + ln Низкий
    ph Низкий
    ge, bd, ct, st, zp, страна. Низкий

    * Вес/рейтинг на основе вероятности увеличения коэффициента соответствия

    Сторонняя реализация

    В Pinterest реализована интеграция с несколькими сторонними системами для поддержки внедрения API.

    Диспетчер тегов Google — на стороне сервера

    Чтобы узнать влияние Pinterest на трафик магазина и продажи товаров, подключите свой аккаунт в Диспетчере тегов Google к API Pinterest для конверсий.

    Эта интеграция требует от вас установки серверного контейнера с использованием предпочитаемого облачного провайдера и знаний о маркировке на стороне сервера. Чтобы узнать больше о предварительных требованиях, посетите сайт разработчика

    Shopify;

    Этот API для интеграции конверсий дополняет тег Pinterest, чтобы обеспечить высокое покрытие и качество данных. Пока приложение Shopify установлено, никакие действия для использования данного расширения не требуются. Изменения будут автоматически применены к магазину продавца.

    Tealium;

    Рекламодатели, заинтересованные в Tealium, могут настроить API для интеграции конверсий непосредственно с помощью третьей стороны. Tealium создаст шаблон и поможет упростить интеграцию с рекламодателем.

    Процесс реализации описан в Учебном центре Tealium. Вопросы о поддержке реализации можно отправить по адресу support [at] tealium.com (support[at]tealium[dot]com).

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

    Ограниченная обработка данных

    С 1 января 2023 г. рекламодатели могут использовать флажок ограниченной обработки данных, чтобы соответствовать Закону штата Калифорния о конфиденциальности потребителей, внесенному в Закон штата Калифорния о защите конфиденциальности (вместе, CCPA). С помощью этого флажка Pinterest будет ограничивать использование определенных данных для обеспечения соблюдения настроек конфиденциальности пользователей. Например, рекламодатель может применить флажок ограниченной обработки данных для пользователей из Калифорнии, отказавшихся от продажи или предоставления своих данных в соответствии с CCPA. Когда используется флажок ограниченной обработки данных, Pinterest будет выступать в качестве поставщика услуг в соответствии с CCPA в отношении отмеченных флажком данных пользователей в Калифорнии.

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

    End of Other articles Links
    Все еще нужна помощь? Контакты
    User feedback
    Была ли эта статья полезной?

    collection_fields

    Как можно улучшить эту статью?