Transferts De Données Sortantes En Temps Réel real-time-outbound-data-transfers
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 messages au format JSON à une plateforme de destination.
Recommandations
Pour utiliser cette méthode, la plateforme de destination doit répondre aux exigences suivantes :
- Il doit fournir un URL de point d’entrée qui peut se mettre à l’échelle pour recevoir un volume élevé de messages d’Audience Manager ;
- Elle doit accepter les données au format JSON (
Content-type: application/json); - Il doit accepter des transferts de données
HTTPSsécurisés. Audience Manager n'enverra pas de messages via le protocoleHTTPnon sécurisé.
Fréquence
Cette méthode de transfert de données peut envoyer des données en temps quasi réel lorsque les utilisateurs remplissent les critères pour les segments. Les messages en temps réel ne sont diffusés que lorsque l’utilisateur est en ligne et activement visible sur le réseau Audience Manager Edge. En option, 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 d’entrée et utilisent le même format de message. Lorsque les transferts par lots sont activés, la plateforme de destination voit un pic de volume de messages pendant la diffusion des messages par lots. La plupart des 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 incluent uniquement les qualifications de segment (ou les disqualifications) qui ont changé depuis la livraison 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 débit peut entraîner une perte de données.
Réponses requises
Par défaut, le serveur de destinataires doit renvoyer le code 200 OK pour indiquer une réception réussie. D'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 n’effectuera qu’une seule tentative.
Paramètres
Le tableau suivant définit les éléments du fichier de données JSON que vous envoyez à la destination.
ProcessTimeUser_DPIDIdentifiant qui indique le type d’identifiants d’appareil contenus dans le message, dans la propriété User.DataPartner_UUID.
- Android IDs (GAID) :
20914 - iOS IDs (IDFA) :
20915 - Identifiants Web/de cookie : varie selon la plateforme de destination
Client_IDAAM_Destination_IDUser_countPOST.UsersUser.AAM_UUIDUser.DataPartner_UUIDUser.AAM_Regions6. Voir des identifiants de zone géographique, des emplacements et des noms d’hôte du serveur de collecte de données.SegmentsSegment.Segment_IDSegment.StatusDéfinit le statut d’un utilisateur dans le segment. Accepte les valeurs suivantes :
1: actif (par défaut)0: inactive, désactivée ou non segmentée.
Les utilisateurs ne sont pas segmentés lorsqu’ils sont :
- Supprimé d’un segment en fonction de la règle de segment.
- Supprimé d’un segment en fonction de l’intervalle de durée de vie du segment.
- Déplacement vers un état inactif s’ils n’ont pas été vus au cours des 120 derniers jours.
- Supprimé en raison d’une demande de modification de la confidentialité (par exemple, RGPD)
Tous les identifiants de partenaire synchronisés avec un identifiant Audience Manager recevront l’indicateur "Status":"0" lorsqu’un utilisateur n’est pas segmenté.
Segment.DateTimeSé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.
Requête
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"
}]
}]
}