플레이어 변수 사용 - 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. In 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 -인코딩하십시오. 이렇게 하면 에서 디코딩을 수행하면 한 번 인코딩된 값이 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