실시간 아웃바운드 데이터 전송

아웃바운드 실시간 데이터 전송 프로세스는 일련의 형식의 메시지를 대상 플랫폼으로 사용자 데이터를 JSON 전달합니다.

권장 사항

이 메서드를 사용하려면 대상 플랫폼이 다음 요구 사항을 충족해야 합니다.

  • Audience Manager에서 대량의 메시지를 받을 수 있도록 확장할 URL 수 있는 끝점을 제공해야 합니다.
  • 데이터를 JSON 형식(Content-type: application/json);
  • 보안 HTTPS 데이터 전송을 승인해야 합니다. Audience Manager 안전하지 않은 HTTP 프로토콜을 통해 메시지를 전송하지 않습니다.

빈도

이 데이터 전송 방법은 사용자가 세그먼트를 사용할 수 있으므로 거의 실시간으로 데이터를 전송할 수 있습니다. 실시간 메시지는 사용자가 온라인 상태이고 Audience Manager Edge 네트워크에 능동적으로 표시되는 동안에만 전달됩니다. 선택적으로 이 방법을 사용하면 24시간마다 오프라인 또는 온보드 데이터의 일괄 처리를 보낼 수도 있습니다.

일괄 전송

실시간 및 일괄 전송 모두 동일한 종단점으로 전송되며 동일한 메시지 형식을 사용합니다. 일괄 전송 기능이 활성화되면 배치 메시지가 전달되는 동안 대상 플랫폼에 메시지 볼륨이 급등하게 됩니다. 실시간 메시지를 통해 전송되는 많은 세그먼트 자격 조건은 배치 메시지에서 반복됩니다. 배치 이전에는 마지막 배치를 전달한 이후 변경된 세그먼트 자격(또는 비자격)만 포함됩니다.

비율 제한

There are no rate limits set on the throughput of delivered messages. 속도 제한을 설정하면 데이터가 손실될 수 있습니다.

필수 응답

기본적으로 수신자 서버는 성공적인 입고를 나타내는 200 OK 코드를 반환해야 합니다. 다른 코드는 실패로 해석됩니다. 이 응답은 3000밀리초 이내에 필요합니다. 실패에 대한 응답으로 한 번만 다시 Audience Manager 시도합니다.

매개 변수

다음 표에서는 대상으로 전송하는 데이터 파일의 JSON 요소를 정의합니다.

매개 변수 데이터 유형 설명
ProcessTime

DateTime

요청이 실행된 시간입니다.

User_DPID

정수

메시지 내에 포함된 장치 ID의 유형을 나타내는 ID를 User.DataPartner_UUID 속성에서 지정합니다.

  • Android ID(GAID): 20914
  • iOS ID(IDFA): 20915
  • 웹/쿠키 ID: 대상 플랫폼별로 다름
Client_ID

문자열

대상 플랫폼의 대상 계정을 나타냅니다. 이 ID는 대상 플랫폼에서 만들어졌습니다.

AAM_Destination_ID

정수

Audience Manager "대상" 개체의 ID입니다. 이 ID는 Audience Manager에서 유래했습니다.

User_count

정수

요청에 있는 총 사용자 POST 수입니다.

Users

배열

사용자 개체의 배열입니다. 메시지 크기를 최적으로 유지하기 위해 기본적으로 각 메시지에는 1명에서 10명의 사용자가 포함됩니다.

User.AAM_UUID

문자열

Audience Manager UUID입니다.

User.DataPartner_UUID

문자열

대상 플랫폼 UUID 또는 전역 장치 ID.

User.AAM_Regions 배열 이 장치를 본 Audience Manager 지역 ID. 예를 들어, 장치가 파리(유럽)에서 일부 활동을 했다면 지역 ID가 됩니다 6. DCS 영역 ID, 위치 및 호스트 이름을 참조하십시오.
Segments

배열

세그먼트 개체의 배열입니다. 실시간 메시지의 경우 배열에 사용자가 속한 모든 세그먼트가 포함됩니다. 배치 메시지의 경우 배열에 마지막 배치 이후의 세그먼트 변경 사항만 포함됩니다.

Segmnent.Segment_ID

정수

세그먼트의 식별자입니다. 대부분의 경우 Audience Manager에 의해 생성된 세그먼트 ID입니다(정수). 경우에 따라, 대상 플랫폼이 허용하는 경우 고객은 Audience Manager 사용자 인터페이스(텍스트 필드 열기)에서 세그먼트 식별자를 정의하면 이 속성이 반영됩니다.

Segment.Status

정수

세그먼트에 있는 사용자의 상태를 정의합니다. 다음 값을 수락합니다.

  • 1: 활성(기본값)
  • 0: 비활성, 옵트아웃 또는 세그먼트화되지 않은

사용자는 다음 경우에 세그먼트화되지 않습니다.

  • 세그먼트 규칙에 따라 세그먼트에서 제거되었습니다.
  • 세그먼트의 실시간 간격에 따라 세그먼트에서 제거되었습니다.
  • 지난 120일 동안 표시되지 않은 경우 비활성 상태로 이동되었습니다.
  • 개인 정보 변경 요청(예: GDPR)으로 인해 제거됨

Audience Manager ID에 동기화된 모든 파트너 ID는 사용자가 세그먼트화되지 않은 경우 "Status":"0" 플래그를 수신합니다.

Segment.DateTime

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"
        }]
    }]
}

이 페이지에서는