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

입찰 구성 및 템플릿 지정

이 페이지에서는 MediaTailor가 템플릿에서 OpenRTB 입찰 요청을 작성하는 방법, 변수 보간 작동 방식, MediaTailor가 자동으로 설정하는 값에 대해 설명합니다.

구성 필드

재생 구성에서 수율 최적화를 활성화하면 네 개의 필드를 제공합니다.

입찰 요청 구성 방법

광고 시간이 채워지지 않은 기간이 남아 있는 경우 MediaTailor는 다음 단계에서 입찰 요청을 구성합니다.

콘솔 기본 템플릿

MediaTailor 콘솔에서 수율 최적화를 활성화하면 다음과 같은 사전 채워진 템플릿이 시작점으로 제공됩니다. 애플리케이션의 값을 사용자 지정해야 합니다.

{
  "imp": [
    {
      "bidfloor": 5
    }
  ],
  "app": {
    "id": "{{player_params.app_id}}",
    "name": "{{player_params.app_name}}",
    "bundle": "{{player_params.bundle}}",
    "storeurl": "{{player_params.storeurl}}",
    "domain": "{{player_params.domain}}",
    "content": {
      "genre": "{{asset.genre}}",
      "contentrating": "{{asset.content_rating}}"
    }
  },
  "device": {
    "dnt": "{{player_params.dnt}}",
    "ua": "{{session.user_agent}}",
    "ip": "{{session.client_ip}}",
    "ifa": "{{player_params.device_ifa}}",
    "w": "{{player_params.device_width}}",
    "h": "{{player_params.device_height}}",
    "language": "{{player_params.language}}",
    "model": "{{player_params.model}}",
    "os": "{{player_params.os}}",
    "osv": "{{player_params.osv}}",
    "devicetype": "{{player_params.devicetype}}",
    "make": "{{player_params.make}}"
  },
  "user": {
    "consent": "{{player_params.consent}}"
  },
  "regs": {
    "gdpr": "{{player_params.gdpr}}",
    "us_privacy": "{{player_params.us_privacy}}",
    "gpp": "{{player_params.gpp_consent}}",
    "gpp_sid": "{{player_params.gpp_sid}}"
  }
}

Field-by-field 설명:

템플릿 보간(Mustache 템플릿 지정)

ORTB 템플릿은 동적 값 대체에 Mustache 템플릿 구문을 사용합니다. 자리 표시자는 이중 중괄호를 사용합니다{{ }}.

사용 가능한 템플릿 변수

ORTB 템플릿은 ADS URL 템플릿에서 사용할 수 있는 것과 동일한 동적 변수를 사용할 수 있습니다. 여기에는 세션 변수(예: , {{session.user_agent}}{{session.client_ip}}), 플레이어 파라미터({{player_params.*}}), 자산 메타데이터({{asset.*}}), 가용 컨텍스트({{avail.*}}) 및 SCTE 신호 데이터()가 포함됩니다{{scte.*}}.

사용 가능한 변수의 전체 목록과 설명은 섹션을 참조하세요ADS 요청에 대한 MediaTailor 동적 광고 변수. MediaTailor URL이 플레이어 파라미터 값을 템플릿으로 대체하기 전에 이를 디코딩하는 방법은이 페이지의 인코딩 및 디코딩 동작뒷부분을 참조하세요.

ORTB 템플릿에서 가장 일반적으로 사용되는 변수는 다음과 같습니다.

플레이어 파라미터를 전달하는 방법

세션 초기화 중에 플레이어 파라미터를 전달하는 방법에는 두 가지가 있습니다.

방법 1: JSON 본문을 사용한 POST 요청(권장)

POST https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
Content-Type: application/json

{
  "playerParams": {
    "app_id": "558775_example",
    "slot_id": "608109df-2378-4bc5-8da5-24bc355f01a4",
    "os": "Tizen",
    "make": "Samsung",
    "model": "Tizen TV",
    "language": "en",
    "us_privacy": "1YNY"
  }
}

이 메서드는 사용자 에이전트 문자열과 같은 복잡한 값의 URL 인코딩 문제를 방지하기 때문에 선호됩니다.

방법 2: URL 쿼리 파라미터

GET https://<mediatailor-endpoint>/v1/session/<config-hash>/<origin-id>/master.m3u8
  ?playerParams.app_id=558775_example

이 방법을 사용하면 값이 URL로 인코딩되어야 합니다. MediaTailor URL은 보간 전에 이를 디코딩합니다.

인코딩 및 디코딩 동작

MediaTailor는 플레이어 파라미터 값을 템플릿으로 보간하기 전에 플레이어 파라미터 값에 대해 한 수준의 URL 디코딩을 수행합니다. 이는 파라미터 전달 방법(POST 본문 또는 URL 쿼리 파라미터)에 관계없이 적용됩니다.

디코딩된 값의 예:

요점:

변수가 누락되면 어떻게 되나요?

플레이어가 템플릿에 참조된 파라미터(예: 플레이어 파라미터app_name에는 {{player_params.app_name}} 없음)를 보내지 않으면 자리 표시자는 빈 문자열 로 확인됩니다"".

영향: 빈 문자열이 필수 필드(예: app.bundle)에 있는 경우 입찰 요청은에서 실패합니다BidRequestConfigurationError. 선택적 필드에 있는 경우 APS는 입찰 없음(HTTP 204) 응답을 일으킬 수 있는 빈 값을 수신합니다.

MediaTailor가 자동으로 설정하는 항목

다음 필드는 항상 콘솔 구성 및 현재 가용 컨텍스트의 값을 사용하여 MediaTailor에서 설정합니다. 템플릿에 이를 포함하면 값이 재정의됩니다.

다음 단계