CSV 报告终端 借助 CSV 报告服务 API，您可以通过 CSV 格式获得不同来源的聚合数据，包括 KPI 服务可交付数据、KPI 服务同期群、SKAdNetwork 和广告支出。
该报告终端可以在同一报告中结合多种服务数据。可请求按天、应用及广告渠道等查看安装、收入、广告支出以及 SKAdNetwork 数据。
要使用该终端，您需要 Adjust API 识别码。请按照说明设置并管理 Adjust API 验证 。
API 的用户权限与 Adjust 账户中的用户权限 一致。
https://dash.adjust.com/control-center/reports-service/csv_reportGET 方法以 CSV 格式返回来自报告服务的过滤数据。API 会返回该请求中发送的每个参数的数据列。列标题默认是参数的 slug。您可以在请求中传送 readable_names=true ，返回人类可读名称。
人类可读名称可能基于上游要求发生变化。对于运作时间长的报告，请使用 slug 确保报告前后一致。您可以使用
事件终端 来获取事件 slug。
全部展开
dimensions*字符串 用于参数分类的值，用逗号隔开。详细信息请参考下面的表格。 dimensions=app,os_name,week,campaign_id_networkmetrics*字符串 用逗号隔开的 KPI。详细信息请参考下面的表格。 metrics=cost,installs,ecpi_networkdate_period*字符串 报告起始和截止日期，支持 3 种格式。 逻辑日期 ：
this_month_until_yesterdaytodayyesterdaythis_weeklast_weekthis_monthlast_month 绝对日期 ：相对日期 ：readable_names布尔 是否返回带有人类可读名称的数据列。默认为 false readable_names=truecohort_maturity字符串
immature – 展示所有同期群累积性指标的当前值，包括未成熟同期群。mature – 只展示成熟同期群的累积性指标数据，未成熟同期群指标显示为零。
cohort_maturity=immatureutc_offset字符串 报告中使用的时区。 utc_offset=+01:00timezone_id字符串 报告所用时区的 ID。 timezone_id=1hour__between字符串 指定小时区间内的过滤结果。 hour__between=-10h:-0hattribution_type字符串 归因交互类型。 attribution_type=clickattribution_source字符串 应用内活动是分配给用户的安装来源 first，还是分配给安装来源和后续再归因来源dynamic。默认为 dynamic。 attribution_source=firstreattributed字符串 已被再归因用户的专属过滤器。当一名用户已经安装您的应用，但是又通过由 Adjust 跟踪的新来源返回到应用，就会被再归因。 reattributed=falsead_revenue_mode字符串 终端返回的广告总收入百分比。可选项包括：
GROSS_100GROSS_85GROSS_70GROSS_60
ad_revenue_mode=GROSS_70ad_revenue_sources字符串 用逗号隔开的广告收入来源列表。 ad_revenue_sources=unknownos_names字符串 用逗号隔开的操作系统名称列表。 os_names=ios,androidad_spend_mode字符串 指定计算中应用的广告支出。请阅读 广告支出来源如何影响数据 ，了解更多信息。 ad_spend_mode=networksandbox布尔 使用 sandbox 还是真实流量数据。默认为 false。 sandbox=truesort字符串 报告排序所用的指标/维度列表 (用逗号隔开)。使用 - 以降序排列。 sort=-clicks,installsindex字符串 报告索引所用的维度列表 (用逗号隔开)。 index=network,campaign,adgroupformat_dates布尔 如果设置为 false，则所有日期维度都将采用 ISO 格式。 format_dates=falseperiod_over_period字符串 报告数据比较周期 。 period_over_period=previous_weekcurrency字符串 金额相关指标换算时所用的币种。 currency=USD[dimension]__in字符串 逗号隔开的值列表，用于 任意 维度的维度值过滤 (精准匹配)。 campaign__in=abc,def[dimension]__not_in字符串 逗号隔开的值列表，用于 任意 维度的维度值过滤 (排除精准匹配)。 campaign__not_in=abc,def[dimension]__contains字符串 任意 维度的维度值子字符串搜索 (区分大小写)。 campaign__contains=ios[dimension]__exclude字符串 任意 维度的维度值子字符串排除搜索 (区分大小写)。 campaign__exclude=ios[dimension]__starts_with字符串 带有指定前缀的维度值子字符串匹配搜索 (不区分大小写)。 campaign__starts_with=ios[dimension]__not_starts_with字符串 不带指定前缀的维度值子字符串匹配搜索 (不区分大小写)。 campaign__not_starts_with=ios[dimension]__ends_with字符串 带有指定后缀的维度值子字符串匹配搜索 (不区分大小写)。 campaign__ends_with=ios[dimension]__not_ends_with字符串 不带指定后缀的维度值子字符串匹配搜索 (不区分大小写)。 campaign__not_ends_with=ios[metric]__lt字符串 适用于 任意 指标的 "小于" 指标值过滤器。 skad_installs__lt=100[metric]__lte字符串 适用于 任意 指标的 "小于或等于" 指标值过滤器。 skad_installs__lte=100[metric]__gt字符串 适用于 任意 指标的 "大于" 指标值过滤器。 skad_installs__gt=100[metric]__gte字符串 适用于 任意 指标的 "大于或等于" 指标值过滤器。 skad_installs__gte=100[metric]__eq字符串 适用于 任意 指标的 "等于" 指标值过滤器。 skad_installs__eq=100metric__ne字符串 适用于 任意 指标的 "不等于" 指标值过滤器。 skad_installs__ne=100
通过维度，用户可以用一个或多个参数将将指标细分为多个组。例如，您可以按照日期、国家/地区和渠道分别查看安装量。
hour日期 日期值。使用 format_dates=false 返回 ISO 格式值。 2021-05-11T17:00:45 day日期 日期值。使用 format_dates=false 返回 ISO 格式值。 2021-05-11 week日期 日期值。使用 format_dates=false 返回 ISO 格式值。 2021-05-09 - 2021-05-15 month日期 日期值。使用 format_dates=false 返回 ISO 格式值。 2021-05 year日期 日期值。使用 format_dates=false 返回 ISO 格式值。 2021 quarter字符串 日期值。使用 format_dates=false 返回 ISO 格式值。 YYYY 2021 Q2 os_name字符串 可能值：
androidBadablackberryiOSLinuxMac OSserversymbianunknownWebOSWindowswindows-phone
- device_type字符串 可能值：
botconsoleiPodMacPCphoneserversimulatortabletTVunknown
- app字符串 应用名称。 - app_token 字符串 Adjust 中的应用 ID。 - store_id字符串 商店应用 ID。 com.random.app store_type字符串 应用安装来源商店。 google_play currency字符串 币种名称。 Euro currency_code字符串 3 字符 ISO 4217 值。 EUR campaign字符串 跟踪链接子层级 1。 - campaign_network字符串 渠道的推广活动名称。 - campaign_id_network字符串 渠道的推广活动 ID。 - adgroup字符串 跟踪链接子层级 2. - adgroup_network字符串 渠道的广告组名称。 - adgroup_id_network字符串 渠道的广告组 ID。 - source_network字符串 来源渠道名称。基于渠道的可选值。 - source_id_network字符串 来源渠道 ID - creative字符串 跟踪链接子层级 3。 - creative_network字符串 渠道素材名称。 - creative_id_network字符串 渠道素材 ID。 - country字符串 国家/地区名称。 美利坚合众国 country_code字符串 2 字符 ISO 3166 值。 US region字符串 业务地区。 APAC partner_name字符串 Adjust 系统中的合作伙伴名称。 AppLovin partner_ids整数 Adjust 系统中的合作伙伴 ID。 34 合作伙伴字符串 合作伙伴唯一 slug。 AppLovin 渠道源字符串 partner_name和 network的组合。 - platform字符串 设备运行的系统/平台。请在下表中查看所有受支持的平台。 android
平台 androidandroid-tvbadablackberryfacebookfire-tvioslinuxmacosserversymbianweboswindowswindows-phone指标用于评估和比较您通过 Adjust 开展和跟踪的推广活动表现。
每个 API 请求须带有至少 1 个指标。最常用的指标包括：
您可以在我们的Datascape 指标术语表 中查看完整指标列表。您还可以使用filters_data endpoint 来查找完整指标列表。
终端返回以下响应：
200 Success 返回报告信息 204 No content 响应对象为空时 400 Bad request 请求格式错误或包含不受支持的参数 401 Unauthorized 您的凭证不正确或缺失 403 Forbidden 您没有访问此信息的权限 429 Too many requests 同时发送超过 50 个请求 503 Service unavailable 无法连接服务器 504 Gateway timeout 查询返回响应时间过长
CSV 报告终端以 CSV 格式返回数据。
app,partner_name,campaign,campaign_id_network,campaign_network,installs,network_cost
String,String,String,String,String,Number,Numberapp字符串 应用名称 partner_name字符串 合作伙伴名称 campaign字符串 推广活动 ID 名称 campaign_id_network字符串 推广活动 ID campaign_name字符串 推广活动名称 安装数字 安装量 network_cost数字 该行总渠道成本
curl \
--header 'Authorization: Bearer <adjust_api_token>' \
--location --request GET 'https://dash.adjust.com/control-center/reports-service/csv_report?cost_mode=network&app_token__in={app_token1},{app_token2}&date_period=2021-05-01:2021-05-02&dimensions=app,partner_name,campaign,campaign_id_network,campaign_network&metrics=installs,network_cost'
app,partner_name,campaign,campaign_id_network,campaign_network,installs,network_cost
App Name,AppLovin,Campaign Name (Campaign ID),Campaign ID,Campaign Network,64,1000