Spécification des cohortes pour un rapport sur les cohortes.
Les rapports sur les cohortes créent une série temporelle de fidélisation des utilisateurs pour la cohorte. Par exemple, vous pouvez sélectionner la cohorte d'utilisateurs acquis au cours de la première semaine de septembre et la suivre pendant les six semaines suivantes. La sélection des utilisateurs acquis au cours de la première semaine de la cohorte de septembre est spécifiée dans l'objet cohort
. Ensuite, la cohorte pour les six prochaines semaines est spécifiée dans l'objet cohortsRange
.
Vous trouverez des exemples dans l'article Exemples de rapports sur les cohortes.
La réponse du rapport peut afficher une série temporelle hebdomadaire dans laquelle votre application a conservé 60% de cette cohorte après trois semaines et 25% de cette cohorte après six semaines. Ces deux pourcentages peuvent être calculés par la métrique cohortActiveUsers/cohortTotalUsers
et figureront sur des lignes distinctes dans le rapport.
Représentation JSON |
---|
{ "cohorts": [ { object ( |
Champs | |
---|---|
cohorts[] |
Définit les critères de sélection pour regrouper les utilisateurs dans des cohortes. La plupart des rapports sur les cohortes ne définissent qu'une seule cohorte. Si vous spécifiez plusieurs cohortes, vous pourrez les reconnaître dans le rapport grâce à leur nom. |
cohortsRange |
Les rapports sur les cohortes suivent les cohortes sur une période étendue. Cette plage spécifie une durée de décalage à suivre pour suivre les cohortes. |
cohortReportSettings |
Paramètres facultatifs pour un rapport sur les cohortes. |
Cohort
Définit les critères de sélection des cohortes. Une cohorte est un groupe d'utilisateurs qui partagent une caractéristique commune. Par exemple, les utilisateurs ayant le même firstSessionDate
appartiennent à la même cohorte.
Représentation JSON |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
Champs | |
---|---|
name |
Attribue un nom à cette cohorte. La dimension |
dimension |
Dimension utilisée par la cohorte. Obligatoire et compatible uniquement avec |
dateRange |
La cohorte sélectionne les utilisateurs dont la date de premier contact est comprise entre les dates de début et de fin définies dans l' Dans une demande de cohorte, ce Cet élément |
CohortsRange
Permet de configurer la plage de dates étendue pour un rapport sur les cohortes. Spécifie la durée de décalage à suivre pour suivre les cohortes.
Représentation JSON |
---|
{
"granularity": enum ( |
Champs | |
---|---|
granularity |
Obligatoire. Précision utilisée pour interpréter les valeurs |
startOffset |
Si Si Si |
endOffset |
Obligatoire. Si Si Si |
Précision
Précision utilisée pour interpréter les valeurs startOffset
et endOffset
pour la période étendue d'un rapport sur les cohortes.
Enums | |
---|---|
GRANULARITY_UNSPECIFIED |
Ne doit jamais être spécifié. |
DAILY |
Précision quotidienne Généralement utilisé si l'dateRange de la cohorte correspond à une seule journée et que la requête contient cohortNthDay . |
WEEKLY |
Précision hebdomadaire Généralement utilisé si l'dateRange de la cohorte est d'une semaine (du dimanche au samedi) et que la requête contient cohortNthWeek . |
MONTHLY |
Précision mensuelle Généralement utilisé si l'dateRange de la cohorte dure un mois et que la requête contient cohortNthMonth . |
CohortReportSettings
Paramètres facultatifs d'un rapport sur les cohortes.
Représentation JSON |
---|
{ "accumulate": boolean } |
Champs | |
---|---|
accumulate |
Si la valeur est "true", le résultat s'accumule du premier jour de contact jusqu'au jour de fin. Non disponible dans |