简介
DFP(Doubleclick for Publishers)是一款广告管理平台,可以帮助广告发布者方便地创建和发布广告。easy-dfp 是一款基于 Node.js 的 DFP API 封装库,它可以帮助开发者更加便捷地在 Node.js 应用中使用 DFP API。在本文中,我们将介绍 easy-dfp 的使用方法,带你快速掌握它。
安装 easy-dfp
在使用 easy-dfp 前,我们需要先安装它。在命令行输入以下命令:
npm install easy-dfp
如此便可在项目中使用 easy-dfp。
初始化 easy-dfp
在使用 easy-dfp 前,需要先对其进行初始化,以设置 DFP API 访问凭证。在初始化 easy-dfp 时,需要提供以下参数:
networkCode
: DFP 网络代码。applicationName
: 应用名,在 DFP 后台设置的应用名。version
: DFP API 版本号。keyFilePath
: JSON 格式的私钥文件路径。
其中 keyFilePath
参数是在 DFP 管理界面中获取到的。初始化 easy-dfp 的代码如下:
const DFP = require('easy-dfp'); const config = { networkCode: 'your-network-code', applicationName: 'you-application-name', version: 'v202011', keyFilePath: 'path-to-your-private-key-json-file' } const dfp = new DFP(config);
easy-dfp 的使用
easy-dfp 可以帮助我们实现以下操作:
- 创建订单、广告计划、广告单元等。
- 给广告单元添加广告位,创建广告创意等。
- 获取广告单元、广告创意等信息。
下面我们对其中的几个操作进行说明。
创建订单
const order = { name: 'Your order name', advertiserId: 'Your advertiser id', startDate: '2022-08-01T00:00:00', endDate: '2022-12-31T00:00:00' }; const orderId = await dfp.createOrder(order);
创建广告计划
-- -------------------- ---- ------- ----- -------- - - ----- ----- ---- ---- ------ -------- ------ ---- -------------- ---------------------- ------------ ---------------------- ------------ - ------ ---------- --------- -------------- --------- ------- -- --------- ------ ------------ - ------------- ------ ------------ --------- -- --------------- ----- -- ----- ---------- - ----- -----------------------------
给广告单元添加广告位
-- -------------------- ---- ------- ----- ------------------- - - ----- - ------ ------ ------- ----- - -- ----- --------- - - ------------------- - ---------------- - ---------- --- ---- ---- - - -- ----- -------- - --- ---- ---- ----- ---------- - --------- ---- ----- ----------------------------------- ----------- -------------------- -----------
获取广告单元信息
const adUnitId = 'Ad unit id'; const adUnit = await dfp.getAdUnitById(adUnitId);
以上代码仅为 easy-dfp 的部分操作实现,若想了解更多的操作,请查看 easy-dfp 的官方文档。
总结
easy-dfp 可以让我们更加便捷地在 Node.js 应用中使用 DFP API。通过本文的介绍,相信大家已经掌握了 easy-dfp 的使用方法。在使用 easy-dfp 时,需要注意保护好私钥文件,避免泄露。同时,需要注意遵守 DFP 的规定,正常使用 DFP API。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055b7a81e8991b448d8fdc