DocumentatieAudience ManagerAudience Manager-gebruikershandleiding

Realtime-overdracht van uitgaande data real-time-outbound-data-transfers

Last update: Wed Oct 12 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Het uitgaande proces van de gegevensoverdracht in real time levert gebruikersgegevens als reeks JSON geformatteerde berichten aan een bestemmingsplatform.

Recommendations

Om deze methode te gebruiken, moet het bestemmingsplatform aan de volgende vereisten voldoen:

  • Het moet een eindpunt verstrekken URL dat kan worden geschaald om een groot aantal berichten van de Audience Manager te ontvangen;
  • De gegevens moeten worden geaccepteerd in JSON format (Content-type: application/json);
  • Het moet veilig accepteren HTTPS gegevensoverdracht. Audience Manager zal geen berichten door onbeveiligd verzenden 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 de Rand van de Audience Manager 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 om aan te geven dat het ontvangstbewijs is gelukt. Andere codes worden als mislukkingen geïnterpreteerd. Deze reactie wordt verwacht binnen 3000 milliseconden. Als reactie op een storing Audience Manager slechts één poging opnieuw uitvoeren.

Parameters

In de volgende tabel worden de elementen in de JSON gegevensbestand dat 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 bestemmingsplatform
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 van Audience Manager.
User_count
Geheel
Totaal aantal gebruikers in de POST verzoek.
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 regio-id waar we dit apparaat hebben gezien. Als het apparaat bijvoorbeeld enige activiteit had in Parijs (Europa), zou de regio-id 6. Zie Id's, locaties en hostnamen van DCS-regio's.
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 wordt gegenereerd door Audience Manager (een geheel getal). In sommige gevallen, als het bestemmingsplatform toestaat, kunnen de klanten het segmentherkenningsteken in het gebruikersinterface van de Audience Manager (open tekstgebied) bepalen, die dan in dit bezit zou weerspiegelen.
Segment.Status
Geheel

Bepaalt de status van een gebruiker in het segment. Accepteert de volgende waarden:

  • 1: Actief (standaard)
  • 0: Inactief, opted-out of niet-gesegmenteerd.

De gebruikers zijn unsegmentated wanneer zij zijn:

  • Verwijderd uit een segment dat op de segmentregel wordt gebaseerd.
  • Verwijderd uit een segment op basis van de time-to-live-interval.
  • Verplaatst naar een inactieve toestand als deze de afgelopen 120 dagen niet is waargenomen.
  • Verwijderd vanwege een privacywijzigingsverzoek (d.w.z. GDPR)

Alle partner-id's die zijn gesynchroniseerd met een Audience Manager ID ontvangt de "Status":"0" markering wanneer een gebruiker niet-gesegmenteerd is.

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 HTTP-aanvragen ondertekenen het gebruiken van privé sleutels of door Audience Manager authenticeren via de 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