如何通过脚本实现Adjust (MMP)与Google Sheets的自动化数据同步？

核心思路 #

完全可以通过脚本实现：用Adjust的开放API拉取数据，再借助Google Apps Script（GAS）将数据写入指定Google Sheets，全程无需第三方连接器。

具体操作步骤 #

1. 获取Adjust API授权信息 #

• 登录Adjust后台，在开发者设置/API板块生成API Token
• 确定要同步的数据对应的API端点：比如统计核心指标用/kpis/v1，事件明细用/events/v1
• 整理请求必备参数：应用ID、日期范围、需要同步的指标（如installs、clicks等）

2. 编写Google Apps Script代码 #

打开目标Google Sheets，点击「扩展程序 > Apps Script」，替换默认代码为以下示例：

function syncAdjustDataToSheets() {
  // 配置Adjust API信息
  const ADJUST_API_TOKEN = '你的Adjust API Token';
  const ADJUST_APP_ID = '你的应用ID';
  const API_ENDPOINT = 'https://api.adjust.com/kpis/v1';
  const DATE_FROM = '2024-01-01';
  const DATE_TO = new Date().toISOString().split('T')[0]; // 自动取当天日期

  // 构建请求头
  const requestOptions = {
    method: 'get',
    headers: {
      'Authorization': `Bearer ${ADJUST_API_TOKEN}`,
      'Content-Type': 'application/json'
    },
    muteHttpExceptions: true
  };

  // 发送API请求
  const requestUrl = `${API_ENDPOINT}?app_token=${ADJUST_APP_ID}&date_from=${DATE_FROM}&date_to=${DATE_TO}&kpis=installs,clicks`;
  const response = UrlFetchApp.fetch(requestUrl, requestOptions);
  const rawData = JSON.parse(response.getContentText());

  // 写入Google Sheets
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Adjust数据');
  if (!targetSheet) {
    targetSheet = SpreadsheetApp.getActiveSpreadsheet().insertSheet('Adjust数据');
  }

  // 清空旧数据（保留表头）
  targetSheet.getRange(2, 1, targetSheet.getLastRow()-1, targetSheet.getLastColumn()).clearContent();

  // 写入表头
  const headers = ['统计日期', '安装量', '点击量'];
  targetSheet.getRange(1, 1, 1, headers.length).setValues([headers]);

  // 写入数据行
  const dataRows = rawData.data.map(item => [item.date, item.installs, item.clicks]);
  targetSheet.getRange(2, 1, dataRows.length, dataRows[0].length).setValues(dataRows);
}

3. 测试脚本 #

• 点击脚本编辑器的运行按钮，首次运行需完成权限授权验证
• 检查目标Sheet是否成功写入Adjust数据

4. 设置自动同步 #

• 在脚本编辑器中点击「编辑 > 当前项目的触发器」
• 添加新触发器：选择syncAdjustDataToSheets函数，触发方式选「时间驱动」，设置同步频率（比如每天凌晨1点）

注意事项 #

• Adjust API有请求频次限制，避免短时间内重复调用
• 请根据实际需求调整API端点、请求参数和数据提取逻辑
• 如果返回的JSON结构复杂，需对应修改map函数中的字段提取规则

内容的提问来源于stack exchange，提问作者Pedro Cunha