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 JSON messages mis en forme 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 qui peuvent s'adapter pour recevoir un volume élevé de messages de l'Audience Manager ;
- Elle doit accepter les données de JSON format (
Content-type: application/json
); - Elle doit accepter la sécurité
HTTPS
transferts de données. Audience Manager n’enverra pas de messages par l’intermédiaire d’un opérateur non sécurisé.HTTP
protocole .
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 la variable 200 OK
pour indiquer un reçu réussi. 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 de la variable JSON fichier de données que vous envoyez à la destination.
ProcessTime
User_DPID
Identifiant qui indique le type d’ID d’appareil contenu dans le message, dans la propriété User.DataPartner_UUID .
- Identifiants Android (GAID) :
20914
- iOS ID (IDFA) :
20915
- ID de cookie/web : varie selon la plateforme de destination
Client_ID
AAM_Destination_ID
User_count
POST
requête.Users
User.AAM_UUID
User.DataPartner_UUID
User.AAM_Regions
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
Segment.Segment_ID
Segment.Status
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é d’un segment en fonction de la variable intervalle de temps de vie.
- 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 une Audience Manager L’identifiant recevra la variable "Status":"0"
Indicateur lorsqu’un utilisateur n’est pas segmenté.
Segment.DateTime
Sécurité
Vous pouvez sécuriser votre processus de transfert de données sortantes en temps réel en procédant comme suit : signature de requêtes HTTP à l’aide de clés privées ou en Audience Manager vous authentifier via le OAuth 2.0 protocole .
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"
}]
}]
}