DAI-videostreamverzoeken verifiëren

Verificatiesleutels voor dynamische advertentie-invoeging (DAI) worden gebruikt om aan te tonen dat videostreamverzoeken van u afkomstig zijn. Hiermee wordt een betere beveiliging geboden tijdens de advertentieweergave. Een sleutel is een ononderbroken tekenreeks van 64 tekens en cijfers. Sommige oudere sleutels kunnen 25 tekens of cijfers bevatten.

Voorbeeld

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Statische API-sleutels: API-sleutels hebben voorrang op HMAC als beide zijn opgenomen. API-sleutels zijn minder veilig dan HMAC-sleutels. Het gebruik van HMAC-sleutels wordt daarom aanbevolen.

HMAC: HMAC-gebaseerde tokenverificatie biedt meer beveiliging dan statische API-sleutels. HMAC-tokens gebruiken een geheime sleutel en een beperkte duur om ervoor te zorgen dat het token niet makkelijk kan worden gedeeld tussen gebruikers of sessies.

Tip: Zorg dat u het volgende heeft voordat u streamverzoeken verifieert:

• DAI-verificatiesleutel met het type HMAC
• Livestream ingesteld voor DAI

Een nieuwe HMAC DAI-verificatiesleutel toevoegen

Zo genereert u een nieuwe DAI-verificatiesleutel van het type HMAC en voegt u deze toe:

1. Log in bij Google Ad Manager.
2. Klik op Beheerder en dan op Video en audio.
3. Selecteer DAI-verificatiesleutels.
4. Klik op Nieuwe DAI-verificatiesleutel.
5. Voer de naam van de nieuwe sleutel in. Selecteer het type HMAC.
6. Klik op Opslaan.

Deze sleutel wordt aan uw livestream gekoppeld als u verificatie aanzet.

Verificatie aanzetten voor verzoeken naar DAI API's

Zo koppelt u uw HMAC-sleutel aan uw stream:

1. Log in bij Google Ad Manager.
2. Klik op Video en dan op Livestreams.
3. Selecteer uw livestream in de lijst of klik op Nieuwe livestream. Meer informatie over hoe u een nieuwe livestream maakt.
4. Onder Algemene instellingen:
   1. Selecteer Aan voor 'Verificatiesleutels voor podresource' om advertentiepodverzoeken te verifiëren en/of
   2. Selecteer Aan voor 'Verificatiesleutels voor maken van stream' om verzoeken voor streamingsessies te verifiëren.
5. Selecteer de HMAC-sleutel die u heeft gemaakt.
6. Klik op Opslaan.

Als u uw sleutel wilt bekijken en kopiëren, gaat u terug naar de detailpagina. Zodra u een actieve DAI-verificatiesleutel heeft gemaakt, kunt u deze meteen gebruiken. Sluit de sleutel in bij de video-app van de client, waar u DAI-streamverzoeken indient.

Tip: Een best practice is om afzonderlijke DAI-verificatiesleutels te maken voor elk van uw clientplatforms (bijvoorbeeld iOS, Android en Web).

Sleutels worden automatisch ingesteld op Actief nadat u op Opslaan heeft geklikt. Alleen goed geïmplementeerde actieve sleutels kunnen verzoeken valideren.

Verzoeken met gedeactiveerde sleutels worden geweigerd. Deactiveer een sleutel alleen als hier problemen mee zijn of als deze niet moet worden gebruikt.

Een bestaande verificatiesleutel deactiveren

Zo deactiveert u een verificatiesleutel:

1. Log in bij Google Ad Manager.
2. Klik op Beheerder, Video en audio en dan op DAI-verificatiesleutels.
3. Selecteer in de lijst de sleutel die u wilt deactiveren.
4. Selecteer de status Inactief.
5. Klik op Opslaan.

Een verificatiesleutel implementeren

HMAC-sleutels

Meer informatie over de implementatie van HMAC-verificatie.

API-sleutels

Gebruik de IMA-SDK om de apiKey-property voor het IMAStreamRequest-object in te stellen. Bekijk voor meer informatie de documentatie voor ontwikkelaars voor iOS, Android, Chromecast of tvOS.

Gebruik voor Server-Side Beaconing (SSB) de api-key-queryparameter:

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

Neem contact op met het supportteam voor uitgevers voor problemen met DAI-probleemoplossing of -uitval.