Als u de SDK voor mobiele advertenties van Google wilt gebruiken, moet u de app-ID, de advertentieblok-ID's en advertentieformaten verzamelen voor uw ontwikkelaar.
De app-ID's voor mobiele advertenties van Google zoeken
- Log in bij Google Ad Manager.
- Klik op Voorraad Apps.
- Zoek de mobiele app waarvoor u de ID nodig heeft of claim een nieuwe mobiele app.
- Klik op om de app-ID naar uw klembord te kopiëren. Voorbeeld:
ca-app-pub-3940256099942544~3347511713
- Stuur deze informatie naar uw ontwikkelaar.
ID's en formaten van advertentieblokken zoeken
- Klik op Voorraad Advertentieblokken.
- Klik op de naam van het advertentieblok waarvoor u een advertentietag wilt maken of maak een nieuw advertentieblok.
- Klik op Tags.
- Selecteer het tagtype 'Tag voor mobiele app' en klik op Doorgaan.
- Kopieer vanuit Tagresultaten de 'ID van advertentieblok' en Advertentieblokformaten. Stuur deze informatie naar uw ontwikkelaar.
Aanvullende JavaScript-functies
Bekijk de documentatie voor ontwikkelaars als u optimaal gebruik wilt maken van de functionaliteit van de SDK voor mobiele advertenties van Google.
Hier volgen enkele uitgelichte functies om het gedeelte <head>
van het advertentiemateriaal aan te passen.
Alles uitvouwen Alles samenvouwen
De SDK biedt toegang tot de functionaliteit van de in-app-browsers die beschikbaar zijn op iOS- en Android-apparaten. Zo kunnen ontwikkelaars via HTLM5 toegang krijgen tot de apparaatfunctionaliteit, zoals de versnellingsmeter, gyroscoop en het kompas (als het platform dit ondersteunt).
Met app-gebeurtenissen kunt u aangepaste code uitvoeren in uw app als het advertentiemateriaal een app-gebeurtenis verstuurt. Met app-gebeurtenissen kunt u aangepaste advertentieweergaven introduceren die gebruikmaken van de app, zoals de achtergrondkleur van de app wijzigen.
Als u merkt dat uw advertentie op volledige schermgrootte slechts op een gedeelte van het scherm wordt weergegeven, neemt u de volgende code op in het gedeelte <head>
van het advertentiemateriaal:
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no"/>
.
Deze template is een banneradvertentieblok dat begint als banner onderaan het scherm. Als een gebruiker op de banner klikt, maakt zijn standaard agenda-applicatie een nieuwe gebeurtenis met zijn toestemming.
Gedrag en UI-elementen
Het advertentiemateriaal bevat de volgende UI-elementen:
- De bannerafbeelding en de hoogte en breedte daarvan.
- Informatie over de gebeurtenis is vereist, zoals de samenvatting, beschrijving, locatie, start- en einddatum.
Naam | Type | Verplicht | Beschrijving |
---|---|---|---|
Afbeeldingsbestand van banner | Bestand | Ja | Afbeelding van de banneradvertentie. |
Afbeeldingsbreedte van banner | Getal | Ja | Breedte van de bannerafbeelding. |
Afbeeldingshoogte van banner | Getal | Ja | Hoogte van de bannerafbeelding. |
Samenvatting van gebeurtenis | Tekst | Ja | Samenvatting van de gebeurtenis. |
Beschrijving gebeurtenis | Tekst | Ja | Beschrijving van de gebeurtenis. |
Locatie gebeurtenis | Tekst | Nee | Locatie van de gebeurtenis. |
Startdatum gebeurtenis | Tekst | Ja | De startdatum van de gebeurtenis. De startdatum moet de volgende indeling hebben: '2016-10-22T00:00-05:00'. Dit is bijvoorbeeld 22 oktober 2016 van 0:00 tot 05:00 uur. |
Einddatum gebeurtenis | Tekst | Ja | De einddatum van de gebeurtenis. De einddatum moet de volgende indeling hebben: '2016-10-22T00:00-05:00'. Dit is bijvoorbeeld 22 oktober 2016 van 0:00 tot 05:00 uur. |
<html>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0"/>
<head>
<script type="text/javascript" src="mraid.js"></script>
</head>
<body>
<div id="normal" style="display:none; margin:auto;top:0px;text-align:center">
<a href="#" onClick="addToCalendar()"; return false;>
<img width="[%BannerImageWidth%]" height="[%BannerImageHeight%]" src="[%BannerImageFile%]" />
</a>
</div>
<script>
// Check whether mraid is ready by adding event listener
function doReadyCheck(){
if(mraid.getState() == 'loading'){
mraid.addEventListener("ready", mraidIsReady);
}else{
showMyAd();
}
}
// Once mraid is ready, it does not need to listen to the ready event anymore
function mraidIsReady(){
mraid.removeEventListener("ready", mraidIsReady);
showMyAd();
}
// Only show Ad when mraid is ready
function showMyAd(){
var advertElement = document.getElementById("normal");
advertElement.style.display = 'block';
}
// Add event to the calendar using appropriate input if the device supports calendar manipulation
function addToCalendar(){
// Register the click by creating an image
var x = document.createElement("IMG");
x.setAttribute("src", "%%CLICK_URL_ESC%%");
window.top.document.body.appendChild(x);
if(mraid.getVersion()=="2.0"){
mraid.createCalendarEvent({summary: "[%EventSummary%]", description: "[%EventDescription%]", location: "[%EventLocation%]", start: "[%EventStartDate%]", end: "[%EventEndDate%]"});
}
return false;
}
doReadyCheck();
</script>
</body>
</html>
Naam van testadvertentieblok: ali_Calendar
Deze template is een advertentieblok met 2 componenten dat begint als banneradvertentie onderaan het scherm. Als een gebruiker op de banner klikt, past de advertentie zich aan bepaalde specifieke uitgevouwen afmetingen aan. Als de gebruiker op de advertentie met de uitgevouwen afmetingen klikt, wordt deze omgeleid naar de URL die is gedefinieerd als doorklik-URL.
De breedte kan het formaat van de banner zijn of de volledige breedte van het scherm (als de waarde van FullWidthResize
Yes (Ja) is).
Gedrag en UI-elementen
Het advertentiemateriaal bevat de volgende UI-elementen:
- Bestanden voor advertentiemateriaal (voor elk van deze bestanden zijn het bestand, de hoogte en de breedte vereist)
- Component van de bannerafbeelding
- Component voor aangepaste banner
- Icoon voor de knop Sluiten
- De positie van de knop Sluiten kan worden aangepast zodat deze rechtsboven of linksboven in het scherm wordt weergegeven.
- De achtergrondkleur van de advertentie kan worden gewijzigd.
Naam | Type | Verplicht | Beschrijving |
---|---|---|---|
Afbeeldingsbestand van banner | Bestand | Ja | Afbeelding die in de banneradvertentie wordt weergegeven. |
Afbeeldingshoogte van banner | Getal | Ja | De hoogte van de bannerafbeelding. |
Afbeeldingsbreedte van banner | Getal | Ja | De breedte van de bannerafbeelding. |
Achtergrondkleur | Tekst | Ja | De achtergrondkleur van de ruimte die door de aangepaste afbeelding wordt ingenomen of de ruimte die door de banner wordt ingenomen. |
Doorklik-URL | URL | Ja | De URL waarnaar de gebruiker wordt geleid wanneer deze op de aangepaste advertentie klikt. |
Aangepast afbeeldingsbestand | Bestand | Ja | De afbeelding die wordt weergegeven wanneer er op de banner wordt geklikt. |
Aangepaste afbeeldingshoogte | Getal | Ja | De hoogte van de aangepaste afbeelding. |
Aangepaste afbeeldingsbreedte | Getal | Ja | De breedte van de aangepaste afbeelding. |
Het icoon Sluiten | Bestand | Ja | Het afbeeldingsbestand voor de knop Sluiten. |
Breedte van icoon Sluiten | Getal | Ja | De breedte van de knop Sluiten. (30 is de gemiddelde breedte). |
Hoogte van icoon Sluiten | Getal | Ja | De hoogte van de knop Sluiten. (30 is de gemiddelde hoogte). |
Positie van de knop Sluiten | Lijst | Nee | De positie van de knop Sluiten kan worden aangepast zodat deze rechtsboven of linksboven in het scherm wordt weergegeven. Mogelijke waarden zijn Rechts of Links. Als dit leeg wordt gelaten, wordt de knop Sluiten in de rechterbovenhoek van het scherm weergegeven. |
Aanpassen naar volledige breedte | Lijst | Nee | De aangepaste advertentie kan worden ingesteld op de volledige breedte van het scherm als de waarde Ja is. Als de waarde Nee is, is de breedte hetzelfde als de oorspronkelijke banner. Mogelijke waarden zijn Ja en Nee. De standaardwaarde is Nee. |
<html><meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0"/>
<head>
<script type="text/javascript" src="mraid.js"></script>
<style>
#close_button {
position: absolute;
top: 4px;
right: 4px;
display:block;
}
#resized img {
display : block;
margin : auto;
}
</style>
</head>
<body>
<div id="normal" style="display:none; margin:auto;top:0px;text-align:center">
<a onClick="resize();">
<img width="[%BannerImageWidth%]" height="[%BannerImageHeight%]" src="[%BannerImageFile%]" />
</a>
</div>
<div id="resized" style="display:none; top:0px;">
<a onClick="openURL()">
<img width="[%ResizedImageWidth%]" height="[%ResizedImageHeight%]" src="[%ResizedImageFile%]"/>
</a>
<div id="close_button">
<img width="[%CloseIconWidth%]" height="[%CloseIconHeight%]" src="[%CloseIcon%]"/>
</div>
</div>
<script>
<!--
// Variables
var closeButton = document.getElementById("close_button");
var bodyElement = document.body;
var advertElement = document.getElementById("normal");
var resizedElement = document.getElementById("resized");
var resizeBannerWidth;
function changeBodyElementStyle() {
// Change background color
if ("[%ResizedBackgroundColor%]") {
bodyElement.style.backgroundColor = "[%ResizedBackgroundColor%]";
resizedElement.style.backgroundColor = "[%ResizedBackgroundColor%]";
}
}
function openURL() {
mraid.open("%%CLICK_URL_ESC%%[%ClickThroughURL%]");
}
//Check whether MRAID is ready by adding event listener
function checkIfReady(){
if(mraid.getState() == 'loading'){
mraid.addEventListener("ready", mraidIsReady);
} else{
showMyAd();
}
}
function mraidIsReady(){
mraid.removeEventListener("ready", mraidIsReady);
showMyAd();
}
// Set resizing properties and resize
function resize(){
// If FullWidthResize is "Yes", then the resized advert takes up the whole width. Otherwise takes up the width of the original banner
if ("[%FullWidthResize%]" == "Yes") {
resizeBannerWidth = screen.width;
} else {
resizeBannerWidth = mraid.getDefaultPosition().width;
}
if(mraid.getVersion()=="2.0"){
if ("[%PositionOfCloseButton%]" === "Left") {
closeButton.style.left = "0";
mraid.setResizeProperties({"width":""+resizeBannerWidth+"","height":"[%ResizedImageHeight%]","offsetX":"","offsetY":"","customClosePosition":"top-left", "allowOffscreen":false});
} else {
closeButton.style.right = "0";
mraid.setResizeProperties({"width":""+resizeBannerWidth+"","height":"[%ResizedImageHeight%]","offsetX":"","offsetY":"","customClosePosition":"top-right", "allowOffscreen":false});
}
mraid.resize();
return false;
}
else{
return true;
}
}
// Displays the advert and add an event listener to it to detect whether to resize
function showMyAd(){
advertElement.style.display = "inline";
mraid.addEventListener("stateChange",updateAd);
}
// updateAd is called when MRAID changes state - calls toggleLayer to expand/ reduce ad size
function updateAd(state){
if (state == "resized"){
toggleLayer('normal', 'resized');
}else if(state == "default"){
toggleLayer('resized', 'normal');
}
}
// Goes to the other state (either resized or banner)
function toggleLayer(fromLayer, toLayer){
var fromLayerElem = document.getElementById(fromLayer);
fromLayerElem.style.display = 'none';
var toLayerElem = document.getElementById(toLayer);
toLayerElem.style.display = 'block';
}
changeBodyElementStyle();
checkIfReady();
//-->
</script>
</body>
</html>
Naam van testadvertentieblok: ali_resizeBanner
Deze template is een advertentieblok met 2 componenten dat begint als banneradvertentie onderaan het scherm. Als een gebruiker op de banner klikt, wordt het formaat van de advertentie aangepast zodat deze het hele scherm bedekt. Als de gebruiker op de advertentie met de uitgevouwen afmetingen klikt, wordt deze omgeleid naar de URL die is gedefinieerd als doorklik-URL.
Deze template gebruikt de standaard MRAID-knop Sluiten.
Gedrag en UI-elementen
Het advertentiemateriaal bevat de volgende UI-elementen:
- Bestanden voor advertentiemateriaal:
- Component van de bannerafbeelding (hoogte en breedte zijn ook vereist)
- Component voor uitvouwen van banner
- De achtergrondkleur van de banneradvertentie en de uitgevouwen advertentie kan worden gewijzigd
Naam | Type | Verplicht | Beschrijving |
---|---|---|---|
Afbeeldingsbestand van banner | Bestand | Ja | Afbeelding die in de banneradvertentie wordt weergegeven. |
Afbeeldingshoogte van banner | Getal | Ja | De hoogte van de bannerafbeelding. |
Afbeeldingsbreedte van banner | Getal | Ja | De breedte van de bannerafbeelding. |
Achtergrondkleur | Tekst | Ja | De achtergrondkleur van de ruimte die door de bannerafbeelding wordt ingenomen. |
Doorklik-URL | URL | Ja | De URL waarnaar de gebruiker wordt geleid wanneer deze op de aangepaste advertentie klikt. |
Uitgevouwen afbeeldingsbestand | Bestand | Ja | De afbeelding die wordt weergegeven wanneer er op de banner wordt geklikt. |
Hoogte uitgevouwen afbeelding | Getal | Ja | De hoogte van de uitgevouwen afbeelding. |
Breedte uitgevouwen afbeelding | Getal | Ja | De breedte van de uitgevouwen afbeelding. |
<html><meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0"/>
<head>
<script type="text/javascript" src="mraid.js"></script>
</head>
<body>
<div id="normal" style="display:none; margin:auto;top:0px;text-align:center">
<a onClick="expand();">
<img width="[%BannerImageWidth%]" height="[%BannerImageHeight%]" src="[%BannerImageFile%]" />
</a>
</div>
<div id="expanded" style="display:none;top:0px;text-align:center">
<a onClick="openURL()">
<img width="[%ExpandedImageWidth%]" height="[%ExpandedImageHeight%]" src="[%ExpandedImageFile%]" />
</a>
</div>
<script>
<!--
function openURL() {
mraid.open("%%CLICK_URL_ESC%%[%ClickThroughURL%]");
}
// Change background color if present
function changeBodyElementStyle() {
if ("[%BackgroundColor%]") {
var bodyElement = document.body;
bodyElement.style.backgroundColor = "[%BackgroundColor%]";
}
}
// Check whether MRAID is ready by adding event listener
function checkIfReady(){
if(mraid.getState() == 'loading'){
mraid.addEventListener("ready", mraidIsReady);
} else{
showMyAd();
}
}
// Once MRAID is ready, it does not need to listen to the ready event anymore
function mraidIsReady(){
mraid.removeEventListener("ready", mraidIsReady);
showMyAd();
}
function showMyAd(){
// Displays the advert
var advertElement = document.getElementById("normal");
advertElement.style.display = "inline";
// Add event listener to detect whether to expand or not
mraid.addEventListener("stateChange",updateAd);
// Change background color of the expanded advert
var expandedDiv = document.getElementById("expanded");
if ("[%BackgroundColor%]") {
expandedDiv.style.backgroundColor = "[%BackgroundColor%]";
}
}
function expand() {
if(mraid.getVersion()=="2.0"){
mraid.expand();
return false;
}
else {
return true;
}
}
// updateAd is called when mraid changes state
// Calls toggleLayer to expand/ reduce ad size
function updateAd(state){
if (state == "expanded"){
toggleLayer('normal', 'expanded');
}else if(state == "default"){
toggleLayer('expanded', 'normal');
}
}
// Goes to the other state (either expands or banner)
function toggleLayer(fromLayer, toLayer){
var fromLayerElem = document.getElementById(fromLayer);
fromLayerElem.style.display = 'none';
var toLayerElem = document.getElementById(toLayer);
toLayerElem.style.display = "block";
}
changeBodyElementStyle();
checkIfReady();
//-->
</script>
</body>
</html>
Naam van testadvertentieblok: ali_expandDefaultClose
Een interstitial sluiten nadat er een vaste periode is verstreken:
- Neem code in het advertentiemateriaal op om de interstitial te sluiten nadat een vaste periode is verstreken. De volgende code kan worden gebruikt als template voor deze aanpak:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="viewport" content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0"/>
<script type="text/javascript" src="https://www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
<script>
<!--
function
_admStartCountDown(){setTimeout('admob.opener.close()',parseInt('[%displayTime%]')*1000)}
function
_admOnload(){if(admob.opener.isOverlayShowing()){_admStartCountDown()}else{admob.events.addEventListener('onshow',
_admStartCountDown)}}
if(window.addEventListener){window.addEventListener("load",_admOnload,false)}else{window.attachEvent("onload",_admOnload)}
//-->
</script>
</head>
<body>
[Your_AdCode_Goes_Here]
</body>
</html>
Met admob.opener.openOverlay()
kunt u een overlay-browser van volledige schermgrootte openen die is geanimeerd vanaf de onderkant van het scherm. Deze browser bevat geen statusbalk en heeft linksboven altijd een knop voor sluiten. Deze optie kan goed werken voor een uitvouwbare advertentie waarbij het advertentiemateriaal op volledige schermgrootte op een afzonderlijke pagina kan worden gehost.
Hieronder vindt u voorbeeldcode voor een banner waarbij het advertentieblok op volledige schermgrootte in een overlaybrowservenster kan worden geladen. Vervang de volgende tijdelijke aanduidingen door uw eigen waarden. Als dit voor uw netwerk mogelijk is, kunt u de voorbeeldcode gebruiken om een template voor advertentiemateriaal te maken.
[BANNER_UNIT]
: URL van banneradvertentiemateriaal.[WIDTH]
: breedte van banneradvertentiemateriaal.[HEIGHT]
: hoogte van banneradvertentiemateriaal.[FULLSCREEN_UNIT]
: URL van advertentiemateriaal op volledig scherm. Opmerking: Een blok van volledige schermgrootte moet JavaScript-codering bevatten om de bestemmings-URL te parseren en de gebruiker door te verwijzen naar de bestemmingspagina nadat een klikactie is ontvangen. Zie De bestemmings-URL van een advertentieblok op volledige schermgrootte verwerken voor meer informatie.[DESTINATION_URL]
: URL van een bestemmingspagina.[FALLBACK_URL]
: Reservebestemmingspagina-URL die u kunt gebruiken voor het geval de JavaScript-functie niet wordt uitgevoerd.[ORIENTATION]
: Ondersteunde stand voor bestemmings-URL (gebruik 'p' voor staand, 'l' voor liggend, of laat deze waarde weg om alle standen toe te staan)
Hier is een voorbeeld van de advertentiemateriaalcode:
<!DOCTYPE html>
<head>
<meta name="viewport"
content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0"/>
<script type="text/javascript" src="https://www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
</head>
<body>
<a href="[FALLBACK_CLICKURL]"
onClick="admob.opener.openOverlay('%%CLICK_URL_ESC%%[FULLSCREEN_UNIT]?destination=[DESTINATION_URL]',
'[ORIENTATION]'); return false;"><img border="0"
src="[BANNER_UNIT]" width="[WIDTH]" height="[HEIGHT]"></a>
</body>
</html>
De bestemmings-URL van een advertentieblok op volledige schermgrootte verwerken
De functie admob.opener.openOverlay()
biedt geen optie om de bestemmings-URL van de HTML-content op te geven.
Als we ervan uitgaan dat u de bestemmings-URL als sleutel/waarde-paar heeft doorgegeven bij het opgeven van het advertentieblok op volledige schermgrootte (zoals https://link.to.fullscreen.unit?destination=https://my.destination.url
), kunt u een JavaScript-functie schrijven en een HTML-codefragment opnemen om de klik te registreren en de gebruiker om te leiden naar de bestemmingspagina.
Hier volgt een voorbeeld van een paginabron:
<!DOCTYPE html>
<head>
<meta name="viewport"
content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0"/>
<script type="text/javascript" src="https://www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
<script type="text/javascript">
function destinationUrl() {
// Get current url after ?
var destinationUrl = window.location.search;
// Strip off the leading '?'
destinationUrl = destinationUrl.substring(1);
// Parse destination=url key-value pair
var kvPair = destinationUrl.split("=");
var key = kvPair[0]; // key: destination
var value = kvPair[1]; // value: url
var url = decodeURIComponent(value);
// Open destination inside overlay
window.location = url;
// Open destination in an external browser
// admob.opener.openUrl(url, true);
}
</script>
</head>
<body>
<div style="position:relative;">
<!-- Load content source into an iframe -->
<iframe src="https://creative.admob.com/t1/bestBuy/tradeinJul/gi/"
align="middle" frameborder=0 width=320 height=480 marginheight=0 marginwidth=0 scrolling=no></iframe>
<!-- Create a clickable area -->
<a href="#" onClick="destinationUrl(); return false;" style="position:absolute; top:0; left:0;
display:inline-block; width:320px; height:480px; z-index:5;"></a>
</div>
</body>
</html>
Compatibiliteit met MRAID
De SDK voor mobiele advertenties van Google ondersteunt de MRAID-standaard (Mobile Rich Media Ad Interface Definitions) van IAB voor advertenties in mobiele apps. U kunt een regelitem instellen als MRAID v1 of MRAID v2 via de targetinginstellingen voor regelitems onder Targeting toevoegen Apparaatcapaciteit.
MRAID-vereisten:
- Voor MRAID v2 is Google Play-services v7.8 of hoger voor Android en de SDK voor mobiele advertenties van Google v7.4.0 of hoger voor iOS vereist.
- Voor MRAID v3 is Google Play-services v15.0.0 of hoger voor Android en de SDK voor mobiele advertenties van Google v7.30.0 of hoger voor iOS vereist.
Als u MRAID-functies wilt gebruiken in uw advertentiemateriaal, moet u mraid.js
importeren in uw advertentiemateriaal. Voeg <script src="mraid.js">
toe aan uw advertentiemateriaal om dit te doen. De SDK voor mobiele advertenties van Google werkt met MRAID. Deze SDK zoekt naar de code in uw advertentiemateriaal en vervangt deze door een daadwerkelijke URL die naar een implementatie van MRAID verwijst. Andere SDK's die MRAID ondersteunen, doen hetzelfde, maar de URL's die deze SDK's genereren, zijn verschillend.
U kunt ook de MRAID-bibliotheken en de functionaliteit van de SDK voor mobiele advertenties van Google aan hetzelfde advertentiemateriaal toevoegen.
mraid.resize()
en andere vergelijkbare functies hebben pas effect nadat er op de advertentie is geklikt. Dit voorkomt dat het formaat van schadelijk advertentiemateriaal automatisch wordt aangepast zodat het advertentiemateriaal het hele scherm inneemt.