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

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

Аналитика

Обновлено: 12 февраля 2026 г
Начиная с 1 декабря 2025 года максимальный период ретроспективного анализа для анализа сообщений, переписок и ценообразования изменяется с 10 лет до 1 года. Период ретроспективного анализа для анализа шаблонов и групп шаблонов останется без изменений и будет по-прежнему составлять 90 дней.
В этом документе описывается, как получить аналитику по сообщениям, беседам, шаблонам и группам, например, количество сообщений, отправленных с корпоративного номера телефона, количество бесед и их стоимость для бизнес-аккаунта WhatsApp (WABA), или количество прочтений определенного шаблона.
В ответы будут включены только показатели по номерам телефонов компаний и шаблонам, связанным с вашей системой WABA на момент запроса.

Получить данные

Параметры запроса

Заполнитель Описание Пример значения
<FIELD>
аналитика
<FILTERS>
Необходимый.
Параметр фильтрации метрик. Добавьте дополнительные параметры фильтрации, используя точки.
Возможные значения см. в:
Параметры аналитики сообщенийПараметры анализа разговоровПараметры анализа шаблоновПараметры аналитики групп шаблоновПараметры анализа звонковПараметры групповой аналитики
.start(1543543200).end(1544148000).granularity(DAY)

Анализ ценообразования

Поле pricing_analytics позволяет получить подробную информацию о ценах на любые сообщения, доставленные в указанном диапазоне дат.

Синтаксис запроса

ПОЛУЧАТЬ /<WHATSAPP_BUSINESS_ACCOUNT_ID> ?fields=pricing_analytics .start(<START> ) .конец(<END> ) .granularity(<GRANULARITY> ) .phone_numbers(<PHONE_NUMBERS> ) .country_codes(<COUNTRY_CODES> ) .metric_types(<METRIC_TYPES> ) .pricing_types(<PRICING_TYPES> ) .pricing_categories(<PRICING_CATEGORIES> ) .размеры(<DIMENSIONS> )

Параметры ценовой аналитики

Фильтр Описание Пример значения
<COUNTRY_CODES>
Массив строк
Необязательный.
Укажите страны, для которых вы хотите получить аналитические данные. Предоставьте массив с двухбуквенными кодами стран, которые вы хотите включить. Если данные не указаны, будут возвращены аналитические данные для всех стран, с которыми вы взаимодействовали.
 
[США, Бразилия]
<DIMENSIONS>
Массив строк
Необязательный.
Список параметров, которые вы хотите применить к своим метрикам. Если вы отправите пустой список, мы вернем результаты без каких-либо параметров.
Возможные значения:
СТРАНАТЕЛЕФОНКАТЕГОРИЯ_ЦЕНООБРАЗОВАНИЯТИП_ЦЕНЫУРОВЕНЬ
 
[ PRICING_CATEGORY, PRICING_TYPE, COUNTRY ]
<END>
метка времени UNIX
Необходимый.
Метка времени UNIX, указывающая конечную дату диапазона дат, за который вы получаете аналитические данные.
1728581152
<GRANULARITY>
Нить
Необходимый.
Уровень детализации, с которым вы хотите получать аналитические данные. Значение может быть одним из следующих:
ЕЖЕДНЕВНОПОЛЧАСАЕЖЕМЕСЯЧНО
ЕЖЕДНЕВНО
<METRIC_TYPES>
Массив строк
Необязательный.
Массив метрик, которые вы хотите получить. Если вы отправите пустой массив, мы вернем результаты для всех типов метрик.
Возможные значения:
СТОИМОСТЬ: Ориентировочная стоимость сообщений, доставленных в указанный период времени, в валюте вашей WABA.ОБЪЕМ: Включает количество сообщений, доставленных за указанный период времени.
Обратите внимание, что стоимость не будет возвращена для WABA, использующих кредитную линию партнера по решениям. Если ваш WABA использует кредитную линию партнера по решениям, свяжитесь с вашим партнером по решениям, чтобы уточнить размер ваших расходов.
[СТОИМОСТЬ, ОБЪЕМ]
<PHONE_NUMBERS>
Массив строк
Необязательный.
Массив телефонных номеров, для которых вы хотите получить аналитические данные. Если не указан, будут включены данные по всем корпоративным телефонным номерам, связанным с вашей базой данных WABA.
 
[
15550783881,
15550783882,
15550783883
]
<PRICING_CATEGORIES>
Массив строк
Необязательный.
Массив ценовых категорий. Если вы отправите пустой массив, мы вернем результаты для всех ценовых категорий.
Возможные значения:
АУТЕНТИФИКАЦИЯ: За сообщения взимается плата за аутентификацию.AUTHENTICATION_INTERNATIONAL: Сообщения обрабатываются по международному тарифу аутентификации.МАРКЕТИНГ: За сообщения взимается плата по маркетинговому тарифу.ОБСЛУЖИВАНИЕ: Сообщения, за которые не была произведена оплата. Включает все сообщения, не являющиеся шаблонами, и служебные сообщения, отправленные в течение периода обслуживания клиентов.КОММУНАЛЬНЫЕ УСЛУГИ: За сообщения взимается плата по тарифу коммунальных услуг.REFERRAL_CONVERSION: Сообщения, полученные через бесплатную точку входа.
 
[Аутентификация, маркетинг, полезность]
<PRICING_TYPES>
Массив строк
Необязательный.
Массив типов ценообразования. Если вы отправите пустой массив, мы вернем результаты для всех типов ценообразования.
Возможные значения:
FREE_CUSTOMER_SERVICE: Бесплатные сообщения. Это сообщения, не являющиеся шаблонами, и служебные сообщения, отправляемые в рамках работы службы поддержки клиентов.FREE_ENTRY_POINT: Все сообщения, отправленные в рамках времени работы службы поддержки клиентов Free Entry Point.ОБЫЧНЫЙ ВАРИАНТ: Платные сообщения. Включает все шаблонные сообщения для аутентификации и маркетинга, а также любые служебные шаблонные сообщения, отправленные вне установленного окна обслуживания клиентов. Исключает все сообщения, отправленные в рамках бесплатного окна обслуживания клиентов.
 
[ОБЫЧНОЕ, БЕСПЛАТНОЕ ОБСЛУЖИВАНИЕ КЛИЕНТОВ]
<START>
метка времени UNIX
Необходимый.
Временная метка UNIX, указывающая начальную дату диапазона дат, за который вы получаете аналитические данные.
1726014453
<WABA_ID>
Нить
Необходимый.
Идентификатор бизнес-аккаунта WhatsApp.
102290129340398

Информация об уровне объема

добавьте TIER, PRICING_CATEGORYи COUNTRY в измерений . Точки данных, представляющие сообщения, на которые влияют тарифные планы объемов, будут иметь tier в ответе.
Пример синтаксиса ответа с информацией об уровне
Значение tier представляет собой конкатенацию нижней и верхней границ для уровня, специфичного для пары "рынок-категория" (страна и "ценовая категория"), которую представляет данная точка данных.
<LOWER> - Целое число, представляющее нижнюю границу уровня (включительно).<UPPER> - Целое число, представляющее верхнюю границу уровня (включительно), или строка MAX.
Примечания
Чтобы определить свой текущий уровень объема продаж, ознакомьтесь tier, countryи pricing_category . tier Значение <UPPER> Целое число (число после двоеточия) указывает ваш текущий тарифный план для страны и ценовой категории (например, Индия и коммунальные услуги соответственно).Чтобы определить, сколько сообщений нужно отправить для перехода на следующий уровень для данной страны и ценовой категории, вычтите объема из значения уровня. <UPPER> целое число.Уровни объема будут доступны только для служебных сообщений и сообщений-шаблонов аутентификации. Для маркетинговых сообщений-шаблонов (где уровни объема не применяются) уровень будет установлен на 0:MAX.Свойство tier будет опущено для точек данных, представляющих бесплатные сообщения, поскольку бесплатные сообщения не учитываются при подсчете уровней.Уровни объема будут определяться исключительно Meta. Все данные аналитики являются приблизительными из-за небольших расхождений в обработке данных. Не следует чрезмерно полагаться на данные аналитики.

Аналитика шаблонов

Аналитика шаблонов показывает количество отправленных, доставленных и прочитанных шаблонов, а также количество кликов по кнопкам URL или кнопкам быстрого ответа в шаблоне. Кроме того, интегрированный API MM для WhatsApp Business позволяет отслеживать показатели конверсии вне сайта.
Данные возвращаются с точностью до дня в часовом поясе по умолчанию UTC и часовом поясе WABA, с периодом ретроспективного анализа до 90 дней. Для отображения данных в настроенном часовом поясе WABA передайте параметр use_waba_timezone со значением true.
Для отображения данных в часовом поясе, настроенном для WABA, передайте use_waba_timezone со значением true.

Ограничения

Аналитика кликов по кнопкам доступна только для шаблонов, отнесенных к категориям МАРКЕТИНГ или ПОЛЕЗНЫЕ ИНСТРУМЕНТЫ.WABA-аккаунты, принадлежащие или используемые совместно с Meta Business Accounts в Европейском Союзе, Соединенном Королевстве или Японии, или имеющие бизнес-номер с кодом страны из любой из этих стран или регионов, не поддерживаются.Показатели конверсии вне сайта доступны исключительно для компаний, подключенных к MM API для WhatsApp.Данные о прочтении и кликах по шаблонным сообщениям WhatsApp доступны только в течение 7 дней с момента отправки сообщения. По истечении этого 7-дневного периода соответствующие счетчики прочтений/кликов обнуляются, и дальнейшие обновления для этих сообщений не регистрируются.

Подтверждение аналитики шаблона

Для получения аналитики по шаблонам необходимо подтвердить ее в своем аккаунте WhatsApp Business. Подтвердить ее можно с помощью WhatsApp Manager или API.
Подтвердив доступ через API, вы даёте Meta разрешение на добавление аналитических данных в ваш бизнес-аккаунт WhatsApp. Эти данные включают отслеживание ссылок для составления отчётов о переходах на веб-сайты. Вы можете отключить отслеживание ссылок в каждом шаблоне сообщения. Вы также даёте Meta разрешение на сбор и анонимизацию данных из ваших чатов с клиентами. Meta будет анонимизировать эти данные для улучшения предоставляемых вам и другим компаниям услуг.
Для подтверждения через API отправьте следующий запрос:
После подтверждения мы начнем сбор аналитики шаблонов для бизнес-аккаунта WhatsApp. После подтверждения аналитику шаблонов отключить нельзя.
В случае успешного выполнения API отправит вам идентификатор вашего бизнес-аккаунта WhatsApp. Например:

Параметры анализа шаблонов

Имя Описание Пример значения
начинать
Строка времени или даты в формате UNIX
Необходимый.
Начальное время для диапазона дат, за который вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД. Поскольку аналитические данные шаблона предоставляются с ежедневной детализацией в часовом поясе UTC, начальная метка времени Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего 00:00 UTC.
Если use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
1543536000
конец
Строка времени или даты в формате UNIX
Необходимый.
Время окончания диапазона дат, для которого вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД. Поскольку аналитические данные шаблона предоставляются с ежедневной детализацией в часовом поясе UTC, метка времени окончания Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего 00:00 UTC.
Если use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
1543708800
детализация
Перечисление
Необходимый.
Уровень детализации, с которым вы хотите получать аналитические данные. Значение должно быть ЕЖЕДНЕВНЫМ.
ЕЖЕДНЕВНО
template_ids
Массив идентификаторов
Необходимый.
Массив идентификаторов шаблонов, для которых вы хотите получить аналитические данные.
Максимум 10.
[1924084211297547,954638012257287,969725530748535]
metric_types
Массив перечислений
Необязательный.
Типы метрик, которые вы хотите получить. Если этот параметр отсутствует или представляет собой пустой массив, будут возвращены аналитические данные для всех типов метрик.
Возможные значения:
РАСХОДЫНАЖАЛДОСТАВЛЕННЫЙЧИТАТЬОТПРАВИЛAPP_ACTIVATIONS (MM API только для WhatsApp)APP_ADD_TO_CART (MM API только для WhatsApp)APP_CHECKOUTS_INITIATED (MM API только для WhatsApp)APP_PURCHASES (MM API только для WhatsApp)APP_PURCHASES_CONVERSION_VALUE (только для API MM для WhatsApp)WEBSITE_ADD_TO_CART (MM API только для WhatsApp)WEBSITE_CHECKOUT_INITIATED (MM API только для WhatsApp)ПОКУПКИ НА САЙТЕ (MM API только для WhatsApp)WEBSITE_PURCHASES_CONVERSION_VALUE (MM API только для WhatsApp)
Обратите внимание, что стоимость не будет возвращена для WABA, использующих кредитную линию партнера по решениям. Если ваш WABA использует кредитную линию партнера по решениям, свяжитесь с вашим партнером по решениям, чтобы уточнить размер ваших расходов.
[ОТПРАВЛЕНО, ДОСТАВЛЕНО, ПРОЧИТАНО]
тип продукта
Перечисление
Необязательный.
Тип продукта метрик, которые вы хотите получить. Если этот параметр опущен, будут возвращены только аналитические данные для Cloud API.
Возможные значения:
CLOUD_API: Используйте этот тип продукта для фильтрации метрик шаблонов, отправляемых через Cloud API.MARKETING_MESSAGES_API_FOR_WHATSAPP: Используйте этот тип продукта для фильтрации метрик шаблонов, отправляемых через Marketing Messages API для WhatsApp.
API для маркетинговых сообщений WhatsApp
<USE_WABA_TIMEZONE>
Логический
Необязательный.
Следует ли отображать метрики в часовом поясе, заданном в WABA. Если значение равно false или отсутствует, метрики будут отображаться в UTC.
Если значение равно true, параметры start и end должны быть в формате ГГГГ-ММ-ДД.
истинный

Аналитика шаблонов: стоимость и показатели кликов

Показатели затрат возвращаются в виде массива объектов затрат, каждый из которых имеет тип и значение. Типы могут быть следующими:
amount_spent - Общая сумма, потраченная на диалоги, открытые в течение начального и конечного периодов времени в результате отправки шаблона. См. «Открытие диалогов».cost_per_delivered - amount_spent, деленное на количество доставок шаблона в течение начального и конечного периодов времени.cost_per_url_button_click - amount_spent, деленное на количество нажатий на кнопку URL шаблона в течение начального и конечного временных интервалов. Нажатия на кнопку быстрого ответа не учитываются. Объект опускается, если шаблон не содержит кнопки URL.
Показатели кликов возвращаются в виде массива объектов JSON, каждый из которых содержит тип и значение. Клики возвращаются только для кнопок URL и кнопок быстрого ответа в шаблонах, отнесенных к категориям МАРКЕТИНГ или ПОЛЕЗНОСТЬ.
Типы могут быть следующими:
url_button — общее количество кликов по кнопке.unique_url_button — Показатель уникальных кликов отслеживает количество различных учетных записей WhatsApp, которые нажали на кнопку. Этот показатель помогает понять, сколько отдельных пользователей взаимодействуют с вашими призывами к действию, исключая повторные клики от одного и того же получателя и обеспечивая точное измерение вовлеченности.

Отключение аналитики кликов по кнопкам

Вы можете отключить отслеживание кликов по кнопкам в отдельном шаблоне, установив для cta_url_link_tracking_opted_out поля true. После отключения API больше не будет возвращать свойство clicked в аналитике шаблона и не будет отображать активность/клики по кнопкам в WhatsApp Manager при просмотре статистики шаблона.
Параметры запроса
Заполнитель Описание Пример значения
<WHATSAPP_TEMPLATE_ID>
Идентификатор шаблона
Необходимый.
Идентификатор шаблона.
245435364965041
<OPT_OUT>
Логический
Необходимый.
Указывает, отключено ли отслеживание кликов по кнопкам шаблона. Установите значение true , чтобы отключить отслеживание кликов по кнопкам в шаблоне, или false, чтобы включить.
это значение устанавливается в false При создании шаблона
истинный
<TEMPLATE_CATEGORY>
Нить
Необходимый.
Текущая категория шаблона.
Если вы зададите категории шаблона значение, отличное от текущей категории, статус шаблона изменится на «ОЖИДАЕТСЯ» , и шаблон должен пройти проверку для утверждения.
маркетинг

Аналитика групп шаблонов

Поле template_group_analytics позволяет получить количество отправленных, доставленных и прочитанных шаблонов в группе шаблонов , а также количество нажатий на кнопки URL или кнопки быстрого ответа .
Данные возвращаются с точностью до дня в часовом поясе по умолчанию UTC и часовом поясе WABA, с периодом ретроспективного анализа до 90 дней. Для отображения данных в настроенном часовом поясе WABA передайте параметр use_waba_timezone со значением true.

Ограничения

Аналитика кликов по кнопкам доступна только для шаблонов, отнесенных к категориям «маркетинг» или «полезные». WABA-аккаунты, принадлежащие или используемые совместно с Meta Business Accounts в Европейском Союзе, Великобритании или Японии, или имеющие бизнес-номер телефона с кодом страны из этих стран или регионов, не поддерживаются.

Включение аналитики шаблонов

Для получения аналитики по группам с использованием шаблонов необходимо включить аналитику по шаблонам в вашем аккаунте WhatsApp Business. Подтвердить включение аналитики по шаблонам можно с помощью WhatsApp Manager или API.
Подтвердив доступ через API, вы даёте Meta разрешение на добавление аналитических данных в ваш бизнес-аккаунт WhatsApp. Эти данные включают отслеживание ссылок для составления отчётов о переходах на веб-сайты. Вы можете отключить отслеживание ссылок в каждом шаблоне сообщения. Вы также даёте Meta разрешение на сбор и анонимизацию данных из ваших чатов с клиентами. Meta будет анонимизировать эти данные для улучшения предоставляемых вам и другим компаниям услуг.
Для подтверждения включения через API отправьте следующий запрос:
В случае успеха API отправит вам идентификатор вашей бизнес-учетной записи WhatsApp, и мы начнем сбор аналитики по группам шаблонов для этой бизнес-учетной записи WhatsApp.
После включения аналитику шаблонов отключить ее невозможно.

Параметры аналитики групп шаблонов

Заполнитель Описание Пример значения
<WABA_ID>Нить
Необходимый.
Идентификатор бизнес-аккаунта WhatsApp.
102290129340398
<START_TIME>
Строка времени или даты в формате UNIX
Необходимый.
Время начала диапазона дат, за который вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД.
Поскольку аналитика групп шаблонов предоставляется с ежедневной детализацией в часовом поясе UTC, начальная метка времени Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего времени 00:00 UTC.
Если use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
1738465116
<END_TIME>
Строка времени или даты в формате UNIX
Необходимый.
Время окончания диапазона дат, за который вы получаете аналитические данные. Может быть представлено либо в виде целочисленной метки времени Unix, либо в виде строки даты в формате ГГГГ-ММ-ДД.
Поскольку аналитика групп шаблонов предоставляется с ежедневной детализацией в часовом поясе UTC, конечная метка времени Unix, не соответствующая 0:00 UTC, будет скорректирована до текущего времени 00:00 UTC.
Если параметр use_waba_timezone имеет значение true, это значение должно быть строкой даты в формате ГГГГ-ММ-ДД.
1739559516
<METRIC_TYPES>
Массив строк
Необязательный.
Массив метрик, которые вы хотите получить. Если вы отправите пустой массив, API вернет результаты для всех типов метрик.
Возможные значения:
расходыкликнулдоставленныйчитатьотправил
Обратите внимание, что функция COST недоступна для корпоративных клиентов, счета за услуги которых выставляются через партнера по решениям.
 
[отправлено, доставлено, прочитано]
<TEMPLATE_GROUP_IDS>
Необходимый.
Массив идентификаторов групп шаблонов, для которых вы хотите получить метрики групп шаблонов.
Максимум 10 идентификаторов.
102290129340398
<USE_WABA_TIMEZONE>`
Логический
Необязательный.
Следует ли отображать метрики в часовом поясе, заданном в WABA. Если значение равно false или отсутствует, метрики будут отображаться в UTC.
Если значение равно true, параметры start и end должны быть в формате ГГГГ-ММ-ДД.
истинный

Показатели стоимости и кликов для групп шаблонов

Показатели затрат возвращаются в виде массива объектов затрат, каждый из которых имеет тип и значение. Типы могут быть следующими:
amount_spent - Общая сумма, потраченная на диалоги, открытые в течение начального и конечного периодов времени в результате отправки шаблона. См. «Открытие диалогов».cost_per_delivered - amount_spent, деленное на количество доставок шаблона в течение начального и конечного периодов времени.cost_per_url_button_click - amount_spent, деленное на количество нажатий на кнопку URL шаблона в течение начального и конечного временных интервалов. Нажатия на кнопку быстрого ответа не учитываются. Объект опускается, если шаблон не содержит кнопки URL.
Показатели кликов возвращаются в виде массива объектов JSON, каждый из которых содержит тип и значение. Клики возвращаются только для кнопок URL и кнопок быстрого ответа в шаблонах, отнесенных к категориям «маркетинг» или «полезные материалы».
Типы могут быть следующими:
url_button — общее количество кликов по кнопке.unique_url_button — Показатель уникальных кликов отслеживает количество различных учетных записей WhatsApp, которые нажали на кнопку. Этот показатель помогает понять, сколько отдельных пользователей взаимодействуют с вашими призывами к действию, исключая повторные клики от одного и того же получателя и обеспечивая точное измерение вовлеченности.

Комментарии отсутствуют

Вернуться наверх