CohortSpec

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 (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Champs
cohorts[]

object (Cohort)

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

object (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

object (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 (DateRange)
  }
}
Champs
name

string

Attribue un nom à cette cohorte. La dimension cohort est associée à ce nom dans une réponse de rapport. Si cette règle est définie, elle ne peut pas commencer par cohort_ ni RESERVED_. Si ce champ n'est pas défini, les cohortes sont nommées en fonction de leur indice base 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 est comprise entre les dates de début et de fin définies dans l'dateRange. Ce champ 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, ce dateRange est étendu par la précision et le décalage présents dans le cohortsRange. Les données d'événement pour la période étendue du rapport sont présentes dans un rapport sur les cohortes.

Dans une demande de cohorte, ce dateRange est obligatoire, et le dateRanges de RunReportRequest ou de RunPivotReportRequest ne doit pas être spécifié.

Cet élément dateRange doit généralement être aligné sur la précision de la cohorte. Si CohortsRange utilise une précision quotidienne, dateRange peut correspondre à un seul jour. Si CohortsRange utilise une précision hebdomadaire, cet élément dateRange peut être aligné sur une limite de semaine, du dimanche au samedi. Si CohortsRange utilise une précision mensuelle, cette dateRange peut être alignée sur un mois, du premier au dernier jour du mois.

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 (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Champs
granularity

enum (Granularity)

Obligatoire. Précision utilisée pour interpréter les valeurs startOffset et endOffset pour la période étendue d'un rapport sur les cohortes.
startOffset

integer

startOffset indique la date de début de la période étendue d'un rapport sur les cohortes. startOffset est généralement défini sur 0 afin que les rapports contiennent les données collectées à partir de l'acquisition de la cohorte.

Si granularity est défini sur DAILY, la valeur startDate de la période de référence étendue correspond à startDate de la cohorte plus startOffset jours.

Si granularity est défini sur WEEKLY, la valeur startDate de la période de référence étendue correspond à startDate de la cohorte plus startOffset * 7 jours.

Si granularity est défini sur MONTHLY, la valeur startDate de la période de référence étendue correspond à startDate de la cohorte plus startOffset * 30 jours.
endOffset

integer

Obligatoire. endOffset indique la date de fin de la période de référence étendue d'un rapport sur les cohortes. endOffset peut être n'importe quel entier positif, mais il est généralement défini sur une valeur comprise entre 5 et 10, afin que les rapports contiennent des données sur la cohorte pour les périodes de précision suivantes.

Si granularity est défini sur DAILY, la valeur endDate de la période de référence étendue correspond à endDate de la cohorte plus endOffset jours.

Si granularity est défini sur WEEKLY, la valeur endDate de la période de référence étendue correspond à endDate de la cohorte plus endOffset * 7 jours.

Si granularity est défini sur MONTHLY, la valeur endDate de la période de référence étendue correspond à endDate de la cohorte plus endOffset * 30 jours.

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

boolean

Si la valeur est "true", le résultat s'accumule du premier jour de contact jusqu'au jour de fin. Non disponible dans RunReportRequest.