Envoyer les propriétés utilisateur

Les propriétés utilisateur décrivent des segments de votre base d'utilisateurs, comme les préférences linguistiques ou un emplacement géographique. Analytics enregistre automatiquement certaines propriétés utilisateur. Si vous souhaitez collecter d'autres propriétés, vous pouvez configurer jusqu'à 25 établissements par projet. Consultez l'article Propriétés utilisateur personnalisées pour découvrir comment définir et pour enregistrer des propriétés utilisateur.

Les propriétés utilisateur améliorent la segmentation des utilisateurs, mais elles ne concernent souvent sont disponibles côté serveur. Le protocole de mesure vous permet des mesures côté client avec des données côté serveur, ce qui est généralement impossible en n'utilisant que des solutions côté client.

Noms réservés

Certains noms de propriétés utilisateur sont réservés et ne peuvent pas être utilisés dans les mesures:

• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id
• first_open_after_install

De plus, les noms de propriétés utilisateur ne peuvent pas commencer par :

• google_
• ga_
• firebase_

Exemple d'utilisation

Dans l'exemple suivant, votre CRM comporte une propriété utilisateur (customer_tier) que vous vous souhaitez ajouter à vos mesures. customer_tier peut être défini sur l'une des valeurs suivantes : premium ou standard. Pour inclure cette propriété utilisateur dans vos rapports, les éléments suivants:

Demandez au client d'envoyer un événement add_payment_info avec un appel à un API de serveur ayant accès à votre système CRM:

code client

Votre serveur étend ensuite la mesure avec la propriété utilisateur customer_tier. à l'aide du protocole de mesure:

code du serveur

Cette propriété utilisateur enregistre les deux segments premium et standard.

Consultez la section Envoi d'événements pour en savoir plus sur l'envoi d'événements à l'aide de la propriété Protocole de mesure.

Remplacer l'horodatage

Le protocole de mesure utilise le premier horodatage qu'il trouve dans pour chaque propriété utilisateur de la requête:

1. Le timestamp_micros de l'entrée dans user_properties.
2. timestamp_micros de la requête.
3. Heure à laquelle le protocole de mesure reçoit la requête.

L'exemple suivant envoie un code temporel au niveau de la requête qui s'applique à toutes les les propriétés utilisateur dans la requête. Par conséquent, le protocole de mesure attribue les propriétés utilisateur customer_tier et customer_group sont associées à un code temporel requestUnixEpochTimeInMicros

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "user_properties": {
      "customer_tier": {
        "value": customerTierValue
      },
      "customer_group": {
        "value": customerGroupValue
      }
  }
}

L'exemple suivant envoie à la fois un code temporel au niveau de la requête et un code temporel pour la propriété utilisateur customer_tier. Par conséquent, le protocole de mesure attribue pour customer_tier, un code temporel de customerTierUnixEpochTimeInMicros, et customer_group est un code temporel de requestUnixEpochTimeInMicros.

"timestamp_micros": requestUnixEpochTimeInMicros,
"user_properties": {
    "customer_tier": {
      "value": customerTierValue,
      "timestamp_micros": customerTierUnixEpochTimeInMicros
    },
    "customer_group": {
      "value": customerGroupValue
    }
}