ADmobile | 广告聚合SaaS

三方平台接入及开通Report API

聚合是本平台的一项核心功能，帮助开发者在具体应用的具体广告位集中管理投放的所有广告来源。利用聚合功能，开发者可以将收到的广告请求发送给多个广告来源，从而确保找到最合适的广告来源来填充广告请求，以求最大限度提高填充率和收益。

穿山甲

1. 创建穿山甲账号

登录穿山甲官网在新窗口打开申请开通账号

2. 创建穿山甲平台的应用和广告位

1）在 流量--> 应用 中创建应用

1csjapp

（2）在 流量--> 代码位 中创建代码位.

2csjpos

3. 开通穿山甲平台的Report API

当您的账号流水达到穿山甲要求时，可以向穿山甲商务申请开通Report API的权限。穿山甲会提供用于通过Report API拉取收益数据的配置信息，具体如下

配置信息说明
用户ID穿山甲主账号ID
Role ID穿山甲子账号ID (如果登录账号为主账号，子账号ID跟主账号ID一致）
Secure Key即密钥口令，每个子账号ID对应一个密钥口令

注：穿山甲Report API 2.0增加了Role ID参数，您可以按照以下说明增加Role ID的配置

  1. 在穿山甲获取Report API信息
  • 获取用户ID

3csjuserid

  • 获取Role ID和Secure Key

4csjroleid

  1. 在本平台的开发者后台开通穿山甲的Report API

登录本平台开发者后台→广告平台→平台账号管理→添加广告平台（穿山甲）→编辑（开通报表API）→填写账户 ID、Role ID和Security Key

5csjpng

注意： 如果您的账号未开通ReportAPI权限，报表API可以先选择 未开通，这不影响您后面配置广告位的操作，后续您可通过上传三方平台数据功能将穿山甲数据上传至本平台

4. 在本平台的开发者后台绑定穿山甲广告

以下穿山甲的2个参数需要配置在本平台的开发者后台, 这样才能通过本平台SDK展示穿山甲广告, 以及通过本平台的开发者后台展示穿山甲的数据：

参数名称说明
APP ID穿山甲每个应用对应的唯一的应用ID
Slot ID穿山甲每个广告单元对应的唯一的广告单元ID

在代码位管理中查看APP ID和Slot ID

6csjappid

优量汇

1. 创建优量汇账号

登录腾讯优量汇广告官网在新窗口打开申请开通账号

2. 创建优量汇平台的应用和广告位

（1）在 流量合作--> 我的媒体 中创建应用

7ylhapp

（2）在 流量合作--> 我的广告位 中创建广告位

8ylhpos

（3）创建竞价广告位（可选）

  • 如果您有腾讯广告的竞价权限，您可以在腾讯广告后台创建广告位时针对价格策略 选择 实时竞价=服务端竞价(S2S Biddding)，以完成竞价广告位创建。如果您没有竞价权限，请联系腾讯广告商务人员申请开通。

9ylhbiddingpos

3. 开通优量汇平台的Report API

  1. 在本平台的开发者后台开通优量汇的Report API

登录本平台开发者后台→广告平台→平台账号管理→添加广告平台（穿山甲）→编辑（开通报表API）→填写用户 ID、Role ID和Secret Key

10ylhapi

  1. 如何获取密钥Secret Key？

请按照腾讯广告后台指引发送邮件申请即可

11ylhgetkey

注意： 如果您的账号未开通ReportAPI权限，报表API可以先选择 未开通，这不影响您后面配置广告位的操作，后续您可通过上传三方平台数据功能将穿山甲数据上传至本平台**

4. 在本平台的开发者后台绑定优量汇广告

以下腾讯广告的2个参数需要配置在本平台的开发者后台，这样才能通过本平台SDK展示腾讯广告广告,以及通过本平台的开发者后台展示腾讯广告的数据：

参数名称说明
媒体 ID（Media ID)腾讯广告每个应用对应的唯一的应用ID
广告位 ID (Unit ID ）腾讯广告每个广告单元对应的唯一的广告单元ID

将优量汇广告的参数配置在本平台的开发者后台

  1. 登录本平台开发者后台→广告平台→平台账号管理→添加广告平台（优量汇）
  2. 填写本平台聚合的应用在优量汇对应的应用ID（媒体 ID）& 广告单元ID（媒体 ID）
  3. 针对常规广告源，关闭服务端实时竞价开关，并设置广告源的eCPM价格（可针对不同的流量分组进行独立设置）

快手

1. 创建快手账号

登录快手广告官网在新窗口打开申请开通账号。 注：快手账号的注册默认不开放，需联系快手的商务运营团队申请开通。

2. 创建快手平台的应用和广告位

（1）在 流量管理--> 应用管理-->新建应用 中创建应用

12ksapp

（2）在 流量管理-->广告位--> 新建广告位 中创建广告位

13kspos

3. 开通快手平台的Report API

  1. 快手广告会提供用于通过ReportAPI拉取收益数据的配置信息，具体如下：
参数名称说明
Access Key即发布商密钥，每个账号对应一个发布商密钥
Security Key即密钥口令，每个发布商对应一个密钥口令

请联系快手广告商务获取上述信息

  1. 在本平台开发者后台开通快手平台的Report API

登录本平台开发者后台→广告平台→平台账号管理→添加广告平台（快手）→编辑（开通报表API）→填写Access Key和Secret Key

14ksapi

4. 在本平台的开发者后台绑定快手广告

以下3个快手广告的参数需要配置在本平台的开发者后台, 这样才能通过本平台SDK展示快手广告, 以及通过本平台的开发者后台展示快手广告的数据：

参数名称说明
AppId快手广告每个应用对应的唯一应用ID
AppName快手广告每个应用对应的唯一应用名称
posId广告位ID，快手广告每个广告单元对应的唯一广告单元ID

在流量管理中查看APP ID , APP Name和posId(广告位ID)，或请联系快手广告商务或本平台商务沟通，获取上述信息。

将快手广告的参数配置在开发者后台

  1. 添加广告源，登录开发者后台→广告平台→广告源管理（快手广告）→添加广告源
  2. 填写应用对应的快手广告的应用ID（AppId）、应用名称（AppName）、广告位ID（posId）

百度

1. 创建百度账号

注册并登录百度在新窗口打开 点击“登录” 按页面内容完成注册流程。资料经审核通过后立即成为百度百青藤会员。

2. 创建百度平台的应用和广告位

（1）进入应用合作页面

15enterbaidu

（2）添加手机应用并进行所有权认证 每一款应用创建后需要按照指引进行所有权认证，否则无法使用。所有权认证通过后，状态显示“已通过”。

16baiduapp

  • 添加代码位 根据应用广告场景需要创建对应的代码位类型。 注1：激励视频和插屏视频的使用，需向百度联盟的对接人申请开通权限。 注2：目前除了Banner，其他广告样式均支持设置底价。如需要设置底价，需向百度联盟的对接人申请设置。17baidupos

3. 开通百度平台的Report API

1、权限：添加前请确保您的账号已拥有「百度API」权限

2、必填参数：

  • 账号名称：用于区分您在该广告网络下的不同账号，平台不做正确性校验
  • 报表API权限：打开后，GroMore可拉取API数据，建议打开
  • Access Key：可在百青藤后台「账号管理-API管理」获取
  • 私钥：与“公钥”一同生成 image 根据百度提供的文档，可生成DSA的公私钥对:
 ① 生成随机参数
 openssl dsaparam -out dsaparam.pem 1024
 ② 生成 DSA 私钥 privkey.pem
 openssl gendsa -out privkey.pem dsaparam.pem
 ③ 生成公钥 pubkey.pem
 openssl dsa -in privkey.pem -pubout -out pubkey.pem

注意：新版本的openssl在这里默认生成的公私钥格式为PKCS#8，但是mix平台只支持PKCS#1格式。所以需要将生成的私钥从PKCS#8格式转换成PKCS#1。

openssl dsa -in privkey.pem -out privkey.pem

如何识别是PKCS#8还是PKCS#1？ 如果以BEGIN DSA PRIVATE KEY开头则表明是PKCS#1格式，而不带DSA算法类型的BEGIN PRIVATE KEY的开头则是PKCS#8。

4. 在本平台的开发者后台绑定百度广告

以下百度联盟的2个参数需要配置在本平台的开发者后台才能通过本平台展示百度联盟广告以及通过本平台的开发者后台展示百度联盟的数据：

参数名称说明
APP ID百度联盟每个应用对应的唯一的应用ID
Ad Place ID百度联盟每个代码位对应的唯一的代码位ID
  • APP ID 1. 合作管理→应用管理→应用ID（即APP ID）

18babidupos1

  • Ad Place ID 2. 合作管理→网盟推广→代码位管理→代码位ID（即Ad Place ID)

19baidupos2

将快手广告的参数配置在本平台的开发者后台

  1. 添加广告源，登录开发者后台→广告平台→广告源管理（百度广告）→添加广告源
  2. 填写本平台应用对应的快手广告的应用ID（AppId）、广告位ID（Ad Place ID）