단일 콘텐츠 재생 세션의 nonce와 이벤트 보고를 관리합니다.
프로그래매틱 수익 창출을 사용 설정하려면 sendAdClick, sendTouch, sendPlaybackStart, sendPlaybackEnd를 비롯한 콘텐츠 재생 세션 수명 주기 메서드를 각 이벤트가 발생할 때 호출해야 합니다.
메서드
getNonce
public
getNonce()는 문자열을 반환합니다.
반환 값
string 관리자가 로드될 때 생성된 nonce입니다.
이 값은 지정된 NonceManager 인스턴스에 대해 변경되지 않습니다. 이 nonce 값은 최대 6시간의 단일 콘텐츠 재생 세션에만 유효합니다.
sendAdClick
public
sendAdClick()이 void를 반환함
지정된 콘텐츠 재생 세션 중에 광고 클릭이 발생했음을 Google 광고 서버에 알립니다.
반환 값
void
sendAdImpression
public
sendAdImpression()이 void를 반환함
이 관리자가 생성한 nonce로 요청된 광고의 첫 번째 프레임이 표시될 때 호출해야 합니다.
지원 중단됨
대신 `sendPlaybackStart` 및 `sendPlaybackEnd` 를 사용하세요.
반환 값
void
sendAdTouch
public
sendAdTouch(userInteractionEvent)는 void를 반환합니다.
클릭연결을 제외한 광고에 대한 사용자 터치 또는 클릭 (예: 건너뛰기, 음소거, 탭 등)이 지정된 콘텐츠 재생 세션 중에 발생했음을 Google 광고 서버에 알립니다.
매개변수
userInteractionEvent
cast.framework.events.Event
Cast 프레임워크에서 발생한 사용자 상호작용 이벤트입니다.
값은 null이 아니어야 합니다.
반환 값
void
sendPlaybackEnd
public
sendPlaybackEnd()는 void를 반환합니다.
지정된 콘텐츠 재생 세션의 재생이 종료되었음을 Google 광고 서버에 알립니다. 재생이 종료될 때 호출해야 합니다 (예: 플레이어가 스트림 끝에 도달하거나, 사용자가 중간에 재생을 종료하거나, 사용자가 페이지를 나가거나, 재생목록 설정에서 다음 콘텐츠 항목으로 이동하는 경우).
이 메서드는 sendPlaybackStart에서 시작된 Google 서버에 대한 비동기 호출을 종료합니다.
반환 값
void
sendPlaybackStart
public
sendPlaybackStart()는 void를 반환합니다.
지정된 콘텐츠 재생 세션의 재생이 시작되었음을 Google 광고 서버에 알립니다. '동영상 플레이어 시작' 시 호출해야 합니다. 이는 사용자 시작 작업 (클릭하여 재생) 또는 페이지 시작 작업 (자동 재생)에 대한 응답일 수 있습니다.
이 메서드는 IVT 모니터링 및 감지에 필요한 신호를 수집하기 위해 Google 서버에 비동기 호출을 시작합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eThe NonceManager class manages a unique nonce and reports events for a single content playback session, enabling programmatic monetization.\u003c/p\u003e\n"],["\u003cp\u003eTo enable programmatic monetization, you must call specific lifecycle methods like \u003ccode\u003esendAdClick\u003c/code\u003e, \u003ccode\u003esendTouch\u003c/code\u003e, \u003ccode\u003esendPlaybackStart\u003c/code\u003e, and \u003ccode\u003esendPlaybackEnd\u003c/code\u003e when their corresponding events occur.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetNonce()\u003c/code\u003e provides a unique nonce for the session, valid for a single playback up to 6 hours.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esendPlaybackStart()\u003c/code\u003e and \u003ccode\u003esendPlaybackEnd()\u003c/code\u003e should be used to signal the start and end of content playback to Google ad servers, replacing the deprecated \u003ccode\u003esendAdImpression\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eOther methods like \u003ccode\u003esendAdClick\u003c/code\u003e and \u003ccode\u003esendAdTouch\u003c/code\u003e allow reporting of ad interactions for comprehensive monetization tracking.\u003c/p\u003e\n"]]],["The `NonceManager` class manages a unique nonce for a single content playback session, valid for up to 6 hours. Key actions include: retrieving the nonce via `getNonce()`; notifying ad server events with `sendAdClick()`, `sendAdTouch()`, and `sendAdImpression()`; and signaling the start and end of a playback session via `sendPlaybackStart()` and `sendPlaybackEnd()`. `sendPlaybackStart()` begins background monitoring while `sendPlaybackEnd()` concludes it.\n"],null,[]]
