Ir para o console

Ampliar o Google Analytics com o Cloud Functions

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, você consegue acessar os eventos de conversão registrados e acionar funções baseadas nesses eventos.

Acionar uma função do Google Analytics

O Cloud Functions é compatível com o AnalyticsEvent do Google Analytics. 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. Especifique qual evento do Analytics acionará sua função por meio do método functions.analytics.event(). Depois, gerencie esse 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 do namespace functions.analytics.

Para uma função acionada por compra, como a exibida nesta amostra (em inglês), 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 e a referência de functions.analytics. Além disso, tente executar o cupom na compra (em inglês) da amostra de código.