概述
Query API是一个HTTP API,可用于以编程方式查询预聚合的分析。它可用于获取分支仪表板中显示的相同数据,而无需访问仪表板本身。
请参考Query API以获取完整的参考文档。
费用数据
通过API提取费用数据的建议用法是“按合作伙伴和广告系列提取所有费用”。您可以尝试深入研究诸如关键字和操作系统之类的内容,但是您绝对应该计划处理空值,因为合作伙伴API提供的细分在合作伙伴之间是不一致的。如果仪表板针对某些成本细分向您返回零,则API也会返回零。
热门提示
Aggregation
必须为cost
(其他尺寸可能为“ total_count”或"unique_count"但不适用于费用)。费用总是以美元返回,汇率是在我们从API检索时存储的汇率(实际上通常是活动的日期,例如,我们将2020年12月17日运行的活动的数据提取到2020年12月17日的分支系统中汇率将为2020年12月17日的汇率)。
我们将仅返回广告合作伙伴API可用的参数,因此尺寸通常会以"null"的价格显示。例如,快照数据几乎没有设备故障(例如,操作系统)
支持的合作伙伴:FB,Google,Snap,Apple。
费用数据通常可在合作伙伴API中的6-12小时内在Branch中获得。
费用数据可能会随时间变化,因为我们会在今天和更新日期之前30天根据合作伙伴API进行准确性检查。
每个广告合作伙伴/广告系列的费用
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
}
}
大约一个月前更新