Перейти к основному содержимому

Настройка измерения конверсий | Документация для разработчиков

Настройка измерения конверсии

Обновлено: 27 марта 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
Используя API маркетинговых сообщений для WhatsApp, вы можете интегрировать свои маркетинговые сообщения с событиями, что позволит вам измерять скорость и стоимость, с которой маркетинговое сообщение, отправленное через API маркетинговых сообщений для WhatsApp, приводит к событию на последующем этапе воронки продаж, например, к «покупке» на вашем веб-сайте или в приложении.
Измерение конверсий основано на тех же событиях, которые можно отправлять в Meta при использовании рекламы, что позволяет компаниям, уже интегрированным с Events for Ads (например, через Pixel или Conversions API для веб-сайтов или Meta SDK в мобильном приложении), автоматически получать отчеты без какой-либо настройки.
Если компания использует как маркетинговые сообщения через Marketing Messages API для WhatsApp, так и рекламные кампании в рамках одного и того же бизнес-портфеля, то события конверсии будут автоматически приписываться последнему мета-действию (либо клику по Marketing Messages API для WhatsApp, либо клику по рекламе) перед событием, в зависимости от настроек окна атрибуции для каждого из них. Например, если компания запускает как рекламную кампанию в Instagram, так и кампанию маркетинговых сообщений через MM API для WhatsApp, каждая с URL-адресом, указывающим на один и тот же веб-сайт для продажи, то пользователь, совершивший покупку после клика как по рекламе в Instagram, так и по маркетинговому сообщению, будет приписан либо к клику по MM API для WhatsApp, либо к клику по рекламе, в зависимости от настроек окна атрибуции для каждого из них. Это помогает компаниям лучше понимать общую картину эффективности своих рекламных и маркетинговых кампаний в достижении результатов.

Понимание связанных рекламных объектов

Когда компания регистрируется в API маркетинговых сообщений для WhatsApp, в её бизнес-портфеле создаются рекламные аккаунты только для чтения, которые синхронизируются с каждым бизнес-аккаунтом WhatsApp в том же портфеле. Обратите внимание, что маркетинговые сообщения являются отдельными и отличными от рекламы — использование термина «реклама» ниже представляет собой использование сущностей рекламы только в качестве технических конструкций.
Никаких действий со стороны компании или партнера не требуется — эти связанные рекламные аккаунты только для чтения синхронизируются со всеми изменениями, внесенными в маркетинговые шаблоны, так что любые новые или обновленные маркетинговые шаблоны отражаются в связанном с ними рекламном объекте.
Связывание маркетинговых шаблонов с рекламными аккаунтами предоставляет ряд преимуществ:
Единый пользовательский интерфейс и API для маркетинговых команд: Компании могут просматривать свои маркетинговые сообщения через API для маркетинговых кампаний WhatsApp и показатели кампаний в разделе «Кампании» на вкладке «Маркетинговые сообщения» в Ads Manager, а также через API, используя « Аналитический API » маркетингового отдела. Использование этих интерфейсов помогает маркетинговым командам компаний просматривать свои рекламные кампании и маркетинговые сообщения, используя единый интерфейс и терминологию, вместо того, чтобы просматривать рекламные кампании в одном месте, а маркетинговые кампании, отправленные через WhatsApp, в другом.
    Новые метрики: пользовательский интерфейс Ads Manager и API Insights предоставляют новые метрики конверсии (например, веб-сайт, приложение), которые не поддерживаются Cloud API и Business Management API. Когда шаблонные маркетинговые сообщения, отправленные через MM API для WhatsApp, приводят к событиям конверсии (например, добавление в корзину, покупка), о которых компания сообщает со своего веб-сайта или приложения, эти события конверсии приписываются маркетинговому сообщению и отображаются в метриках, что позволяет лучше понимать рентабельность маркетинговых сообщений. Отчетность по событиям осуществляется посредством интеграции с Pixel или Conversions API для событий веб-сайта и приложения, а также Meta SDK.

    Рекомендации по синхронизации шаблонов с объявлениями

      Шаблоны маркетинговых сообщений сопоставляются с объявлениями только один раз во время первоначального подключения к API маркетинговых сообщений для WhatsApp.Для корректного отображения показателей конверсии приложения в шаблонах необходимо завершить синхронизацию.Синхронизация рекламы может занять до 10 минут.Избегайте отправки сообщений с новыми шаблонами до завершения синхронизации, чтобы предотвратить ошибки или потерю результатов оптимизации и отслеживания.В шаблонах, созданных до начала внедрения, показатели конверсии будут отключены.Чтобы повторно активировать неиспользуемые шаблоны, которые не применялись более 7 дней: отправьте одно сообщение, используя шаблон, и подождите 10 минут, пока синхронизация рекламы не активируется снова.
      Диаграмма, показывающая процесс синхронизации шаблона и рекламы

      Понимание автоматической постановки целей

      Для измерения конверсий API маркетинговых сообщений для WhatsApp автоматически синхронизирует маркетинговые шаблоны с соответствующими объектами объявлений (кампаниями, наборами сообщений и объявлениями) с настройками, позволяющими формировать отчеты о конверсиях по предполагаемой цели.
      Этот процесс связывания происходит автоматически, чтобы упростить интеграцию API маркетинговых сообщений для WhatsApp для бизнеса. Тем, кто знаком с экосистемой рекламы Meta, следует отметить, что эти параметры кампании и группы объявлений не изменят способ доставки сообщений через API маркетинговых сообщений для WhatsApp — они устанавливаются только для того, чтобы зарегистрированные события могли быть корректно отнесены к определенным категориям.
      В таблице ниже показано, как шаблоны маркетинговых материалов сопоставляются с сущностями рекламных объявлений.
      Параметры кампании Параметры набора сообщений
      Шаблоны маркетинговых материалов без кнопки призыва к действию (CTA)
      Цель: РЕЗУЛЬТАТ_ПРОДАЖ
      Цель оптимизации: Количество показов
      Шаблоны маркетинговых материалов с кнопкой призыва к действию (CTA), которая ведет на веб-сайт или в приложение без включенной функции отслеживания событий.
      Цель: ССЫЛКИ
      OptimizationGoal: LinkClicks
      Маркетинговые шаблоны с кнопкой призыва к действию (CTA), которая ведет на веб-сайт или в приложение с включенной функцией отслеживания событий.
      Цель: ССЫЛКИ
      Цель оптимизации: Конверсия вне сайта
        Отслеживание событий определяется по тому, указывает ли URL-адрес на веб-сайт или приложение, для которого в рамках того же бизнес-портфеля включена функция отслеживания событий через Pixel, Conversions API или Meta SDK.
        Хотя большинство изменений в шаблонах автоматически синхронизируются с объявлениями (например, текстовое содержимое), параметры кампании и набора сообщений синхронизируются только один раз, когда компания впервые подключается к API маркетинговых сообщений для WhatsApp или создает новый шаблон, чтобы поддерживать согласованную структуру кампании и набора сообщений при составлении отчетов о кликах и конверсиях из сообщений, отправленных с использованием этого шаблона. Это означает, что если вы хотите добавить, отредактировать или удалить URL-адрес кнопки призыва к действию в шаблоне, вам необходимо создать новый шаблон, чтобы корректно фиксировать показатели кликов и конверсий для обновленного URL-адреса.

        Требования к URL-адресам для измерения конверсии

        Meta добавляет идентификатор клика (click ID) к URL-адресам, которые вы отправляете в кнопках призыва к действию (CTA) в шаблонных маркетинговых сообщениях. Цель идентификатора клика — атрибуция событий, о которых вы сообщаете через Meta Pixel, Conversions API (события веб-сайта или приложения) или Meta SDK.
        Идентификатор клика генерируется метаданными и обычно указывается в качестве fbclid .
        Пример URL-адреса с параметром запроса fbclid
        https://www.jaspersmarket.com/?fbclid=IwAR2F4-dbP0l7Mn1IawQQGCINEz7PYXQvwjNwB_qa2ofrHyiLjcbCRxTDMgk
        

        Совместимость URL-адресов (короткие ссылки, перенаправления и перезапись URL-адресов)

        Некоторые сервисы коротких ссылок и перенаправлений могут мешать измерению конверсий, если они удаляют, перезаписывают или не передают параметры запроса, добавляемые Meta. Если вы используете поставщика коротких ссылок или сервис перезаписи URL-адресов, убедитесь, что он сохраняет все параметры запроса от начала до конца.
        Пример, где перетаскивается fbclid:
          Настройте целевую страницу для призыва к действию следующим образом: https://www.jaspersmarket.com/checkout?campaign=whatsapp_templateВаш партнер по ссылкам преобразует эту ссылку в короткую ссылку, которая перенаправляет на ваш сайт: https://www.example.com/jaspersmarketПеред отправкой Meta добавляет идентификатор клика к короткой ссылке: https://www.example.com/jaspersmarket?fbclid=xyz789Когда пользователь нажимает на ссылку, сервис коротких ссылок перенаправляет на ваш сайт, но при этом удаляет строку запроса, отправляя пользователя по адресу: https://www.jaspersmarket.com/checkout?campaign=whatsapp_template (отсутствует fbclid=xyz789 )
          Идентификатор клика не сохраняется при перенаправлении, что может снизить способность Meta связывать конверсии с исходным кликом.

          Проблемы с порядком параметров URL

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

          Рекомендации

          Если вы используете короткие ссылки или перенаправления:
            Убедитесь, что итоговый URL-адрес сохраняет все параметры запроса (включая fbclid ).Перед отправкой данных в рабочую среду проверьте отчеты о конверсиях в Ads Manager и Insights API.Избегайте добавления параметров после fbclid таким образом, чтобы это могло нарушить структуру URL-адреса.
            В случае возникновения проблем, сотрудничайте со своим партнером, чтобы обеспечить сохранение параметров запроса, или обратитесь в Meta с подробной информацией.
            В Android для маршрутизации прямых ссылок используются фильтры намерений, заданные приложениями. URL-адрес прямой ссылки состоит из трех частей:
              Схема (например, https , myapp ) — помогает определить, какое приложение может открыть ссылку.Путь (например, /product/123 ) — маршрут внутри приложения.Параметры запроса (например, ?fbclid=... ) — включают данные об атрибуции, такие как fbclid , campaignId , al_applink_data и другие.
              Когда пользователь переходит по прямой ссылке, Android:
                Находит приложения с фильтрами намерений, соответствующими URL-адресу (схема/хост/путь).Создаёт неявное намерение.Передает его в целевую Activity (часто через onCreate() и/или onNewIntent() ), где приложение должно прочитать полный URL-адрес (включая параметры запроса).
                Android передает URL-адрес, но ваше приложение должно явно собирать и сохранять параметры атрибуции. В противном случае они могут быть фактически «потеряны» после первого экрана.
                Параметры атрибуции, такие как fbclid, могут быть удалены, неправильно кэшированы или переданы не так, как ожидалось, по одной или нескольким причинам:
                  Поведение разрешения намерений в Android (несколько обработчиков, поведение при повторном запуске или режимы запуска активности)Как WhatsApp инициирует ссылки приложений (промежуточный анализ и передача на Android)Например, выявление пробелов в реализации приложений:
                    методе onCreate() считывается только URL-адрес, а методе onNewIntent() Несохранение параметров для последующего использования (установка/отложенная глубокая ссылка/атрибуция сессии)Внутреннее перенаправление и удаление параметров запроса при перестроении нового URI

                    Контрольный список внедрения

                    Для обеспечения корректной работы идентификатора клика принимающее Android-приложение должно:
                      Прочитайте полный URI из входящего Intent
                        Обрабатывать как холодный старт ( onCreate() ), так и теплый старт/повторное использование ( onNewIntent() ).Извлеките параметры атрибуции (как минимум fbclid и любые другие, на которые вы полагаетесь).Сохраните их для последующего составления отчетов о конверсиях/атрибуции сессий
                          Сохраните данные в надежном месте (например, в SharedPreferences или базе данных) с меткой времени.Обновите страницу, если появится новое значение (эти идентификаторы могут меняться в зависимости от сессии)Не следует опускать параметры запроса при внутреннем перенаправлении
                            Если ваше приложение преобразует URI во внутренний маршрут, убедитесь, что вы передаете параметры атрибуции или сохраняете их перед построением маршрута
                            При открытии прямой ссылки, содержащей fbclid , ваше приложение должно иметь возможность регистрировать (или иным образом подтверждать), что оно получило URI, включающий fbclid , и что оно сохранило его для последующих событий.
                            Используйте тестовую ссылку, например:
                            myapp://some/path?fbclid=TEST123&campaignId=TESTCAMPAIGN
                            
                            Или адресу https://, если вы её поддерживаете.
                            Тестирование с использованием adb
                            Вы можете смоделировать работу Android, отправив Intent самостоятельно:
                            adb shell am start -W -a android.intent.action.VIEW \ -d "myapp://some/path?fbclid=TEST123&campaignId=TESTCAMPAIGN"
                            
                            Затем убедитесь, что ваше приложение получает fbclid и сохраняет его.

                            Измеряйте конверсию сайта с помощью Meta Pixel или Conversions API

                            Компании, которые отслеживают события на своем веб-сайте с помощью Meta Pixel или Conversions API для веб-сайтов, могут измерять, когда клик по URL-адресу в маркетинговом сообщении, отправленном через Marketing Messages API для WhatsApp, приводит к одному из 3 событий конверсии.
                            Если компания еще не отправляет отчеты о конверсиях вне сайта, ознакомьтесь со следующей документацией, чтобы настроить отправку отчетов о событиях:
                            После того как компания начнет отслеживать события через Pixel или Conversions API, следующие 3 стандартных события автоматически связываются с посетителями сайта, которые перешли на сайт по ссылке с призывом к действию (CTA) из маркетингового сообщения, отправленного через MM API для WhatsApp:
                              Добавить в корзинуНачать оформление заказаПокупкаСтоимость покупки
                              Когда пользователь переходит по ссылке с призывом к действию (CTA) в сообщении WhatsApp через API маркетинговых сообщений и совершает любое из трех вышеописанных событий, Meta автоматически связывает событие конверсии с кампанией WhatsApp через API маркетинговых сообщений и предоставляет вам или вашему партнеру доступ к аналитике через API аналитики, которую ваш партнер может отобразить в своих собственных отчетных отчетах, которые вы привыкли использовать.
                              Обратите внимание, что если это событие конверсии также используется для измерения эффективности рекламы в Facebook или Instagram, Meta будет приписывать конверсию последнему взаимодействию пользователя. Например, если пользователь переходит на ваш сайт через рекламу в Facebook, затем закрывает окно браузера и позже в тот же день возвращается на ваш сайт, перейдя по ссылке из сообщения MM API для WhatsApp, и совершает покупку, то это событие конверсии покупки будет отнесено к кампании MM API для WhatsApp (а не к рекламе в Facebook) как к самому последнему взаимодействию.

                              Измеряйте конверсию приложения с помощью Meta SDK или Conversions API

                              Компании могут использовать API маркетинговых сообщений для WhatsApp, чтобы отслеживать, когда маркетинговые сообщения приводят пользователей к совершению событий в приложении, таких как покупки и активация приложения. Подробнее событиях в приложении см. в разделе API конверсий для событий в приложении.
                              Для MM API в WhatsApp доступны следующие события конверсии приложения:
                                Покупка приложенияСтоимость покупки приложенияДобавить приложение в корзинуПриложение. Начать оформление заказаАктивация приложений
                                Компании могут отслеживать события конверсии в приложении тремя способами. Подробнее см. «API конверсий для событий приложений»
                                  Через Meta SDKЧерез API конверсийЧерез стороннего партнера по мобильным измерениям, который отправляет события в Meta от вашего имени

                                  Использование Meta SDK

                                    Если ваше приложение использует Meta SDK, обновите версию SDK до Meta Android SDK v17.0.2 или выше. Обратите внимание, что измерение производительности iOS-приложений в настоящее время не поддерживается.Если ваше приложение использует поддерживаемого партнера по мобильным измерениям (MMP), свяжитесь со своим MMP, чтобы подготовить приложение к работе.Если ваше приложение использует Conversions API, узнайте, как отправлять параметры campaign_ids вместе с событиями приложения . Чтобы получить campaign_ids, вам нужно будет извлечь campaign_ids из параметров al_applink_data, полученных из прямой ссылки, по которой перешёл пользователь.
                                    Пример прямой ссылки:
                                    exampleapp://applink/ad_landing_recommend?data={"goods_id":"39109246","page_type":"B"}&al_applink_data={"target_url":"https://www.exampleapp.com&fbclid=IwZXh0bgNhZW0BMAABHbKVD62Fa0uTdpAh6KZn16BmrnWgsTbZgiCEsKGLOcF9RDncEAsbJKWp0Q_aem_y0zBYthdxb0j9epvkZum7w","extras":{"fb_app_id":312563225523989},"referer_app_link" :{"url":"fb:///?app_id=312563225523989","app_name":"Facebook"},"campaign_ids": "IwAR2rBBgtFjvI_IUUes4nZ6FcQ0dtqujIz1w9JIwrs1YKKn7tGIIqC4kKrXk_wapm_fVVosPGBQJW pvSW8Z8emXg_aem_pyDxR3ch5qDkVdd0Y138yg","ad_id":"1234567","adgroup_id":"1234567 ","campaign_id":"1234567","campaign_group_id":"1234567","account_id":"1234567"}
                                    
                                      Убедитесь, что для резервного URL-адреса сайта также настроены пиксели/конверсии.

                                      Через стороннего партнера по измерению мобильных показателей

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