DokumentationAudience ManagerAnvändarhandbok för Audience Manager

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

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

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

Rekommendationer

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

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

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-koden för att ange att kvittot har slutförts. Andra koder tolkas som fel. Detta svar förväntas inom 3 000 millisekunder. Som svar på ett fel kommer Audience Manager endast att göra ett nytt försök.

Parametrar

Följande tabell definierar elementen i datafilen JSON 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
Audience Manager UUID.
User.DataPartner_UUID
Sträng
UUID för målplattform eller det globala enhets-ID:t.
User.AAM_Regions
Array
Det Audience Manager-region-ID där den här enheten har visats. Om enheten till exempel har någon aktivitet i Paris (Europa) blir region-ID 6. Se ID:n för DCS-region, 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
Segmentets identifierare. 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 Audience Manager användargränssnitt (ö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 (t.ex. GDPR)

Alla partner-ID:n som synkroniseras med ett Audience Manager-ID får flaggan "Status":"0" 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 hjälp av privata nycklar eller genom att låta Audience Manager autentisera via protokollet ​ OAuth 2.0.

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