入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

财务信息

本节将为您介绍资金账户的类型以及如何通过接口查询帐号的资金账户相关信息,包括余额、历史资金流水、实时消耗等。


资金账户

资金账户用于分别存放不同途径进入您帐号的资金。

目前,Marketing API支持的资金账户如下:

V1.1对应枚举值名称 描述
FUND_TYPE_CASH 现金账户,默认开通,线上进行财付通、微信支付的款项,对应投放管理平台的现金账户
FUND_TYPE_GIFT 赠送账户,默认开通,一般为活动赠送可消耗金额,对应投放管理平台的虚拟账户
FUND_TYPE_SHARED 分成账户,默认开通,如APP平台收益转为广告费,用法同现金,区别是分成非真金白银,对应投放管理平台的现金账户
FUND_TYPE_BANK 银证账户,线下银行转账后自动开通,对应投放管理平台的现金账户
FUND_TYPE_MP_CASH 微信现金账户,仅对部分账户(绑定微信代理商的腾讯广告代理商账号)开放
FUND_TYPE_MP_BANK 微信银证账户,仅对部分账户(绑定微信代理商的腾讯广告代理商账号)开放
FUND_TYPE_MP_GIFT 微信赠送账户,仅对部分账户(绑定微信代理商的腾讯广告代理商账号)开放
FUND_TYPE_CREDIT_ROLL 竞价信用账户,仅对部分客户开放。 用于竞价广告业务的可滚动使用的信用额度,以实际扣费金额按月出账单,还款后会恢复可用余额。
FUND_TYPE_CREDIT_TEMPORARY 竞价临时信用账户,仅对部分客户开放。 用于竞价广告业务的一次性授予的信用额度,以授信时的金额出账单结算,还款后不再恢复可用余额。
FUND_TYPE_COMPENSATE_VIRTUAL 补偿虚拟金账户,当产生oCPA赔付等情况后自动开通,仅对部分客户开放
FUND_TYPE_UNSUPPORTED 不支持的账户类型

所有资金账户均可以用于广告投放费用的扣除,如果一个推广帐号中有多种资金,则各种资金的使用顺序从先至后依次为 赠送>分成>现金>银证,即只有赠送账户的资金用完后才会开始消费分成账户的资金,依次类推。现金账户、分成账户、赠送账户是当您开通广告主帐号时,系统会为您自动生成,而银证账户是当您通过线下银行汇款进行充值时生成。

余额查询

您可以通过funds/get查询推广帐号当前的资金余额情况。假如您希望查询推广帐号123当前资金余额情况,对应的请求示例如下:

curl –G 'https://api.e.qq.com/v1.1/funds/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123'

{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "list": [
            {
                "fund_type": "GENERAL_CASH",
                "balance": 120000,
                "fund_status": "FUND_STATUS_NORMAL",
                "realtime_cost": 100
            },
            {
                "fund_type": "GENERAL_SHARED",
                "balance": 1000,
                "fund_status": "FUND_STATUS_NORMAL",
                "realtime_cost": 100
            },
            {
                "fund_type": "GENERAL_GIFT",
                "balance": 0,
                "fund_status": "FUND_STATUS_NORMAL",
                "realtime_cost": 0
            },
            {
                "fund_type": "BANK",
                "balance": 0,
                "fund_status": "FUND_STATUS_NORMAL",
                "realtime_cost": 0
            }
        ]
    }
}

资金流水

我们提供资金日结和明细流水两种类型的接口供您了解自己的资金变动情况,其中:

    • 资金日结接口路径为 fund_statements_daily/get ,返回的数据会展示您每种资金账户的每天盈亏变动,每种资金账户每天一条汇总结算记录(例如一天内有多笔现金充值记录,会汇总显示为一条)
    • 明细流水接口路径为 fund_statements_detailed/get ,返回的数据为详细的交易记录,当前只支持按资金账户进行分别查询(例如一天内有多笔现金充值记录,则查询结果中会显示为多条)

假如您希望查询推广帐号123的现金账户在2018/04/24的资金日结情况,对应的请求示例如下:

curl -G 'https://api.e.qq.com/v1.1/fund_statements_daily/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123' \
-d 'fund_type=GENERAL_CASH' \
-d 'date_range={
    "start_date": "2018-04-24",
    "end_date": "2018-04-24"
}'

假如您希望查询推广帐号123的现金账户在2018/04/24~2018/04/26的资金流水情况,对应的请求示例如下:

curl -G 'https://api.e.qq.com/v1.1/fund_statements_detailed/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=123' \
-d 'fund_type=GENERAL_CASH' \
-d 'date_range={
    "start_date": "2018-04-24",
    "end_date": "2018-04-26"
}' 

余额查询以及资金流水的接口详细说明可参考 接口清单-fund 章节中的描述。

值得注意的是,以上两个接口均只支持历史的数据查询,不能查询当天的情况,如需查询当前的实时消耗,可通过接下来要介绍的实时消耗接口查询。

实时消耗

您可以从广告主帐号、推广计划以及广告组三个维度查询实时消耗,以便您随时了解投放情况并及时调整帐号、推广计划以及广告组的日预算。获取实时消耗接口路径为realtime_cost/get。假如您希望查询推广帐号123的广告组456在今天(假设今天为2017/08/25)的实时消耗,对应的请求示例如下:

curl -G 'https://api.e.qq.com/v1.1/realtime_cost/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'advertiser_id=123' \
-d 'level=ADGROUP' \
-d 'date=2017-08-25' \
-d 'filtering=[{"field":"adgroup_id","operator":"EQUALS","values":[456]}]'

实时消耗的接口详细说明可参考 接口清单-realtime_cost 章节中的描述。