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 HTTPS moet worden geaccepteerd. Audience Manager verzendt geen berichten via het onveilige HTTP -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.

Parameter
Datatype
Beschrijving
ProcessTime
DateTime
Tijdstip waarop het verzoek is uitgevoerd.
User_DPID
Geheel

Een 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_ID
String
Vertegenwoordigt de doelrekening in het bestemmingsplatform. Deze id is afkomstig van het doelplatform.
AAM_Destination_ID
Geheel
De id van het Audience Manager-object 'destination'. Deze id is afkomstig uit Audience Manager.
User_count
Geheel
Het totale aantal gebruikers in de POST -aanvraag.
Users
Array
Een array van gebruikersobjecten. Door gebrek, zal elk bericht tussen 1 en 10 gebruikers bevatten, om de berichtgrootte optimaal te houden.
User.AAM_UUID
String
De Audience Manager UUID.
User.DataPartner_UUID
String
UUID van doelplatform of de algemene apparaat-id.
User.AAM_Regions
Array
De Audience Manager gebied identiteitskaart waar wij dit apparaat hebben gezien. Als het apparaat bijvoorbeeld enige activiteit had in Parijs (Europa), zou de regio-id 6 zijn. Zie DCS Gebied IDs, Locaties, en de Namen van de Gastheer.
Segments
Array
Een array van segmentobjecten. Voor berichten in real time, bevat de serie alle segmenten de gebruiker tot behoort. Voor batchberichten bevat de array alleen segmentwijzigingen sinds de laatste batch.
Segment.Segment_ID
Geheel
De id voor het segment. In de meeste gevallen is dit de segment-id die door Audience Manager wordt gegenereerd (een geheel getal). In sommige gevallen, als het bestemmingsplatform toestaat, kunnen de klanten het segment herkenningsteken in het Audience Manager gebruikersinterface (open tekstgebied) bepalen, die dan in dit bezit zou weerspiegelen.
Segment.Status
Geheel

Hiermee 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.DateTime
DateTime
De tijd toen de user-segment kwalificatie onlangs werd geverifieerd.

Beveiliging

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"
        }]
    }]
}
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695