跟踪统计

获取指定群发任务的跟踪统计概览

URL

http://www.bestedm.net/mm-ms/apinew/track.php?do=overview

HTTP请求方式

GET

参数说明

参数	类型	必须	说明
id	string	*	统计任务任务 id, 创建任务时返回的任务 id ，也就是 send_id
ident	string	*	任务批次号. 举例: `20200615134441-2369-93`, 参数 id，ident 两者必须有一个，如果两个都存在，取 ident

API 返回的结果是 XML 格式, 示例如下:

 <track>
    <track_id>跟踪统计 id</track_id>
    <task_sn>任务批次号</task_sn>
    <send_id>任务 id</task_sn>
    <send_count>发送量</send_count>
    <real_send_count>成功发送量</real_send_count>
    <error_send_count>失败量</error_send_count>
    <open_unique>唯一打开数</open_unique>
    <open_total>总打开数</open_total>
    <open_first>首次打开时间</open_first>
    <open_last>最后打开时间</open_last>
    <click_unique>唯一点击数</click_unique>
    <click_total>总点击数</click_total>
    <click_first>首次点击时间</click_first>
    <click_last>最后点击时间</click_last>
    <open_ratio>打开率</open_ratio>
    <click_ratio>点击率</click_ratio>
    <link_statistic>
        <link>
            <link_id>链接 id</link_id>
            <link>链接</link>
            <click_unique>唯一点击数</click_unique>
            <click_total>总点击数</click_total>
            <click_first>首次点击时间</click_first>
            <click_last>最后点击时间</click_last>
        </link>
        <link>
        ...
        </link>
        ...
    </link_statistic>
</track>

获取指定任务邮件打开统计详情

URL

http://www.bestedm.net/mm-ms/apinew/track.php?do=open-detail

HTTP请求方式

GET

参数说明

参数	类型	必须	说明
id	string	*	群发任务 send_id, 也就是创建任务成功后返回的 task_id
ident	string	*	任务批次号. 举例: `20200615134441-2369-93`, 参数 id，ident 两者必须有一个，如果两个都存在，取 ident

API 返回的结果是 XML 格式, 示例如下:

<?xml version="1.0" encoding="UTF-8"?>
<data>
    <user>
        <email_id>邮箱 id</email_id>
        <email>邮箱</email>
        <browser>浏览器</browser>
        <os>操作系统</os>
        <addr_first>首次打开地址</addr_first>
        <ip_first>首次打开 ip</ip_first>
        <ip_last>最后打开 ip</ip_last>
        <addr_last>最后打开地址</addr_last>
        <open_total>总打开数</open_total>
        <click_total>总点击数</click_total>
        <open_first>首次打开时间</open_first>
        <open_last>最后打开时间</open_last>
        <click_first>首次点击时间</click_first>
        <click_last>最后点击时间</click_last>
    </user>
    ...
<data>

获取指定任务链接点击统计概览

URL

http://www.bestedm.net/mm-ms/apinew/track.php?do=link-stat

HTTP请求方式

GET

参数说明

参数	类型	必须	说明
id	string	*	群发任务 send_id;即创建任务时返回的 task_id
ident	string	*	任务批次号. 举例: `20200615134441-2369-93`，参数 id，ident 两者必须有一个，如果两个都存在，取 ident
link_id	int	否	统计链接ID

API 返回的结果是 XML 格式, 示例如下:

 <?xml version="1.0" encoding="UTF-8"?>
<data>
    <link>
        <link_id>链接 id</link_id>
        <link>链接地址</link>
        <click_unique>唯一点击数</click_unique>
        <click_total>总点击数</click_total>
        <click_first>首次点击数</click_first>
        <click_last>最后点击数</click_last>
    </link>
    ...
</data>

获取指定任务点击统计详情

URL

http://www.bestedm.net/mm-ms/apinew/track.php?do=click-detail

HTTP请求方式

GET

参数说明

参数	类型	必须	说明
id	string	*	群发任务 send_id，也就是创建任务成功后返回的 task_id
ident	string	*	任务批次号. 举例: `20200615134441-2369-93`, 参数 id，ident 两者必须有一个，如果两个都存在，取 ident
link_id	int	否	链接 id，指定任务指定链接点击统计详情

API 返回的结果是 XML 格式, 示例如下:

<?xml version="1.0" encoding="UTF-8"?>
<data>
    <click>
        <click_id>点击 id</click_id>
        <email>邮箱地址</email>
        <link>链接地址</link>
        <click_unique>唯一点击数</click_unique>
        <click_total>总点击数</click_total>
        <click_first>首次点击时间</click_first>
        <click_last>最后点击时间</click_last>
    </click>
    ...
<data>

导出指定群发任务跟踪邮箱信息

URL

http://www.bestedm.net/mm-ms/apinew/trackexport.php

HTTP请求方式

GET

参数说明

参数	类型	必须	说明
track_id	int	是	跟踪统计ID, 可以传入多个,以英文逗号隔开,举例:`38282,38283`
is_click	int	否	取值0/1, 0 为导出所有邮箱,1 为只导出有点击的邮箱
link_id	int	否	统计链接ID, 如果有传，表示只导出有点击指定链接的邮箱
email_id	int	否	邮箱 id，导出指定邮箱