AIP

生成 AIP 站点

相信你已经通过构建 AIP 页面对于如何编写 AIP 页面有了初步的了解。

这一章节会帮助你将编写的页面创建成一个可以用于巨量引擎广告投放平台open in new window直接投放的第三方落地页站点。

以下步骤为示例，调用了部分 AIP 链路服务的接口，所有接口细节详见：投放链路服务。

提示

开发者部署在自己服务器上的 URL 可以视作常规 web 页面，用于任何渠道的广告投放。

本教程仅着重讲解如何在字节跳动的广告生态内使用 AIP 标准，使广告主享受完整的 AIP 能力和收益。

1. 部署页面

首先我们需要一个 URL 地址访问到你编写的 AIP 页面，所以请先将页面部署到你的服务器上。

你可以使用任何部署方式和服务器形式，只需要确保页面可以通过一个特定域名的 URL 访问即可。

注意

需要注意的是，为了保证后续链路的通畅，请使用通过 ICP 备案的域名，并在巨量引擎广告投放平台open in new window进行相应资质认证open in new window。

示例

以构建 AIP 页面中的 Demo 为例，我们将其部署在：https://p6-orange.byteorg.com/obj/ad-tetris-site/aip/official_site/intro.htmlopen in new window。

后续步骤将会使用这个页面作为样例进行操作。

2. 获取接口授权

请先前往巨量引擎开放平台open in new window，注册成为开发者并获取相应广告主授权，详细步骤可参考此处open in new window。

如已是巨量引擎开放平台认证的开发者可忽略此步。

3. 创建站点

通过调用AIP 站点创建接口，即可将相应 URL 创建为一个投放站点。

示例

将上述示例 URL 通过如下方式发起站点创建请求。（其中Access-Token和advertiser_id仅为示例，开发者请自行填入对应信息）

curl --location --request \
POST 'https://ad.oceanengine.com/open_api/2/tools/aip_third_site/create/' \
--header 'Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "advertiser_id": 170**********349,
    "name": "AIP示例",
    "url": "https://p6-orange.byteorg.com/obj/ad-tetris-site/aip/official_site/intro.html?lynx_enable=1&adid=__AID__&creativeid=__CID__&creativetype=__CTYPE__&clickid=__CLICKID__"
}'

 
 


 

 

1
2
3
4
5
6
7
8
9

注意

需要注意的是，为了保证后续链路的通畅，发起上述请求时请给 URL 添加如下 query：

?lynx_enable=1&adid=__AID__&creativeid=__CID__&creativetype=__CTYPE__&clickid=__CLICKID__

供平台方识别此链接为一个 AIP 页面，否则无法启用 AIP 的原生渲染能力

成功请求后将得到如下响应结果，其中生成的站点 id（site_id） 为 7062590479577186334。

HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {
        "site_id": 7062590479577186334
    },
    "request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}





 



1
2
3
4
5
6
7
8
9

P.S.request_id 仅用于提供给平台方排查问题所用，常规情况不需要关心。

4. 查看站点审核状态

通过上一步生成 AIP 站点后，页面将自动进入审核流程，你可以通过AIP 站点详情获取接口的调用来查询页面站点状态，只有当审核通过后站点方可正常投放在广告链路中。审核结果将在创建或更新后约 30 分钟生成。

示例

将上一步获得的站点 id：7062590479577186334，通过如下方式发起页面详情请求（其中Access-Token和advertiser_id仅为示例，开发者请自行填入对应信息）

curl --location --request \
GET 'https://ad.oceanengine.com/open_api/2/tools/aip_third_site/get/?advertiser_id=170**********349&site_id=7062590479577186334' \
--header 'Access-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json'

 
 

1
2
3
4

成功请求后将得到如下响应结果，audit_status是"AUDIT_ACCEPTED"即为审核通过。

HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {
        "advertiser_id": 170**********349,
        "name": "AIP示例",
        "site_id": 7062590479577186334,
        "url": "https://p6-orange.byteorg.com/obj/ad-tetris-site/aip/official_site/intro.html?lynx_enable=1&adid=__AID__&creativeid=__CID__&creativetype=__CTYPE__&clickid=__CLICKID__",
        "create_time": "2021-11-03 11:37:46",
        "status": "ENABLE",
        "validate_status": "VALIDATE_SUCCESS",
        "audit_status": "AUDIT_ACCEPTED"

    },
    "request_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}







 




 




1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

P.S.

  1. request_id 仅用于提供给平台方排查问题所用，常规情况不需要关心。
  2. 你也可以在巨量引擎广告投放平台登陆对应账号后，直接访问第三方落地页资产open in new window，查看所有页面及其状态。

下一步

当你完成上面的操作后，恭喜你已经几乎完成了 AIP 标准的完整链路，接下来你可以使用相应的页面直接在巨量引擎广告投放平台open in new window投放广告。

Last Updated: 2022/7/15 下午7:22:06