Gatilhos do Google Analytics

O Google Analytics fornece relatórios de eventos que ajudam você a entender como os usuários interagem com seu aplicativo. Com o Cloud Functions (1ª geração), você pode acessar eventos de conversão registrados em dispositivos Apple e Android e acionar funções com base nesses eventos.

Atualmente, apenas os eventos da plataforma Apple e do Android marcados como eventos de conversão são compatíveis com o Cloud Functions. Os eventos de conversão da Web não estão disponíveis no momento. Você pode especificar quais eventos são eventos de conversão na guia Eventos do painel Analytics do Firebase console.

Observação: o Cloud Functions para Firebase (2ª geração) não oferece suporte para os eventos e gatilhos descritos neste guia. Como as funções de 1ª e 2ª geração podem coexistir lado a lado no mesmo arquivo de origem, você ainda pode desenvolver e implantar essa funcionalidade junto com funções de 2ª geração.

Acione uma função do Google Analytics

O Cloud Functions oferece suporte ao AnalyticsEvent do Google Analytics. Este evento é acionado sempre que a atividade do usuário gera um evento de conversão. Por exemplo, você pode escrever uma função que seja acionada quando o evento in_app_purchase for gerado, indicando que ocorreu uma compra no aplicativo. Você deve especificar o evento do Analytics que deseja acionar sua função usando o método functions.analytics.event() e manipular o evento no manipulador de eventos onLog() :

exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
  // ...
});

Acessar atributos de evento

Com cada evento do Analytics, você tem acesso a todos os parâmetros e propriedades do usuário relevantes. Isso inclui informações sobre o usuário, o dispositivo, o aplicativo e informações geográficas do evento. Para obter a lista completa de parâmetros e propriedades do usuário, consulte a referência functions.analytics .

Para uma função acionada por compra, conforme ilustrado neste exemplo , talvez você queira acessar atributos do usuário, como o idioma do usuário e o valor do evento ( valueInUSD ). Este segundo atributo permite que a função de amostra teste se este é um evento de conversão de alto valor, a fim de enviar um cupom de valor mais alto para clientes valiosos.

/**
 * After a user has completed a purchase, send them a coupon via FCM valid on their next purchase.
 */
exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
  const user = event.user;
  const uid = user.userId; // The user ID set via the setUserId API.
  const purchaseValue = event.valueInUSD; // Amount of the purchase in USD.
  const userLanguage = user.deviceInfo.userDefaultLanguage; // The user language in language-country format.

  // For purchases above 500 USD, we send a coupon of higher value.
  if (purchaseValue > 500) {
    return sendHighValueCouponViaFCM(uid, userLanguage);
  }
  return sendCouponViaFCM(uid, userLanguage);
});
index.js

Próximos passos

Para saber mais sobre como lidar com eventos do Analytics no Cloud Functions, consulte a documentação do Google Analytics e a referência functions.analytics e tente executar o exemplo de código cupom na compra .