Οι μακροεντολές είναι ειδικές συμβολοσειρές στον κώδικα ενός δημιουργικού. Το Ad Manager αντικαθιστά αργότερα αυτές τις συμβολοσειρές με άλλες τιμές ή κώδικα βάσει των ρυθμίσεων του δημιουργικού. Οι μακροεντολές είναι χρήσιμες, γιατί δεν χρειάζεται να ενημερώσετε απευθείας τον κώδικα δημιουργικού όταν πρέπει να κάνετε αλλαγές. Μπορείτε απλώς να ενημερώσετε την αναφορά μακροεντολής.
Για κάθε μακροεντολή, έχουμε ετοιμάσει προτάσεις σχετικά με τον τρόπο με τον οποίο μπορείτε να τη χρησιμοποιήσετε. Ωστόσο, οι μακροεντολές μπορούν να χρησιμοποιηθούν με οποιονδήποτε τρόπο σάς εξυπηρετεί καλύτερα. Οι μακροεντολές μπορούν να συμπεριληφθούν σε οποιονδήποτε κώδικα επεξεργάζεται ο διακομιστής διαφημίσεων κατά την προβολή: σε κώδικα προσαρμοσμένου δημιουργικού ή κώδικα δημιουργικού τρίτου μέρους, σε κώδικα Studio, σε URL προορισμού ή σε ετικέτες διαφημίσεων.
Σημαντικές σημειώσεις σχετικά με τις μακροεντολές
- Διάκριση πεζών-κεφαλαίων
Στις μακροεντολές εφαρμόζεται διάκριση πεζών-κεφαλαίων. Χρησιμοποιήστε τη μακροεντολή%%CACHEBUSTER%%και όχι τη μακροεντολή%%Cachebuster%%. - Επέκταση με και χωρίς χαρακτήρα διαφυγής
Οι εκδόσεις μακροεντολών με και χωρίς χαρακτήρα διαφυγής επεκτείνονται με διαφορετικό τρόπο. Μάθετε σχετικά με τον τρόπο χρήσης των μακροεντολών με και χωρίς χαρακτήρα διαφυγής. - Εισαγωγή μακροεντολών
Το Ad Manager εισάγει αυτόματα τις μακροεντολές για τα δημιουργικά τρίτου μέρους ή τα URL ετικετών VAST, εφόσον το Ad Manager αναγνωρίσει το τρίτο μέρος. Για τα προσαρμοσμένα δημιουργικά και τα πρότυπα δημιουργικών, πρέπει να προσθέτετε τις μακροεντολές μη αυτόματα. Εάν δεν ξέρετε σε ποιο σημείο πρέπει να τοποθετήσετε μια μακροεντολή, επικοινωνήστε με τον προμηθευτή του δημιουργικού.
Κατά τη διακίνηση με ένα πρότυπο δημιουργικού, θα υπάρχει μια είσοδος με URL προορισμού μόνο όταν χρησιμοποιείται μια μακροεντολή κλικ στο πρότυπο. - Δεσμευμένοι χαρακτήρες και κωδικοποίηση URL (κωδικοποίηση με σύμβολο ποσοστού)
Το Ad Manager δεσμεύει ορισμένα πεζά γράμματα που έπονται ενός συμβόλου ποσοστού:%a
%c
%h
%i
%n
%p
%kΑυτές οι συμβολοσειρές δεν πρέπει να χρησιμοποιούνται στην κωδικοποίηση URL καθώς μπορούν να επηρεάσουν την επέκταση των μακροεντολών.
- Οι μακροεντολές δεν υποστηρίζονται για τη δυνατότητα Απευθείας μέσω προγραμματισμού
Δείτε τις διαθέσιμες λειτουργίες για τη δυνατότητα Απευθείας μέσω προγραμματισμού.
Μετάβαση σε συγκεκριμένη μακροεντολή στη λίστα
Απόδοση μακροεντολών
Οι μακροεντολές απόδοσης χρησιμοποιούνται συνήθως για την απόδοση των δημιουργικών, διασφαλίζοντας τη σωστή λειτουργία και εμφάνισή τους.
Στοιχείο διαφημίσεων| Μακροεντολή |
|---|
%%ADUNIT%% |
Η μακροεντολή στοιχείου διαφημίσεων εισάγει τη διαδρομή του στοιχείου διαφημίσεων από την ετικέτα του Google Publisher στον κώδικα δημιουργικού κατά την προβολή.
Δείτε πώς θα μπορούσατε να προσθέσετε τη μακροεντολή ADUNIT σε ένα απόσπασμα κώδικα δημιουργικού τρίτου μέρους:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
Η μακροεντολή στοιχείου διαφημίσεων επεκτείνεται στην πλήρη διαδρομή του στοιχείου διαφημίσεων που περιέχεται στο αρχικό αίτημα για διαφήμιση, συμπεριλαμβανομένου του κωδικού δικτύου. Ακολουθεί ένα παράδειγμα του τρόπου με τον οποίο επεκτείνεται η διαδρομή ενός στοιχείου διαφημίσεων κατά την προβολή της διαφήμισης:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Αυτή η μακροεντολή λειτουργεί μόνο για εγκεκριμένα προτεινόμενα στοιχεία διαφημίσεων. Εάν ένα προτεινόμενο στοιχείο διαφημίσεων βρίσκεται στο τρίτο επίπεδο, αυτή η μακροεντολή επεκτείνεται μόνο στο στοιχείο διαφημίσεων δεύτερου επιπέδου όταν χρησιμοποιείται στο απόσπασμα δημιουργικού. Μετά την έγκριση του προτεινόμενου στοιχείου διαφημίσεων, η μακροεντολή επεκτείνεται στο τρίτο επίπεδο στοιχείου διαφημίσεων στο απόσπασμα δημιουργικού
| Μακροεντολή | Διαφυγή |
|---|---|
%%DEST_URL_ESC%% |
Με χαρακτήρα διαφυγής |
%%DEST_URL_ESC_ESC%% |
Με διπλό χαρακτήρα διαφυγής |
%%DEST_URL_UNESC%% |
Χωρίς χαρακτήρα διαφυγής |
Η μακροεντολή URL προορισμού επεκτείνεται στο URL προορισμού του δημιουργικού, που είναι είτε το URL προορισμού του στοιχείου γραμμής είτε ένα σύνολο αντικατάστασης για το δημιουργικό εντός του στοιχείου γραμμής.
Η μακροεντολή URL προορισμού είναι χρήσιμη σε προσαρμοσμένα δημιουργικά και πρότυπα δημιουργικών. Εάν ο κώδικας δημιουργικού πρέπει να περιλαμβάνει το URL προορισμού του δημιουργικού και το URL προορισμού αλλάξει ενώ το δημιουργικό ή το πρότυπο χρησιμοποιείται σε διαφορετικά στοιχεία γραμμής, τότε αυτή η μακροεντολή μπορεί να φανεί χρήσιμη.
Υπάρχουν τρεις μακροεντολές URL προορισμού: με χαρακτήρα διαφυγής, με διπλό χαρακτήρα διαφυγής και χωρίς διαφυγή. Τυπικά, το μέγεθος της διαφυγής (είτε συμπεριλαμβάνετε το ESC μία φορά είτε δύο είτε καθόλου) εξαρτάται από την εταιρεία παρακολούθησης κλικ τρίτου μέρους. Ορισμένες εταιρείες παρακολούθησης κλικ τρίτου μέρους απαιτούν το URL να περιέχει χαρακτήρα διαφυγής, ενώ άλλες όχι. Το επίπεδο διαφυγής που απαιτείται από μια εταιρεία παρακολούθησης κλικ τρίτου μέρους συχνά προσδιορίζεται στην ετικέτα με τη συμβολοσειρά click= στην ετικέτα διαφήμισης του τρίτου μέρους ή τον προσαρμοσμένο κώδικα δημιουργικού στο Ad Manager:
-
click=: Να γίνεται διαφυγή μία φορά (%%DEST_URL_ESC%%). -
click0=: Να μην γίνεται διαφυγή (%%DEST_URL_UNESC%%). -
click1=: Να γίνεται διαφυγή μία φορά (%%DEST_URL_ESC%%). -
click2=: Να γίνεται διαφυγή δύο φορές (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%% που έχει ακριβώς την ίδια λειτουργία με τη μακροεντολή %%DEST_URL_ESC%%. Προτείνουμε να χρησιμοποιείτε τη μακροεντολή %%DEST_URL_ESC%% για λόγους σαφήνειας. Ωστόσο, δεν είναι απαραίτητο να γίνει εκ νέου κωδικοποίηση παλαιότερων δημιουργικών και προτύπων.%u ή %%DEST_URL%%, θα μεταφερθείτε στο URL του xsd:string όταν κάνετε κλικ στο δημιουργικό. Έχει μέγιστο μήκος 1.024 χαρακτήρων.| Μακροεντολή |
|---|
%%FILE:file_display_name%% |
Η μακροεντολή διακομιστή αρχείων %%FILE:file_display_name%% επεκτείνεται στο πλήρες URL ενός στοιχείου δημιουργικού που μεταφορτώθηκε για κάποιο δημιουργικό. Χρησιμοποιήστε αυτήν τη μακροεντολή, για να καλέσετε μεταφορτωμένα στοιχεία, όπως μια εικόνα, με προσαρμοσμένο κώδικα δημιουργικού.
Για να χρησιμοποιήσετε αυτήν τη μακροεντολή, αντικαταστήστε το file_display_name με το εμφανιζόμενο όνομα του στοιχείου δημιουργικού, όπως εμφανίζεται στο Ad Manager όταν βλέπετε τις λεπτομέρειες του δημιουργικού.
| Μακροεντολή |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Αυτές οι μακροεντολές εισάγουν το ύψος και το πλάτος του δημιουργικού, όπως ορίζονται στο Ad Manager από την τιμή του πεδίου "Μέγεθος στοιχείου διαφημίσεων στόχευσης" του δημιουργικού, στον προσαρμοσμένο κώδικα ενός δημιουργικού κατά τη διάρκεια της διαδικασίας προβολής διαφημίσεων.
Οι μακροεντολές ύψους και πλάτους μπορεί να είναι ιδιαίτερα χρήσιμες, εάν δημιουργείτε ένα πρότυπο δημιουργικού το οποίο θέλετε να χρησιμοποιήσετε ξανά με δημιουργικά διαφορετικών μεγεθών. Αντί για την κωδικοποίηση του μεγέθους κάθε δημιουργικού, μπορείτε να επιτρέψετε στις μακροεντολές ύψους και πλάτους να εισάγουν τιμές δυναμικά σε κάθε δημιουργικό.
| Μακροεντολή |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
Χρησιμοποιήστε τη μακροεντολή αντιστοίχισης μοτίβων για τη μεταβίβαση ενός ή περισσότερων προσαρμοσμένων μεταβλητών, όπως μιας τιμής στόχευσης σε κάποιο δημιουργικό. Μπορείτε να χρησιμοποιήσετε αυτήν τη μακροεντολή για τη μεταβίβαση κλειδιών-τιμών, την αντικατάσταση ολόκληρης της συμβολοσειράς στόχευσης ή την επέκταση του URL συνδέσμου παραπομπής. Αυτό μπορεί να σας φανεί χρήσιμο σε περίπτωση που θέλετε να εμφανίζετε διαφορετικά δημιουργικά βάσει των πληροφοριών που γνωρίζετε σχετικά με κάποιον χρήστη, όπως τις προτιμήσεις περιεχομένου του χρήστη.
Η μακροεντολή αντιστοίχισης μοτίβων περιορίζεται σε 100 αντικαταστάσεις ανά δημιουργικό.
Διαφυγή της μακροεντολής αντιστοίχισης μοτίβων
Η μακροεντολή αντιστοίχισης μοτίβων επιστρέφει την τιμή όπως λαμβάνεται. Εάν χρησιμοποιείτε τη μακροεντολή σε ένα από τα πεδία URL, όπως το πεδίο "URL ετικέτας VAST" ή το πεδίο "URL παρακολούθησης τρίτου μέρους" σε ένα δημιουργικό βίντεο, μπορεί να θέλετε η τιμή που επεκτάθηκε να επιστρέψει με χαρακτήρα διαφυγής. Για να το κάνετε αυτό, θα χρειαστεί να χρησιμοποιήσετε τριπλό χαρακτήρα διαφυγής στην τιμή στο αίτημα.
%%PATTERN:key%%
Για παράδειγμα, ας υποθέσουμε ότι έχετε δύο δημιουργικά για κάποιο συγκεκριμένο στοιχείο γραμμής: ένα που έχει σχεδιαστεί για να προσελκύει τις γυναίκες χρήστες και ένα που έχει σχεδιαστεί για να προσελκύει τους άντρες χρήστες. Η τιμή key που χρησιμοποιείται στη μακροεντολή πρέπει να είναι αλφαριθμητικός χαρακτήρας ή το σύμβολο υπογράμμισης (_).
Η διαδικασία είναι η εξής:
- Διαβιβάζετε την προσαρμοσμένη τιμή (σε αυτήν την περίπτωση το φύλο του χρήστη) μέσα σε μια ετικέτα διαφήμισης στη σελίδα σας χρησιμοποιώντας κλειδιά-τιμές:
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - Στο προσαρμοσμένο δημιουργικό ή στο δημιουργικό τρίτου μέρους, διαβιβάστε δυναμικά την προσαρμοσμένη τιμή (το φύλο του χρήστη), χρησιμοποιώντας την παρακάτω μακροεντολή:
<some creative script here>...&gender=%%PATTERN:gender%% - Ολόκληρη η μακροεντολή
%%PATTERN:gender%%θα αντικατασταθεί με τη λέξη "male". - Το Ad Manager θα καλέσει και θα εμφανίσει το αρχείο δημιουργικού "male" σε αυτόν τον χρήστη.
%%PATTERN:TARGETINGMAP%%
Μπορείτε να χρησιμοποιήσετε το %%PATTERN:TARGETINGMAP%%, για να αντικαταστήσετε ολόκληρο τον χάρτη στόχευσης και να δημιουργήσετε ετικέτες επιστροφής δυναμικά.
Δείτε πώς μπορείτε να προσθέσετε τη μακροεντολή TARGETINGMAP σε μια ετικέτα διαφήμισης:
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Ακολουθεί ένα παράδειγμα της πλήρους συμβολοσειράς τιμής-κλειδιού κατά την προβολή της διαφήμισης:
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Μπορείτε να χρησιμοποιήσετε αυτήν τη μακροεντολή, για να ρυθμίσετε μια ετικέτα επιστροφής μεταξύ δύο δικτύων Ad Manager ("Δίκτυο A" και "Δίκτυο B").
Ακολουθεί ένα δείγμα δημιουργικού που έχει δεσμευτεί στο Δίκτυο A του Ad Manager:
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Σε περίπτωση που το Δίκτυο B του Ad Manager δεν διαθέτει για προβολή κάποια καμπάνια η οποία έχει πωληθεί, μπορεί να επιστρέψει την εμφάνιση στο Δίκτυο A χρησιμοποιώντας ένα δημιουργικό επιστροφής όπως το παρακάτω:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // για αποφυγή συνεχών επαναλήψεων
.display();
</script>Μπορείτε, επίσης, να χρησιμοποιήσετε το TARGETINGMAP σε μια ετικέτα επιστροφής η οποία αποστέλλεται σε ένα αίτημα σε κάποιον διακομιστή διαφημίσεων τρίτου μέρους, επιτρέποντάς σας να έχετε πολλές τιμές σε ένα δυναμικό δημιουργικό.
Ακολουθεί ένα δείγμα δημιουργικού που έχει δεσμευτεί στο Ad Manager:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
Όταν προβάλλεται από το Ad Manager, επεκτείνεται σε:
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
Το τρίτο μέρος έχει πλέον πρόσβαση στις παραμέτρους dfpAdUnit και targeting που δημιουργούνται δυναμικά και μπορεί να δημιουργήσει την παρακάτω επιστροφή:
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // για αποφυγή συνεχών επαναλήψεων (ανατρέξτε στη διεύθυνση https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Για να γίνει αυτό, το τρίτο μέρος ενδέχεται να έχει στη διάθεσή του έναν κώδικα προτύπου που έχει την εξής μορφή:
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
Μπορείτε επίσης να χρησιμοποιήσετε το δεσμευμένο κλειδί url για να επεκταθείτε στο URL της σελίδας παραπομπής.
Λάβετε υπόψη ότι το url είναι ένα δεσμευμένο κλειδί. Τυχόν κλειδιά-τιμές στις ετικέτες σας στο Campaign Manager 360 που περιέχουν το στοιχείο url ως όνομα κλειδιού θα αντικαθίστανται από το URL συνδέσμου παραπομπής.
| Μακροεντολή |
|---|
%%TAG_PARAM%% |
Η μακροεντολή παραμέτρου ετικέτας χρησιμοποιείται σε συνδυασμό με άλλες παραμέτρους ετικέτας διαφήμισης και διατίθεται μόνο για χρήση με τις ακόλουθες παραμέτρους:
Όπου υποστηρίζεται, επεκτείνεται στην τιμή της παραμέτρου.
Για παράδειγμα, το %%TAG_PARAM:correlator%% (υποστηρίζεται) επεκτείνεται στην τιμή της συσχέτισης από την ετικέτα διαφήμισης, αλλά η τιμή %%TAG_PARAM:ppid%% (δεν υποστηρίζεται) δεν επεκτείνεται σε καμία τιμή.
| Μακροεντολή |
|---|
%%TARGET_IN_NEW_WINDOW%% |
Η μακροεντολή στόχευσης σε νέο παράθυρο υποδεικνύει αν η ρύθμιση παραθύρου στόχευσης που ορίστηκε για το στοιχείο διαφημίσεων στο οποίο προβάλλεται το δημιουργικό φέρει την τιμή "_blank" (νέο παράθυρο) ή κάποια άλλη τιμή.
-
Εάν το παράθυρο στόχευσης φέρει την τιμή
_blank, η μακροεντολή επεκτείνεται σε1. -
Εάν το παράθυρο στόχευσης φέρει οποιαδήποτε άλλη τιμή ή σε περίπτωση που δεν έχει προσδιοριστεί κάποιο παράθυρο στόχευσης, η μακροεντολή επεκτείνεται σε
0.
Χρησιμοποιήστε τη μακροεντολή %%TARGET_WINDOW%% όταν θέλετε να εισαγάγετε την πραγματική τιμή ρύθμισης του παράθυρου στόχευσης.
| Μακροεντολή |
|---|
%%TARGET_WINDOW%% |
Η μακροεντολή παράθυρου στόχευσης επεκτείνεται στο παράθυρο στόχευσης που έχει καθοριστεί για το στοιχείο διαφημίσεων στο οποίο προβάλλεται ένα δημιουργικό. Μπορείτε να χρησιμοποιήσετε τη μακροεντολή εντός του κώδικα ενός δημιουργικού, για να καθορίσετε εάν ένα κλικ στο δημιουργικό θα μεταφέρει τον χρήστη σε ένα νέο παράθυρο ή θα φορτώνει τη σελίδα προορισμού στο ίδιο παράθυρο, ανάλογα με τις ρυθμίσεις κάθε ιστοτόπου στον οποίο θα βλέπουν τη διαφήμιση οι χρήστες.
Για παράδειγμα, στο στοιχείο διαφημίσεων AdManager_News.com, το παράθυρο στόχευσης έχει οριστεί ως _top και στο στοιχείο διαφημίσεων AdManager_Fashion.com έχει οριστεί ως _new. Εάν η μακροεντολή %%TARGET_WINDOW%% περιλαμβάνεται στον κώδικα του δημιουργικού, θα επεκταθεί σε _top για τους χρήστες στο AdManager_News.com και σε _new για τους χρήστες στο AdManager_Fashion.com.
Ακολουθεί ένα παράδειγμα υλοποίησης:
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
Χρησιμοποιήστε τη μακροεντολή %%TARGET_IN_NEW_WINDOW%%, αν θέλετε να καθορίσετε εάν η τιμή της ρύθμισης του παράθυρου στόχευσης είναι "_blank" ή κάποια άλλη.
| Μακροεντολή |
|---|
%%TFCD%% |
Η ετικέτα για περιεχόμενο που προορίζεται για παιδιά (TFCD) σάς επιτρέπει να ενημερώνετε τρίτους ότι ένα συγκεκριμένο αίτημα για διαφήμιση προέρχεται από μια σελίδα με περιεχόμενο που προορίζεται για παιδιά. Στόχος της μακροεντολής είναι να διευκολύνει τη συμμόρφωση με τον Νόμο για την Προστασία του Απορρήτου των Παιδιών στο Διαδίκτυο (COPPA).
Μπορείτε να συμπεριλάβετε τη μακροεντολή σε κάθε ανακατεύθυνση ή αίτημα για δημιουργικά τρίτων, με τη μορφή coppa=%%TFCD%% ή με παρόμοια μορφή. Επίσης, μπορεί να χρησιμοποιηθεί σε JavaScript για τον ορισμό αιτημάτων ετικετών επιστροφής GPT σχετικά με περιεχόμενο που προορίζεται για παιδιά. Η μακροεντολή επεκτείνεται σε 1 για περιεχόμενο που προορίζεται για παιδιά ή σε 0 για άλλο περιεχόμενο, ανάλογα με τις πληροφορίες σχετικά με τη φύση της σελίδας, του ιστοτόπου ή της εφαρμογής για κινητά που έστειλε το αίτημα στο Ad Manager.
Εάν χρησιμοποιείτε τις υπηρεσίες διαφήμισης της Google και θέλετε να ενσωματώσετε περιεχόμενο που προορίζεται για παιδιά σε επίπεδο ιστοτόπου ή εφαρμογής, ανατρέξτε στην ενότητα Προσθήκη ετικέτας "προορίζεται για παιδιά" σε ιστότοπο ή εφαρμογή.
| Μακροεντολή |
|---|
[%URI_ENCODE:variable%] |
Η μακροεντολή κωδικοποίησης URI μεταφράζει σωστά τα διαστήματα και άλλους ειδικούς χαρακτήρες σε τιμές μεταβλητών προτύπου δημιουργικού για χρήση σε URI, τα οποία είναι γνωστά και ως URL.
Παράδειγμα
Ας υποθέσουμε ότι το πρότυπο δημιουργικού έχει μια μεταβλητή "list" με την ονομασία "Color (Χρώμα)" και δύο τιμές: "dark blue (σκούρο μπλε)" και "light green (ανοιχτό πράσινο)". Από προεπιλογή, το Ad Manager προσθέτει το [%Color%] στο απόσπασμα του προτύπου δημιουργικού:
<a href="https://paint.com/wall.html?color=[%Color%]">Ζωγραφίστε!</a>
Κατά τη δημιουργία του δημιουργικού, το Ad Manager αντικαθιστά το [%Color%] με τη συμβολοσειρά κειμένου του επιλεγμένου στοιχείου λίστας. Σε αυτό το παράδειγμα, οι συμβολοσειρές κειμένου περιέχουν κενά και θα καταστρέψουν το URL καθώς οι χαρακτήρες κενού πρέπει να κωδικοποιούνται. Χρησιμοποιήστε το [%URI_ENCODE:Color%], για να αποφύγετε αυτό το πρόβλημα.
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Ζωγραφίστε!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Αυτή η μακροεντολή είναι ιδιαίτερα χρήσιμη σε περίπτωση χρήσης μιας μεταβλητής προτύπου δημιουργικού για τον καθορισμό ενός URL προορισμού ή ενός URL ανακατεύθυνσης. Χωρίς τη σωστή κωδικοποίηση, το πλήρες URL στο δημιουργικό σας μπορεί να μην λειτουργεί.
Παράδειγμα
Ας υποθέσουμε ότι το πρότυπο δημιουργικού έχει μια μεταβλητή "URL" με την ονομασία "LandingPage". Από προεπιλογή, το Ad Manager προσθέτει το [%LandingPage%] στο απόσπασμα του προτύπου δημιουργικού:
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Κάντε κλικ εδώ!</a>
Αν το URL [%LandingPage%] περιέχει παραμέτρους ερωτήματος, όπως την παράμετρο ?page=home&sport=baseball, το URL αποκτά λανθασμένη μορφή και η ανακατεύθυνση δεν θα λειτουργήσει όπως πρέπει. Σε αυτό το παράδειγμα, το περιεχόμενο μετά το συμπλεκτικό σύμβολο (&) θα αποδοθεί στο πλήρες URL αντί για το URL ανακατεύθυνσης. Χρησιμοποιήστε το [%URI_ENCODE:LandingPage%], για να αποφύγετε αυτό το πρόβλημα.
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Κάντε κλικ εδώ!</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Μακροεντολές παρακολούθησης
Αυτές είναι οι πιο κοινές μακροεντολές για παρακολούθηση και δημιουργία αναφορών.
Cachebuster (τυχαίος αριθμός)| Μακροεντολή |
|---|
%%CACHEBUSTER%% |
Η μακροεντολή "cachebuster" διασφαλίζει ότι πραγματοποιείται μια νέα κλήση στον διακομιστή διαφημίσεων κάθε φορά που εκτελείται ο κώδικας, για να μπορείτε να μετράτε με ακρίβεια τις εμφανίσεις. Εάν δεν προσθέσετε τη μακροεντολή cache-busting σε κώδικα δημιουργικού, θα είναι πιο πιθανό να δείτε αποκλίσεις καταμέτρησης εμφανίσεων μεταξύ του Google Ad Manager και ενός διακομιστή διαφημίσεων τρίτου μέρους. Έχετε υπόψη ότι η μακροεντολή "cachebuster" δεν απαιτείται από όλα τα τρίτα μέρη.
Οι περισσότεροι προμηθευτές δημιουργικού προσφέρουν ένα placeholder στην ετικέτα τους για την εισαγωγή μακροεντολών "cachebuster". Για παράδειγμα, αν ο κώδικας δημιουργικού τρίτου μέρους περιέχει τμήμα όπως το παρακάτω:
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[ΤΥΧΑΙΟΣ ΑΡΙΘΜΟΣ]
Θα πρέπει να επιλέξετε [RANDOM_NUMBER] και να πατήσετε Εισαγωγή μακροεντολής cachebuster για να αντικατασταθεί το placeholder:
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER, για να μειώσετε τις αποκλίσεις όταν χρησιμοποιείτε την παρακολούθηση εμφανίσεων του Campaign Manager 360 για το Ad Manager.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
Οι μακροεντολές cachebuster σε αποκρίσεις VAST
Η μακροεντολή %%CACHEBUSTER%% επεκτείνεται στον ίδιο τυχαίο αριθμό για όλα τα συμβάντα σε ένα συγκεκριμένο δημιουργικό. Αυτό είναι ιδιαίτερα χρήσιμο για διαφημίσεις βίντεο, καθώς η μακροεντολή επεκτείνεται στον ίδιο τυχαίο αριθμό για κάθε συμβάν παρακολούθησης βίντεο σε μια απόκριση VAST.
| Μακροεντολή | Διαφυγή |
|---|---|
%%CLICK_URL_UNESC%% |
Χωρίς χαρακτήρα διαφυγής |
%%CLICK_URL_ESC%% |
Με χαρακτήρα διαφυγής |
%%CLICK_URL_ESC_ESC%% |
Με διπλό χαρακτήρα διαφυγής |
Η μακροεντολή κλικ επεκτείνεται σε ένα ειδικό URL ώστε να μπορείτε να παρακολουθείτε τα κλικ στο Ad Manager για δημιουργικά τρίτου μέρους. Αυτή η μακροεντολή συνδυάζεται γενικά με το URL προορισμού ενός δημιουργικού στην ετικέτα αγκύρωσης (<a>). Μην εισαγάγετε τη μακροεντολή κλικ ως προέλευση μιας εικόνας ή ενός iframe. Κάτι τέτοιο θα προκαλέσει την καταγραφή ενός κλικ κάθε φορά που πραγματοποιείται απόδοση εικόνας ή iframe, το οποίο δεν θα είναι κατάλληλο και θα φιλτράρεται ως μη έγκυρο κλικ.
Χρησιμοποιήστε τη μακροεντολή %%CLICK_URL_UNESC%% στην αρχή ενός συνδέσμου. Χρησιμοποιήστε τη μακροεντολή %%CLICK_URL_ESC_ESC%% όταν η παρακολούθηση κλικ είναι η παράμετρος κάποιου άλλου URL.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">link</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">link</a>
Μάθετε περισσότερα σχετικά με τις μακροεντολές με χαρακτήρες διαφυγής και τις μακροεντολές χωρίς χαρακτήρες διαφυγής.
Επαληθεύστε την υλοποίηση της μακροεντολής κλικ
Μια μακροεντολή κλικ που δεν έχει τοποθετηθεί σωστά δεν θα παρακολουθεί κλικ. Ακολουθήστε αυτά τα βήματα, για να επιβεβαιώσετε ότι το Ad Manager θα καταγράφει τα κλικ με τον τρόπο που επιθυμείτε.
- Δείτε σε προεπισκόπηση το δημιουργικό.
- Κάντε κλικ στην προεπισκόπηση.
Το Ad Manager εμφανίζει μια επιβεβαίωση ότι θα γίνεται καταγραφή των κλικ. Εάν δεν εμφανιστεί αυτή η επιβεβαίωση, τότε η μακροεντολή κλικ δεν έχει υλοποιηθεί σωστά.
| Μακροεντολή | Σε τι επεκτείνεται |
|---|---|
%eaid! |
Αναγνωριστικό στοιχείου γραμμής |
%eadv! |
Αναγνωριστικό διαφημιζoμένου για το στοιχείο γραμμής που εμφανίζεται |
%ebuy! |
Αναγνωριστικό παραγγελίας για το στοιχείο γραμμής που εμφανίζεται |
%ecid! |
Αναγνωριστικό δημιουργικού |
%eenv! |
Ένδειξη περιβάλλοντος (τύπος ετικέτας): i για iframe, j για JavaScript |
%epid! |
Αναγνωριστικό του στοιχείου διαφημίσεων στο οποίο εμφανίζεται το στοιχείο γραμμής |
%esid! |
Αναγνωριστικό του στοιχείου διαφημίσεων υψηλότερου επιπέδου πάνω από το στοιχείο διαφημίσεων στο οποίο εμφανίζεται το στοιχείο γραμμής
Πρόκειται για μια μακροεντολή παλαιού τύπου και ενδέχεται να μην λειτουργεί όπως αναμένεται με το δίκτυό σας.
|
Χρησιμοποιήστε τις μακροεντολές επέκτασης σε προσαρμοσμένο κώδικα δημιουργικού ή σε URL προορισμού, ώστε να εμφανίζονται οι τιμές αναγνωριστικών από το Ad Manager κατά την προβολή ενός δημιουργικού σε μια σελίδα. Αυτό χρησιμοποιείται συνήθως για αντιστοίχιση αναγνωριστικών από το Ad Manager με αναγνωριστικά στη βάση δεδομένων του εκδότη για αντιμετώπιση προβλημάτων ή για αναφορές άλλου τύπου.
Οι μακροεντολές επέκτασης μπορούν να διαχωριστούν μεταξύ τους στο URL προορισμού με οποιονδήποτε χαρακτήρα που είναι ασφαλής για χρήση σε URL προορισμού Ad Manager. Για παράδειγμα, το http://www.site.com/?%eaid!;%ecid! επεκτείνεται σε http://www.site.com/?1234567;4265598.
| Μακροεντολή |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (το αναγνωριστικό της συσκευής) |
%%ADVERTISING_IDENTIFIER_TYPE%% (ο τύπος της συσκευής) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (η ρύθμιση Περιορισμός παρακολούθησης διαφημίσεων) |
Η μακροεντολή %%ADVERTISING_IDENTIFIER_PLAIN%% επιτρέπει στους εκδότες εντός εφαρμογής την αποστολή αναγνωριστικών συσκευής με δυνατότητα επαναφοράς σε συνεργάτες διαφήμισης για την προβολή διαφημίσεων βάσει ενδιαφέροντος. Με αυτόν τον τρόπο μπορείτε πιο εύκολα να δώσετε σε διαφημιζομένους και εταιρείες πρόσβαση στα αναγνωριστικά συσκευών με δυνατότητα επαναφοράς.
Οι εκδότες εντός εφαρμογής μπορούν επίσης να χρησιμοποιήσουν τη μακροεντολή %%ADVERTISING_IDENTIFIER_TYPE%% για να στείλουν τον τύπο της συσκευής και τη μακροεντολή %%ADVERTISING_IDENTIFIER_IS_LAT%% για να στείλουν τη ρύθμιση Περιορισμός παρακολούθησης διαφημίσεων (LAT), η οποία υποδεικνύει το χαρακτηριστικό ταυτοποίησης Περιορισμός παρακολούθησης διαφημίσεων από μια συσκευή.
Μάθετε περισσότερα σχετικά με τα αναγνωριστικά συσκευών με δυνατότητα επαναφοράς για στόχευση χρηστών, η οποία περιλαμβάνει τους υποστηριζόμενους τύπους συσκευών.
Προϋποθέσεις
Ορίστε κρυπτογράφηση HTTPS για δημιουργικά. Αυτή η απαίτηση αφορά τόσο το δημιουργικό όσο και τυχόν pixel τρίτου μέρους, τα οποία χρησιμοποιείτε για την παρακολούθηση μετατροπών. Εάν τα δημιουργικά δεν έχουν κρυπτογραφηθεί για HTTPS ή εάν παρακάμψετε την αυτόματη συμβατότητα SSL, η μακροεντολή δεν θα επεκτείνει την τιμή, αλλά τα δημιουργικά θα εξακολουθήσουν να προβάλλονται.
Πώς λειτουργεί
- Στο Ad Manager, ο εκδότης συμπεριλαμβάνει τις μακροεντολές στο δημιουργικό ή/και στα URL παρακολούθησης.
-
Οι μακροεντολές επεκτείνονται και περιέχουν το αναγνωριστικό συσκευής του χρήστη, τον τύπο συσκευής ή/και τη ρύθμιση LAT, τα οποία περιλαμβάνονται στο δημιουργικό, καθώς ο χρήστης πραγματοποιεί κλήσεις στο τρίτο μέρος.
Η μακροεντολή αναγνωριστικού δεν θα επεκταθεί, εάν το αίτημα για διαφήμιση προέρχεται από μια εφαρμογή που προορίζεται για παιδιά (TFCD) ή εάν έχει ενεργοποιηθεί ο Περιορισμός παρακολούθησης διαφημίσεων (LAT). Σε αυτές τις περιπτώσεις, αυτή η μακροεντολή επιστρέφει μια κενή συμβολοσειρά ("").
Μορφή
Αυτή η μακροεντολή στέλνει μια τιμή 32 κεφαλαίων δεκαεξαδικών ψηφίων, η οποία εμφανίζεται σε πέντε ομάδες που διαχωρίζονται από παύλες, με τη μορφή 8-4-4-4-12 για ένα σύνολο 36 χαρακτήρων (32 αλφαριθμητικούς χαρακτήρες και τέσσερις παύλες).
Παράδειγμα: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Δείτε τις πιθανές τιμές για τους υποστηριζόμενους τύπους συσκευών και τον Περιορισμό παρακολούθησης διαφημίσεων (Limit Ad Tracking — LAT).
| Μακροεντολή |
|---|
%%PREVIEW_MODE%% |
Χρησιμοποιήστε τη μακροεντολή λειτουργίας προεπισκόπησης σε προσαρμοσμένο κώδικα δημιουργικού, για να αποτρέψετε την καταμέτρηση των εμφανίσεων προεπισκόπησης από τα συστήματα υποστήριξής σας ή από συστήματα τρίτου μέρους. Η μακροεντολή επεκτείνεται σε true, εάν το δημιουργικό προβάλλεται σε μια προεπισκόπηση του Ad Manager και σε false, εάν πρόκειται για τυπική εμφάνιση.
| Μακροεντολή |
|---|
%%SCHEME%% |
Η μακροεντολή σχήματος επεκτείνεται σε http: ή https:, ανάλογα με το ποιο αντιστοιχεί στο σχήμα ασφάλειας της ιστοσελίδας στην οποία προβάλλεται το δημιουργικό. Μπορείτε να το τοποθετήσετε στην αρχή ενός URL.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Μακροεντολή |
|---|
%%SITE%% |
Επεκτείνεται στον τομέα της παραμέτρου URL σε μια ετικέτα διαφημίσεων (για παράδειγμα, google.com). Η μακροεντολή μπορεί να χρησιμοποιηθεί για την τροποποίηση του δημιουργικού σας ανάλογα με την προέλευση του αιτήματος. Δεν λειτουργεί σε διαφημίσεις Ad Exchange οι οποίες επισημαίνονται ως ανώνυμες.
| Μακροεντολή | Διαφυγή |
|---|---|
%%VIEW_URL_ESC%% |
Με χαρακτήρα διαφυγής |
%%VIEW_URL_UNESC%% |
Χωρίς χαρακτήρα διαφυγής |
Η μακροεντολή προβεβλημένης εμφάνισης επιτρέπει στο Ad Manager να μετρά μια εμφάνιση κάθε φορά που γίνεται λήψη κάποιου δημιουργικού στη συσκευή του χρήστη και ξεκινάει η φόρτωσή του. Χρησιμοποιήστε αυτήν τη μακροεντολή μόνο σε δημιουργικά εκτός σελίδας.
Υπάρχουν πολλοί τρόποι για την αποστολή ping προβολής. Προτείνουμε να χρησιμοποιήσετε μια ετικέτα <img>:
<!-- Αυτή η ετικέτα img είναι αόρατη. Κάνει το πρόγραμμα περιήγησης να στείλει ένα αίτημα στο VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Αυτή η ετικέτα img εμφανίζει την πραγματική διαφήμιση.-->
<img src="[%Imagefile%]" border="0">
Η πρώτη ετικέτα <img> ανακτά μια εικόνα 1x1 από το VIEW_URL. Ορίστε το στιλ σε "display:none", έτσι ώστε να είναι κρυφό και να μην επηρεάζει τη διάταξη της σελίδας.
Μακροεντολές αιτημάτων για διαφημίσεις για τον ΓΚΠΔ
Αυτές οι μακροεντολές χρησιμοποιούνται κυρίως με αιτήματα για διαφημίσεις που υπόκεινται στον GDPR.
GDPR| Μακροεντολή |
|---|
${GDPR} |
Επεκτείνεται στην τιμή gdpr= που συσχετίζεται με το αίτημα.
| Μακροεντολή |
|---|
${GDPR_CONSENT_XXXX} |
Επεκτείνεται στη συμβολοσειρά διαφάνειας και συναίνεσης (TC) που σχετίζεται με το αίτημα. Εάν η συμβολοσειρά διαφάνειας και συναίνεσης (TC) είναι κενή ή δεν είναι έγκυρη, η μακροεντολή δεν θα επεκταθεί. Χρησιμοποιήστε αυτήν τη μακροεντολή για να διαβιβάσετε τη συμβολοσειρά TC σε έναν πάροχο δημιουργικών τρίτου μέρους σε ένα URL σε δημιουργικά χωρίς προγραμματισμό.
Αντικαταστήστε τον κώδικα "XXXX" με το αναγνωριστικό GVL του ΙΑΒ του παρόχου τρίτου μέρους. Εάν η συμβολοσειρά TC είναι κενή ή μη έγκυρη, αυτή η μακροεντολή δεν θα επεκταθεί.
Τα δημιουργικά με τη μακροεντολή ${GDPR_CONSENT_XXXX} μπορεί να αποκλειστούν εάν ο πάροχος τρίτου μέρους που σχετίζεται με το αναγνωριστικό Παγκόσμιας λίστας προμηθευτών (GVL) του IAB που έχετε εισαγάγει δεν έχει τη συναίνεση χρήστη.
Όταν χρησιμοποιείται σε μια ετικέτα VAST και ο πάροχος τρίτου μέρους δεν έχει συναίνεση χρήστη, αυτή η μακροεντολή δεν θα επεκταθεί.
Η μακροεντολή ${GDPR_CONSENT_XXXX} πρέπει να υπάρχει μόνο μία φορά στο URL. Επικοινωνήστε με τον πάροχο δημιουργικών τρίτου μέρους για να κατανοήσετε τις απαιτήσεις του σχετικά με τη διαβίβαση της συμβολοσειράς TC και τους περιορισμούς μήκους του URL. Η μακροεντολή θα αντικατασταθεί στα σχετικά αιτήματα IAB TCF v2.0 με την πλήρη, μη τροποποιημένη συμβολοσειρά TC.
Οι μακροεντολές του Πλαισίου διαφάνειας και συναίνεσης (TCF) δεν επεκτείνονται κατά την υλοποίησή τους στον κώδικα HTML ενός δημιουργικού HTML5. Μόνο τα δημιουργικά Ανακατεύθυνση προβολής και Προσαρμοσμένη προβολή υποστηρίζουν μακροεντολές TCF με δυνατότητα επέκτασης μέσω των πεδίων URL τρίτου μέρους και Κώδικας HTML αντίστοιχα.
| Μακροεντολή |
|---|
${ADDTL_CONSENT} |
Επεκτείνεται στη συμβολοσειρά πρόσθετης συναίνεσης (AC) που συσχετίζεται με το αίτημα.
| Μακροεντολή |
|---|
%%TFUA%% |
Επεκτείνεται στην τιμή 1 για να επισημάνει το αίτημα για Χρήστες ΕΟΧ και Ηνωμένου Βασιλείου κάτω από την ηλικία συναίνεσης.
Μακροεντολές βίντεο
Αυτές οι μακροεντολές χρησιμοποιούνται συνήθως σε δημιουργικά βίντεο για τη συμπερίληψη λεπτομερειών σχετικά με το περιβάλλον ή το περιεχόμενο.
Διάρκεια διαφήμισης βίντεο, σε χιλιοστά του δευτερολέπτου| Μακροεντολή |
|---|
%%VIDEO_AD_DURATION%% |
Επεκτείνεται στη διάρκεια της διαφήμισης βίντεο σε χιλιοστά του δευτερολέπτου. Για περιτυλίγματα/ανακατευθύνσεις VAST, η μακροεντολή επεκτείνεται στη δηλωμένη διάρκεια της διαφήμισης στο Ad Manager.
| Μακροεντολή | Διαφυγή |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Χωρίς χαρακτήρα διαφυγής |
%%DESCRIPTION_URL_ESC%% |
Με χαρακτήρα διαφυγής |
%%DESCRIPTION_URL_ESC_ESC%% |
Με διπλό χαρακτήρα διαφυγής |
Χρησιμοποιήστε τη μακροεντολή %%DESCRIPTION_URL_ESC%% με μονό χαρακτήρα διαφυγής) όταν βρίσκεται σε ένα URL και τη μακροεντολή %%DESCRIPTION_URL_UNESC%% (χωρίς χαρακτήρες διαφυγής) σε άλλα περιβάλλοντα. Μάθετε περισσότερα σχετικά με τις μακροεντολές με χαρακτήρες διαφυγής και τις μακροεντολές χωρίς χαρακτήρες διαφυγής
Στις ετικέτες διαφήμισης ανακατεύθυνσης, αυτές οι μακροεντολές επεκτείνονται στην παράμετρο URL περιγραφής από την αρχική παράμετρο ερωτήματος description_url της ετικέτας του Google Publisher. Το URL περιγραφής θα πρέπει κανονικά να είναι το ίδιο με το URL συνδέσμου παραπομπής. Θα πρέπει να καθορίσετε το description_url στην Ετικέτα του Google Publisher, αν υπάρχουν ενσωματώσεις όπου το Κιτ ανάπτυξης λογισμικού IMA ενδέχεται να μην εντοπίζει με ακρίβεια το URL σελίδας ή σε περίπτωση που χρησιμοποιείτε βίντεο στο Ad Exchange ή στο AdSense για Βίντεο.
%%DESCRIPTION_URL%% η οποία έχει την ίδια λειτουργία με τη μακροεντολή %%DESCRIPTION_URL_UNESC%%. Συνεπώς, δεν απαιτείται εκ νέου κωδικοποίηση παλαιότερων δημιουργικών και προτύπων.| Μακροεντολή | Διαφυγή |
|---|---|
%%REFERRER_URL_UNESC%% |
Χωρίς χαρακτήρα διαφυγής |
%%REFERRER_URL_ESC%% |
Με μονό χαρακτήρα διαφυγής |
%%REFERRER_URL_ESC_ESC%% |
Με διπλό χαρακτήρα διαφυγής |
Χρησιμοποιήστε τη μακροεντολή %%REFERRER_URL_ESC%% (με μονό χαρακτήρα διαφυγής), όταν η μακροεντολή βρίσκεται σε ένα URL και τη μακροεντολή %%REFERRER_URL_UNESC%% (χωρίς χαρακτήρα διαφυγής) σε άλλα περιβάλλοντα. Μάθετε περισσότερα για τις διαφορές μεταξύ των μακροεντολών που έχουν χαρακτήρες διαφυγής και των μακροεντολών που δεν έχουν χαρακτήρες διαφυγής
Αυτή η μακροεντολή επεκτείνεται στο URL συνδέσμου παραπομπής (το URL της σελίδας όπου βρίσκεται το πρόγραμμα αναπαραγωγής βίντεο) στις ετικέτες διαφήμισης ανακατεύθυνσης. Το κάνει αυτό με τον ακόλουθο τρόπο: Το Ad Manager αναλύει την παράμετρο του ερωτήματος του URL της ετικέτας διαφήμισης, απομονώνει το URL του συνδέσμου παραπομπής και αντικαθιστά το κείμενο της μακροεντολής με αυτό το URL. Λειτουργεί μόνο με το Κιτ ανάπτυξης λογισμικού IMA της Google υπό τις ακόλουθες προϋποθέσεις:
- Η πρόσβαση στο σενάριο πρέπει να έχει ενεργοποιηθεί στη σελίδα, για να είναι δυνατή η λειτουργία αυτής της μακροεντολής.
- Η μακροεντολή δεν λειτουργεί μέσα σε ένα iframe.
%%REFERRER_URL%% η οποία έχει την ίδια λειτουργία με τη μακροεντολή %%REFERRER_URL_UNESC%%. Συνεπώς, δεν απαιτείται εκ νέου κωδικοποίηση παλαιότερων δημιουργικών και προτύπων.Μακροεντολές περιεχομένου βίντεο
Αυτές οι μακροεντολές χρησιμοποιούνται για διαφημίσεις που στοχεύουν πηγές περιεχομένου βίντεο.
| Μακροεντολή |
|---|
%%VIDEO_DURATION%% |
Επεκτείνεται στη διάρκεια του βίντεο σε χιλιοστά του δευτερολέπτου.
| Μακροεντολή |
|---|
%%VIDEO_ID%% |
Επεκτείνεται στο αναγνωριστικό του περιεχομένου βίντεο που αναπαράγεται τη δεδομένη στιγμή, το οποίο είναι το μοναδικό αναγνωριστικό στο CMS ή στην τιμή dfpvideo:ContentID από το MRSS.
| Μακροεντολή |
|---|
%%VIDEO_METADATA:key%% |
Επεκτείνεται στα μεταδεδομένα σχετικά με το βίντεο στο οποίο προβάλλεται το δημιουργικό, ανάλογα με τα κλειδιά-τιμές που σχετίζονται με το περιεχόμενο βίντεο. Τα κλειδιά-τιμές ορίζονται στο Ad Manager, στην καρτέλα Βίντεο.
Μετά τη στόχευση ενός κλειδιού μεταδεδομένων βίντεο, είναι δυνατή η επέκταση από τη μακροεντολή μεταδεδομένων βίντεο. Η τιμή key που χρησιμοποιείται στη μακροεντολή πρέπει να είναι αλφαριθμητικός χαρακτήρας ή το σύμβολο υπογράμμισης (_).
| Μακροεντολή | Διαφυγή |
|---|---|
%%VIDEO_TITLE%% |
Με μονό χαρακτήρα διαφυγής |
Η μακροεντολή τίτλου βίντεο επεκτείνεται, για να προβάλει τον τίτλο ενός βίντεο όπως ορίζεται στο Ad Manager.
Για να λειτουργήσει αυτή η μακροεντολή, απαιτείται απορρόφηση περιεχομένου.
| Μακροεντολή |
|---|
%%FW_CAID%% |
Επεκτείνεται στο προσαρμοσμένο αναγνωριστικό διαφήμισης FreeWheel.
Αυτή η μακροεντολή ισχύει μόνο για εκδότες που χρησιμοποιούν το FreeWheel για την προβολή διαφημίσεων βίντεο.
| Μακροεντολή |
|---|
%%IAB_CATEGORIES%% |
Χρησιμοποιείται για τη μεταβίβαση κατηγοριών διαφημίσεων για δημιουργικά που έχετε ταξινομήσει μη αυτόματα με ετικέτες. Αυτή η μακροεντολή εμφανίζει μια λίστα διαχωρισμένη με κόμματα με τις ισχύουσες τυπικές κατηγορίες IAB (που έχουν μετατραπεί από ταξινομημένες κατηγορίες της Google).
Αυτή η μακροεντολή μπορεί να χρησιμοποιηθεί από εκδότες που μοιράζονται απόθεμα βίντεο με το FreeWheel και θέλουν να μεταβιβάσουν κατηγορίες διαφημίσεων ως προσαρμοσμένες παραμέτρους. Για παράδειγμα, θα μπορούσατε να προσθέσετε &iab_categories=%%IAB_CATEGORIES%% στην ετικέτα ανακατεύθυνσης VAST.
