Skip to content

Commit 52e9685

Browse files
hillslatthillslatt
authored
Merge pull request #55 from InteractiveAdvertisingBureau/develop
AdCOM 1.0-2023 Release
2 parents b3cd1eb + da19817 commit 52e9685

File tree

1 file changed

+148
-64
lines changed

1 file changed

+148
-64
lines changed

‎AdCOM v1.0 FINAL.md‎

Lines changed: 148 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,7 @@ OpenRTB Specification the IAB Tech Lab is licensed under a Creative Commons Attr
8282
- [List: Agent Types](#list_agenttypes)
8383
- [List: API Frameworks](#list_apiframeworks)
8484
- [List: Audit Status Codes](#list_auditstatuscodes)
85+
- [List: Auto Refresh Triggers](#list_autorefreshtriggers)
8586
- [List: Category Taxonomies](#list_categorytaxonomies)
8687
- [List: Click Types](#list_clicktypes)
8788
- [List: Companion Types](#list_companiontypes)
@@ -95,7 +96,7 @@ OpenRTB Specification the IAB Tech Lab is licensed under a Creative Commons Attr
9596
- [List: Display Context Types](#list_displaycontexttypes)
9697
- [List: Display Placement Types](#list_displayplacementtypes)
9798
- [List: DOOH Multiplier Measurement Source Types](#list_doohmultipliermeasurementmourcetypes)
98-
- [List: DOOH Venue Taxonomies](#list_venuetaxonomies)
99+
- [List: DOOH Venue Taxonomies](#list_doohvenuetaxonomies)
99100
- [List: DOOH Venue Types (deprecated)](#list_doohvenuetypes)
100101
- [List: Event Tracking Methods](#list_eventtrackingmethods)
101102
- [List: Event Types](#list_eventtypes)
@@ -110,15 +111,16 @@ OpenRTB Specification the IAB Tech Lab is licensed under a Creative Commons Attr
110111
- [List: Operating Systems](#list_operatingsystems)
111112
- [List: Placement Positions](#list_placementpositions)
112113
- [List: Placement Subtypes - Video](#list_placementsubtypesvideo)
114+
- [List: Plcmt Subtypes - Video](#list_plcmtsubtypesvideo)
113115
- [List: Playback Cessation Modes](#list_playbackcessationmodes)
114116
- [List: Playback Methods](#list_playbackmethods)
117+
- [List: Pod Sequence](#list_podsequence)
115118
- [List: Production Qualities](#list_productionqualities)
116119
- [List: Size Units](#list_sizeunits)
120+
- [List: Slot Position in Pod](#list_slotpositioninpod)
117121
- [List: Start Delay Modes](#list_startdelaymodes)
118122
- [List: User-Agent Source](#user-agent_source)
119123
- [List: Volume Normalization Modes](#list_volumenormalizationmodes)
120-
- [List: Slot Position in Pod](#list_slotpositioninpod)
121-
- [List: Pod Sequence](#list_podsequence)
122124
- [Appendix A: Additional Resources](#appendixa_additionalresources)
123125
- [Appendix B: Change Log](#appendixb_changelog)
124126
- [Appendix C: OpenRTB Interfaces](#appendixc_openrtbinterfaces)
@@ -1369,7 +1371,7 @@ This object signals that the placement may be a video placement and provides add
13691371
<tr>
13701372
<td><code>ptype</code></td>
13711373
<td>integer</td>
1372-
<td>Placement subtype. Refer to <a href="#list_placementsubtypesvideo">List: Placement Subtypes - Video</a>.</td>
1374+
<td>Placement subtype. Refer to <a href="#list_plcmtsubtypesvideo">List: Plcmt Subtypes - Video</a>.</td>
13731375
</tr>
13741376
<tr>
13751377
<td><code>pos</code></td>
@@ -2973,7 +2975,6 @@ The following table is a list of API frameworks either supported by a placement
29732975
</tr>
29742976
</table>
29752977

2976-
29772978
### List: Audit Status Codes <a name="list_auditstatuscodes"></a>
29782979

29792980
The following table lists the codes used in `Audit` objects to reflect status or workflow state.
@@ -3013,6 +3014,33 @@ The following table lists the codes used in `Audit` objects to reflect status or
30133014
</tr>
30143015
</table>
30153016

3017+
### List: Auto Refresh Triggers <a name="list_autorefreshtriggers"></a>
3018+
3019+
The following table is a list of triggers that result in an ad slot refreshing.
3020+
3021+
<table>
3022+
<tr>
3023+
<td><strong>Value</strong></td>
3024+
<td><strong>Definition</strong></td>
3025+
</tr>
3026+
<tr>
3027+
<td>0</td>
3028+
<td>UNKNOWN</td>
3029+
</tr>
3030+
<tr>
3031+
<td>1</td>
3032+
<td><strong>User Action:</strong> Refresh triggered by user-initiated action such as scrolling.
3033+
</td>
3034+
</tr>
3035+
<tr>
3036+
<td>2</td>
3037+
<td><strong>Event:</strong> Event-driven content change. For example, ads refresh when the football game score changes on the page.</td>
3038+
</tr>
3039+
<tr>
3040+
<td>3</td>
3041+
<td><strong>Time:</strong>Time-based refresh. Ads refresh on a predefined time interval even without user activity.</td>
3042+
</tr>
3043+
</table>
30163044

30173045
### List: Category Taxonomies <a name="list_categorytaxonomies"></a>
30183046

@@ -3026,7 +3054,7 @@ The following table lists the options for taxonomies that can be used to describ
30263054
</tr>
30273055
<tr>
30283056
<td>1</td>
3029-
<td>IAB Tech Lab Content Category Taxonomy 1.0. - Deprecated, and recommend NOT be used since it does not have SCD flags. </td>
3057+
<td>IAB Tech Lab Content Category Taxonomy 1.0: Deprecated, and recommend NOT be used since it does not have SCD flags. </td>
30303058
</tr>
30313059
<tr>
30323060
<td>2</td>
@@ -3048,7 +3076,11 @@ The following table lists the options for taxonomies that can be used to describ
30483076
<td>6</td>
30493077
<td><a href="https://iabtechlab.com/standards/content-taxonomy/">IAB Tech Lab Content Taxonomy 2.2</a></td>
30503078
</tr>
3051-
3079+
</tr>
3080+
<tr>
3081+
<td>7</td>
3082+
<td><a href="https://iabtechlab.com/standards/content-taxonomy/">IAB Tech Lab Content Taxonomy 3.0</a></td>
3083+
</tr>
30523084
<tr>
30533085
<td>500+</td>
30543086
<td>Vendor-specific codes.</td>
@@ -3949,24 +3981,53 @@ The following table lists the directions in which an expandable ad may expand, g
39493981

39503982
### List: Feed Types <a name="list_feedtypes"></a>
39513983

3952-
The following table lists the types of feeds, typically for audio.
3984+
The following table lists the types of feeds for audio.
39533985

39543986
<table>
39553987
<tr>
39563988
<td><strong>Value</strong></td>
3989+
<td><strong>Class</strong></td>
39573990
<td><strong>Definition</strong></td>
39583991
</tr>
39593992
<tr>
39603993
<td>1</td>
3961-
<td>Music Service</td>
3994+
<td>AOD</td>
3995+
<td>Music streaming service</td>
39623996
</tr>
39633997
<tr>
39643998
<td>2</td>
3965-
<td>FM/AM Broadcast</td>
3999+
<td>LIVE</td>
4000+
<td>FM/AM broadcast (live content broadcast over the air but also available via online streaming)</td>
39664001
</tr>
39674002
<tr>
39684003
<td>3</td>
3969-
<td>Podcast</td>
4004+
<td>AOD</td>
4005+
<td>Podcast (original, pre-recorded content distributed as episodes in a series)</td>
4006+
</tr>
4007+
<tr>
4008+
<td>4</td>
4009+
<td>AOD</td>
4010+
<td>Catch-up radio (recorded segment of a radio show that was originally broadcast live)</td>
4011+
</tr>
4012+
<tr>
4013+
<td>5</td>
4014+
<td>LIVE</td>
4015+
<td>Web radio (live content only available via online streaming, not as AM/FM broadcast)</td>
4016+
</tr>
4017+
<tr>
4018+
<td>6</td>
4019+
<td>MISC</td>
4020+
<td>Video game (background audio in video games)</td>
4021+
</tr>
4022+
<tr>
4023+
<td>7</td>
4024+
<td>MISC</td>
4025+
<td>Text to speech (audio books, website plugin that can read article)</td>
4026+
</tr>
4027+
<tr>
4028+
<td>500+</td>
4029+
<td>MISC</td>
4030+
<td>Vendor-specific codes.</td>
39704031
</tr>
39714032
</table>
39724033

@@ -4337,7 +4398,7 @@ The following table lists the placement positions as a relative measure of visib
43374398

43384399
### List: Placement Subtypes - Video <a name="list_placementsubtypesvideo"></a>
43394400

4340-
The following table lists the various types of video placements derived largely from the IAB Digital Video Guidelines.
4401+
The following table lists the various types of video placements derived largely from the IAB Digital Video Guidelines. To be sent using <code>placement</code> attribute in <strong>Object:Video</strong>. DEPRECATED AS OF 2.6-202303 RELEASE. Proposed removal of this list and associated attribute in 2024.
43414402

43424403
<table>
43434404
<tr>
@@ -4364,6 +4425,32 @@ The following table lists the various types of video placements derived largely
43644425
<td>5</td>
43654426
<td><strong>Interstitial/Slider/Floating:</strong> Covers the entire or a portion of screen area, but is always on screen while displayed (i.e. cannot be scrolled out of view).</td>
43664427
</tr>
4428+
<tr>
4429+
</table>
4430+
4431+
### List: Plcmt Subtypes - Video <a name="list_plcmtsubtypesvideo"></a>
4432+
The following table lists the various types of video placements in accordance with updated IAB Digital Video Guidelines. To be sent using <code>plcmt</code> attribute in <strong>Object:Video</strong>. Please refer to the <a href=https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/develop/implementation.md#710---updated-in-stream-values>implementation guide</a> for examples and information on how to use the updated signals.
4433+
<table>
4434+
<tr>
4435+
<td><strong>Value</strong></td>
4436+
<td><strong>Definition</strong></td>
4437+
</tr>
4438+
<tr>
4439+
<td>1</td>
4440+
<td><strong>Instream:</strong> Pre-roll, mid-roll, and post-roll ads that are played before, during or after the streaming video content that the consumer has requested. Instream video must be set to “sound on” by default at player start, or have explicitly clear user intent to watch the video content. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view capable of audio when playing. If the player converts to floating/sticky subsequent ad calls should accurately convey the updated player size.</td>
4441+
</tr>
4442+
<tr>
4443+
<td>2</td>
4444+
<td><strong>Accompanying Content:</strong> Pre-roll, mid-roll, and post-roll ads that are played before, during, or after streaming video content. The video player loads and plays before, between, or after paragraphs of text or graphical content, and starts playing only when it enters the viewport. Accompanying content should only start playback upon entering the viewport. It may convert to a floating/sticky player as it scrolls off the page.</td>
4445+
</tr>
4446+
<tr>
4447+
<td>3</td>
4448+
<td><strong>Interstitial:</strong>Video ads that are played without video content. During playback, it must be the primary focus of the page and take up the majority of the viewport and cannot be scrolled out of view. This can be in placements like in-app video or slideshows. </td>
4449+
</tr>
4450+
<tr>
4451+
<td>4</td>
4452+
<td><strong>No Content/Standalone:</strong> Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating.</td>
4453+
</tr>
43674454
</table>
43684455

43694456

@@ -4430,6 +4517,28 @@ The following table lists the various media playback methods.
44304517
</tr>
44314518
</table>
44324519

4520+
### List: Pod Sequence <a name="list_podsequence"></a>
4521+
4522+
The following table lists the values for the pod sequence field, for use in audio and video content streams with one or more ad pods.
4523+
4524+
<table>
4525+
<tr>
4526+
<td><strong>Value</strong></td>
4527+
<td><strong>Definition</strong></td>
4528+
</tr>
4529+
<tr>
4530+
<td>-1</td>
4531+
<td>Last pod in the content stream</td>
4532+
</tr>
4533+
<tr>
4534+
<td>0</td>
4535+
<td>Any pod in the content stream</td>
4536+
</tr>
4537+
<tr>
4538+
<td>1</td>
4539+
<td>First pod in the content stream</td>
4540+
</tr>
4541+
</table>
44334542

44344543
### List: Production Qualities <a name="list_productionqualities"></a>
44354544

@@ -4482,6 +4591,33 @@ The following table lists the units of height and width used by creatives, asset
44824591
</tr>
44834592
</table>
44844593

4594+
### List: Slot Position in Pod <a name="list_slotpositioninpod"></a>
4595+
4596+
The following table lists the values for the slot position in pod field, for use in audio and video ad pods.
4597+
4598+
<table>
4599+
<tr>
4600+
<td><strong>Value</strong></td>
4601+
<td><strong>Definition</strong></td>
4602+
</tr>
4603+
<tr>
4604+
<td>-1</td>
4605+
<td>Last ad in the pod</td>
4606+
</tr>
4607+
<tr>
4608+
<td>0</td>
4609+
<td>Any ad in the pod</td>
4610+
</tr>
4611+
<tr>
4612+
<td>1</td>
4613+
<td>First ad in the pod</td>
4614+
</tr>
4615+
<tr>
4616+
<td>2</td>
4617+
<td>First or Last ad in the pod</td>
4618+
</tr>
4619+
</table>
4620+
44854621

44864622
### List: Start Delay Modes <a name="list_startdelaymodes"></a>
44874623

@@ -4570,58 +4706,6 @@ The following table lists the types of volume normalization modes, typically for
45704706
</table>
45714707

45724708

4573-
### List: Slot Position in Pod <a name="list_slotpositioninpod"></a>
4574-
4575-
The following table lists the values for the slot position in pod field, for use in audio and video ad pods.
4576-
4577-
<table>
4578-
<tr>
4579-
<td><strong>Value</strong></td>
4580-
<td><strong>Definition</strong></td>
4581-
</tr>
4582-
<tr>
4583-
<td>-1</td>
4584-
<td>Last ad in the pod</td>
4585-
</tr>
4586-
<tr>
4587-
<td>0</td>
4588-
<td>Any ad in the pod</td>
4589-
</tr>
4590-
<tr>
4591-
<td>1</td>
4592-
<td>First ad in the pod</td>
4593-
</tr>
4594-
<tr>
4595-
<td>2</td>
4596-
<td>First or Last ad in the pod</td>
4597-
</tr>
4598-
</table>
4599-
4600-
4601-
### List: Pod Sequence <a name="list_podsequence"></a>
4602-
4603-
The following table lists the values for the pod sequence field, for use in audio and video content streams with one or more ad pods.
4604-
4605-
<table>
4606-
<tr>
4607-
<td><strong>Value</strong></td>
4608-
<td><strong>Definition</strong></td>
4609-
</tr>
4610-
<tr>
4611-
<td>-1</td>
4612-
<td>Last pod in the content stream</td>
4613-
</tr>
4614-
<tr>
4615-
<td>0</td>
4616-
<td>Any pod in the content stream</td>
4617-
</tr>
4618-
<tr>
4619-
<td>1</td>
4620-
<td>First pod in the content stream</td>
4621-
</tr>
4622-
</table>
4623-
4624-
46254709
# Appendix A: Additional Resources <a name="appendixa_additionalresources"></a>
46264710

46274711
Interactive Advertising Bureau Technology Laboratory (IAB Tech Lab)

0 commit comments

Comments
 (0)