Просмотр метрик | Документация для разработчиков
Показатели просмотров
Обновлено: 10 февраля 2026 г
API для маркетинговых сообщений WhatsApp (ранее известный как Marketing Messages Lite API) теперь доступен для всех пользователей.
Показатели конверсии будут доступны исключительно в пользовательском интерфейсе WhatsApp Manager и API управления WhatsApp Business, которые компании будут использовать с Cloud API, начиная с октября 2025 года.
В результате следующие показатели конверсии будут упразднены:
Компании, использующие Marketing Messages API для WhatsApp, могут просматривать метрики с четырех разных платформ:
| Отчетность по рентабельности инвестиций | WhatsApp Business Management стал доступен | Появляется реклама |
|---|---|---|
Сообщения отправлены, доставлены, прочитаны | Я | Я |
Общая сумма потраченных средств | Я | Я |
Стоимость доставки | Я | Я |
клики по ссылкам CTA URL | Я | Я |
Стоимость за клик | Я | Я |
Показатель кликабельности ссылок CTA URL | Н | Я |
Добавить в корзину (Веб + Приложение) | Я | Я * |
Оформление заказа началось (веб-сайт + приложение) | Я | Я * |
Покупка, стоимость покупки (Веб + Приложение) | Я | Я * |
Активация приложений | Я | Я * |
Быстрые ответы | Я | Я |
* Для регистрации этого события конверсии необходимо, чтобы компания сообщала о нем через Meta Pixel или Conversions API для событий приложений. См . раздел «Начало работы с Meta Pixel и Conversions API» .Просмотр метрик через пользовательский интерфейс
После отправки маркетинговых сообщений через API маркетинговых сообщений для WhatsApp, вы можете просмотреть показатели отправки, кликов и конверсий в режиме только для чтения в двух пользовательских интерфейсах:
API маркетинговых сообщений для анализа метрик WhatsApp можно просмотреть в WhatsApp Manager как на экране номера телефона, так и на экране шаблона:
Контрольные показатели и метрики рекомендаций
Контрольные показатели позволяют оценить эффективность вашего бизнеса по сравнению с аналогичными компаниями в вашей отрасли. Эти показатели основаны на данных за последние 30 дней и учитывают различные факторы, определяющие аналогичные компании. На основе контрольных показателей мы предоставляем персонализированные рекомендации, которые помогут вам улучшить производительность вашего шаблона. Если показатель прочтения или кликабельности вашего шаблона ниже контрольного уровня, мы предлагаем способы повышения вовлеченности.
Расчет контрольных показателей
Для расчета эталонных показателей мы учитываем следующие характеристики:
Затем мы рассчитываем два ключевых показателя эффективности:
Понимание вашего рейтинга и использование контрольных показателей
При просмотре показателей эффективности вы увидите рейтинг, который показывает, как ваш шаблон работает по сравнению с шаблонами той же категории. Этот рейтинг рассчитывается путем сравнения производительности вашего шаблона с показателями количества прочтений или кликов аналогичных шаблонов с высокой вовлеченностью за последние 30 дней.
Используйте контрольные показатели для сравнения производительности вашего шаблона с шаблонами аналогичных компаний за последние 30 дней. Контрольные показатели рассчитываются ежедневно с задержкой до 2 дней. Это гарантирует вам доступ к актуальным и релевантным данным для принятия обоснованных бизнес-решений.
Для доступа к эталонным показателям и рекомендациям:
Метрики ошибок
Чтобы просмотреть сводку сообщений об ошибках, возникших с вашим шаблоном за определенный период времени, перейдите в WhatsApp Manager > Шаблоны сообщений > управления шаблонами и щелкните по шаблону. Ошибки отображаются в «Сообщения об ошибках» .
Период времени можно задать с помощью выпадающего списка выбора даты в верхней части страницы. Список кодов ошибок и их описания «Коды ошибок Cloud API»
Наиболее часто встречающиеся ошибки доставки сообщений отображаются на «Сводка» :
Эта информация также отображается в виде линий тренда на «Тренд» :
Просмотр метрик через API
После регистрации в API маркетинговых сообщений для WhatsApp аналитика по шаблонам маркетинговых сообщений компании, отправляемых через API, становится доступна из двух API:
Контрольные показатели
Вы можете получить эталонные показатели по количеству прочтений и кликов через API Insights, запросив следующие поля:
маркетинговые_сообщения_рейтинг_чтениямаркетинговые_сообщения_показатель_кликов_с_уровняСинтаксис
curl
'https://graph.facebook.com/
< API_VERSION > / < AD_GROUP_ID > /insights?fields= < METRICS > ' \ -H 'Авторизация: Bearer
< ACCESS_TOKEN > '
Пример запроса
Этот пример запроса возвращает количество прочитанных сообщений, скорость их прочтения и эталонную скорость прочтения для сравнения, а также количество кликов по ссылкам-кнопкам, скорость их кликов и эталонную скорость кликов для сравнения, с периодом поиска по умолчанию в 30 дней:
curl
'https://graph.facebook.com/v17.0/1202293061789002 26/insights?fields=marketing_messages_read, marketing_messages_read_rate,marketing_messages_read_rate _benchmark,marketing_messages_link_btn_click, marketing_messages_link_btn_click_rate,marketing_messages_click_rate_benchmark ' \ -H
'Авторизация: Bearer EAACE...'
Пример ответа
{
"data"
: [ {
"date_start"
: "2025-05-11" , "date_stop"
: "2025-06-09" , "marketing_messages_read"
: "265" , "marketing_messages_read_rate"
: "481.818182" , "marketing_messages_read_rate_benchmark"
: "70.27" , "marketing_messages_link_btn_click"
: "59" , "marketing_messages_link_btn_click_rate"
: "107.272727" , "marketing_messages_click_rate_benchmark"
: "18.74" }
],
"paging"
: { "cursors"
: { "after"
: "MAZDZD" , "before"
: "MAZDZD" }
}
}
Измерение ROI с помощью конечной точки «Insights API» маркетингового API (рекомендуется более подробная аналитика)
Компании могут использовать Meta Pixel и Conversions API для событий приложений , когда клиенты совершают действие на их веб-сайте или в приложении после перехода по ссылке в маркетинговом сообщении. Обратите внимание, что оптимизация конверсий и отчетность внутри цепочки сообщений пока недоступны для Marketing Messages API для WhatsApp.
API Insights — это интерфейс для получения статистики по рекламе, позволяющий компании просматривать все показатели Template Analytics, а также дополнительные показатели о том, когда маркетинговые сообщения, отправленные через Marketing Messages API для WhatsApp, привели к событию, зафиксированному на их веб-сайте через Meta Pixel или Conversions API, например, добавлению товара в корзину или оформлению заказа. Необходимо, чтобы компания, владеющая пикселем, совпадала с компанией, владеющей WABA.
Шаг 1: Получите идентификаторы объявлений для шаблонов, используя конечную точку Templates
После регистрации компании в API маркетинговых сообщений для WhatsApp для каждого WABA под его BMID будет создан рекламный аккаунт только для чтения, и все шаблоны маркетинговых сообщений в рамках WABA будут связаны с рекламным объектом в этом рекламном аккаунте. Каждый шаблон маркетингового сообщения в рамках WABA также будет связан с группой объявлений. Эти идентификаторы необходимы при вызове API аналитики для получения метрик маркетинговых кампаний, отправленных через API маркетинговых сообщений для WhatsApp.
После регистрации компании в API маркетинговых сообщений для WhatsApp, конечная точка Template API управления бизнесом вернет дополнительный параметр, отражающий идентификаторы ее объявлений.
ad_idad_account_idad_campaign_idad_adset_idВ этих полях указан идентификатор объявления (Ad id) связанного объекта объявления для каждого шаблона маркетингового сообщения.
Для получения идентификаторов объявлений (Ad ID) для каждого объекта объявления, связанного с шаблонами маркетинговых сообщений, обратитесь к конечной точке Template, чтобы позже вызвать API Insights.
| Конечная точка | Аутентификация |
|---|---|
/WHATSAPP_BUSINESS_ACCOUNT_ID/message_templates | Разработчики могут аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в панели управления приложения > WhatsApp > Настройка API . Партнеры по корпоративному мессенджеру должны пройти аутентификацию с помощью токена доступа, имеющего whatapp_business_messaging . |
Синтаксис запроса
ПОЛУЧАТЬ
//message_templates ?fields=category,ad_id,ad_adset_id,ad_campaign_id
,ad_account_id
См. документацию: Шаблоны сообщений GET
Если вам нужно получить данные только по одному шаблону за раз, вы можете получить поля идентификатора объявления на уровне шаблона.
| Конечная точка | Аутентификация |
|---|---|
/<TEMPLATE_ID> / | Разработчики могут аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в панели управления приложения > WhatsApp > Настройка API . Партнеры по бизнес-мессенджерам должны пройти аутентификацию с помощью токена доступа, имеющего whatsapp_business_management . |
Синтаксис запроса
ПОЛУЧАТЬ
/?fields=category,ad_id,ad_adset_id,ad_campaign_id
,ad_account_id
См. документацию: GET Templates
Шаг 2: Вызовите API аналитики, используя идентификаторы объявлений
Прямые интеграторы или партнеры по обмену сообщениями получают доступ к этим объектам кампаний только для чтения через существующие конечные точки API Insights:
| Конечная точка | Аутентификация |
|---|---|
/AD_CAMPAIGN_ID/insights | Партнеры должны пройти аутентификацию с помощью токена доступа, имеющего ads_read . |
Получите указанные метрики на уровне объекта объявления (то есть на уровне аккаунта объявления, кампании, группы объявлений или идентификатора объявления) по его идентификатору:
Пример запроса
curl --verbose -s -G -d "access_token=${ACCESS_TOKEN}" https://graph.facebook.com/v19. 0 / ${AD _ ACCOUNT _ ID|CAMPAIGN _ ID|AD _ SET _ ID|AD _ ID} /insights?fields=marketing_messages_sent% 2 Cmarketing_messages_read "
Пример ответа
{
"data"
: [ {
"marketing_messages_sent"
: "2" , "marketing_messages_read"
: "1" , "date_start"
: "2023-09-24" , "date_stop"
: "2023-10-23" }
],
"paging"
: { "cursors"
: { "before"
: "MAZDZD" , "after"
: "MAZDZD" }
}
}
Это всего лишь пример. Полный список доступных параметров API см. в документации: Документация по API Insights.
Ниже перечислены все доступные поля для получения аналитических данных:
Измерение рентабельности инвестиций с помощью конечной точки «Аналитика шаблонов» API управления бизнесом WhatsApp (базовая аналитика)
Template Analytics позволяет просматривать такие показатели, как: отправлено, доставлено, прочитано, кликнуто и стоимость.
Для получения метрик сообщений, отправленных через Marketing Messages API для WhatsApp, добавьте новый параметр «product_type» со значением, указанным ниже. Если он опущен, будут возвращены только аналитические данные для Cloud API.
| Конечная точка | Аутентификация |
|---|---|
/WHATSAPP_BUSINESS_ACCOUNT_ID/conversation_analyticsИспользуйте параметр запроса conversation_categories = MARKETING_MESSAGES , чтобы включить данные из API маркетинговых сообщений для WhatsApp.Если этот параметр опущен, API вернет результаты для всех категорий диалогов. | Разработчики могут аутентифицировать свои вызовы API с помощью токена доступа, сгенерированного в панели управления приложения > WhatsApp > Настройка API . Партнеры по бизнес-мессенджерам должны пройти аутентификацию с помощью токена доступа, имеющего whatsapp_business_management . |
Синтаксис запроса
GET /WHATSAPP_BUSINESS_ACCOUNT_ID/?fields=conversation_analytics.start ( ).конец( ty(DAILY).conversation_categories(MARKETING_LITE). dimensions([ "CONVERSATION_CATEGORY" ])).granulari
См. документацию: GET Conversation Analytics