Expo React Native接入Segment+Amplitude会话异常与自动页面追踪问题

1. 修复Amplitude session显示为-1的问题 #

问题根因 #

你当前使用的expo-analytics-segment包在设备模式集成Amplitude时，会直接调用原生Amplitude SDK上报数据，SDK会自行管控session生命周期，你手动传入的自定义session参数会被直接忽略，因此会显示为-1。

修复步骤 #

• 登录Segment后台，进入Amplitude目的地配置页，将集成模式切换为云端模式，该模式下Segment会透传你上报的所有自定义参数到Amplitude。
• 统一所有埋点的session参数写法，统一使用下划线格式的session_id，不要混用小驼峰sessionId，同时去掉identify调用中多余的event字段，修正后的代码示例如下：

Segment.initialize({
  androidWriteKey: 'androidKey',
  iosWriteKey: 'iOsKey',
});

const sessionId = Date.now();
// 上报用户属性
Segment.identifyWithTraits(
  user.sub,
  { email: 'notgood@gmail.com' },
  {
    integrations: {
      Amplitude: {
        session_id: sessionId,
      },
    },
  }
);

// 上报自定义事件
Segment.trackWithProperties(
  'App Started',
  { email: 'fancyemail@gmail.com' },
  {
    integrations: {
      Amplitude: {
        session_id: sessionId
      }
    }
  }
);

• 如果你必须使用设备模式集成，expo-analytics-segment没有暴露自定义Amplitude session的接口，建议直接使用Amplitude官方的Expo SDK完成埋点。

2. 开启自动页面追踪 #

expo-analytics-segment本身没有内置自动页面采集能力，需要自行结合导航库实现，以常用的React Navigation为例：

• 在导航容器上添加路由变更监听，每次页面切换时调用Segment.screen方法上报页面事件，示例代码如下：

import { useNavigationContainerRef } from '@react-navigation/native';

function App() {
  const navigationRef = useNavigationContainerRef();
  let previousRouteName;

  useEffect(() => {
    const unsubscribe = navigationRef.addListener('state', () => {
      const currentRoute = navigationRef.getCurrentRoute();
      const currentRouteName = currentRoute?.name;
      if (currentRouteName && currentRouteName !== previousRouteName) {
        // 上报页面浏览事件
        Segment.screen(currentRouteName, {
          // 可传入自定义页面属性，比如页面路径、来源等
        });
        previousRouteName = currentRouteName;
      }
    });
    return unsubscribe;
  }, [navigationRef]);

  // 其余App逻辑
}

• 上报页面事件后，进入Segment后台的Amplitude目的地配置页，开启「同步Screen事件为Amplitude页面浏览事件」的开关，即可在Amplitude中查看自动采集的页面数据。

内容的提问来源于stack exchange，提问作者Aneesh Gopalakrishnan