CohortSpec

Spécification des cohortes pour un rapport sur les cohortes.

Les rapports sur les cohortes créent une série temporelle de la rétention des utilisateurs pour la cohorte. Par exemple, vous pouvez sélectionner la cohorte d'utilisateurs acquise au cours de la première semaine de septembre et la suivre pendant les six semaines suivantes. La sélection des utilisateurs acquis dans la cohorte de la première semaine de septembre est spécifiée dans l'objet cohort. Le suivi de cette cohorte pendant les six prochaines semaines est spécifié dans l'objet cohortsRange.

Pour obtenir des exemples, consultez Exemples de rapports sur les cohortes.

La réponse du rapport peut afficher une série temporelle hebdomadaire indiquant, par exemple, que votre application a conservé 60% de cette cohorte au bout de trois semaines et 25% au bout de six semaines. Ces deux pourcentages peuvent être calculés à l'aide de la métrique cohortActiveUsers/cohortTotalUsers et apparaîtront sur des lignes distinctes dans le rapport.

Représentation JSON 
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Champs
cohorts[]

object (Cohort)

Définit les critères de sélection pour regrouper les utilisateurs en cohortes.

La plupart des rapports sur les cohortes ne définissent qu'une seule cohorte. Si vous spécifiez plusieurs cohortes, vous pouvez les reconnaître dans le rapport par leur nom.
cohortsRange

object (CohortsRange)

Les rapports sur les cohortes suivent les cohortes sur une plage de dates de reporting étendue. Cette plage spécifie une durée de décalage à suivre pour les cohortes.
cohortReportSettings

object (CohortReportSettings)

Paramètres facultatifs pour un rapport sur les cohortes.

Cohorte

Définit des critères de sélection de cohorte. Une cohorte est un groupe d'utilisateurs qui partagent une caractéristique commune. Par exemple, les utilisateurs ayant la même firstSessionDate appartiennent à la même cohorte.

Représentation JSON 
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Champs
name

string

Attribue un nom à cette cohorte. La valeur de la dimension cohort est définie sur ce nom dans une réponse de rapport. Si défini, ne peut pas commencer par cohort_ ou RESERVED_. Si cet attribut n'est pas défini, les cohortes sont nommées en fonction de leur index à partir de zéro (cohort_0, cohort_1, etc.).
dimension

string

Dimension utilisée par la cohorte. Obligatoire et compatible uniquement avec firstSessionDate.
dateRange

object (DateRange)

La cohorte sélectionne les utilisateurs dont la date de premier contact se situe entre la date de début et la date de fin définies dans dateRange. Cette dateRange ne spécifie pas la plage de dates complète des données d'événement présentes dans un rapport sur les cohortes. Dans un rapport sur les cohortes, cette dateRange est étendue par la granularité et le décalage présents dans la cohortsRange. Les données d'événement pour la plage de dates de reporting étendue sont présentes dans un rapport sur les cohortes.

Dans une requête de cohorte, cet élément dateRange est obligatoire et l'élément dateRanges dans RunReportRequest ou RunPivotReportRequest ne doit pas être spécifié.

En règle générale, cette dateRange doit être alignée sur la granularité de la cohorte. Si CohortsRange utilise une précision quotidienne, dateRange peut correspondre à une seule journée. Si CohortsRange utilise une granularité hebdomadaire, ce dateRange peut être aligné sur une limite de semaine, commençant le dimanche et se terminant le samedi. Si CohortsRange utilise une granularité mensuelle, ce dateRange peut être aligné sur un mois, du premier au dernier jour.

CohortsRange

Configure la plage de dates étendue pour un rapport sur les cohortes. Spécifie une durée de décalage à suivre pour les cohortes.

Représentation JSON 
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Champs
granularity

enum (Granularity)

Obligatoire. Précision utilisée pour interpréter les startOffset et endOffset pour la plage de dates de reporting étendue d'un rapport sur les cohortes.
startOffset

integer

startOffset spécifie la date de début de la plage de dates de rapport étendue pour un rapport sur les cohortes. startOffset est généralement défini sur 0 afin que les rapports contiennent les données à partir de l'acquisition de la cohorte.

Si granularity est DAILY, la startDate de la plage de dates de reporting étendue correspond à la startDate de la cohorte plus startOffset jours.

Si granularity est WEEKLY, la startDate de la plage de dates de reporting étendue correspond à la startDate de la cohorte plus startOffset * 7 jours.

Si granularity est MONTHLY, la startDate de la plage de dates de reporting étendue correspond à la startDate de la cohorte plus startOffset * 30 jours.
endOffset

integer

Obligatoire. endOffset spécifie la date de fin de la période de référence étendue pour un rapport sur les cohortes. endOffset peut être n'importe quel entier positif, mais il est généralement défini sur 5 à 10 afin que les rapports contiennent des données sur la cohorte pour les prochaines périodes de granularité.

Si granularity est DAILY, la endDate de la plage de dates de reporting étendue correspond à la endDate de la cohorte plus endOffset jours.

Si granularity est WEEKLY, la endDate de la plage de dates de reporting étendue correspond à la endDate de la cohorte plus endOffset * 7 jours.

Si granularity est MONTHLY, la endDate de la plage de dates de reporting étendue correspond à la endDate de la cohorte plus endOffset * 30 jours.

Précision

Précision utilisée pour interpréter les startOffset et endOffset pour la plage de dates de reporting étendue d'un rapport sur les cohortes.

Enums
GRANULARITY_UNSPECIFIED Ne doit jamais être spécifié.
DAILY Granularité quotidienne. Couramment utilisé si la dateRange de la cohorte correspond à un seul jour et que la requête contient cohortNthDay.
WEEKLY Précision hebdomadaire. Couramment utilisé si la durée de la dateRange de la cohorte est d'une semaine (du dimanche au samedi) et que la requête contient cohortNthWeek.
MONTHLY Précision mensuelle. Utilisé couramment si la durée de la dateRange de la cohorte est d'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

boolean

Si la valeur est "true", le résultat est cumulé du jour de la première interaction au jour de fin. Non compatible avec le ou les niveaux de sortie suivants : RunReportRequest.