# 3分钟了解天幕字节跳动版

## 1、简介

![天幕由四个主要模块组成（字节跳动版暂无卖量助手功能）](https://cdn.61week.com/tianmu/doc/index/image/README-1.jpg)

天幕是服务于全平台小游戏开发者/运营者的一站式运营方案，字节跳动版天幕由以下三**个主要功能**组成：

1. 买量助手：买量投放，渠道数据监控与管理，帮助投放效益ROI最大化
2. 游戏数据：从用户入手分析产品，从产品到渠道，多维度全方面数据分析
3. 游戏配置：在线管理游戏分享转发素材、在线配置参数与ABtest等内容

使用天幕的第一步需要创建一个与小游戏对应平台类型的主体，而后在主体中添加项目下载SDK并接入。

{% hint style="info" %}
三个模块功能**相互独立**，在下载SDK后可根据需求按需接入功能；当接入全部模块时，可实现数据互通，实现真正**一站式运营**。

运营人员可参看各功能使用说明：买量助手、游戏数据、游戏收支

开发人员可参看各功能接入指南：[技术接入指南](https://tt.skysriver.com/dev-guide)
{% endhint %}

## 2、主体

天幕的主体是项目应用、团队人员的一个集合，对于每一种平台类型均需要新建一个对应平台的主体，即微信小游戏需要使用微信平台类型的主体，字节跳动版需要使用字节跳动平台类型的主体，对于一个主体而言：

1. 游戏隶属于主体
2. 每个主体下有上述的三个主功能模块及其他次要模块

一个天幕账号可以创建多个主体，创建主体的用户默认为超级管理员，拥有该主体的全部权限

{% hint style="info" %}

1. 建议一个公司/团队下的一种平台类型的游戏项目放在一个主体内进行管理。
2. 小游戏必须添加在对应平台类型的主体中，否则无法添加至主体中
   {% endhint %}

## 3、加入天幕的方式

目前支持以下方式加入天幕：

1. 直接注册天幕账号；
2. 已有账号用户邀请加入；

### **3.1、直接注册**

天幕已开放注册，用户可在[天幕的官网](https://www.skysriver.com/)，点击右上角的注册按钮，使用手机号注册。

新注册的账户，系统会自动创建一个该账户的主体。

### **3.2、邀请加入**

已有账号用户登录天幕系统，创建主体后，可通过成员管理模块，点击添加成员，在弹出的页面填写成员手机号进行邀请。

请注意：

* 若成员已注册了天幕账号，重新登录后即可看见被邀请加入的主体；
* 若成员未注册天幕账号，则会收到一条带登录密码的手机短信，使用用户手机号+短信密码即可登录天幕系统；

{% hint style="info" %}
超级管理员创建主体后，邀请相关开发运营人员进入即可
{% endhint %}

## 4、账号角色

### 4.1、三种角色

一个天幕主体下的账号，按照角色分为三种：

1. 超级管理员；
2. 管理员；
3. 普通成员；

创建主体的账号默认为超级管理员（角色可转移），每个天幕主体拥有**1个超级管理员**，可设置**多个管理员**，**多个普通成员**。

### 4.2、角色权限

不同角色拥有不同权限。

#### **超级管理员**

1. 设置管理员；
2. 可将管理员、普通成员移出主体；
3. 设置管理员、普通成员三个模块中的权限；
4. 三个模块的全部权限；
5. 为主体添加、移除小游戏；

#### **管理员**

1. 将普通成员移出主体；
2. 设置管理员、普通成员三个模块的权限；
3. 三个模块的全部权限；
4. 为主体添加小游戏、移除小游戏；

#### **普通成员**

1. 三个模块的被设置的权限；
2. 为主体添加小游戏；

权限功能说明详见：天幕

## 5、添加第一款游戏

![点击游戏管理，添加游戏](https://cdn.61week.com/tianmu/doc/index/image/README-2.jpg)

## 6、SDK接入

### 6.1、兼容性

1. 天幕SDK支持现有主流的小游戏开发引擎：Cocos、Laya、Egret
2. 因字节跳动本身机制限定，在登录获取openid时，存在兼容性风险，需做处理
3. 与阿拉丁SDK兼容

### 6.2、留意事项

请留意：

1. **天幕三个主要功能模块共用一个SDK；**
2. **每个游戏一个单独的SDK，不可复用**。

接入时，请参照[技术接入指南](https://tt.skysriver.com/dev-guide)：

{% hint style="info" %}

1. 注意SDK文件引入必须在game.js第一行
2. 注意版本控制与分享转发功能部分功能接口调用前需要[SDK初始化](https://tt.skysriver.com/dev-guide/basic/initialization)
   {% endhint %}

您在接入功能以及使用过程有何问题，可以到[常见问题](https://tt.skysriver.com/faq)中查找。

### 6.3、接入工作量预估

以下为四个“主模块”及“游戏收支”功能正常使用**所需的SDK接入工作**：

（×代表当前接入状态此模块无法使用，需更多接入工作）

|                                              | 未引入SDK | ①直接引入SDK                      | 更多                                              |
| -------------------------------------------- | ------ | ----------------------------- | ----------------------------------------------- |
| [买量助手](https://tt.skysriver.com/channel)     | ×      | ✔全部功能                         |                                                 |
| [游戏数据](https://tt.skysriver.com/game-data)   | ×      | <p>✔95%功能，重点功能</p><p>均可使用</p> | <p>✔②性能分析、内购分析按需接入、<br>自定义事件、A/Btest、转发素材分析</p> |
| [游戏配置](https://tt.skysriver.com/game-config) | ×      | ×                             | ✔③所有功能均需单独接入                                    |
| [游戏收支](https://tt.skysriver.com/revenue)     | ✔全部功能  | ✔全部功能                         | 游戏收支中的数据需要人工上传                                  |

以下为上表中**不同功能SDK接入工作的工作量**预估，供参考：

| 接入工作                                                                                                              | 预估工作量（**单人**）           |
| ----------------------------------------------------------------------------------------------------------------- | ----------------------- |
| ①[直接引入SDK](https://tt.skysriver.com/dev-guide/basic/add-sdk)、[登录](https://tt.skysriver.com/dev-guide/basic/login) | 10min（如有兼容性问题，会额外增加工作量） |
| ②[游戏数据类功能](https://tt.skysriver.com/dev-guide/data)                                                               | 每项0.5h                  |
| ③[游戏配置 - 全部功能](https://tt.skysriver.com/dev-guide/config)                                                         | 分享素材配置2h，其余每项0.5h       |

## 7、数据安全

天幕始终将用户的数据安全视为最重要的事情，全力保障接入天幕系统的用户数据安全。

相关链接：[天幕服务条款](https://tt.skysriver.com/terms)

## 8、贴心服务

我们强烈建议您添加如下微信号，

在您了解、接入、使用天幕过程中，我们会提供全程的服务和支持

![微信扫一扫，添加对接人员微信](https://cdn.61week.com/tianmu/doc/index/image/README-3.jpg)

{% hint style="info" %}
建议进一步建立微信对接群，添加天幕技术、产品人员

获取从接入、使用、运营的全方位支持，第一时间获得天幕最新动态
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tt.skysriver.com/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
