플레이어 변수 사용 - AWS Elemental MediaTailor

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

플레이어 변수 사용

플레이어에서 ADS로 수신된 데이터를 전송하도록 AWS Elemental MediaTailor을 구성하려면 템플릿 ADS URL에서 player_params.<query_parameter_name> 변수를 지정합니다. 예를 들어 플레이어가 user_id 요청에서 이름이 지정된 쿼리 파라미터를 에 보내는 경우 해당 데이터를 ADS 요청에 전달하려면 ADS URL 구성에 [player_params.user_id] 포함해야 합니다. MediaTailor

이렇게 하면 ADS 요청에 포함되어 있는 쿼리 파라미터를 제어할 수 있습니다. 일반적으로, ADS가 인식하는 특수 쿼리 파라미터를 ADS 요청 URL에 추가하고 키-값 페어를 파라미터의 값으로 제공합니다.

다음 절차에 사용된 예제는 다음 키-값 페어를 사용합니다.

  • 값이 1인 매개변수 1:

  • 값이 2인 매개변수 2:

쿼리 파라미터를 키-값 페어로 추가하려면

  1. AWS Elemental MediaTailor에서 ADS 요청 템플릿 URL을 구성하여 파라미터를 참조합니다. 다음 URL은 예제 파라미터가 포함되어 있음을 보여줍니다.

    https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

  2. (선택 사항) 서버 측 광고 추적 보고의 경우 플레이어의 키 값 페어를 URL 인코딩합니다. 세션 초기화 요청을 MediaTailor 받으면 값을 URL 디코딩한 후 ADS 요청 URL로 대체합니다.

    참고

    ADS가 URL 인코딩 값을 요구하는 경우 플레이어에서 값을 두 번 URL 인코딩합니다. 이렇게 하면 에서 디코딩을 수행하면 ADS에 한 번 인코딩된 값이 MediaTailor 생성됩니다.

    예를 들어 ADS에 전송된 값의 디코딩된 표현이 param1=value1:&param2=value2:인 경우 URL 인코딩된 표현은 param1=value1%3A&param2=value2%3A입니다.

  3. 플레이어의 세션 초기화 호출 시 키-값 쌍을 단일 쿼리 파라미터의 MediaTailor 값으로 전달합니다. 다음 예제 호출은 서버 측 및 클라이언트 측 광고 추적 보고에 대해 예제 키-값 페어를 제공합니다.

    • 서버 측 광고 추적 보고에 대한 예제 요청 - URL 인코딩 페어 사용

      HLS:

      <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

      DASH:

      <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

    • 클라이언트 측 광고 추적 보고에 대한 예제 요청 - URL 인코딩 사용하지 않음

      HLS:

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

      DASH:

      POST <manifest>.mpd
    {
        "adsParams": {
           "param1": "value1:",
           "param2": "value2:"
       }
    }

서버측 보고의 경우 플레이어 요청이 수신되면 파라미터를 MediaTailor 디코딩합니다. 클라이언트측 보고의 경우 JSON 페이로드에 수신된 파라미터는 변경되지 않습니다. MediaTailor ADS에 다음 요청을 보냅니다.

https://my.ads.com/<path>?param1=value1:&param2=value2:

이러한 방식으로 param1 및 param2 키-값 페어는 최고 수준의 쿼리 파라미터로 ADS 요청에 포함됩니다.