如何在JavaScript/Node.js环境下编写Google Conversion API相关代码？

开发者阿泽

2026-10-2

Google Conversion API Node.js 实现方案

存在和facebook-nodejs-business-sdk对应的官方开发方案，Google官方提供了适配Node.js环境的Google Ads API SDK，可直接用于Conversion API的开发。

核心使用步骤

首先安装官方维护的SDK依赖：
npm install google-ads-api
该SDK已经封装了所有转化上报相关的接口逻辑，不需要你手动处理签名、请求拼接等底层操作，和Facebook业务SDK的使用逻辑高度相似，仅需要提前准备好Google Ads账号的认证信息、对应的转化动作ID即可完成开发。

基础上报示例代码

const { GoogleAdsApi } = require('google-ads-api')

// 初始化SDK客户端
const client = new GoogleAdsApi({
  client_id: '你的Google Cloud客户端ID',
  client_secret: '你的Google Cloud客户端密钥',
  developer_token: '你的Google Ads开发者令牌',
})

// 绑定对应Google Ads客户账号
const customer = client.Customer({
  customer_id: '你的Google Ads客户ID',
  refresh_token: '你的OAuth刷新令牌',
})

// 转化上报方法
async function uploadConversionEvent() {
  await customer.conversionUploads.uploadClickConversions({
    customer_id: '你的Google Ads客户ID',
    conversions: [{
      // 对应你在Google Ads后台创建的转化动作资源路径
      conversion_action: 'customers/你的客户ID/conversionActions/你的转化动作ID',
      // 上报用户点击标识，也可替换为邮箱、手机号等哈希后的用户匹配参数
      gclid: '用户点击广告时获取的GCLID参数',
      conversion_date_time: '2024-05-20 14:30:00+08:00',
      conversion_value: 99.9,
      currency_code: 'CNY',
    }],
    partial_failure: true,
  })
}