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 à une plateforme de destination.
Pour utiliser cette méthode, la plate-forme de destination doit répondre aux exigences suivantes :
Content-type: application/json
);HTTPS
. Audience Manager n'enverra pas de messages via le HTTP
protocole non sécurisé.Cette méthode de transfert de données peut envoyer des données en temps quasi réel, car les utilisateurs remplissent les conditions requises pour les 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 souvent que toutes les 24 heures.
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 plate-forme de destination voit un pic dans le volume des messages pendant la remise des messages par lot. La plupart des qualifications du 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 (ou les non-qualifications) du segment qui ont changé depuis la livraison du dernier lot.
Aucune limite de débit n'est fixée pour le débit des messages diffusés. La définition de limites de taux peut entraîner une perte de données.
Par défaut, le serveur de destinataires 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 nouvelle tentative.
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 d’exécution de la requête. |
User_DPID |
Entier |
ID qui indique le type d’ID de périphérique contenus dans le message, dans la propriété User.DataPartner_UUID.
|
Client_ID |
Chaîne |
Représente le compte de cible dans la plateforme de destination. Cet identifiant provient de la plateforme de destination. |
AAM_Destination_ID |
Entier |
ID de l’objet Audience Manager "destination". Cet identifiant provient de l'Audience Manager. |
User_count |
Entier |
Nombre total d’utilisateurs dans la requête |
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 |
L'Audience Manager UUID. |
User.DataPartner_UUID |
Chaîne |
UUID de plate-forme de destination ou ID de périphérique global. |
User.AAM_Regions |
Tableau | ID de région Audience Manager où nous avons vu ce périphérique. Par exemple, si le périphérique 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, la baie contient tous les segments auxquels l'utilisateur appartient. Pour les messages par lot, la baie contient uniquement des modifications de segment depuis le dernier lot. |
Segmnent.Segment_ID |
Entier |
Identificateur du segment. Dans la plupart des cas, il s’agit de l’identifiant de segment généré par l’Audience Manager (entier). Dans certains cas, si la plate-forme de destination le permet, les clients peuvent définir l’identifiant de segment dans l’interface utilisateur de l’Audience Manager (champ de texte ouvert), qui est alors répercuté dans cette propriété. |
Segment.Status |
Entier |
Définit l’état d’un utilisateur dans le segment. Accepte les valeurs suivantes :
Les utilisateurs ne sont pas segmentés lorsqu’ils sont :
Tous les identifiants de partenaire synchronisés avec un identifiant d'Audience Manager recevront l'indicateur |
Segment.DateTime |
DateTime |
Heure à laquelle la qualification du segment utilisateur a été vérifiée le plus récemment. |
Vous pouvez sécuriser votre processus de transfert de données sortant 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.
Une requête en temps réel peut se présenter comme 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"
}]
}]
}