DokumentationAudience ManagerAnvändarhandbok för Audience Manager

Utgående dataöverföringar i realtid real-time-outbound-data-transfers

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

Den utgående dataöverföringsprocessen i realtid levererar användardata som en serie JSON formaterade meddelanden till en målplattform.

Recommendations

Om du vill använda den här metoden måste målplattformen uppfylla följande krav:

  • Den måste ange en slutpunkt URL som kan skalas för att kunna ta emot ett stort antal meddelanden från Audience Manager,
  • Informationen måste accepteras i JSON format (Content-type: application/json).
  • Den måste acceptera säker HTTPS dataöverföringar. Audience Manager skickar inte meddelanden via den osäkra HTTP -protokoll.

Frekvens

Denna dataöverföringsmetod kan skicka data i nästan realtid när användarna kvalificerar sig för segment. Realtidsmeddelanden levereras endast när användaren är online och aktivt synlig för Audience Manager Edge-nätverket. Den här metoden kan också skicka batchar med offline- eller inbyggda data så ofta som var 24:e timme.

Batchöverföringar

Både realtids- och batchöverföringar skickas till samma slutpunkt och använder samma meddelandeformat. När batchöverföringar är aktiverade kommer målplattformen att se en ökning av meddelandevolymen medan batchmeddelandena levereras. Många av de segmentkvalifikationer som skickas via realtidsmeddelanden upprepas i gruppmeddelandena. Batchöverföringar omfattar endast de segmentkvalifikationer (eller icke-kvalifikationer) som har ändrats sedan den senaste batchen levererades.

Hastighetsgränser

Det finns inga hastighetsbegränsningar för flödet av levererade meddelanden. Inställning av hastighetsgränser kan leda till dataförlust.

Obligatoriska svar

Som standard måste mottagarservern returnera 200 OK kod som anger att kvittot har slutförts. Andra koder tolkas som fel. Detta svar förväntas inom 3 000 millisekunder. Som svar på ett misslyckande, Audience Manager kommer endast att göra ett nytt försök.

Parametrar

Följande tabell definierar elementen i JSON datafil som du skickar till målet.

Parameter
Datatyper
Beskrivning
ProcessTime
DateTime
Tid då begäran kördes.
User_DPID
Heltal

Ett ID som anger vilken typ av enhets-ID som finns i meddelandet, i egenskapen User.DataPartner_UUID.

  • Android ID (GAID): 20914
  • iOS ID (IDFA): 20915
  • Webb-/cookie-ID: varierar beroende på målplattform
Client_ID
Sträng
Representerar målkontot på målplattformen. Detta ID kommer från målplattformen.
AAM_Destination_ID
Heltal
ID:t för Audience Manager-objektet "destination". Detta ID kommer från Audience Manager.
User_count
Heltal
Totalt antal användare i POST begäran.
Users
Array
En array med användarobjekt. Som standard kommer varje meddelande att innehålla mellan 1 och 10 användare, vilket ger optimal meddelandestorlek.
User.AAM_UUID
Sträng
The Audience Manager UUID.
User.DataPartner_UUID
Sträng
UUID för målplattform eller det globala enhets-ID:t.
User.AAM_Regions
Array
The Audience Manager region-ID där vi har sett den här enheten. Om enheten till exempel har någon aktivitet i Paris (Europa) blir region-ID:t 6. Se DCS-region-ID, -platser och -värdnamn.
Segments
Array
En array med segmentobjekt. För realtidsmeddelanden innehåller arrayen alla segment som användaren tillhör. För gruppmeddelanden innehåller arrayen endast segmentändringar sedan den senaste gruppen.
Segment.Segment_ID
Heltal
Identifieraren för segmentet. I de flesta fall är detta det segment-ID som genereras av Audience Manager (ett heltal). I vissa fall, om målplattformen tillåter det, kan kunderna definiera segmentidentifieraren i användargränssnittet i Audience Manager (öppet textfält), som sedan återspeglas i den här egenskapen.
Segment.Status
Heltal

Definierar statusen för en användare i segmentet. Accepterar följande värden:

  • 1: Aktiv (standard)
  • 0: Inaktiv, avanmäld eller osegmenterad.

Användarna är osegmenterade när de är:

  • Borttagen från ett segment baserat på segmentregeln.
  • Borttagen från ett segment baserat på segmentets time-to-live-intervall.
  • Flyttad till ett inaktivt läge om de inte har setts de senaste 120 dagarna.
  • Borttagen på grund av en begäran om sekretessändring (dvs. GDPR)

Alla partner-ID:n som synkroniseras med en Audience Manager ID:t får "Status":"0" flagga när en användare är osegmenterad.

Segment.DateTime
DateTime
Den tidpunkt då användarsegmentets kvalifikationer senast verifierades.

Säkerhet

Du kan skydda din utgående dataöverföringsprocess i realtid genom att signera HTTP-begäranden med privata nycklar eller genom att Audience Manager autentisera via OAuth 2.0 -protokoll.

Begäran

En begäran i realtid kan se ut ungefär så här:

{
"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