Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

(New):Nr 322277 media streaming #19620

Open
wants to merge 91 commits into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
91 commits
Select commit Hold shift + click to select a range
04a11ab
Streaming video & Ads name change and minor updates
adutta-newrelic Dec 16, 2024
737c753
updates
adutta-newrelic Dec 16, 2024
c70b9e6
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 16, 2024
64709a6
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 17, 2024
4ca26c8
Updates
adutta-newrelic Dec 17, 2024
1b651a6
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 18, 2024
62e8948
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 18, 2024
06df65e
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 19, 2024
65ced98
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 19, 2024
87083be
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 20, 2024
6476a74
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 23, 2024
1130eec
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 23, 2024
54c6ec8
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 24, 2024
e21cf68
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 24, 2024
440d9ee
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 27, 2024
bbd7f3b
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Dec 30, 2024
aee9898
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 2, 2025
2afbc92
Media Streaming updates
adutta-newrelic Jan 2, 2025
731fa03
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 2, 2025
918a338
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 3, 2025
603dea3
Updates
adutta-newrelic Jan 3, 2025
ee24638
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 6, 2025
00b9db5
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 8, 2025
130166d
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 9, 2025
4079764
branching of docs
adutta-newrelic Jan 9, 2025
ad32fef
Updated the path from aws-logs to browser-media
adutta-newrelic Jan 9, 2025
7c55833
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 10, 2025
438cca6
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 13, 2025
b9987ad
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 16, 2025
5dafd7f
Updates
adutta-newrelic Jan 16, 2025
76ca3f3
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 16, 2025
2b0afb9
Updates
adutta-newrelic Jan 17, 2025
bc82f49
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 20, 2025
374ca16
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 20, 2025
dcc2959
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 21, 2025
2937c59
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 22, 2025
18cc065
Create appInfo_EU1.mdx
adutta-newrelic Jan 22, 2025
56c7e53
Updates
adutta-newrelic Jan 22, 2025
22e3cf6
Updates
adutta-newrelic Jan 22, 2025
9a0cb53
Added content
adutta-newrelic Jan 22, 2025
0e4aa2a
Updates to the branched document
adutta-newrelic Jan 22, 2025
3c8d481
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 22, 2025
3420b3f
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 23, 2025
d76ae8e
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 23, 2025
8cee93f
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 23, 2025
d1ba9ad
Updates to the browser media
adutta-newrelic Jan 23, 2025
5118655
Updates
adutta-newrelic Jan 24, 2025
a30566f
Updates
adutta-newrelic Jan 24, 2025
97830f8
Updates
adutta-newrelic Jan 24, 2025
bf4e9e1
Updates
adutta-newrelic Jan 24, 2025
8bf158e
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 24, 2025
8786ded
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 24, 2025
acfde82
Updates
adutta-newrelic Jan 24, 2025
a77ee5d
Updates to the browser agent
adutta-newrelic Jan 24, 2025
ab12d62
Updates
adutta-newrelic Jan 24, 2025
2ef85ed
Updates
adutta-newrelic Jan 24, 2025
652d5d2
updates
adutta-newrelic Jan 24, 2025
1263e48
Updates
adutta-newrelic Jan 26, 2025
ec75e0c
updates
adutta-newrelic Jan 26, 2025
79780c9
updates
adutta-newrelic Jan 26, 2025
25cd6f0
Updates to the android installation steps
adutta-newrelic Jan 26, 2025
54417e7
Updates to the iOS page
adutta-newrelic Jan 26, 2025
5d23be3
Updates to the iOS agent
adutta-newrelic Jan 27, 2025
b39752c
Updated the Ios names
adutta-newrelic Jan 27, 2025
be5aafd
updates
adutta-newrelic Jan 27, 2025
854c9db
Updates
adutta-newrelic Jan 27, 2025
bc2322c
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 28, 2025
9e255ab
updates
adutta-newrelic Jan 28, 2025
36b938b
Updates
adutta-newrelic Jan 28, 2025
1cacbd3
updates
adutta-newrelic Jan 28, 2025
c628a20
updates
adutta-newrelic Jan 28, 2025
3071702
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 28, 2025
fa09826
updates
adutta-newrelic Jan 28, 2025
c4d95bf
updated the indentation
adutta-newrelic Jan 28, 2025
24eee89
Updates to the browser application
adutta-newrelic Jan 29, 2025
1498924
updates'
adutta-newrelic Jan 29, 2025
842c749
updates'
adutta-newrelic Jan 29, 2025
5fe92c1
updated the name
adutta-newrelic Jan 29, 2025
269d2ff
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 29, 2025
10c1e0b
Merge branch 'develop' into NR-322277-media-streaming
adutta-newrelic Jan 29, 2025
990034c
Updates to the browser agent
adutta-newrelic Jan 29, 2025
f6b4ca6
updates
adutta-newrelic Jan 29, 2025
b7266d9
updates
adutta-newrelic Jan 29, 2025
938234b
updates to the Android page
adutta-newrelic Jan 29, 2025
42c572b
updates
adutta-newrelic Jan 29, 2025
263f8e1
updates to ios
adutta-newrelic Jan 29, 2025
f2d9d69
updates to ios
adutta-newrelic Jan 29, 2025
47ef5d9
updates
adutta-newrelic Jan 30, 2025
be323b6
Updates
adutta-newrelic Jan 30, 2025
f45074b
updates to the release notes
adutta-newrelic Jan 30, 2025
7848c06
updates
adutta-newrelic Jan 30, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ There are four ways to install the browser agent. Depending on your specific nee
</TabsBarItem>

<TabsBarItem id="2">
Install via APM
Install with APM
</TabsBarItem>

<TabsBarItem id="3">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ redirects:
- /docs/browser/new-relic-browser/getting-started/compatibility-requirements-new-relic-browser
- /docs/browser/single-page-app-monitoring/get-started/spa-compatibility-requirements
- /docs/browser/single-page-app-monitoring/spa-compatibility-requirements
- /docs/streaming-video-&-ads/installation/browser/browser-agent-compatibility-requirements
freshnessValidatedDate: never
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -69,8 +69,7 @@ We use these methods to collect the page load timing information:

<td>
For browsers that do not implement the Navigation Timing Specification API, we rely on the [NREUM cookie](/docs/browser/new-relic-browser/miscellaneous/new-relic-cookies#nreum) and the browser agent to collect timing information.
<Callout variant="important">For browser agent version 1220 and higher, [usage of session cookies has been deprecated](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1220/#removed-3rd-party-cookies), so this information is only relevant if you're using browser agent version 1216 and lower.
</Callout>
<Callout variant="important">For browser agent version 1220 and higher, [usage of session cookies has been deprecated](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/browser-agent-v1220/#removed-3rd-party-cookies), so this information is only relevant if you're using browser agent version 1216 and lower.</Callout>
</td>
</tr>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ tags:
translate:
- jp
metaDescription: 'Compatible build systems, OS versions, and more for the Android agent.'
redirects:
- /docs/streaming-video-&-ads/installation/mobile/android/android-compatibility-and-requirement
freshnessValidatedDate: never
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ tags:
metaDescription: 'Troubleshooting tips if no data appears in the mobile monitoring UI after you install, configure, and generate traffic for your Android app.'
redirects:
- /docs/mobile-monitoring/new-relic-mobile/troubleshoot/no-data-appears-android
- docs/streaming-video-&-ads/installation/mobile/android/troubleshooting/no-data-appears-android
freshnessValidatedDate: never
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ tags:
- New Relic Mobile iOS
- Get started
metaDescription: 'Before installing the iOS agent, review these requirements.'
redirects:
- /docs/streaming-video-&-ads/installation/mobile/ios/ios-compatibility-requirements
freshnessValidatedDate: never
---

Expand Down
1 change: 1 addition & 0 deletions src/content/docs/release-notes/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -174,6 +174,7 @@ To take full advantage of New Relic's latest features, enhancements, and importa
icon="logo-newrelic"
to="/docs/release-notes/service-levels-release-notes"
/>

<TechTile
name="AWS Lambda"
icon="logo-newrelic"
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
subject: Streaming Video & Ads
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
subject: Media agent for Browser
---
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
---
title: Get started with Streaming Video & Ads
metaDescription: Monitor and optimize video and ad streaming performance with intelligent insights into quality of experience metrics.
freshnessValidatedDate: never
---

<SideBySide>
<Side>
In today's competitive media landscape, optimizing your viewing experience is crucial for success. Our <InlinePopover type="Streaming Video & Ads"/> suite provides media and entertainment companies with the tools and insights needed to enhance your media capabilities. Seamlessly integrated into the New Relic UI, this suite enables you to:

* Monitor video and ad performance.
* Analyze video and ad errors.
* Gain insights into user sessions.

By leveraging these features, you can enhance quality of experience(QOE), maximize viewer engagement and minimize churn with full stack visibility for the entire media distribution pipeline.

<ButtonGroup>
<ButtonLink
role="button"
to="https://newrelic.com/signup"
variant="primary"
>
Sign up
</ButtonLink>

<ButtonLink
role="button"
to="https://onenr.io/0BQ127zqMwx"
variant="primary"
>
Install Streaming Video & Ads
</ButtonLink>

<ButtonLink
role="button"
to="https://docs.newrelic.com/docs/streaming-video-&-ads/installation/install-the-streaming-video-&-ads-agent/#install-the-media-streaming-agent"
variant="primary"
>
Installation options
</ButtonLink>
</ButtonGroup>
</Side>

<Side>
<img
title="Visualizing data"
alt="A screenshot of data visualization using browser monitoring"
src="/images/browser_screenshot-crop_data-visualize.webp"
/>
</Side>
</SideBySide>

<SideBySide>
<Side>
<img
title="Real User Monitoring with New Relic"
alt="An image showing the distributed tracing feature"
src="/images/browser_screenshot-crop_distributed-tracing.webp"
/>
</Side>

<Side>
## Key Benefits

* **Deliver exceptional Quality of Experience (QoE) for video/ads**: Ensure high-quality viewing by analyzing video/ad reliability, engagement, and quality metrics.
* **Maximize viewer engagement**: Track video/ad completion rates and concurrent view trends to enhance viewer engagement.
* **Faster troubleshooting with full-stack visibility**: Correlate data across your entire stack to quickly identify and resolve video/ad distribution issues.
* **Optimize user experience**: Visualize individual user sessions to pinpoint and address video playback issues that impact viewer satisfaction.
</Side>
</SideBySide>

<SideBySide>
<Side>
## Pricing structure

* The Streaming Video & Ads is a part of New Relic Advanced Compute offering. It is billable based on viewer minutes monitored, providing a scalable solution tailored to your audience size. The Streaming Video & Ads pricing starts at $0.60 per 16,308 minutes. **(To be confirmed)**

* For how to find usage and billing information in the UI, see [Billing UI](docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/).

* For further details on pricing, please contact our sales team.
</Side>
</SideBySide>

Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: Browser agent release and support dates
metaDescription: Policies, start and end dates for support of New Relic browser monitoring agent releases.
freshnessValidatedDate: never
---

The following are the specific policies and dates for support of our <InlinePopover type="browser"/> agent. See our documentation about [general EOL policies](/docs/licenses/end-of-life/notification-changes-new-relic-saas-features-distributed-software/) for information about New Relic's overall end-of-life policy.

## New Relic browser agent releases and support dates [#browser-eol]

Any versions not listed in the following table are no longer supported. Please [update your browser monitoring agent version](/docs/browser/new-relic-browser/installation/update-browser-agent) to the [latest release](/docs/release-notes/new-relic-browser-release-notes/browser-agent-release-notes/).

<table>
<thead>
<tr>
<th>
[Browser agent release](https://github.com/newrelic/newrelic-browser-agent/releases)
</th>

<th>
Start date
</th>

<th>
End date
</th>
</tr>
</thead>

<EolPage agent="browser"/>
</table>

## Browser runtimes [#browser-runtimes]

For support of browser runtimes, New Relic follows [general EOL policies](/docs/licenses/end-of-life/notification-changes-new-relic-saas-features-distributed-software/) for major browsers.
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: Install the Streaming Video & Ads agent
metaDescription: 'Use the New Relic Streaming Video & Ads solution to gain deep visibility and actionable insights into real user experiences.'
freshnessValidatedDate: never
---

Maintain consistent video quality across all regions, devices, and platforms by troubleshooting issues such as playback errors, poor quality, and rebuffering. Empower your team with the tools and insights needed to enhance Streaming Video and Ads capabilities. Integration with the New Relic UI allows for proactive alerts of potential issues, ensuring they are addressed before impacting the viewer experience.

## Prerequisites [#requirements]

Before you install the media agent, ensure you have a New Relic [account ID](/docs/accounts/accounts-billing/account-setup/account-id).

## Install the media agent [#installation]

To get started with Streaming Video & Ads, add our media agent to the type of app you want to monitor.

<Steps>

<Step>
Go to <DNT>**[one.newrelic.com](https://one.newrelic.com) > Integrations & Agents > Streaming Video & Ads**</DNT>.
</Step>

<Step>
## Select an account [#select-account]

Select an account you would like to work with from the dropdown and click **Continue**.
</Step>

<Step>
## Select streaming app type[#select-streaming-app-type]

Select the type of app you would like to monitor:

* [Browser](/install/browser-media): Monitor video players in your browser applications. Benefit from enhanced playback quality, error detection, and cross-browser compatibility.
* [Mobile](/docs/streaming-video-&-ads/installation/mobile/get-started/): Monitor video players in your mobile applications. Optimize streaming for iOS and Android devices, manage resources efficiently, and ensure seamless integration.
* [Roku](/docs/streaming-video-&-ads/installation/roku/get-started-with-roku): Monitor video players in your Roku applications. Enhance streaming quality, ensure a consistent user experience, and improve ad delivery.
</Step>

</Steps>
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
---
title: Ad tracking for Roku applications
tags:
translate:
metaDescription: 'Learn how to track ad events in Roku applications using the New Relic Roku Agent.'
redirects:
freshnessValidatedDate: never
---

The Roku Video Agent provides ad event monitoring through two different Ad APIs:

* [Roku Advertising Framework (RAF)](https://developer.roku.com/en-gb/docs/developer-program/advertising/roku-advertising-framework.md)
* [Google IMA](https://developers.google.com/ad-manager/dynamic-ad-insertion/sdk/roku)

## Install Roku Advertising Framework (RAF)

For RAF, no additional steps are required as the tracker is integrated within the NRAgent.

## Install Google IMA

For IMA, the following files must be included in the project:

```
components/NewRelicAgent/trackers
IMATracker.brs
IMATracker.xml
source/
IMATrackerInterface.brs
```

## Usage

### RAF Usage

Pass the NRAgent object (created with the call to `NewRelic(accountId, apiKey)`) to the Ads task using a field. Inside the Ads task, perform the following:

```brightscript
adIface = Roku_Ads()

' Ad Iface setup code...

logFunc = Function(obj = Invalid as Dynamic, evtType = invalid as Dynamic, ctx = invalid as Dynamic)
' Call RAF tracker, passing the event and context
nrTrackRAF(obj, evtType, ctx)
End Function

' m.top.nr is the reference to the field where we have the NRAgent object
adIface.setTrackingCallback(logFunc, m.top.nr)
```

For a complete usage example, check out the files `VideoScene.brs` (function `setupVideoWithAds()`) and `AdsTask.brs` in the present repo.

### IMA Usage

<Steps>

<Step>
Create the IMA Tracker object:

```brightscript
tracker = IMATracker(m.nr)
```

Where `m.nr` is the NRAgent object.

</Step>

<Step>

Pass the tracker object to the IMA SDK Task using a field and include the script `IMATrackerInterface.brs` in the task XML. Inside the task, perform the following:

```brightscript
m.player.adBreakStarted = Function(adBreakInfo as Object)
' Ad break start code...

' Send AD_BREAK_START
nrSendIMAAdBreakStart(m.top.tracker, adBreakInfo)
End Function

m.player.adBreakEnded = Function(adBreakInfo as Object)
' Ad break end code...

' Send AD_BREAK_END
nrSendIMAAdBreakEnd(m.top.tracker, adBreakInfo)
End Function

' ...

m.streamManager.addEventListener(m.sdk.AdEvent.START, startCallback)
m.streamManager.addEventListener(m.sdk.AdEvent.FIRST_QUARTILE, firstQuartileCallback)
m.streamManager.addEventListener(m.sdk.AdEvent.MIDPOINT, midpointCallback)
m.streamManager.addEventListener(m.sdk.AdEvent.THIRD_QUARTILE, thirdQuartileCallback)
m.streamManager.addEventListener(m.sdk.AdEvent.COMPLETE, completeCallback)

Function startCallback(ad as Object) as Void
' Send AD_START
nrSendIMAAdStart(m.top.tracker, ad)
End Function

Function firstQuartileCallback(ad as Object) as Void
' Send AD_QUARTILE (first)
nrSendIMAAdFirstQuartile(m.top.tracker, ad)
End Function

Function midpointCallback(ad as Object) as Void
' Send AD_QUARTILE (midpoint)
nrSendIMAAdMidpoint(m.top.tracker, ad)
End Function

Function thirdQuartileCallback(ad as Object) as Void
' Send AD_QUARTILE (third)
nrSendIMAAdThirdQuartile(m.top.tracker, ad)
End Function

Function completeCallback(ad as Object) as Void
' Send AD_END
nrSendIMAAdEnd(m.top.tracker, ad)
End Function
```

Where `m.top.tracker` is the tracker object passed to the task.

</Step>

</Steps>

For a complete usage example, check out the files `VideoScene.brs` (function `setupVideoWithIMA()`) and `imasdk.brs` in the present repo.
Loading
Loading