Fired first time each ad break begins playback. If an ad break is watched
subsequent times this will not be fired. Applications must disable seeking
when this occurs (only used for dynamic ad insertion).
Fired every time the stream switches from advertising or slate to content.
This will be fired even when an ad is played a second time or when seeking
into an ad (only used for dynamic ad insertion).
Fired every time the stream switches from content to advertising or slate.
This will be fired even when an ad is played a second time or when seeking
into an ad (only used for dynamic ad insertion).
Cuepoints changed for VOD stream (only used for dynamic ad insertion).
For this event, theIMAAdEvent.adDataproperty contains a list ofIMACuepoints atIMAAdEvent.adData[@"cuepoints"].
The user has closed the icon fallback image dialog. This may be a good time to resume ad
playback, which the SDK autopaused on icon tap. This event only fires for tvOS.
The user has tapped an ad icon. On iOS, the SDK will navigate to the landing page. On tvOS, the
SDK will present a modal dialog containing the VAST icon fallback image.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003e\u003ccode\u003eIMAAdEventType\u003c/code\u003e is an enum defining different event types sent by the IMAAdsManager to its delegate.\u003c/p\u003e\n"],["\u003cp\u003eThese events provide signals for ad playback states, user interactions, and ad break lifecycle changes.\u003c/p\u003e\n"],["\u003cp\u003eEvent types like \u003ccode\u003eLOADED\u003c/code\u003e, \u003ccode\u003eSTARTED\u003c/code\u003e, \u003ccode\u003eCOMPLETE\u003c/code\u003e, and \u003ccode\u003eSKIPPED\u003c/code\u003e track individual ad progression.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eAD_BREAK_READY\u003c/code\u003e, \u003ccode\u003eAD_BREAK_STARTED\u003c/code\u003e, and \u003ccode\u003eAD_BREAK_ENDED\u003c/code\u003e manage ad break states, relevant for dynamic ad insertion.\u003c/p\u003e\n"],["\u003cp\u003eEvents such as \u003ccode\u003eCUEPOINTS_CHANGED\u003c/code\u003e, \u003ccode\u003eSTREAM_LOADED\u003c/code\u003e, and \u003ccode\u003eSTREAM_STARTED\u003c/code\u003e are specific to dynamic ad insertion in VOD streams.\u003c/p\u003e\n"]]],[],null,["# GoogleInteractiveMediaAds Framework Reference\n\nIMAAdEventType\n==============\n\n enum IMAAdEventType : NSInteger {}\n\nDifferent event types sent by the IMAAdsManager to its delegate.\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_AD_BREAK_READY](#/c:@E@IMAAdEventType@kIMAAdEvent_AD_BREAK_READY)\n\n `\n ` \n Ad break ready. \n\n #### Declaration\n\n Swift \n\n case AD_BREAK_READY = 0\n\n Objective-C \n\n kIMAAdEvent_AD_BREAK_READY\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_AD_BREAK_FETCH_ERROR](#/c:@E@IMAAdEventType@kIMAAdEvent_AD_BREAK_FETCH_ERROR)\n\n `\n ` \n Ad break will not play back any ads. \n\n #### Declaration\n\n Swift \n\n case AD_BREAK_FETCH_ERROR = 1\n\n Objective-C \n\n kIMAAdEvent_AD_BREAK_FETCH_ERROR\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_AD_BREAK_ENDED](#/c:@E@IMAAdEventType@kIMAAdEvent_AD_BREAK_ENDED)\n\n `\n ` \n Fired the first time each ad break ends. Applications must reenable seeking\n when this occurs (only used for dynamic ad insertion). \n\n #### Declaration\n\n Swift \n\n case AD_BREAK_ENDED = 2\n\n Objective-C \n\n kIMAAdEvent_AD_BREAK_ENDED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_AD_BREAK_STARTED](#/c:@E@IMAAdEventType@kIMAAdEvent_AD_BREAK_STARTED)\n\n `\n ` \n Fired first time each ad break begins playback. If an ad break is watched\n subsequent times this will not be fired. Applications must disable seeking\n when this occurs (only used for dynamic ad insertion). \n\n #### Declaration\n\n Swift \n\n case AD_BREAK_STARTED = 3\n\n Objective-C \n\n kIMAAdEvent_AD_BREAK_STARTED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_AD_PERIOD_ENDED](#/c:@E@IMAAdEventType@kIMAAdEvent_AD_PERIOD_ENDED)\n\n `\n ` \n Fired every time the stream switches from advertising or slate to content.\n This will be fired even when an ad is played a second time or when seeking\n into an ad (only used for dynamic ad insertion). \n\n #### Declaration\n\n Swift \n\n case AD_PERIOD_ENDED = 4\n\n Objective-C \n\n kIMAAdEvent_AD_PERIOD_ENDED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_AD_PERIOD_STARTED](#/c:@E@IMAAdEventType@kIMAAdEvent_AD_PERIOD_STARTED)\n\n `\n ` \n Fired every time the stream switches from content to advertising or slate.\n This will be fired even when an ad is played a second time or when seeking\n into an ad (only used for dynamic ad insertion). \n\n #### Declaration\n\n Swift \n\n case AD_PERIOD_STARTED = 5\n\n Objective-C \n\n kIMAAdEvent_AD_PERIOD_STARTED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_ALL_ADS_COMPLETED](#/c:@E@IMAAdEventType@kIMAAdEvent_ALL_ADS_COMPLETED)\n\n `\n ` \n All valid ads managed by the ads manager have completed or the ad response\n did not return any valid ads. \n\n #### Declaration\n\n Swift \n\n case ALL_ADS_COMPLETED = 6\n\n Objective-C \n\n kIMAAdEvent_ALL_ADS_COMPLETED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_CLICKED](#/c:@E@IMAAdEventType@kIMAAdEvent_CLICKED)\n\n `\n ` \n Ad clicked. \n\n #### Declaration\n\n Swift \n\n case CLICKED = 7\n\n Objective-C \n\n kIMAAdEvent_CLICKED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_COMPLETE](#/c:@E@IMAAdEventType@kIMAAdEvent_COMPLETE)\n\n `\n ` \n Single ad has finished. \n\n #### Declaration\n\n Swift \n\n case COMPLETE = 8\n\n Objective-C \n\n kIMAAdEvent_COMPLETE\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_CUEPOINTS_CHANGED](#/c:@E@IMAAdEventType@kIMAAdEvent_CUEPOINTS_CHANGED)\n\n `\n ` \n Cuepoints changed for VOD stream (only used for dynamic ad insertion).\n For this event, the [IMAAdEvent.adData](../Classes/IMAAdEvent.html#/c:objc(cs)IMAAdEvent(py)adData) property contains a list of\n [IMACuepoint](../Classes/IMACuepoint.html)s at `IMAAdEvent.adData[@\"cuepoints\"]`. \n\n #### Declaration\n\n Swift \n\n case CUEPOINTS_CHANGED = 9\n\n Objective-C \n\n kIMAAdEvent_CUEPOINTS_CHANGED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_ICON_FALLBACK_IMAGE_CLOSED](#/c:@E@IMAAdEventType@kIMAAdEvent_ICON_FALLBACK_IMAGE_CLOSED)\n\n `\n ` \n The user has closed the icon fallback image dialog. This may be a good time to resume ad\n playback, which the SDK autopaused on icon tap. This event only fires for tvOS. \n\n #### Declaration\n\n Swift \n\n case ICON_FALLBACK_IMAGE_CLOSED = 10\n\n Objective-C \n\n kIMAAdEvent_ICON_FALLBACK_IMAGE_CLOSED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_ICON_TAPPED](#/c:@E@IMAAdEventType@kIMAAdEvent_ICON_TAPPED)\n\n `\n ` \n The user has tapped an ad icon. On iOS, the SDK will navigate to the landing page. On tvOS, the\n SDK will present a modal dialog containing the VAST icon fallback image. \n\n #### Declaration\n\n Swift \n\n case ICON_TAPPED = 11\n\n Objective-C \n\n kIMAAdEvent_ICON_TAPPED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_FIRST_QUARTILE](#/c:@E@IMAAdEventType@kIMAAdEvent_FIRST_QUARTILE)\n\n `\n ` \n First quartile of a linear ad was reached. \n\n #### Declaration\n\n Swift \n\n case FIRST_QUARTILE = 12\n\n Objective-C \n\n kIMAAdEvent_FIRST_QUARTILE\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_LOADED](#/c:@E@IMAAdEventType@kIMAAdEvent_LOADED)\n\n `\n ` \n An ad was loaded. \n\n #### Declaration\n\n Swift \n\n case LOADED = 13\n\n Objective-C \n\n kIMAAdEvent_LOADED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_LOG](#/c:@E@IMAAdEventType@kIMAAdEvent_LOG)\n\n `\n ` \n A log event for the ads being played. These are typically non fatal errors. \n\n #### Declaration\n\n Swift \n\n case LOG = 14\n\n Objective-C \n\n kIMAAdEvent_LOG\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_MIDPOINT](#/c:@E@IMAAdEventType@kIMAAdEvent_MIDPOINT)\n\n `\n ` \n Midpoint of a linear ad was reached. \n\n #### Declaration\n\n Swift \n\n case MIDPOINT = 15\n\n Objective-C \n\n kIMAAdEvent_MIDPOINT\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_PAUSE](#/c:@E@IMAAdEventType@kIMAAdEvent_PAUSE)\n\n `\n ` \n Ad paused. \n\n #### Declaration\n\n Swift \n\n case PAUSE = 16\n\n Objective-C \n\n kIMAAdEvent_PAUSE\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_RESUME](#/c:@E@IMAAdEventType@kIMAAdEvent_RESUME)\n\n `\n ` \n Ad resumed. \n\n #### Declaration\n\n Swift \n\n case RESUME = 17\n\n Objective-C \n\n kIMAAdEvent_RESUME\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_SKIPPED](#/c:@E@IMAAdEventType@kIMAAdEvent_SKIPPED)\n\n `\n ` \n Ad has skipped. \n\n #### Declaration\n\n Swift \n\n case SKIPPED = 18\n\n Objective-C \n\n kIMAAdEvent_SKIPPED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_STARTED](#/c:@E@IMAAdEventType@kIMAAdEvent_STARTED)\n\n `\n ` \n Ad has started. \n\n #### Declaration\n\n Swift \n\n case STARTED = 19\n\n Objective-C \n\n kIMAAdEvent_STARTED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_STREAM_LOADED](#/c:@E@IMAAdEventType@kIMAAdEvent_STREAM_LOADED)\n\n `\n ` \n Stream request has loaded (only used for dynamic ad insertion). \n\n #### Declaration\n\n Swift \n\n case STREAM_LOADED = 20\n\n Objective-C \n\n kIMAAdEvent_STREAM_LOADED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_STREAM_STARTED](#/c:@E@IMAAdEventType@kIMAAdEvent_STREAM_STARTED)\n\n `\n ` \n Stream has started playing (only used for dynamic ad insertion). Start\n Picture-in-Picture here if applicable. \n\n #### Declaration\n\n Swift \n\n case STREAM_STARTED = 21\n\n Objective-C \n\n kIMAAdEvent_STREAM_STARTED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_TAPPED](#/c:@E@IMAAdEventType@kIMAAdEvent_TAPPED)\n\n `\n ` \n Ad tapped. \n\n #### Declaration\n\n Swift \n\n case TAPPED = 22\n\n Objective-C \n\n kIMAAdEvent_TAPPED\n\n- `\n ``\n ``\n `\n\n ### [kIMAAdEvent_THIRD_QUARTILE](#/c:@E@IMAAdEventType@kIMAAdEvent_THIRD_QUARTILE)\n\n `\n ` \n Third quartile of a linear ad was reached. \n\n #### Declaration\n\n Swift \n\n case THIRD_QUARTILE = 23\n\n Objective-C \n\n kIMAAdEvent_THIRD_QUARTILE"]]
