Ir para o console

Acionadores do Google Analytics para Firebase

O Google Analytics para Firebase fornece relatórios de eventos que ajudam você a entender como os usuários interagem com o seu app. Com o Cloud Functions, você consegue acessar os eventos de conversão registrados e acionar funções baseadas nesses eventos.

Acionar uma função do Google Analytics para Firebase

O Cloud Functions é compatível com o AnalyticsEvent do Google Analytics para Firebase. Esse evento é acionado sempre que a atividade do usuário gera um evento de conversão. Por exemplo, é possível escrever uma função que será acionada quando o evento in_app_purchase for gerado. Isso indicará que ocorreu uma compra no aplicativo. É necessário especificar qual evento do Analytics acionará sua função por meio do método functions.analytics.event(). Depois, gere 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 relevantes e propriedades do usuário. Isso inclui informações sobre o usuário, o dispositivo, o app e as informações geográficas do evento. Para ter acesso à lista completa de parâmetros e propriedades do usuário, consulte a referência functions.analytics.

Para uma função acionada por compra, como a exibida nesta amostra, acesse os atributos do usuário, como o idioma e o valor do evento (valueInUSD). Esse segundo atributo permite que a função de exemplo avalie se o evento de conversão é de alto valor para enviar cupons mais relevantes a clientes mais 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);
});

Próximas etapas

Para saber mais sobre como processar eventos do Analytics no Cloud Functions, consulte a documentação do Google Analytics para Firebase e a referência functions.analytics. Além disso, tente executar o cupom na compra (em inglês) da amostra de código.