Как подключить Cognito к Pinpoint для аналитики?

Из своего исследования я выяснил, что, поскольку вы используете веб-приложение без использования платформы AWS Amplify, вам необходимо добавить в приложение дополнительные строки кода, чтобы отправлять данные аналитики аутентификации Cognito в ваш проект Amazon Pinpoint.

1. Если вы используете Javascript SDK, вы можете добавить фрагмент кода свойства initate-Auth в ваше внешнее приложение:

    var cognitoidentityserviceprovider = new AWS.CognitoIdentityServiceProvider();
   
    var params = {
      AuthFlow: "USER_PASSWORD_AUTH",
      ClientId: 'STRING_VALUE', /* the client ID attached to the Pinpoint project */
      AuthParameters: {
        'USERNAME': 'STRING_VALUE',
        'PASSWORD': 'STRING_VALUE'
      },
      AnalyticsMetadata: {
        AnalyticsEndpointId: 'STRING_VALUE' /* the Pinpoint project ID */
      },
    };
    cognitoidentityserviceprovider.initiateAuth(params, function(err, data) {
      if (err) console.info(err, err.stack); // an error occurred
      else     console.info(data);           // successful response
    });
   

• В приведенном выше фрагменте кода идентификатор проекта/приложения Pinpoint добавляется как часть параметра «Метаданные аналитики», когда клиент выполняет вызовы API (например, вход, регистрация и т. д.) в пул пользователей Cognito. Таким образом, к вызовам API будет прикреплен идентификатор проекта Pinpoint, и Cognito сможет использовать эту информацию для отправки данных в ваш проект Pinpoint. Без этого важного шага аналитические данные не будут отправляться в Pinpoint, что приведет к описанному вами поведению.

2. Если вы используете интерфейс командной строки (для проверки/тестирования), вы можете выполнить следующую команду AWS CLI инициировать-аутентификацию ниже:

   $ aws cognito-idp initiate-auth --auth-flow USER_PASSWORD_AUTH --auth-parameters USERNAME=STRING_VALUE,PASSWORD=STRING_VALUE --client-id STRING_VALUE --analytics-metadata AnalyticsEndpointId=STRING_VALUE
   

Суть в том, что:

Интеграция Amazon Cognito с Amazon Pinpoint работает только для приложений (клиентов), которые используют Cognito SDK для мобильных приложений (AMS Mobile SDK или JavaScript — библиотека JavaScript AWS Amplify).

Просто примечание к ответу syumaK: да, вам нужно обновить вызов initAuth вашего кода, чтобы включить свойство AnalyticsMetadat. Однако я обнаружил, что AnalyticsEndpointId НЕ ДОЛЖЕН быть идентификатором проекта Pinpoint.

Я полагаю, что, поскольку вы уже настроили Cognito для интеграции с проектом Pinpoint, он знает, в какой проект Pinpoint вы уже отправляете метрики. AnalyticsEndpointId должен быть уникальным идентификатором для входа.

Документация определенно ненадежная здесь. cli от syumaK, похоже, описывает это иначе, чем Cognito API Reference

Что случилось со мной, так это то, что я использовал идентификатор проекта pinpoint, и когда я вхожу в систему с несколькими пользователями, он думает, что это один и тот же. Ежедневное количество активных пользователей остается на уровне единицы. Служба поддержки AWS пояснила, что это должен быть уникальный идентификатор для каждого пользователя. Итак, после изменения идентификатора на адрес электронной почты пользователя я начинаю получать точные цифры для ежедневных активных пользователей.

Также кажется, что это примерно так же полезно, как и для того, чтобы не использовать Cognito SDK для мобильных приложений или Amplify. Вы можете получить только такую ​​информацию, как ежедневные/ежемесячные активные пользователи, показатели аутентификации. У вас нет возможности дальнейшей разбивки по сегментам и т. д.