Com a API de Insights sobre Mensagens, você pode ler, de forma programática, as mesmas informações exibidas na aba Insights da Página da sua Página do Facebook.
Para saber mais a respeito da API de Insights sobre Mensagens e de outras análises da plataforma do Messenger, consulte Análises.
Para obter mais informações sobre a API de Insights da Página, incluindo outras métricas disponíveis e as permissões necessárias, consulte a documentação sobre Insights da Página ou a referência do objeto Insights.
Para interagir com esse ponto de extremidade, é preciso ter um token de acesso à Página com a permissão read_insights
.
curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=
{
"data": [
{
"name": "
Parâmetro | Descrição |
---|---|
| Dimensões em que a resposta é agrupada. Pode ser |
| Intervalo de datas relativo que pode ser usado no lugar de |
| Uma lista separada por vírgulas das métricas que devem ser retornadas. |
| A agregação fornecida dentro do intervalo since/until ou date_preset. O |
| Registro de data e hora do UNIX da hora de início para obter a métrica. |
| Registro de data e hora do UNIX da hora de término para obter a métrica. |
As seguintes métricas estão disponíveis na API de Insights sobre Mensagens:
Nome da metric | Descrição |
---|---|
| O número de vezes que uma conta assinou para receber mensagens de marketing da sua empresa. Se uma conta tiver assinado vários tópicos, ela será contabilizada novamente para cada um deles. Como é calculado: a métrica contabiliza o número de vezes que as contas concordaram em receber mensagens recorrentes menos o número de vezes que elas cancelaram a assinatura. Possíveis valores de
Essa métrica está em desenvolvimento. |
| O número de vezes que os usuários interagiram com mensagens na Página da sua empresa tocando em um botão de chamada para ação. Essa métrica só inclui dados de mensagens de marketing. Possíveis valores de
Essa métrica está em desenvolvimento. |
| O número de mensagens que a Página da sua empresa enviou a um cliente. Essa métrica só inclui dados de mensagens de marketing. Possíveis valores de
Essa métrica está em desenvolvimento. |
| O número de mensagens lidas dividido pelo número de mensagens enviadas pela sua Página. Algumas mensagens lidas podem não ser capturadas, como quando um cliente desativa as confirmações de leitura. Essa métrica só inclui dados de mensagens de marketing. Possíveis valores de
Essa métrica está em desenvolvimento. |
| O número de vezes que você criou um pedido em conversas por mensagem ou em apps ou sites de terceiros usados para gerenciar conversas por mensagem. Essa métrica está em desenvolvimento. |
| A quantia aproximada de dinheiro que você ganhou com pedidos criados em conversas por mensagem ou em apps ou sites de terceiros usados para gerenciar conversas por mensagem. Os ganhos finais podem ser diferentes devido às conversões de moeda. Essa métrica está em desenvolvimento. |
| O número de conexões por mensagem com pelo menos um pedido criado. Essa métrica está em desenvolvimento. |
| O número de conversas com a Página que foram bloqueadas. |
| O número de conversas por mensagem no Messenger que foram iniciadas por pessoas que nunca tinham enviado mensagens para a sua empresa antes. |
| O número de conversas da sua Página que foram denunciadas por pessoas por motivos como spam ou por exibirem conteúdo inadequado. |
| O número de pessoas para as quais a sua empresa pode enviar mensagens. Essa métrica mostra o número de pessoas que já enviaram uma mensagem para a sua empresa no Messenger. Ela não inclui as pessoas que bloquearam ou denunciaram a empresa na plataforma. Pode haver algumas restrições à sua capacidade de enviar mensagens a conexões, como a limitação de quantas mensagens podem ser enviadas durante determinados períodos. Essa métrica inclui apenas as conexões feitas a partir de outubro de 2016, quando os dados foram disponibilizados. |
Propriedade | Descrição |
---|---|
| Uma lista de objetos de métricas. |
name string | O nome da métrica. |
period string | O período durante o qual os dados foram coletados. |
values matriz de objetos | Uma lista de dados para uma métrica. |
value matriz de objetos | A contagem diária da métrica solicitada. Para métricas que detalham por tipo, um objeto com contagens para cada tipo será retornado. |
end_time registro de data e hora do Unix | Registro de data e hora UTC da hora de término da métrica. |