다음 표에는 XML 피드에서 동영상 솔루션이 인식하는 모든 필드(일부는 필수항목)가 나와 있습니다. 이 외의 요소는 인식되지 않습니다.
목록에서 특정 요소로 이동하기
필수 요소
권장 요소 및 선택 요소
동적 광고 삽입 요소
이러한 요소는 동적 광고 삽입에만 적용되며 위 요소와 함께 사용해야 합니다.
이 요소가 실제로 사용되는 예를 보려면 샘플 피드를 참조하세요.
이제 콘텐츠 ID에서 대소문자가 구분됩니다. 대문자와 소문자가 모두 사용된
콘텐츠 ID는 소문자만 사용된 동일한 ID와 다른 ID로 간주됩니다. 이는 Ad Manager 보고서에도 반영됩니다.
필수 요소
요소 |
다음의 하위 요소: |
요구사항 |
<atom:link> |
<channel> |
필수 |
설명
피드의 페이지 정보를 식별합니다. Ad Manager는 이 요소에서 두 가지 속성(rel 및 href )을 읽습니다.
rel 은 href 속성의 URL이 피드의 결과 집합과 어떻게 관련되는지를 나타냅니다.
rel='next' : href URL이 피드 결과 집합의 다음 페이지로 연결된다는 의미입니다. 피드에 <atom:link> rel='next' 인 태그가 있는 경우 결과 페이지가 더 있다는 의미입니다. 그렇지 않으면 현재 페이지가 결과 집합의 마지막 페이지입니다.
href 는 <atom:link> 태그에서 리소스를 식별하는 URL을 지정합니다.
예
<atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/
중요사항:
- Ad Manager에서 먼저 콘텐츠 소스를 생성한 경우, Ad Manager는 피드 URL 집합이 피드의 첫 결과 집합을 반환할 것이라 예상합니다. 항목이 100개(페이지당)인 결과 집합을 사용하는 것이 좋습니다.
<atom:link> 요소가 피드 페이지에 없는 경우 Ad Manager에서는 해당 페이지를 피드의 마지막 페이지로 간주합니다.
|
맨 위로
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:contentId> |
<item> |
필수 |
설명
Ad Manager에서 CMS 콘텐츠 ID로 저장됩니다. 이 ID는 중요한 요청 매개변수이며 Ad Manager에서 해당 동영상에 대해 어떤 광고를 게재할 수 있는지 파악하기 위해 광고 요청의 일부로 생성됩니다.
Content ID 값은 문자열이어야 하며 대소문자를 구분합니다. 이 값은 동영상 광고 요청에서 vid 매개변수로 사용할 수 있습니다.
예
<dfpvideo:contentID>sdjfbadfb8w3489y</dfpvideo:contentID>
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:lastModifiedDate> |
<item> |
필수 |
설명
동영상 또는 해당 메타데이터의 요소가 마지막으로 수정된 시점을 나타냅니다.
Ad Manager에서 수정된 콘텐츠를 처리하기 위해서는 lastModifiedDate 가 지정되어야 하며, 피드는 가장 최근에 수정된 항목이 가장 위로 오도록 정렬되어야 합니다.
모든 타임스탬프는 RFC 822 사양을 준수하거나 IS0 8601 형식을 따라야 합니다. 시간대가 타임스탬프 문자열에 포함되어 있지 않으면 태평양 표준시(PST)가 기본값으로 설정됩니다.
예
<dfpvideo:lastModifiedDate>2021-01-15T08:00:00+01:00</dfpvideo:lastModifiedDate>
<dfpvideo:lastModifiedDate>Fri, 15 Jan 2021 08:00:00 EST
</dfpvideo:lastModifiedDate>
각 날짜 형식의 예시 보기
예
RFC 822
Fri, 15 Jan 2021 08:00:00 EST
Fri, 15 Jan 2021 13:00:00 GMT
Fri, 15 Jan 2021 15:00:00 +0200
ISO 8601
2021-01-15T12:00:00Z
2021-01-15T08:00:00+01:00
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:version> |
<channel> |
필수 |
설명
이 피드가 사용하는 MRSS 사양의 현재 버전을 나타냅니다. 값은 정수로 입력해야 하며 피드당 한 번 설정해야 합니다.
다음 필드에서는 현재 유효한 값이 2뿐입니다.
예
<dfpvideo:version>2</dfpvideo:version>
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<title> |
<item> |
필수 |
설명
동영상 항목의 이름입니다.
|
맨 위로
권장 요소 및 선택 요소
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:cuepoints> |
<item> |
경우에 따라 다름 * |
설명
* 동영상에 미드롤 광고 시간이 포함되어 있는 경우 필수입니다.
쉼표로 구분된 큐 포인트(단위: 초)를 식별합니다. 큐 포인트는 동영상에 광고를 삽입할 수 있는 시간상의 위치입니다.
최대 소수점 셋째 자리까지 지정할 수 있습니다(예: 55.532 초). 셋째 자리 아래는 버립니다.
동영상의 큐 포인트는 최대 1,000개로 제한됩니다. 동영상이 이 제한에 도달하면 모든 큐 포인트가 잘립니다.
예
<dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:keyvalues> |
<item> |
선택사항 |
설명
동영상의 모든 맞춤 메타데이터를 식별합니다. 여기에는 key, value 및 type (string 데이터 유형으로 제한됨) 속성이 포함되어 있습니다.
MRSS 피드를 통해 처리되는 키-값에는 Ad Manager 인터페이스 내에서 정의된 키-값과 동일한 형식 요구사항이 적용됩니다. 키-값이 이러한 형식 요구사항을 준수하도록 하세요.
예
<dfpvideo:keyvalues key="episode" value="5" type="string"/>
<dfpvideo:keyvalues key="season" value="2" type="string"/>
<dfpvideo:keyvalues key="title" value="Example Title" type="string"/>
<dfpvideo:keyvalues key="recommended count" value="5" type="string"/>
<dfpvideo:keyvalues key="description" value="A lot of text here" type="string"/>
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:thirdPartyContentId> |
<item> |
선택사항 |
설명
이 기능은 사용 설정부터 해야 사용할 수 있습니다. 사용하려면 계정 관리자에게 문의하세요.
이 요소는 YouTube 동영상을 포함하는 맞춤 MRSS 피드가 있는 경우 사용됩니다. 네트워크에 있는 두 개의 MRSS 콘텐츠가 동일한 YouTube 동영상을 지정해서는 안 됩니다.
이 요소의 필수 속성은 다음 하나뿐입니다.
'id' 속성: YouTube 콘텐츠 소스의 contentId 를 참조해야 합니다.
예
<dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<media:content> |
<item> |
권장 |
설명
이 요소에는 소스 URL이나 재생 시간 등 유용한 메타데이터 정보를 제공하는 속성이 포함되어 있습니다. 이 요소는 <item> 의 하위 요소로서 선택적으로 사용됩니다.
Ad Manager에서는 <media:content> 요소의 다음 속성을 읽을 수 있습니다.
-
'duration' 속성: Ad Manager에서는 <item> 당 재생 시간 입력값 1개만 인식합니다. 둘 이상을 지정하면 입력값 중에서 임의로 재생 시간이 선택되므로 재생 시간을 예측할 수 없습니다.
재생 시간 값은 초로 표시되어야 합니다(소수점이 없는 정수).
미드롤 광고를 게재하려면 duration 속성이 필요합니다.
'url' 속성: 동영상 소스로 직접 연결되는 URL이며 Ad Manager 인터페이스 내의 콘텐츠 세부정보에서 링크를 표시하는 데만 사용됩니다.
예
<media:content url='http://www.feedprovider.com/video?8eqe7e' duration='39'/>
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<media:status> |
<media:content> 또는
<item> |
선택사항 |
설명
동영상이 Ad Manager에서 '활성', '비활성' 또는 '보관처리됨'으로 표시되는지를 결정합니다. 이 요소가 없을 때의 기본 상태는 '활성'입니다. 값은 대소문자를 구분하지 않으며 다음을 포함할 수 있습니다.
- 'active'(Ad Manager에 '활성'으로 표시됨)
- 'deleted'(Ad Manager에서 '보관처리됨'으로 표시됨, 새로운 '삭제됨' 동영상은 처리되지 않음)
- 'blocked'(Ad Manager에서 '비활성'으로 표시됨)
사용자가 Ad Manager 내 동영상 상태를 변경하면 피드의 모든 후속 상태 변경이 무시됩니다. 사용자는 Ad Manager 인터페이스에서 소스 설정 사용을 클릭하여 재정의를 제거할 수 있으며, 이렇게 하면 Ad Manager가 피드에서 가져온 상태 업데이트를 다시 사용하기 시작합니다.
게시자 및 CMS 파트너는 다음 중 하나를 수행하여 Ad Manager에서 이미 업로드되었지만 비활성 상태이거나 지원 중단된 콘텐츠가 다시 컨디셔닝되지 않도록 할 수 있습니다.
- (권장) MRSS 피드에서
<media:status state="deleted"/> 지원
- 콘텐츠는 피드에 유지하되 콘텐츠에서 모든 동적 광고 삽입 관련 요소를 삭제하여 VOD 처리에 적합하지 않은 콘텐츠로 만듭니다. 삭제할 특정 요소는 동적 광고 삽입 요소 섹션으로 이동하세요.
동적 광고 삽입을 통해 게재될 때의 게재 상태
동적 광고 삽입의 게재 상태는 소스와 콘텐츠 자체의 상태를 모두 고려하여 결정됩니다. 두 값을 모두 고려하는 경우 예상할 수 있는 동작은 다음과 같습니다.
콘텐츠 소스 상태 |
콘텐츠 상태 |
게재 상태 |
활성 |
활성 |
콘텐츠가 게재됨 |
활성 |
비활성 |
콘텐츠가 게재됨 |
활성 |
보관처리됨 |
콘텐츠가 게재되지 않음(404 오류) |
비활성 |
활성 |
콘텐츠가 게재되지 않음(404 오류) |
비활성 |
비활성 |
콘텐츠가 게재되지 않음(404 오류) |
비활성 |
보관처리됨 |
콘텐츠가 게재되지 않음(404 오류) |
보관처리됨 |
활성 |
콘텐츠가 게재되지 않음(404 오류) |
보관처리됨 |
비활성 |
콘텐츠가 게재되지 않음(404 오류) |
보관처리됨 |
보관처리됨 |
콘텐츠가 게재되지 않음(404 오류) |
- 활성: 광고를 게재할 수 있습니다.
- 비활성: 광고를 게재할 수 없습니다.
- 보관처리됨: 콘텐츠 타겟팅 광고는 게재할 수 없지만, RON 광고는 계속 게재할 수 있습니다.
콘텐츠 소스 상태가 비활성 또는 보관처리됨으로 표시되거나 콘텐츠 상태가 보관처리됨으로 표시되면 동적 광고 삽입을 통해 게재되지 않습니다.
예
<media:status state="blocked" reason="http://www.reasonforblocking.com"/>
<media:status state="deleted"/>
<media:status state="active"/>
(Ad Manager는 reason 속성을 처리하지 않습니다.)
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<media:thumbnail> |
<media:content> 또는
<item> |
권장 |
설명
동영상의 미리보기 이미지가 Ad Manager 인터페이스에 나타나도록 합니다. Ad Manager에서는 현재 이 요소의 URL 속성만 필요로 하지만, 원하는 경우 높이, 너비, 시간(미리보기 이미지로 표시된 이미지가 동영상에 나타나는 시간) 등 추가 속성을 입력할 수 있습니다.
Ad Manager 인터페이스에서는 너비가 280픽셀을 초과하고 높이가 190픽셀을 초과하는 미리보기 이미지를 표시하지 않습니다. URL이 더 큰 이미지에 연결되면, Ad Manager에서 링크는 원본 버전에 연결하지만 인라인 CSS를 사용하여 이미지 크기를 조정하여 UI에 표시되도록 합니다.
예
<media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<pubDate> |
<item> |
선택사항 |
설명
콘텐츠가 게시된 날짜를 식별합니다. 이 요소는 동영상 광고 규칙에만 사용됩니다.
모든 타임스탬프는 RFC 822 사양을 준수하거나 IS0 8601 형식을 따라야 합니다. 시간대가 타임스탬프 문자열에 포함되어 있지 않으면 태평양 표준시(PST)가 기본값으로 설정됩니다.
예
<pubDate>2006-02-19T04:22:39+05:00</pubDate>
<pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate>
각 날짜 형식의 예시 보기
예
RFC 822
Wed, 31 Oct 2016 08:00:00 EST
Wed, 31 Oct 2016 13:00:00 GMT
Wed, 31 Oct 2016 15:00:00 +0200
ISO 8601
20161031
2016-10-31
2016-10-31T08:00:00+01:00
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:ingestUrl> |
<item> |
필수 * |
설명
* 동적 광고 삽입 시 필수입니다.
컨디셔닝 및 재생목록 생성에 사용되는 마스터 m3u8 파일의 동영상 처리 URL을 지정하는 것과 관련된 노드입니다.
"type" 속성: HLS의 경우 Happlication/x-mpegURL 로 설정하고, DASH의 경우 application/dash+xml 로 설정해야 합니다.
"preconditioned" 속성: 이 콘텐츠의 ingestURL 이 이미 미드롤 광고용으로 컨디셔닝되었는지(즉, 광고 시점에 세그먼트가 이미 분할되었는지)를 나타내기 위해 true 나 false 로 설정해야 합니다. 명시적으로 설정하지 않으면 이 속성의 기본값은 false 입니다.
큐 포인트가 광고를 삽입할 수 있도록 스트림의 동영상 세그먼트 시간이 정확하게 맞춰진 경우 콘텐츠가 컨디셔닝되었다고 간주됩니다. 이 경우 동영상 콘텐츠의 해당 위치에 광고 시간이 삽입되어야 한다고 Ad Manager에 알리려면 HLS 스트림에 #EXT-X-PLACEMENT-OPPORTUNITY 마커가 있어야 합니다.
미드롤 광고 삽입 관련 컨디셔닝 및 프리컨디셔닝된 콘텐츠를 자세히 알아보세요.
예
HLS
<dfpvideo:ingestUrl type="application/x-mpegURL" preconditioned="false">https://cdn.example.com/?v=123.m3u8</dfpvideo:ingestUrl>
DASH
<dfpvideo:ingestUrl type="application/dash+xml" preconditioned="true">
https://cdn.example.com//playlist.mpd
</dfpvideo:ingestUrl>
단일 동영상 콘텐츠에서 HLS와 DASH를 동시에 사용할 수도 있습니다. 보안(https) 처리 URL을 사용하는 것이 좋습니다.
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:lastMediaModifiedDate> |
<item> |
권장 |
설명
<dfpvideo:ingestUrl> 에서 참조된 동영상 파일이 마지막으로 수정된 시간을 나타냅니다. 이 값이 피드에서 업데이트되면 콘텐츠의 lastModifiedDate 도 업데이트되어야 합니다.
모든 타임스탬프는 RFC 822 사양을 준수하거나 IS0 8601 형식을 따라야 합니다. 시간대가 타임스탬프 문자열에 포함되어 있지 않으면 태평양 표준시(PST)가 기본값으로 설정됩니다.
예
<dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate>
<dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39
+0000</dfpvideo:lastMediaModifiedDate>
각 날짜 형식의 예시 보기
예
RFC 822
Wed, 31 Oct 2016 08:00:00 EST
Wed, 31 Oct 2016 13:00:00 GMT
Wed, 31 Oct 2016 15:00:00 +0200
ISO 8601
20161031
2016-10-31
2016-10-31T08:00:00+01:00
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:closedCaptionUrl> |
<item> |
경우에 따라 다름 * |
설명
* 인터페이스에 자막을 활성화한 경우에만 필요합니다.
자막 파일에 URL을 지정하는 것과 관련된 노드입니다. 사용 가능한 모든 자막 파일은 여러 closedCaptionUrl 요소로 피드에 제공되어야 합니다(언어 한 개당 자막 파일 한 개).
VOD용 HLS 매니페스트 자막
이 피드 요소가 있으면 피드의 자막만 처리되고 HLS 매니페스트에 지정된 자막은 무시됩니다. HLS 매니페스트 자막은 자막 피드 요소가 없는 경우에만 수집됩니다.
지원되는 형식은 TTML/DXFP(application/ttaf+xml ) 및 WebVTT(text/vtt )입니다.
"language" 속성: 필수 항목이며(비워둘 수 없음), 자막 파일의 언어로 설정해야 합니다. 이는 RFC5646을 준수해야 하고, 문자열 "$$$$$" 를 포함할 수 없습니다. 이 속성은 XML에 자세히 설명되어 있는 xml:lang 속성과 유사하게 사용됩니다.
"name" 속성: 문자열 "$$$$$" 를 포함할 수 없습니다.
"type" 속성: 자막 파일의 MIME 유형으로 설정해야 합니다.
"characteristics" 속성: 다음 중 하나로 설정해야 합니다(또는 비워둘 수 있음).**
"public.accessibility.transcribes-spoken-dialog"
"public.accessibility.describes-music-and-sound"
"public.easy-to-read"
** "characteristics" 가 위와 같이 설정되지 않으면 경고가 표시되지만, 계속 작동하기는 합니다.
단일 콘텐츠 소스의 경우 language 및 name 조합은 각 자막 파일에 대해 고유해야 합니다. [language="en", name="English" ] 및 [language="en", name="English (CC)" ]를 예로 들 수 있습니다.
예
<dfpvideo:closedCaptionUrl language="en" name="English" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl>
<dfpvideo:closedCaptionUrl language="en" name="English (CC)" characteristics="public.accessibility.describes-music-and-sound" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl
|
맨 위로
요소 |
다음의 하위 요소: |
요구사항 |
<dfpvideo:fw_caid> |
<item> |
경우에 따라 다름 * |
설명
* Freewheel 사용자에게만 필요합니다.
광고 타겟팅 시 사용되는 Freewheel 맞춤 애셋 ID 지정과 관련된 노드입니다.
예
<dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>
|
맨 위로