Transferts de données sortantes en temps réel

Le processus de transfert de données en temps réel sortant fournit des données utilisateur sous la forme d’une série de JSON messages formatés vers une plateforme de destination.

Recommandations

Pour utiliser cette méthode, la plateforme de destination doit répondre aux exigences suivantes :

  • Il doit fournir un point de terminaison URL pouvant être mis à l’échelle pour recevoir un volume élevé de messages d’Audience Manager ;
  • Il doit accepter les données au format JSON (Content-type: application/json);
  • Il doit accepter les transferts de données HTTPS sécurisés. Audience Manager n’enverra pas de messages par le biais du HTTP protocole non sécurisé.

Fréquence

Cette méthode de transfert de données peut envoyer des données en temps quasi réel, car les utilisateurs remplissent les critères des segments. Les messages en temps réel ne sont diffusés que lorsque l’utilisateur est en ligne et qu’il est activement visible sur le réseau Audience Manager Edge. Cette méthode peut également envoyer des lots de données hors ligne ou intégrées aussi fréquemment que toutes les 24 heures.

Transferts par lots

Les transferts en temps réel et par lots sont envoyés au même point de terminaison et utilisent le même format de message. Lorsque les transferts par lots sont activés, la plateforme de destination voit un pic du volume de messages pendant la diffusion des messages par lots. De nombreuses qualifications de segment envoyées par le biais de messages en temps réel seront répétées dans les messages par lots. Les transferts par lots incluront uniquement les qualifications de segment (ou les qualifications) qui ont changé depuis la diffusion du dernier lot.

Limites de taux

Aucune limite de débit n’est définie sur le débit des messages diffusés. La définition de limites de taux peut entraîner une perte de données.

Réponses requises

Par défaut, le serveur destinataire doit renvoyer le code 200 OK pour indiquer la réception réussie. Les autres codes seront interprétés comme des échecs. Cette réponse est attendue dans les 3 000 millisecondes. En réponse à un échec, Audience Manager effectue une seule tentative de reprise.

Paramètres

Le tableau suivant définit les éléments du fichier de données JSON que vous envoyez à la destination.

Paramètre Type de données Description
ProcessTime

DateTime

Heure à laquelle la requête a été exécutée.

User_DPID

Entier

Identifiant qui indique le type d’ID d’appareil contenu dans le message, dans la propriété User.DataPartner_UUID .

  • Identifiants Android (GAID) : 20914
  • ID iOS (IDFA) : 20915
  • ID de cookie/web : varie selon la plateforme de destination
Client_ID

Chaîne

Représente le compte cible dans la plateforme de destination. Cet identifiant provient de la plateforme de destination.

AAM_Destination_ID

Entier

L’identifiant de l’objet "destination" de l’Audience Manager. Cet identifiant provient de l’Audience Manager.

User_count

Entier

Nombre total d’utilisateurs dans la requête POST.

Users

Tableau

Tableau d’objets utilisateur. Par défaut, chaque message contiendra entre 1 et 10 utilisateurs, afin que la taille du message reste optimale.

User.AAM_UUID

Chaîne

Audience Manager UUID.

User.DataPartner_UUID

Chaîne

UUID de la plateforme de destination ou identifiant global de l’appareil.

User.AAM_Regions Tableau Identifiant de région de l’Audience Manager où nous avons vu cet appareil. Par exemple, si l’appareil avait une certaine activité à Paris (Europe), l’identifiant de région serait 6. Voir ID de zone géographique, emplacements et noms d’hôte du serveur de collecte de données (DCS Region IDs, Locations, and Host Names).
Segments

Tableau

Tableau d’objets de segment. Pour les messages en temps réel, le tableau contient tous les segments auxquels appartient l’utilisateur. Pour les messages par lots, le tableau contient uniquement les modifications de segment depuis le dernier lot.

Segmnent.Segment_ID

Entier

Identifiant du segment. Dans la plupart des cas, il s’agit de l’identifiant de segment généré par l’Audience Manager (un entier). Dans certains cas, si la plateforme de destination le permet, les clients peuvent définir l’identifiant du segment dans l’interface utilisateur de l’Audience Manager (champ de texte ouvert), qui refléterait alors dans cette propriété.

Segment.Status

Entier

Définit l’état d’un utilisateur dans le segment. Accepte les valeurs suivantes :

  • 1: Principal (par défaut)
  • 0: Inactif, exclu ou non segmenté.

Les utilisateurs ne sont pas segmentés lorsqu’ils sont :

  • Supprimée d’un segment en fonction de la règle de segment.
  • Supprimée d’un segment en fonction de l’ intervalle de temps de vie du segment.
  • Déplacement vers un état inactif s’ils n’ont pas été vus pendant les 120 derniers jours.
  • Suppression en raison d’une demande de modification de la confidentialité (c.-à-d. RGPD)

Tous les identifiants de partenaire synchronisés avec un identifiant d’Audience Manager recevront l’indicateur "Status":"0" lorsqu’un utilisateur n’est pas segmenté.

Segment.DateTime

DateTime

Heure à laquelle la qualification du segment utilisateur a été vérifiée le plus récemment.

Sécurité

Vous pouvez sécuriser votre processus de transfert de données sortantes en temps réel en signant des requêtes HTTP à l’aide de clés privées ou en vous authentifiant Audience Manager via le protocole OAuth 2.0.

Demande

Une requête en temps réel peut ressembler à ce qui suit :

{
"ProcessTime": "Wed Jul 27 16:17:42 UTC 2016",
"User_DPID": "12345",
"Client_ID": "74323",
"AAM_Destination_Id": "423",
"User_count": "2",
"Users": [{  
   "AAM_UUID": "19393572368547369350319949416899715727",
   "DataPartner_UUID": "4250948725049857",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "14356",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         },
         {
            "Segment_ID": "12176",
            "Status": "0",  
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         }
      ]
   },
   {
   "AAM_UUID": "0578240750487542456854736923319946899715232",
   "DataPartner_UUID": "848457757347734",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "10329",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
         },
         {
            "Segment_ID": "23954",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
        }]
    }]
}

Sur cette page