Αυτό το άρθρο παρέχει σημειώσεις και παραδείγματα που περιγράφουν τον τρόπο με τον οποίο μπορείτε να προβάλετε μια μη αυτόματη παρενθετική διαφήμιση παιχνιδιού, χρησιμοποιώντας τη βιβλιοθήκη της Ετικέτας του Google Publisher (GPT). Οι μη αυτόματες παρενθετικές διαφημίσεις παιχνιδιού είναι διαφημίσεις πλήρους σελίδας, η διαχείριση των οποίων πραγματοποιείται από το GPT. Οι διαφημίσεις αυτές γίνονται ορατές στους χρήστες μέσω ενός μη αυτόματου εναύσματος.
Τα ακόλουθα συμβάντα GPT χρησιμοποιούνται για την προβολή και την αλληλεπίδραση με παρενθετικές διαφημίσεις:
| Συμβάν | Ενεργοποιείται όταν… |
|---|---|
|
|
Μια υποδοχή μη αυτόματης παρενθετικής διαφήμισης παιχνιδιού είναι έτοιμη για προβολή. Για την προβολή της παρενθετικής διαφήμισης, καλέστε το στοιχείο |
Η μη αυτόματη παρενθετική διαφήμιση παιχνιδιού μπορεί να εμφανιστεί σε πλήρη οθόνη ή εντός του πλαισίου του παιχνιδιού, ανάλογα με τον τρόπο προβολής του παιχνιδιού. Μάθετε περισσότερα σχετικά με τις δομές των διαφημίσεων για παιχνίδια HTML5.
Το παρακάτω δείγμα κώδικα προϋποθέτει ότι το παιχνίδι HTML5 τοποθετείται απευθείας στο ίδιο επάνω πλαίσιο με τη σελίδα (χρησιμοποιώντας τη δομή Πλήρης οθόνη). Σε αυτή την περίπτωση, η μη αυτόματη παρενθετική διαφήμιση θα εμφανίζεται επίσης σε πλήρη οθόνη.
Ωστόσο, ο ίδιος κώδικας λειτουργεί επίσης όταν τοποθετείται εντός ενός θυγατρικού πλαισίου (χρησιμοποιώντας τη δομή iframe/Προβολή στον ιστό). Για να περιοριστεί η μη αυτόματη παρενθετική διαφήμιση στον καμβά του παιχνιδιού HTML5, το παιχνίδι θα πρέπει να τοποθετηθεί σε ένα iframe.
Παράδειγμα
<!doctype html>
<html>
<head>
<!-- Η Ετικέτα του Google Publisher εδώ, εάν υπάρχει, θα είναι υπεύθυνη μόνο για την προβολή διαφημίσεων εκτός του παιχνιδιού HTML5. -->
<title>Σελίδα για αυτό το παράδειγμα παιχνιδιού HTML5</title>
<!-- Το περιεχόμενό σας <head> εδώ. -->
</head>
<body>
<span id="example-text">Παράδειγμα παιχνιδιού HTML5</span>
<iframe src="https://www.example-game.com" title="Παράδειγμα παιχνιδιού" allow="autoplay">
<!-- Το δείγμα κώδικα προβάλλεται εδώ. Η Ετικέτα του Google Publisher που φορτώνεται σε αυτό το πλαίσιο θα χρησιμοποιηθεί μόνο εντός του παιχνιδιού HTML5. -->
</iframe>
</body>
</html>
Σημειώσεις χρήσης
- Για να διασφαλιστεί η βέλτιστη εμπειρία χρήστη, το GPT ζητά μη αυτόματες παρενθετικές διαφημίσεις παιχνιδιού μόνο στις σελίδες που υποστηρίζουν σωστά τη μορφή. Για αυτόν τον λόγο, το στοιχείο
defineOutOfPageSlot()μπορεί να εμφανίσει την τιμή null. Πρέπει να ελέγξετε για αυτή την περίπτωση, ώστε να βεβαιωθείτε ότι δεν κάνετε περιττές εργασίες. - Ζητήστε μη αυτόματες παρενθετικές διαφημίσεις παιχνιδιού μόνο σε σελίδες ή περιβάλλοντα όπου θέλετε να εμφανίζεται μια παρενθετική διαφήμιση. Οι μη αυτόματες παρενθετικές διαφημίσεις παιχνιδιού είναι κατάλληλες για προβολή σε υπολογιστές, tablet και κινητές συσκευές.
- Η παρενθετική διαφήμιση εμφανίζεται όταν καλείτε το στοιχείο
makeGameManualInterstitialVisibleαπό το συμβάνGameManualInterstitialSlotReady. - Οι μη αυτόματες παρενθετικές διαφημίσεις παιχνιδιού έχουν σταθερό όριο συχνότητας. Αυτό αποτρέπει την ενεργοποίηση του συμβάντος
gameManualInterstitialSlotReadyπερισσότερες από μία φορές κάθε 120 δευτερόλεπτα.
Απαιτήσεις και προτάσεις
- Οι μη αυτόματες παρενθετικές διαφημίσεις παιχνιδιού δημιουργούν τη δική τους υποδοχή διαφήμισης. Σε αντίθεση με άλλους τύπους διαφημίσεων, δεν είναι απαραίτητο να ορίσετε ένα στοιχείο
<div>για τις μη αυτόματες παρενθετικές διαφημίσεις παιχνιδιού. Αυτές οι διαφημίσεις δημιουργούν και εισάγουν αυτόματα ένα δικό τους κοντέινερ στη σελίδα όταν συμπληρώνεται μια διαφήμιση. - Εάν χρησιμοποιείτε αρχιτεκτονική ενός αιτήματος (SRA) σε μια σελίδα με πολλές υποδοχές, μην καλέσετε το στοιχείο
display(), μέχρι να δημιουργηθούν στοιχεία div στατικών υποδοχών διαφήμισης. Όπως περιγράφεται στις Βέλτιστες πρακτικές για τις διαφημίσεις, η πρώτη κλήση στο στοιχείοdisplay()ζητά όλες τις υποδοχές διαφήμισης που έχουν οριστεί πριν από το συγκεκριμένο σημείο. Παρόλο που οι υποδοχές των μη αυτόματων παρενθετικών διαφημίσεων παιχνιδιού δεν απαιτούν ένα προκαθορισμένο στοιχείο<div>, οι στατικές υποδοχές διαφήμισης το απαιτούν. Η κλήση του στοιχείουdisplay()πριν από την παρουσία αυτών των στοιχείων στη σελίδα μπορεί να οδηγήσει σε χαρακτηριστικά ταυτοποίησης χαμηλότερης ποιότητας, επομένως συνιστάται να καθυστερήσετε την αρχική κλήση μέχρι να καθοριστούν οι στατικές υποδοχές. - Η διακίνηση μη αυτόματων παρενθετικών διαφημίσεων απαιτεί την ίδια ρύθμιση στοιχείου διαφημίσεων και στοιχείου γραμμής με τις βασικές παρενθετικές διαφημίσεις ιστού.
Παράδειγμα
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Παράδειγμα μη αυτόματης παρενθετικής διαφήμισης παιχνιδιού</title>
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script>
window.googletag = window.googletag || { cmd: [] };
let gameManualInterstitialSlot;
googletag.cmd.push(function () {
// Ορισμός υποδοχής μη αυτόματης παρενθετικής διαφήμισης παιχνιδιού.
defineGameManualInterstitialSlot();
// Ορισμός στατικών υποδοχών διαφήμισης.
staticSlot = googletag.defineSlot(
'/6355419/Travel/Europe', [100, 100], 'static-ad-1')
.addService(googletag.pubads());
// Ενεργοποίηση SRA και υπηρεσιών.
googletag.pubads().enableSingleRequest();
googletag.enableServices();
});
function defineGameManualInterstitialSlot() {
gameManualInterstitialSlot = googletag.defineOutOfPageSlot(
'/6355419/Travel/Europe/France/Paris',
googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL);
// Η υποδοχή επιστρέφει την τιμή null αν η σελίδα ή η συσκευή δεν υποστηρίζει τις παρενθετικές διαφημίσεις.
if (gameManualInterstitialSlot) {
gameManualInterstitialSlot.addService(googletag.pubads());
printStatus('Αναμονή για προετοιμασία παρενθετικής διαφήμισης…');
// Προσθήκη λειτουργίας αναμονής συμβάντος για την καταχώριση του δείκτη χειρισμού κλικ μετά τη φόρτωση της παρενθετικής διαφήμισης.
// Αν αυτό το συμβάν δεν ενεργοποιηθεί, δοκιμάστε να κάνετε εκκαθάριση του τοπικού αποθηκευτικού χώρου και να ανανεώσετε
// τη σελίδα.
googletag.pubads().addEventListener('gameManualInterstitialSlotReady',
(slotReadyEvent) => {
if (gameManualInterstitialSlot === slotReadyEvent.slot) {
printStatus('Η παρενθετική διαφήμιση είναι έτοιμη.');
const button = document.getElementById('trigger');
button.style.display = 'block';
button.addEventListener('click', () => {
slotReadyEvent.makeGameManualInterstitialVisible();
printStatus('Η παρενθετική διαφήμιση είναι ενεργή.');
}, { once: true });
}
});
googletag.pubads().addEventListener('gameManualInterstitialSlotClosed',
resumeGame);
}
}
function resumeGame() {
document.getElementById('trigger').style.display = 'none';
// Οι υποδοχές μη αυτόματων παρενθετικών διαφημίσεων παιχνιδιού προορίζονται για μία χρήση, επομένως καταστρέψτε την παλιά υποδοχή και δημιουργήστε μια νέα.
googletag.destroySlots([gameManualInterstitialSlot]);
defineGameManualInterstitialSlot();
googletag.display(gameManualInterstitialSlot);
}
function printStatus(status) {
document.getElementById('status').innerText = status;
}
</script>
<style>
button {
display: none;
}
div.content {
position: fixed;
top: 50%;
}
</style>
</head>
<body>
<div id="static-ad-1" style="width: 100px; height: 100px;"></div>
<div class="content">
<span id="status">Η μη αυτόματη παρενθετική διαφήμιση παιχνιδιού δεν υποστηρίζεται σε αυτή τη σελίδα.</span>
<p>
<button id="trigger">TRIGGER INTERSTITIAL</button>
</p>
</div>
<script>
googletag.cmd.push(function () {
// Βεβαιωθείτε ότι η πρώτη κλήση στο στοιχείο display πραγματοποιείται αφού
// καθοριστούν τα στοιχεία div των στατικών υποδοχών διαφήμισης.
googletag.display(staticSlot);
});
</script>
</body>
</html>
