파라미터를 ADS에 전달하는 MediaTailor - AWS Elemental MediaTailor
고급 사용량

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

파라미터를 ADS에 전달하는 MediaTailor

AWS Elemental MediaTailor 는 다음 단계를 사용하여 ADS에 대한 MediaTailor 요청에서 동적 변수 설정을 지원합니다.

세션 초기화 방법

MediaTailor는 세션 초기화 및 파라미터 전달을 위한 여러 방법을 지원합니다.

  1. 요청 본문이 있는 POST:

    POST <master>.m3u8
{
    "adsParams": {"param1": "value1", "param2": "value2"},
    "playerParams": {"param3": "value3"}
}

  2. URL의 쿼리 파라미터:

    GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
중요

초기화 시 파라미터를 한 번만 지정할 수 있습니다. 구성 별칭은 전달하기 전에 실제 값으로 확인됩니다.

세션 및 플레이어 정보를 ADS에 전달하려면

  1. ADS와 협력하여 광고 쿼리에 응답해야 하는 정보를 결정합니다 AWS Elemental MediaTailor.

  2. ADS 요구 사항을 충족하는 템플릿 ADS 요청 URL을 사용하는 구성을 MediaTailor에서 생성합니다. URL에는 정적 파라미터를 포함시키고 동적 파라미터의 자리 표시자를 포함시킵니다. 구성의 Ad decision server(광고 의사결정 서버) 필드에 템플릿 URL을 입력합니다.

    다음 예제 템플릿 URL에서 correlation은 세션 데이터를 제공하고 deviceType은 플레이어 데이터를 제공합니다.

    https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]

  3. 플레이어에서는 AWS Elemental MediaTailor 이 플레이어 데이터의 파라미터를 제공하도록 세션 시작 요청을 구성합니다. 세션 시작 요청에 파라미터를 포함시키고 세션에 대한 후속적인 요청에서 이를 제외합니다.

    세션을 초기화하기 위해 플레이어가 수행하는 호출 유형에 따라 플레이어(클라이언트) 또는 MediaTailor(서버)가 세션에 대한 광고 추적 보고를 제공하는지 여부가 결정됩니다. 이러한 두 가지 옵션에 대한 자세한 내용은 광고 추적 데이터 보고 단원을 참조하십시오.

    서버 측 또는 클라이언트 측 광고 추적 보고 중 어떤 것을 원하는지 여부에 따라 다음 호출 유형 중 하나를 실행합니다. 두 가지 예제 호출의 경우 모두 userID는 ADS를 위한 것이며 auth_token은 오리진을 위한 것입니다.

    • (선택 사항) 서버 측 광고 추적 보고 호출 - MediaTailor가 ADS로 전송할 파라미터 앞에를 추가합니다ads. MediaTailor가 오리진 서버로 전송할 파라미터의 접두사를 끈 상태로 둡니다.

      다음 예제에서는에 대한 HLS 및 DASH에 대한 수신 요청을 보여줍니다 AWS Elemental MediaTailor. MediaTailor는 ADS에 대한 요청deviceType에서를 사용하고 오리진 서버에 대한 요청auth_token에서를 사용합니다.

      HLS 예:

      GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh

      DASH 예:

      GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh

    • (선택 사항) 클라이언트 측 광고 추적 보고를 위한 호출 - adsParams 객체 내의 ADS에 대한 파라미터를 제공합니다.

      HLS 예:

      POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

      DASH 예:

      POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }

플레이어가 세션을 시작하면 템플릿 ADS 요청 URL의 변수를 세션 데이터 및 플레이어의 ads 파라미터로 바 AWS Elemental MediaTailor 꿉니다. 나머지 파라미터는 플레이어에서 오리진 서버로 전달됩니다.

예 광고 변수를 사용한 MediaTailor 요청

다음 예제에서는 앞에 나온 플레이어의 세션 초기화 호출 예제와 일치하는 AWS Elemental MediaTailor 에서의 ADS 및 오리진 서버로의 호출을 보여줍니다.

  • MediaTailor는 세션 데이터와 플레이어의 디바이스 유형을 사용하여 ADS를 호출합니다.

    https://my.ads.server.com/path?correlation=896976764&deviceType=ipad

  • MediaTailor는 플레이어의 권한 부여 토큰을 사용하여 오리진 서버를 호출합니다.

    • HLS 예:

      https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

    • DASH 예:

      https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

고급 사용량

플레이어 및 세션 데이터로 다양한 방법으로 ADS 요청을 사용자 지정할 수 있습니다. ADS 호스트 이름만 포함하면 됩니다.

다음 예시에서는 요청을 사용자 지정할 수 있는 방법의 일부를 보여줍니다.

  • 플레이어 파라미터와 세션 파라미터를 연결하여 새 파라미터를 생성합니다. 예시 

    https://my.ads.com?key1=[player_params.value1][session.id]

  • 플레이어 파라미터를 경로 요소의 일부로 사용합니다. 예시

    https://my.ads.com/[player_params.path]?key=value

  • 플레이어 파라미터를 사용하여 단지 값을 전달하기 보다는 경로 요소와 키 자체를 둘 다 전달합니다. 예시 

    https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]