๋ณธ๋ฌธ์œผ๋กœ ๊ฑด๋„ˆ๋›ฐ๊ธฐ
Pellio

ํ”Œ๋ ˆ์ด์–ด API

2026๋…„ 10์›” 2์ผ ์—…๋ฐ์ดํŠธ
์ด ํŽ˜์ด์ง€์˜ ๋‚ด์šฉ

ํ”Œ๋ ˆ์ด์–ด๋ฅผ ์ œ์–ดํ•˜๊ณ  ์ด๋ฒคํŠธ๋ฅผ ์ˆ˜์‹ ํ•˜๋Š” ๋ฐฉ๋ฒ•์€ ๋‘ ๊ฐ€์ง€์ž…๋‹ˆ๋‹ค. <pellio-player> ์›น ์ปดํฌ๋„ŒํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๊ฑฐ๋‚˜, iframe ์ž„๋ฒ ๋“œ์—์„œ postMessage๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

์›น ์ปดํฌ๋„ŒํŠธ

๋™์˜์ƒ์˜ Embed & share ํƒญ์—์„œ Web component๋ฅผ ์„ ํƒํ•˜๊ฑฐ๋‚˜ ์ง์ ‘ ์ž‘์„ฑํ•˜์„ธ์š”.

<script src="https://play.pellio.io/assets/embed.js" async></script>
<pellio-player video="VIDEO_ID" muted start="30" color="#e8492f"></pellio-player>
  • ์†์„ฑ: video(์žฌ์ƒ๋ชฉ๋ก์€ playlist), start, color, title, ๊ณ ์ • ํฌ๊ธฐ๋ฅผ ์œ„ํ•œ width์™€ height ๋˜๋Š” aspect-ratio(๊ธฐ๋ณธ๊ฐ’ 16/9), controls="false", ๊ทธ๋ฆฌ๊ณ  ํ”Œ๋ž˜๊ทธ autoplay, muted, loop, captions, background, resume, dnt๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค. ํ”Œ๋ ˆ์ด์–ด๋Š” ์Šคํฌ๋กคํ•ด์„œ ํ™”๋ฉด์— ๋ณด์ผ ๋•Œ ๋กœ๋“œ๋˜๋ฉฐ, ๋ฐ”๋กœ ๋กœ๋“œํ•˜๋ ค๋ฉด eager๋ฅผ ์ถ”๊ฐ€ํ•˜์„ธ์š”.
  • ํŒ์˜ค๋ฒ„: popover๋ฅผ ์ถ”๊ฐ€ํ•˜๋ฉด ์žฌ์ƒ ๋ฒ„ํŠผ์ด ์žˆ๋Š” ์ธ๋„ค์ผ์ด ํ‘œ์‹œ๋˜๊ณ , ํƒœ๊ทธ ์•ˆ์— ์ง์ ‘ ํ…์ŠคํŠธ๋‚˜ ๋ฒ„ํŠผ์„ ๋„ฃ์„ ์ˆ˜๋„ ์žˆ์Šต๋‹ˆ๋‹ค. ํด๋ฆญํ•˜๋ฉด ํ”Œ๋ ˆ์ด์–ด๊ฐ€ ๋ผ์ดํŠธ๋ฐ•์Šค๋กœ ์—ด๋ฆฝ๋‹ˆ๋‹ค.
  • ๋ฉ”์„œ๋“œ: play(), pause(), seek(seconds), mute(true|false), volume(0โ€“1), rate(n), identify(email)
  • ํ”„๋กœํผํ‹ฐ(์ฝ๊ธฐ ์ „์šฉ): currentTime, duration, paused
  • ์ด๋ฒคํŠธ: ์•„๋ž˜์˜ ๋ชจ๋“  ํ”Œ๋ ˆ์ด์–ด ์ด๋ฒคํŠธ๊ฐ€ ์š”์†Œ์—์„œ pellio:<event>๋กœ ๋ฐœ์ƒํ•˜๋ฉฐ, ๋ฉ”์‹œ์ง€๋Š” event.detail์— ๋‹ด๊น๋‹ˆ๋‹ค. ํŒ์˜ค๋ฒ„๋Š” pellio:open๊ณผ pellio:close๋„ ๋ฐœ์ƒ์‹œํ‚ต๋‹ˆ๋‹ค.
const player = document.querySelector('pellio-player');
player.addEventListener('pellio:progress', (e) => console.log(e.detail.percent));
player.seek(42);

์›น ์ปดํฌ๋„ŒํŠธ๋Š” ๋™์˜์ƒ ์ด๋ฒคํŠธ๋ฅผ Google Analytics์™€ Tag Manager๋กœ๋„ ๋ณด๋ƒ…๋‹ˆ๋‹ค(๋ถ„์„ ์ฐธ๊ณ ).

postMessage ๋ช…๋ น

const player = document.querySelector('iframe').contentWindow;
player.postMessage({ pellio: true, method: 'play' }, '*');
player.postMessage({ pellio: true, method: 'seek', value: 42 }, '*');
method value
play, pause ์—†์Œ
seek ์ดˆ(๊ฑด๋„ˆ๋›ฐ๊ธฐ ๊ธˆ์ง€๊ฐ€ ์ผœ์ ธ ์žˆ์œผ๋ฉด ์ด๋ฏธ ์‹œ์ฒญํ•œ ๋ฒ”์œ„ ์•ˆ์—์„œ๋งŒ)
mute true ๋˜๋Š” false
volume 0~1
rate ์žฌ์ƒ ์†๋„(์˜ˆ: 1.5, ํ”„๋ฆฌ์…‹์˜ ์†๋„ ์ œํ•œ๊นŒ์ง€)
identify ์‹œ์ฒญ์ž์˜ ์ด๋ฉ”์ผ(๋ถ„์„์—์„œ ์ด๋ฆ„์œผ๋กœ ํ‘œ์‹œํ•˜๊ณ  ์–‘์‹์„ ๊ฑด๋„ˆ๋›ฐ๊ธฐ ์œ„ํ•จ)

์ด๋ฒคํŠธ

ํ”Œ๋ ˆ์ด์–ด๋Š” ์ƒ์œ„ ํŽ˜์ด์ง€๋กœ { pellio: true, id, title, event, currentTime, duration }๋ฅผ ๋ณด๋‚ด๋ฉฐ, ์ผ๋ถ€ ์ด๋ฒคํŠธ์—๋Š” ์ถ”๊ฐ€ ํ•„๋“œ๊ฐ€ ํฌํ•จ๋ฉ๋‹ˆ๋‹ค.

event ๋ฐœ์ƒ ์‹œ์ 
ready, play, pause, seeked, timeupdate, ratechange, volumechange video ์š”์†Œ๊ฐ€ ํ•ด๋‹น ์ด๋ฒคํŠธ๋ฅผ ๋ฐœ์ƒ์‹œํ‚ฌ ๋•Œ
ended, complete ๋™์˜์ƒ์ด ๋์— ๋„๋‹ฌํ–ˆ์„ ๋•Œ(๋‘˜์ด ํ•จ๊ป˜ ๋ฐœ์ƒ)
progress ์žฌ์ƒ ์œ„์น˜๊ฐ€ 25, 50, 75, 90%๋ฅผ ์ง€๋‚ฌ์„ ๋•Œ(percent). ๊ณ ์œ  ์‹œ์ฒญ ์ดˆ๊ฐ€ ์•„๋‹ˆ๋ผ ์œ„์น˜ ๊ธฐ์ค€์ž…๋‹ˆ๋‹ค.
interaction ์ธํ„ฐ๋ž™์…˜์ด ํ‘œ์‹œ, ํด๋ฆญ, ๊ฑด๋„ˆ๋›ฐ๊ธฐ ๋˜์—ˆ์„ ๋•Œ(interaction, type, kind: view, click, skip)
lead ์–‘์‹์ด ์ œ์ถœ๋˜์—ˆ์„ ๋•Œ(interaction, email)
chapter ์ฑ•ํ„ฐ๋ฅผ ์„ ํƒํ–ˆ์„ ๋•Œ(chapter, t)
download ์‹œ์ฒญ์ž๊ฐ€ ๋™์˜์ƒ์„ ๋‹ค์šด๋กœ๋“œํ–ˆ์„ ๋•Œ
logo ์‹œ์ฒญ์ž๊ฐ€ ํ”„๋ฆฌ์…‹์˜ ๋กœ๊ณ ๋ฅผ ํด๋ฆญํ–ˆ์„ ๋•Œ(href)
transcript ์Šคํฌ๋ฆฝํŠธ ํŒจ๋„์ด ์—ด๋ฆฌ๊ฑฐ๋‚˜ ๋‹ซํ˜”์„ ๋•Œ(open)
attention โ€œStill watching?โ€ ํ™•์ธ์ด ํ‘œ์‹œ๋˜๊ฑฐ๋‚˜ ์‘๋‹ต๋˜์—ˆ์„ ๋•Œ(prompt)
cast TV๋กœ ์บ์ŠคํŒ…์ด ์‹œ์ž‘๋˜๊ฑฐ๋‚˜ ์ค‘์ง€๋˜์—ˆ์„ ๋•Œ(state)
window.addEventListener('message', (e) => {
  if (e.data?.pellio && e.data.event === 'progress') console.log(e.data.id, e.data.percent);
});

์žฌ์ƒ๋ชฉ๋ก ์ž„๋ฒ ๋“œ(/p/โ€ฆ)๋Š” ๊ฐ™์€ ์ด๋ฒคํŠธ์— playlist ํ•„๋“œ๋ฅผ ๋”ํ•ด ๋ณด๋‚ด๋ฉฐ, ๋™์˜์ƒ์ด ์„ ํƒ๋˜๋ฉด select๋„ ๋ณด๋ƒ…๋‹ˆ๋‹ค. ์žฌ์ƒ๋ชฉ๋ก ์ž„๋ฒ ๋“œ๋Š” ๋ช…๋ น์„ ๋ฐ›์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ด ๊ธ€์ด ๋„์›€์ด ๋˜์—ˆ๋‚˜์š”?

์•„์ง ํ•ด๊ฒฐ๋˜์ง€ ์•Š์•˜๋‚˜์š”?๋ฉ”์‹œ์ง€๋ฅผ ๋ณด๋‚ด ์ฃผ์‹œ๋ฉด ๋‹ด๋‹น์ž๊ฐ€ ๋‹ต๋ณ€๋“œ๋ฆด๊ฒŒ์š”.