실시간 아웃바운드 데이터 전송 real-time-outbound-data-transfers
아웃바운드 실시간 데이터 전송 프로세스는 일련의 JSON 형식의 메시지로 사용자 데이터를 대상 플랫폼에 전달합니다.
권장 사항
이 방법을 사용하려면 대상 플랫폼이 다음 요구 사항을 충족해야 합니다.
- Audience Manager에서 많은 양의 메시지를 받도록 확장할 수 있는 끝점 URL을(를) 제공해야 합니다.
- JSON 형식(
Content-type: application/json
)의 데이터를 허용해야 합니다. - 보안
HTTPS
데이터 전송을 허용해야 합니다. Audience Manager이(가) 비보안HTTP
프로토콜을 통해 메시지를 보내지 않습니다.
빈도
이 데이터 전송 방법은 사용자가 세그먼트에 대한 자격을 얻을 때 거의 실시간으로 데이터를 전송할 수 있습니다. 실시간 메시지는 사용자가 온라인 상태이고 Audience Manager Edge 네트워크에 적극적으로 표시되는 동안에만 전달됩니다. 선택적으로, 이 방법은 오프라인 또는 온보딩된 데이터의 배치를 24시간마다 전송할 수도 있습니다.
배치 전송
실시간 전송과 배치 전송 모두 동일한 끝점으로 전송되며 동일한 메시지 형식을 사용합니다. 일괄 전송 기능을 활성화하면 일괄 처리 메시지가 배달되는 동안 대상 플랫폼에서 메시지 볼륨이 급증합니다. 실시간 메시지를 통해 전송되는 많은 세그먼트 자격이 배치 메시지에서 반복됩니다. 배치 이전에는 마지막 배치가 전달된 이후 변경된 세그먼트 자격(또는 비자격)만 포함됩니다.
비율 제한
게재된 메시지의 처리량에 설정된 속도 제한은 없습니다. 요율 제한을 설정하면 데이터가 손실될 수 있습니다.
필수 응답
기본적으로 받는 사람 서버는 200 OK
코드를 반환하여 성공적으로 받았음을 나타내야 합니다. 다른 코드는 실패로 해석될 것입니다. 이 응답은 3000밀리초 내에 예상됩니다. 실패에 대한 응답으로 Audience Manager이(가) 한 번만 다시 시도합니다.
매개 변수
다음 표는 대상으로 보내는 JSON 데이터 파일의 요소를 정의합니다.
ProcessTime
User_DPID
User.DataPartner_UUID 속성에서 메시지 내에 포함된 장치 ID 유형을 나타내는 ID입니다.
- Android ID(GAID):
20914
- iOS ID(IDFA):
20915
- 웹/쿠키 ID: 대상 플랫폼에 따라 다름
Client_ID
AAM_Destination_ID
User_count
POST
요청의 총 사용자 수입니다.Users
User.AAM_UUID
User.DataPartner_UUID
User.AAM_Regions
6
입니다. 개의 DCS 지역 ID, 위치 및 호스트 이름을 참조하십시오.Segments
Segment.Segment_ID
Segment.Status
세그먼트에서 사용자의 상태를 정의합니다. 다음 값을 허용합니다.
1
: 활성(기본값)0
: 비활성, 옵트아웃 또는 세그먼테이션되지 않음.
사용자는 다음과 같은 경우 세분화되지 않습니다.
- 세그먼트 규칙에 따라 세그먼트에서 제거되었습니다.
- 세그먼트의 TTL(Time-to-Live) 간격을(를) 기반으로 세그먼트에서 제거되었습니다.
- 지난 120일 동안 표시되지 않은 경우 비활성 상태로 이동되었습니다.
- 개인 정보 변경 요청(예: GDPR)으로 인해 제거되었습니다.
Audience Manager ID에 동기화되는 모든 파트너 ID는 사용자가 세분화되지 않은 경우 "Status":"0"
플래그를 받습니다.
Segment.DateTime
보안
개인 키를 사용하여 HTTP 요청에 서명하거나 OAuth 2.0 프로토콜을 통해 Audience Manager을(를) 인증하면 실시간 아웃바운드 데이터 전송 프로세스를 보호할 수 있습니다.
요청
실시간 요청은 다음과 유사할 수 있습니다.
{
"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"
}]
}]
}