Companion banneradvertenties

Documentatie Primetime Primetime Programming Help

Last update: Thu Sep 21 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

TVSDK biedt ondersteuning voor banneradvertenties die bij een lineaire advertentie horen en die vaak op de pagina blijven staan nadat de lineaire advertentie is beëindigd. Uw toepassing is verantwoordelijk voor het weergeven van de bijbehorende banners die een lineaire advertentie hebben.

Volg deze aanbevelingen bij het weergeven van bijhorende advertenties:

Poging om zoveel van de banneradvertenties van een video-advertentie weer te geven als in de lay-out van de speler passen.

Een bijbehorende banner alleen presenteren als u een locatie hebt die exact overeenkomt met de opgegeven hoogte en breedte.

note tip
TIP
Wijzig de grootte van de banner niet.

Plaats de bijbehorende banner(s) zo snel mogelijk nadat de advertentie is gestart.
Bedek de hoofd-advertentie-/videoclip niet met bijbehorende banners.
Ga door met het weergeven van bijbehorende banners nadat de advertentie is beëindigd.

Standaard wordt elke bijbehorende banner weergegeven totdat u een nieuwe banner voor deze banner hebt.

De inhoud van een PTAdAsset beschrijft een bijbehorende banner.

De PTMediaPlayerAdStartedNotification melding retourneert een PTAd instantie die een companionAssets eigenschap (array van PtAdAsset).
Elk PtAdAsset biedt informatie over de weergave van het element.

Beschikbare informatie

Beschrijving

width

Breedte van de bijbehorende banner in pixels.

height

Hoogte van de bijbehorende banner in pixels.

brontype

Het middeltype voor deze metgezelbanner:

html: De gegevens staan in HTML-code.
iframe: de gegevens zijn een iframe-URL (src).
statisch: de gegevens zijn een staticURL die een directe URL naar een afbeelding is.

data

De gegevens van het type dat wordt opgegeven door resourceType voor deze gezelschapsbanner.

Als u banneradvertenties wilt weergeven, moet u bannerinstanties maken en TVSDK toestaan te luisteren naar gebeurtenissen met betrekking tot advertenties.

TVSDK biedt een lijst met banneradvertenties voor gezellen die via de PTMediaPlayerAdPlayStartedNotification notification-gebeurtenis.

Manifests kunnen banneradvertenties voor gezellen specificeren door:

Een HTML-fragment
De URL van een iFrame-pagina
De URL van een statisch of Adobe Flash-SWF-bestand

Voor elke bijbehorende advertentie geeft TVSDK aan welke typen beschikbaar zijn voor uw toepassing.

Een PTAdBannerView exemplaar voor elke metgezel en groef op uw pagina.

code language-none
`Ervoor zorgen dat de volgende informatie is verstrekt:`

Als u wilt voorkomen dat er naast elkaar geplaatste advertenties van verschillende grootten worden opgehaald, gebruikt u een bannerinstantie die de breedte en hoogte opgeeft.
Standaardbannergrootten.

Voeg een waarnemer toe voor de PTMediaPlayerAdStartedNotification dat doet het volgende:

Wist bestaande advertenties in de bannerinstantie.
Hiermee wordt de lijst met bijbehorende advertenties opgehaald van Ad.getCompanionAssets PTAd.companionAssets.
Doorloop de lijst voor bannerinstanties als de lijst met bijbehorende advertenties niet leeg is.

Elke bannerinstantie ( a PTAdAsset) bevat informatie, zoals breedte, hoogte, middeltype (html, iframe, of statisch), en gegevens die wordt vereist om de bijbehorende banner te tonen.
Als een video zonder bijbehorende advertenties is geboekt, bevat de lijst met bijbehorende elementen geen gegevens voor die video-advertentie.

Als u een standalone weergaveadvertentie wilt weergeven, voegt u de logica toe aan uw script om een normale DFP-advertentie (DoubleClick voor Publishers) in de juiste bannerinstantie uit te voeren.

Verzendt de bannergegevens naar een functie op de pagina die de banners op een geschikte locatie weergeeft.

Dit is meestal een diven uw functie gebruikt de div ID de banner weergeven. Bijvoorbeeld:

code language-none

code language-none
- (void) onMediaPlayerAdPlayStarted:(NSNotification ) notification { _currentAd = [notification.userInfo objectForKey:PTMediaPlayerAdKey]; if (_currentAd != nil) { [self removeAllBanners]; // remove any existing PTAdBannerView views // banners if (_currentAd.companionAssets && _currentAd.companionAssets.count > 0) { PTAdAsset bannerAsset = [_currentAd.companionAssets objectAtIndex:0]; PTAdBannerView *bannerView = [[PTAdBannerView alloc] initWithAsset:bannerAsset]; bannerView.player = self.player; bannerView.delegate = self; bannerView.frame = CGRectMake(0.0, 0.0, bannerAsset.width, bannerAsset.height); [_adBannerView.bannerView addSubview:bannerView]; } } }

- (void) onMediaPlayerAdPlayStarted:(NSNotification *) notification {
    _currentAd  = [notification.userInfo  objectForKey:PTMediaPlayerAdKey];
    if (_currentAd != nil) {
        [self removeAllBanners]; // remove any existing PTAdBannerView views

        // banners
        if (_currentAd.companionAssets && _currentAd.companionAssets.count > 0) {
            PTAdAsset *bannerAsset = [_currentAd.companionAssets objectAtIndex:0];

            PTAdBannerView *bannerView = [[PTAdBannerView alloc] initWithAsset:bannerAsset];
            bannerView.player = self.player;
            bannerView.delegate = self;

            bannerView.frame = CGRectMake(0.0, 0.0, bannerAsset.width, bannerAsset.height);
            [_adBannerView.bannerView addSubview:bannerView];
        }
    }
}

recommendation-more-help

284ef3b4-8c23-499c-bca9-676901b13689

Companion banneradvertenties companion-banner-ads

Bannergegevens van de onderneming companion-banner-data

banneradvertenties weergeven display-banner-ads