分享链接是一个可以下载报告数据 CSV 文件的链接。通过分享链接,您可以将报告数据实时分享至 Google 表格等平台,方便提供给无法访问 Airbridge 面板的合作伙伴。
注意
分享链接提供的数据范围取决于生成该分享链接的 Airbridge 用户的 App 角色。请注意避免意外分享非预期数据。
分享链接可通过启用报告分享功能来生成。报告分享功能仅适用于已保存的报告。将分享链接输入浏览器地址栏即可下载包含报告数据的 CSV 文件。通过分享链接分享的数据,其指标、分组、筛选条件、语言和日期范围的设置与生成分享链接的报告保持一致。除指标、分组、筛选条件、汇总标准和时区外,部分设置可通过在分享链接中添加参数进行更改。有关在分享链接中添加参数的详情,请参阅 本指南。
注意
为了生成分享链接,请先保存报告。如果报告未保存,将无法显示分享图标,也无法生成分享链接。
请点击 “已保存的报告” 打开已保存的报告,或创建新报告后保存该报告。
2. 请点击报告分享图标。
3. 请启用 “生成分享链接” 切换按钮,分享链接将显示在下方。
4. 分享链接可点击复制。禁用切换按钮后,之前生成的分享链接将失效。如需新的分享链接,请重新启用切换按钮并生成新的分享链接。
分享链接的部分设置可通过在分享链接中添加参数进行更改。分享链接的结构如下:
基本分享链接: report.airbridge.io/v2/(地址).csv
定制的分享链接: 基本分享链接?参数1&参数2&参数3
分享链接的指标、分组、筛选条件、语言和日期范围设置与生成分享链接的报告保持一致。通过不带额外参数的基本分享链接下载的 CSV 文件,最多可提供 1,000 行数据。
在基本分享链接添加 ?
,然后按照正确格式添加所需参数,即可更改部分分享链接设置。例如,添加 rowNo
参数,可以在 CSV 文件中查看最多 50,000 行的数据。
如需添加多个参数,请在参数之间插入 &
。可用参数及其格式请参考下方内容。
与数据日期范围相关的参数(from、since、last)的最大可设置范围为 92 天。此外,在一个分享链接中只能设置一个日期范围参数。
参数 | 说明 | 格式 | 示例 |
---|---|---|---|
from, to | 将数据的日期范围更改为特定的起止日期 | YYYY-MM-DD | from=2022-01-01&to=2022-03-01 |
since | 将数据的日期范围更改为从特定日期到今天 | YYYY-MM-DD | since-2022-01-01 |
last | 将数据的日期范围更改为最近 N 天,但不包括今天(last 0) | 0 或自然数 (1, 2, 3...) | last=3 |
offset | 将日期范围的结束日期从今天更改为 N 天前,必须与日期范围参数一起使用 | 自然数 (1, 2, 3...) | offset=3 |
rowNo | 提供数据的行数,最多可设置为 50,000 | 自然数 (1~50,000) | rowNo=5000 |
granularity | 将 last 和 offset 参数的单位更改为 day、week 或 month。如果未指定,默认单位为 day | day/week/month | granularity=day |
language | 更改分享链接的语言设置。如果未指定,默认使用 Airbridge 面板的语言 | en/ko | language=en |
isNowenabled | 与 last 参数一起使用,如果未指定,默认值为 false - true:包括今天 - false:不包括今天 | true/false | isNowEnabled=false |
useViewFormat | 设置包含特殊字符(如 +α, ±α, - 等)的值的数据显示格式。单位标识(如 d、h)不视为特殊字符。如果未指定,默认值为 true - true:值包含特殊字符并按原样显示 - false:值不包含特殊字符,例如 56+α 会显示为 56,仅含特殊字符的值显示为 0。请注意,0 不一定代表实际值为 0 | true/false | useViewFormat=true |
注意
分享链接默认包含语言设置参数(language)。即,分享链接中默认会包含至少一个参数,因此,为了定制分享链接,只需添加
&
后再添加其他参数即可。如果链接中没有
?
和参数,请先添加?
,然后再添加参数。
请参考以下示例,定制分享链接。请注意,示例题目中省略了基本分享链接部分(report.airbridge.io/v2/(地址).csv
)。若需定制,请在基本分享链接后添加 ?
并添加所需参数。
report.airbridge.io/v2/(URL).csv?language=en
在上述分享链接中,language=en
表示 CSV 文件的语言设置为英语。
如果分享链接中没有语言设置参数,CSV 文件的语言设置将与 Airbridge 面板的设置一致。
report.airbridge.io/v2/(URL).csv?last=4&offset=3&isNowEnabled=true&language=en
在上述分享链接中:
last=4
和 isNowEnabled=true
表示数据日期范围为包括今天在内的最近 4 天。
offset=3
表示数据日期范围的结束日期为今天前 3 天。
language=en
表示语言设置为英语。
report.airbridge.io/v2/(URL).csv?language=en&last=4&granularity=month
在上述分享链接中,granularity=month
和 last=4
表示数据范围为最近 4 个月。然而,最大支持的日期范围为 92 天,因此此分享链接将无法正常运行。
report.airbridge.io/v2/(URL).csv?rowNo=3000&language=ko
在上述分享链接中,rowNo=3000
表示 CSV 文件将包含 3,000 行数据,语言设置为韩文。
默认情况下,CSV 文件最多只能下载 1,000 行数据。要下载更多行,必须添加 rowNo
参数。通过使用 rowNo
参数,最多可以下载 50,000 行数据。
注意
分享链接中的以下设置无法通过添加参数进行更改:指标、分组、筛选条件、汇总标准、时区。
这些设置与生成分享链接的报告的设置保持一致。为了更改分享链接中适用的指标、分组或筛选条件,需先更改报告的设置,然后禁用报告分享功能切换按钮并重新启用,以生成新的分享链接。
报告数据可以通过 importdata
函数导出至 Google 表格。importdata
函数从分享链接的 CSV 文件中提取数据并导入至 Google 表格。使用示例如下:
=importdata("分享链接")
由于 importdata
函数 每小时 调用一次分享链接,因此 Google 表格中的报告数据也每小时更新一次,使您可以在 Google 表格上近乎实时查看报告数据。通过结合分享链接与 importdata
函数,您可以将 Airbridge 数据与其他来源的数据相结合,创建自定义报告。
Google 表格中日期显示异常
在 Google 表格文件中,“Event Date” 分组列可能会以数字形式显示日期。如果出现这种情况,请执行以下操作:
选中包含 Event Date 值的所有单元格。
点击顶部菜单栏的 [格式],然后选择 [数字]>[日期]。
使用分享链接将数据导出至 Google 表格可用于以下用途:
无论访问权限如何,将 Airbridge 数据共享至外部
在 Google 表格中实时监控 Airbridge 数据
将 Airbridge 数据与公司内部数据结合,创建自定义报告
分享链接提供的数据范围取决于生成该分享链接的 Airbridge 用户的 App 角色,而非查看者的权限。例如,由 “内部营销人员” 的生成的分享链接,可能包含 “代理商” 无法访问的数据。
分享链接方便将数据分享给外部人员,即使他们没有 Airbridge 账号,也能通过分享链接,在 Google 表格等平台上查看报告。
Was this page helpful?