Uitgaande gegevensoverdrachten in real time real-time-outbound-data-transfers
Het uitgaande real-time gegevensoverdrachtproces levert gebruikersgegevens als reeks JSON geformatteerde berichten aan een bestemmingsplatform.
Aanbevelingen
Om deze methode te gebruiken, moet het bestemmingsplatform aan de volgende vereisten voldoen:
- Het moet een eindpunt URL verstrekken dat kan schrapen om een hoog volume van berichten van Audience Manager te ontvangen;
- Gegevens in de JSON -indeling (
Content-type: application/json) moeten worden geaccepteerd. - Beveiligde gegevensoverdracht
HTTPSmoet worden geaccepteerd. Audience Manager verzendt geen berichten via het onveiligeHTTP-protocol.
Frequentie
Deze methode van de gegevensoverdracht kan gegevens in bijna real time verzenden aangezien de gebruikers voor segmenten kwalificeren. In real time berichten worden slechts geleverd terwijl de gebruiker online en actief zichtbaar aan het netwerk van Audience Manager Edge is. Deze methode kan optioneel ook batches offline of aan boord genomen gegevens zo vaak verzenden als elke 24 uur.
Batchoverdracht
Zowel worden de in real time als de partijoverdrachten verzonden naar het zelfde eindpunt en gebruiken het zelfde berichtformaat. Wanneer de partijoverdrachten worden toegelaten, zal het bestemmingsplatform een piek in berichtvolume zien terwijl de partijberichten worden geleverd. Veel van de segmentkwalificaties die door berichten in real time worden verzonden zullen in de partijberichten worden herhaald. De overdracht van partijen zal slechts de segmentkwalificaties (of niet-kwalificaties) omvatten die sinds de laatste partij werd geleverd zijn veranderd.
Snelheidslimieten
Er zijn geen tariefgrenzen die op de productie van geleverde berichten worden geplaatst. Door tarieflimieten in te stellen kunnen gegevens verloren gaan.
Vereiste reacties
Standaard moet de ontvangende server de 200 OK -code retourneren om een geslaagde ontvangst aan te geven. Andere codes worden als mislukkingen geïnterpreteerd. Deze reactie wordt verwacht binnen 3000 milliseconden. Als reactie op een fout zal Audience Manager slechts één poging opnieuw proberen.
Parameters
In de volgende tabel worden de elementen in het JSON -gegevensbestand gedefinieerd die u naar de bestemming verzendt.
ProcessTimeUser_DPIDEen identiteitskaart die op het type van apparaat IDs wijst die binnen het bericht, in het bezit User.DataPartner_UID wordt bevat.
- Android-id's (GAID):
20914 - iOS-id's (IDFA):
20915 - Web-/cookie-id's: varieert per doelplatform
Client_IDAAM_Destination_IDUser_countPOST -aanvraag.UsersUser.AAM_UUIDUser.DataPartner_UUIDUser.AAM_Regions6 zijn. Zie DCS Gebied IDs, Locaties, en de Namen van de Gastheer.SegmentsSegment.Segment_IDSegment.StatusHiermee definieert u de status van een gebruiker in het segment. Accepteert de volgende waarden:
1: Actief (standaard)0: Niet actief, niet-gesegmenteerd of optioneel.
Gebruikers worden losgekoppeld wanneer ze:
- Verwijderd uit een segment dat op de segmentregel wordt gebaseerd.
- Verwijderd uit een segment dat op het tijd-aan-levende interval van het segmentwordt gebaseerd.
- Verplaatst naar een inactieve toestand als deze de afgelopen 120 dagen niet is waargenomen.
- Verwijderd vanwege een verzoek tot wijziging van de privacy (bijvoorbeeld GDPR )
Alle partner IDs die aan Audience Manager identiteitskaart worden gesynchroniseerd zal de "Status":"0" vlag ontvangen wanneer een gebruiker wordt unsegmented.
Segment.DateTimeBeveiliging
U kunt uw uitgaande proces van de gegevensoverdracht in real time beveiligen door verzoeken van HTTP te ondertekenen gebruikend privé sleutels of door Audience Manager te hebben voor authentiek verklaard door het OAuth 2.0 protocol.
Verzoek
Een verzoek in real time kan gelijkaardig aan het volgende kijken:
{
"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"
}]
}]
}