O Google Analytics fornece relatórios de eventos que ajudam você a entender como os usuários interagem com seu app. Com o Cloud Functions (1ª geração), é possível acessar eventos de conversão registrados em dispositivos Apple e Android e acionar funções com base nesses eventos.
Acionar uma função do Google Analytics
O Cloud Functions dá suporte ao
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
é acionada quando o evento in_app_purchase é gerado, indicando que ocorreu uma
compra no app.
Você precisa especificar o evento do Google Analytics que
acionará a função usando o método
functions.analytics.event()
e supervisionar o evento no
manipulador de eventos
onLog():
exports.sendCouponOnPurchase = functions.analytics.event('in_app_purchase').onLog((event) => {
// ...
});
Acessar os atributos do 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 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
neste exemplo,
acesse os atributos dos usuários, como idioma e
valor do evento (valueInUSD).
Com esse segundo atributo, a função de exemplo pode ser usada para verificar se é um evento de conversão de alto valor e, então, enviar um cupom de valor mais alto a 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);
});
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 exemplo de código
coupon-on-purchase (em inglês).