成本数据Query API

概述

Query API是HTTP API,可用于以编程方式查询预先聚合的分析。它可用于获取Branch仪表板中显示的相同数据,而无需访问仪表板本身。

有关完整的参考文档,请参考 Query API

费用数据

仅限测试版访问

费用数据现已可用!该功能位于BETA中,请向支持提交问题或反馈。

建议通过API拉取费用数据的用法是" ,以合作伙伴和广告系列"拉取所有费用。您可以尝试深入研究诸如关键字和操作系统之类的内容,但是您绝对应该计划处理空值,因为合作伙伴API提供的细分在合作伙伴之间是不一致的。如果仪表板针对某些成本细分向您返回零,那么API也将返回零。

热门提示

  • Aggregation 必须为cost (其他尺寸可能为" total_count "或"unique_count" 但不适用于费用)。

  • 费用始终以美元返回,汇率是在我们从API检索时存储的汇率(实际上始终是广告活动的日期,例如,我们将2020年12月17日运行的广告活动的数据提取到2020年12月17日的分支系统中汇率将为2020年12月17日的汇率)。

  • 新API附带的今天不支持的点击&展示(2020年,时间待定)

  • 我们只会返回广告合作伙伴API可用的参数,因此,尺寸通常会显示为"null" 以表示成本。例如,快照数据几乎没有设备故障(例如,操作系统)

  • 支持的合作伙伴:FB,Google,Snap,Apple。

  • 费用数据通常可在合作伙伴API中的6到12小时内在Branch中获得。

  • 费用数据可能会随着时间的变化而变化,因为我们对合作伙伴API进行准确性检查的时间最多为今天' s日期和刷新费用之前的30天。

每个广告合作伙伴/广告系列的费用

curl -X POST 'http://api.branch.io/v1/query/analytics' -H 'content-type: application/json' -d '{
  "start_date": "2019-12-06",
  "end_date": "2019-12-11",
  "branch_key": "<branch_live_key>",
  "branch_secret": "<secret_key>,
  "data_source": "cost",
  "dimensions": [
    "last_attributed_touch_data_tilde_advertising_partner_name",
    "last_attributed_touch_data_tilde_campaign"
  ],                      
  "ordered": "descending",
  "aggregation": "cost"
}'

结果示例:

{
  "results" : [ {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "fb_zeit",
      "cost" : 23636.767182316362,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Facebook"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "google_zeit",
      "cost" : 12475.522455796843,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Google AdWords"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName8",
      "cost" : 202.59,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName1",
      "cost" : 158.07999999999998,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName2",
      "cost" : 158.14,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName0",
      "cost" : 100.65,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName7",
      "cost" : 98.57,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName5",
      "cost" : 98.21000000000001,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName6",
      "cost" : 96.42,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName3",
      "cost" : 55.13,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  }, {
    "timestamp" : "2019-12-01T00:00:00.000-08:00",
    "result" : {
      "last_attributed_touch_data_tilde_campaign" : "CampaignName4",
      "cost" : 53.57,
      "last_attributed_touch_data_tilde_advertising_partner_name" : "Apple Search Ads"
    }
  } ],
  "paging" : {
    "total_count" : 11
  }
}

3个月前更新

成本数据Query API


建议的编辑仅限于API参考页

您只能建议对Markdown正文内容进行修改,而不能建议对API规范进行修改。