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

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

플레이어 변수 사용

플레이어로부터 받은 데이터를 로 AWS Elemental MediaTailor 전송하도록 ADS URL 구성하려면 템플릿에서 player_params.<query_parameter_name> 변수를 지정합니다. ADS 예를 들어 플레이어가 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

    참고

    URL-encoded 값이 ADS 필요한 경우 플레이어에서 값을 URL -encode하여 두 번 실행하십시오. 이렇게 하면 에서 디코딩을 수행하면 한 번 인코딩된 값이 MediaTailor 생성됩니다. ADS

    예를 들어, 로 전송된 값의 디코딩된 표현이 is인 경우 -encoded 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