Настройка измерения конверсий | Документация для разработчиков
Настройка измерения конверсии
Обновлено: 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, в другом.
Рекомендации по синхронизации шаблонов с объявлениями

Понимание автоматической постановки целей
Для измерения конверсий API маркетинговых сообщений для WhatsApp автоматически синхронизирует маркетинговые шаблоны с соответствующими объектами объявлений (кампаниями, наборами сообщений и объявлениями) с настройками, позволяющими формировать отчеты о конверсиях по предполагаемой цели.
Этот процесс связывания происходит автоматически, чтобы упростить интеграцию API маркетинговых сообщений для WhatsApp для бизнеса. Тем, кто знаком с экосистемой рекламы Meta, следует отметить, что эти параметры кампании и группы объявлений не изменят способ доставки сообщений через API маркетинговых сообщений для WhatsApp — они устанавливаются только для того, чтобы зарегистрированные события могли быть корректно отнесены к определенным категориям.
В таблице ниже показано, как шаблоны маркетинговых материалов сопоставляются с сущностями рекламных объявлений.
| Параметры кампании | Параметры набора сообщений | |
|---|---|---|
Шаблоны маркетинговых материалов без кнопки призыва к действию (CTA) | Цель: РЕЗУЛЬТАТ_ПРОДАЖ | Цель оптимизации: Количество показов |
Шаблоны маркетинговых материалов с кнопкой призыва к действию (CTA), которая ведет на веб-сайт или в приложение без включенной функции отслеживания событий. | Цель: ССЫЛКИ | OptimizationGoal: LinkClicks |
Маркетинговые шаблоны с кнопкой призыва к действию (CTA), которая ведет на веб-сайт или в приложение с включенной функцией отслеживания событий. | Цель: ССЫЛКИ | Цель оптимизации: Конверсия вне сайта |
Хотя большинство изменений в шаблонах автоматически синхронизируются с объявлениями (например, текстовое содержимое), параметры кампании и набора сообщений синхронизируются только один раз, когда компания впервые подключается к 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 доступен для вашего сайта или приложения.Рекомендации
Если вы используете короткие ссылки или перенаправления:
fbclid ).Перед отправкой данных в рабочую среду проверьте отчеты о конверсиях в Ads Manager и Insights API.Избегайте добавления параметров после fbclid таким образом, чтобы это могло нарушить структуру URL-адреса.В случае возникновения проблем, сотрудничайте со своим партнером, чтобы обеспечить сохранение параметров запроса, или обратитесь в Meta с подробной информацией.
Глубокие ссылки в Android для измерения конверсии
В Android для маршрутизации прямых ссылок используются фильтры намерений, заданные приложениями. URL-адрес прямой ссылки состоит из трех частей:
https , myapp ) — помогает определить, какое приложение может открыть ссылку.Путь (например, /product/123 ) — маршрут внутри приложения.Параметры запроса (например, ?fbclid=... ) — включают данные об атрибуции, такие как fbclid , campaignId , al_applink_data и другие.Когда пользователь переходит по прямой ссылке, Android:
onCreate() и/или onNewIntent() ), где приложение должно прочитать полный URL-адрес (включая параметры запроса).Android передает URL-адрес, но ваше приложение должно явно собирать и сохранять параметры атрибуции. В противном случае они могут быть фактически «потеряны» после первого экрана.
Параметры атрибуции, такие как
fbclid, могут быть удалены, неправильно кэшированы или переданы не так, как ожидалось, по одной или нескольким причинам:методе onCreate() считывается только URL-адрес, а методе onNewIntent() Несохранение параметров для последующего использования (установка/отложенная глубокая ссылка/атрибуция сессии)Внутреннее перенаправление и удаление параметров запроса при перестроении нового URIКонтрольный список внедрения
Для обеспечения корректной работы идентификатора клика принимающее Android-приложение должно:
onCreate() ), так и теплый старт/повторное использование ( onNewIntent() ).Извлеките параметры атрибуции (как минимум fbclid и любые другие, на которые вы полагаетесь).Сохраните их для последующего составления отчетов о конверсиях/атрибуции сессий
в SharedPreferences или базе данных) с меткой времени.Обновите страницу, если появится новое значение (эти идентификаторы могут меняться в зависимости от сессии)Не следует опускать параметры запроса при внутреннем перенаправлении
Проверка сохранения параметров глубоких ссылок на Android
При открытии прямой ссылки, содержащей
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 событий конверсии.
Если компания еще не отправляет отчеты о конверсиях вне сайта, ознакомьтесь со следующей документацией, чтобы настроить отправку отчетов о событиях:
Учебное пособие : Начало работы с Meta Pixel и API конверсий
После того как компания начнет отслеживать события через 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
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"}
Через стороннего партнера по измерению мобильных показателей
Некоторые платформы для измерения эффективности мобильных приложений автоматически пересылают события конверсии приложений в Meta от вашего имени. С вашей стороны не требуется никаких усилий по интеграции. См. партнерскую презентацию .
Комментарии отсутствуют
Комментарии отсутствуют