Η παροχή οποιασδήποτε από τις παρακάτω παραμέτρους στόχευσης είναι προαιρετική.
Όταν δημιουργείτε ή διαμορφώνετε μια πηγή περιεχομένου για βίντεο κατά απαίτηση (VOD) ή ρυθμίζετε μια ζωντανή ροή για DAI, θα πρέπει να καθορίσετε μια προεπιλεγμένη ετικέτα διαφήμισης βίντεο. Όλες οι ροές DAI χρησιμοποιούν αυτήν την ετικέτα διαφήμισης και τις παραμέτρους της από προεπιλογή. Οι παράμετροι ετικέτας διαφήμισης εφαρμόζονται τόσο κατά τη διάρκεια του βίντεο όσο και πριν το βίντεο. Αν θέλετε το πρόγραμμα αναπαραγωγής να υποβάλει αίτημα για κάτι μοναδικό για μια δεδομένη ροή, αυτές οι επιλογές είναι διαθέσιμες σε εσάς.
Παράμετροι ετικέτας διαφήμισης Ad Manager που μπορούν να παρακαμφθούν
Μετάβαση σε συγκεκριμένη παράμετρο:
|
rdp sdk_apis sid sz tfcd trt vconp vpa vpmute wta |
Παράκαμψη της προεπιλεγμένης ετικέτας διαφήμισης
Όταν το πρόγραμμα αναπαραγωγής βίντεο υποβάλει αίτημα για ροή, η προεπιλεγμένη ετικέτα διαφήμισης χρησιμοποιείται ακριβώς όπως την έχετε καθορίσει στη διεπαφή. Ωστόσο, μπορείτε να παρακάμψετε ορισμένες παραμέτρους της συγκεκριμένης ετικέτας στο αίτημα ροής. Αυτές είναι οι μόνες παράμετροι που μπορείτε να παρακάμψετε.
Μάθετε πώς μπορείτε να παρακάμψετε την προεπιλεγμένη ετικέτα διαφήμισης με χρήση του Κιτ ανάπτυξης λογισμικού IMA ή με χρήση SSB.
Παράμετρος | Περιγραφή | Παράδειγμα τιμής | |
---|---|---|---|
iu |
Τρέχον στοιχείο διαφημίσεων. Θα πρέπει να έχει την εξής μορφή: |
iu=/6062/video/example_unit |
|
cust_params |
Ζεύγη τιμών-κλειδιών που θα πρέπει να χρησιμοποιηθούν για τη στόχευση καμπάνιας Ad Manager. Ορισμένες πλατφόρμες απαιτούν κωδικοποίηση URL. Η απαίτηση κωδικοποίησης URL δεν ισχύει κατά τη χρήση του SDK IMA DAI για HTML5, καθώς η τιμή κωδικοποιείται αυτόματα. Αυτή η παράμετρος δεν θα λειτουργήσει, αν έχει ήδη κωδικοποιηθεί σε HTML5. |
Παραδείγματα με πολλά ζεύγη κλειδιών-τιμών, όπως:
Ροές SSB: Κωδικοποιήστε και συνδέστε ολόκληρη την τιμή
Chromecast:
Roku: Κωδικοποιήστε και συνδέστε ολόκληρη την τιμή
iOS και tvOS: Μην κωδικοποιήσετε τίποτα.
Android: Μην κωδικοποιήσετε τίποτα.
|
|
sz |
Παρακάμπτει την παράμετρο Μην συμπεριλάβετε το γράμμα |
sz=400x300 |
|
tfcd |
Προσθέτει σε ένα αίτημα μια ετικέτα ότι προορίζεται για παιδιά. Όταν ένα αίτημα DAI περιλαμβάνει την τιμή |
|
|
Η τιμή θα πρέπει να περιγράφει το βίντεο που αναπαράγεται στη σελίδα. Συνήθως, είναι η σελίδα που φιλοξενεί το πρόγραμμα αναπαραγωγής βίντεο, αλλά θα μπορούσε να είναι και μια σελίδα με κείμενο που περιγράφει το βίντεο. Αυτή η παράμετρος δεν ορίζεται αυτόματα από το Κιτ ανάπτυξης λογισμικού IMA. Πρέπει να οριστεί μη αυτόματα. |
Παράδειγμα κωδικοποίησης URL: Παράδειγμα χωρίς κωδικοποίηση: |
||
ppid |
Το παρεχόμενο αναγνωριστικό εκδότη (Publisher provided identifier - PPID) επιτρέπει στους εκδότες να αποστέλλουν ένα αναγνωριστικό για χρήση στον περιορισμό συχνότητας, την τμηματοποίηση και τη στόχευση κοινού, τη διαδοχική εναλλαγή διαφημίσεων και σε άλλα στοιχεία ελέγχου προβολής διαφημίσεων βάσει κοινού στις συσκευές. Μάθετε περισσότερα | ppid= |
|
ciu_szs |
Λίστα μεγεθών συνοδευτικών διαφημίσεων, διαχωρισμένων με κόμματα. Οι συνοδευτικές διαφημίσεις υποστηρίζονται μόνο με DAI όταν χρησιμοποιείτε το SDK HTML5. |
ciu_szs=728x90,300x250 |
|
mpt |
Υποδεικνύει το όνομα του προγράμματος αναπαραγωγής συνεργάτη. Αυτό θα χρησιμοποιηθεί κυρίως από συνεργάτες όπως οι JWPlayer, Brightcove, Ooyala, οι οποίοι ενσωματώνονται με το SDK. |
mpt=JWPlayer |
|
mpv |
Υποδεικνύει την έκδοση του προγράμματος αναπαραγωγής συνεργάτη. Αυτό θα πρέπει να ορίζεται μόνο αν έχει οριστεί και η παράμετρος |
mpv=2.1 |
|
ptpl |
Το αναγνωριστικό προτύπου διαφημιστικού διαλείμματος.
Μπορείτε να βρείτε αυτό το αναγνωριστικό στο URL του Ad Manager όταν βλέπετε τις ρυθμίσεις για το πρότυπο διαλείμματος στη διεπαφή του Ad Manager. Εμφανίζεται ως η τιμή της παραμέτρου |
ptpl=1234 |
|
ptpln |
Το όνομα για το πρότυπο διαφημιστικού διαλείμματος. Αυτό αντιστοιχεί στο πεδίο Όνομα του Ad Manager, όχι στο εμφανιζόμενο όνομα.
|
ptpln=my_break_template |
|
an |
Η παράμετρος Πρέπει να εφαρμόζεται σε αιτήματα που αποστέλλονται από εφαρμογές για κινητά και συνδεδεμένες συσκευές τηλεόρασης, καθώς απαιτείται από τις περισσότερες διαφημίσεις βίντεο μέσω προγραμματισμού.* Το Κιτ ανάπτυξης λογισμικού IMA την συμπληρώνει αυτόματα, αλλά πρέπει να ορίζεται μη αυτόματα για το DAI API και το SSB (περιβάλλοντα εκτός SDK). * Παρόλο που το όνομα της εφαρμογής θα πρέπει να είναι ένα όνομα που μπορεί να διαβαστεί από ανθρώπους, σε iOS και tvOS, δεν είναι δυνατή η πρόσβαση του SDK στο 9ψήφιο αναγνωριστικό του App Store. Σε αυτές τις περιπτώσεις, το πακέτο εφαρμογής αποστέλλεται από το SDK μέσω της παραμέτρου |
|
|
ltd |
Υποδεικνύει αν θα προβάλλονται διαφημίσεις με περιορισμένο τρόπο, όταν δεν υπάρχει συναίνεση για τη χρήση cookie ή άλλων τοπικών αναγνωριστικών. Μάθετε περισσότερα | ltd=1 |
|
rdid |
Με τις εγγενείς εφαρμογές (όχι στον ιστό ή στον ιστό για κινητά), το SDK μεταβιβάζει αναγνωριστικά συσκευής με δυνατότητα επαναφοράς για στόχευση χρηστών στα αιτήματα ροής σας με τις παραμέτρους για τα στοιχεία rdid , idtype και is_lat . Σε ροές SSB, θα πρέπει να τα μεταβιβάζετε με τη μορφή ρητών παραμέτρων, όπως θα κάνατε σε ένα αίτημα για διαφημίσεις Λύσεων βίντεο σε μια εφαρμογή πελάτη.
|
Δείτε αναλυτικά παραδείγματα αναγνωριστικών συσκευής με δυνατότητα επαναφοράς. | |
trt |
Προσδιορίζει την επισκεψιμότητα ως αγορασμένη ή άλλου τύπου. |
Μη καθορισμένος τύπος επισκεψιμότητας: Αγορασμένη επισκεψιμότητα: Οργανική επισκεψιμότητα: |
|
vconp |
Προτείνεται σύμφωνα με MRCΟδηγίες μέτρησης βίντεο
Υποδεικνύει αν το πρόγραμμα αναπαραγωγής πρόκειται να αναπαράγει συνεχόμενα τα βίντεο περιεχομένου, το ένα μετά το άλλο, όπως ισχύει σε μια τηλεοπτική μετάδοση. Οι πιθανές τιμές είναι Αυτή η παράμετρος πρέπει να μένει χωρίς τιμή, στην περίπτωση που δεν είναι γνωστή. |
Συνεχής αναπαραγωγή ΕΝΕΡΓΗ:vconp=2 Συνεχής αναπαραγωγή ΑΝΕΝΕΡΓΗ: |
|
vpa |
Προτείνεται σύμφωνα με MRCΟδηγίες μέτρησης βίντεο
Υποδεικνύει το αν η διαφήμιση θα ξεκινάει μέσω αυτόματης αναπαραγωγής ή μετά από κλικ. Οι πιθανές τιμές είναι Αυτή η παράμετρος πρέπει να μένει χωρίς τιμή, στην περίπτωση που δεν είναι γνωστή. |
Αυτόματη αναπαραγωγή:vpa=auto Κλικ: |
|
vpmute |
Προτείνεται σύμφωνα με MRCΟδηγίες μέτρησης βίντεο
Υποδεικνύει το αν η αναπαραγωγή του βίντεο θα ξεκινάει όσο το πρόγραμμα αναπαραγωγής βίντεο βρίσκεται σε σίγαση. Οι πιθανές τιμές είναι Αυτή η παράμετρος πρέπει να μένει χωρίς τιμή, στην περίπτωση που δεν είναι γνωστή. |
Σίγαση:vpmute=1 Κατάργηση σίγασης: |
|
npa |
Η ρύθμιση εξατομίκευσης για τα αιτήματα για διαφημίσεις. Θα πρέπει να ορίσετε την παράμετρο στην αρχή της ετικέτας, για να αποφύγετε τον κίνδυνο περικοπής.
Ορίστε την παράμετρο |
npa=1 |
|
omid_p |
Η παράμετρος ονόματος συνεργάτη OMID δέχεται μια μεταβλητή τιμή η οποία υποδεικνύει το όνομα του συνεργάτη που ενσωματώνει τη μέτρηση OMID και την έκδοση συνεργάτη. Αυτή η παράμετρος ισχύει μόνο για εκδότες που θέλουν τη μέτρηση Ενεργής προβολής, όταν χρησιμοποιούν το SDK Open Measurement (OM SDK). Δεν θα πρέπει να χρησιμοποιείται κατά τη χρήση του IMA SDK, καθώς ορίζεται αυτόματα. Για να υποδείξετε την υποστήριξη OMID όταν χρησιμοποιείτε τη Βιβλιοθήκη πρόσβασης μέσω προγραμματισμού (PAL), πρέπει να χρησιμοποιήσετε τα |
Όταν χρησιμοποιείτε PAL:
|
|
gdpr gdpr_consent |
Αυτά τα πεδία χρησιμοποιούνται για τη μεταβίβαση πληροφοριών συναίνεσης του TCF v2.0 τόσο για εισερχόμενα όσο και για εξερχόμενα αιτήματα συγχρονισμού cookie. |
Ανατρέξτε στις προδιαγραφές για το GDPR. |
|
givn|paln |
Για ενσωματώσεις που χρησιμοποιούν τη Βιβλιοθήκη πρόσβασης μέσω προγραμματισμού (PAL), η παράμετρος αριθμός nonce βίντεο δέχεται μια τιμή συμβολοσειράς μεταβλητής. Ο αριθμός nonce μπορεί να χρησιμοποιηθεί με ασφάλεια σε ένα URL. Η κωδικοποίησή του σε URL δεν είναι απαραίτητη. Σημείωση: Αν παρείχατε στο παρελθόν έναν αριθμό nonce χρησιμοποιώντας την παράμετρο παλαιού τύπου |
Μπορείτε να διαβάσετε περισσότερα σχετικά με την τιμή που μεταβιβάζεται σε αυτή την παράμετρο στους οδηγούς έναρξης για PAL. | |
addtl_consent |
Μια λίστα παρόχων τεχνολογίας διαφημίσεων της Google που δεν είναι εγγεγραμμένοι στο IAB. |
Ανατρέξτε στις προδιαγραφές για Πρόσθετη συναίνεση. |
|
rdp |
Πρέπει είτε να ορίσετε το |
|
|
sdk_apis |
Η παράμετρος για το πλαίσιο του SDK API δέχεται μια λίστα με σταθερές ακέραιες τιμές διαχωρισμένες με κόμματα οι οποίες υποδεικνύουν όλα τα πλαίσια API που υποστηρίζει το πρόγραμμα αναπαραγωγής. Δείτε μια λίστα με τις πιθανές τιμές για το πλαίσιο API. Αυτή η παράμετρος χρησιμοποιείται από εκδότες που χρησιμοποιούν τη Βιβλιοθήκη πρόσβασης μέσω προγραμματισμού (PAL). Αν επιχειρήσετε να ορίσετε τιμές σε αυτή την παράμετρο κατά τη χρήση του IMA SDK, οι τιμές θα παρακαμφθούν με τις τιμές που υποστηρίζονται από το IMA SDK. |
sdk_apis=2,7,9 |
|
sid |
Ένας τύπος αναγνωριστικού διαφήμισης που προστατεύει το απόρρητο και μπορεί να χρησιμοποιηθεί μόνο για σκοπούς περιορισμού συχνότητας. Σύμφωνα με τις οδηγίες IFA του IAB, αυτή η παράμετρος πρέπει να συμπληρώνεται σε μορφή UUID. Μάθετε περισσότερα Μπορείτε να εξαιρεθείτε από τη μεταβίβαση του αναγνωριστικού περιόδου σύνδεσης ορίζοντας την παράμετρο |
|
|
wta |
Υποδεικνύει την υποστήριξη του προγράμματος αναπαραγωγής βίντεο για την απόδοση του στοιχείου Γιατί αυτή η διαφήμιση;. Υποστηρίζεται αυτόματα όταν χρησιμοποιείται το Κιτ ανάπτυξης λογισμικού IMA. Όταν δεν χρησιμοποιείται το Κιτ ανάπτυξης λογισμικού IMA, στα προγράμματα αναπαραγωγής βίντεο πρέπει να υλοποιείται υποστήριξη για τα στοιχεία Το WTA δεν υποστηρίζεται για SSB. Αυτό το πεδίο απαιτείται, σε περίπτωση που χρησιμοποιείτε το Ad Exchange. Μάθετε περισσότερα * Δεν απαιτείται υποστήριξη για το στοιχείο |
Υποστηρίζεται: Δεν υποστηρίζεται: |
Παράκαμψη της προεπιλεγμένης ετικέτας διαφήμισης με τη χρήση του Κιτ ανάπτυξης λογισμικού IMA
Όταν ένα πρόγραμμα αναπαραγωγής βίντεο υποβάλει αίτημα για ροή DAI με τη χρήση του Κιτ ανάπτυξης λογισμικού IMA, μπορεί να διαβιβαστεί σε ένα πεδίο που ονομάζεται adTagParameters
. Αυτή η δομή τύπου λεξικού μπορεί να οριστεί με ζεύγη τιμών-κλειδιών, όπου τα κλειδιά μπορεί να είναι οι παράμετροι ετικέτας διαφήμισης Ad Manager που παρατίθενται στον παραπάνω πίνακα.
Μπορείτε να προσαρμόσετε τη ροή και να μεταβιβάσετε παραμέτρους που δεν σχετίζονται με το αίτημα για διαφημίσεις του Ad Manager χρησιμοποιώντας την ίδια δομή. Μάθετε πώς μπορείτε να ζητήσετε συγκεκριμένες παραλλαγές ροής και πώς μπορείτε να ρυθμίσετε ένα διαφημιστικό διάλειμμα.
Η υλοποίηση στο πεδίο adTagParameters
διαφέρει ελαφρώς, ανάλογα με την εκάστοτε γλώσσα προγραμματισμού ή πλατφόρμα. Δείτε την τεκμηρίωση ανάπτυξης για τα iOS, Android, tvOS, Chromecast, HTML5 ή την πρόσθετη τεκμηρίωση στον Οδηγό προγράμματος αναπαραγωγής και ανάπτυξης εφαρμογών DAI.
Ορίστε το πεδίο adTagParameters μέσω του SDK
Όταν ορίζετε τις τιμές cust_params
ή description_url
μέσω του SDK, σε εφαρμογές iOS, tvOS και Android, δεν θα πρέπει να κάνετε κωδικοποίηση url στις συμβολοσειρές. Μπορείτε να μεταβιβάσετε την τιμή cust_params
ως μεμονωμένη συμβολοσειρά που συνενώνει τα ζεύγη τιμών-κλειδιών με το σύμβολο &
.
Για παράδειγμα, αν θέλετε να ορίσετε το πεδίο cust_params
στην τιμή του sport=football&city=newyork
:
Η δομή adTagParams
που χρησιμοποιεί μη κωδικοποιημένες τιμές θα είναι:
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport=football&city=newyork",
"description_url": "http://www.sample.com/golf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
Η δομή adTagParameters
που χρησιμοποιεί κωδικοποιημένες τιμές για αιτήματα ροής HTML5 θα είναι:
{
"tfcd": 1,
"iu": "/987654321/path/to/adunit",
"cust_params": "sport%3Dfootball%26city%3Dnewyork",
"description_url": "http%3A%2F%2Fwww.sample.com%2Fgolf.html",
"ppid": "12JD92JD8078S8J29SDOAKC0EF230337"
}
Η δομή adTagParams
που χρησιμοποιεί κωδικοποιημένες τιμές για αιτήματα ροής Roku θα είναι:
request.adTagParams="tfcd=1&iu=/987654321/path/to/adunit&cust_params=sport%3Dfootball%26city%3Dnewyork&description_url=http%3A%2F%2Fwww.sample.com%2Fgolf.html&ppid=12JD92JD8078S8J29SDOAKC0EF230337"
Παράκαμψη προεπιλεγμένης ετικέτας διαφήμισης με τη χρήση του API DAI (beta)
Όταν ένα πρόγραμμα αναπαραγωγής βίντεο υποβάλει αίτημα για μια ροή DAI με τη χρήση του API DAI, μπορεί προαιρετικά να μεταβιβάσει ζεύγη τιμών-κλειδιών, όπου τα κλειδιά μπορεί να είναι οι παράμετροι ετικέτας διαφήμισης Ad Manager που παρατίθενται στον παραπάνω πίνακα.
Αυτές οι παράμετροι θα πρέπει να αποστέλλονται ως τμήμα του κύριου μέρους του αιτήματος HTTP POST και να έχουν τύπο μορφής application/x‑www‑form‑urlencoded
για το γραμμικό/ζωντανό βίντεο και το VOD.
Μπορείτε να προσαρμόσετε τη ροή και να μεταβιβάσετε παραμέτρους που δεν σχετίζονται με το αίτημα για διαφημίσεις του Ad Manager χρησιμοποιώντας την ίδια δομή. Μάθετε πώς μπορείτε να υποβάλετε αίτημα για συγκεκριμένες παραμέτρους παραλλαγής ροής και έλεγχο ταυτότητας HMAC.
Δείτε ένα δείγμα υλοποίησης API DAI.
Παράκαμψη προεπιλεγμένης ετικέτας διαφήμισης με τη χρήση του SSB
Ακολουθούν παραδείγματα τροποποίησης μιας προεπιλεγμένης ετικέτας διαφήμισης VOD SSB. Επισημαίνονται οι παράμετροι που αντικαταστάθηκαν και οι οποίες μεταβιβάστηκαν από το πρόγραμμα αναπαραγωγής ή την εφαρμογή.
Παραδείγματα βίντεο κατά απαίτηση |
Παράδειγμα | |
---|---|
Βασικό URL ροής VOD | http://dai.google.com/ondemand/hls/content/ |
(με καθορισμένο στοιχείο διαφημίσεων) | http://dai.google.com/ondemand/hls/content/ |
(με κλειδιά-τιμές που έχουν παρακαμφθεί) |
http://dai.google.com/ondemand/hls/content/ |
(με δήλωση περιεχομένου που προορίζεται για παιδιά) |
http://dai.google.com/ondemand/hls/content/ |
(με στοιχείο διαφημίσεων ΚΑΙ κλειδιά-τιμές που έχουν παρακαμφθεί ΚΑΙ ένα προσαρμοσμένο description_url ΚΑΙ μια δήλωση περιεχομένου που προορίζεται για παιδιά) |
http://dai.google.com/ondemand/hls/content/ |
Παραδείγματα ζωντανής γραμμικής ροής |
Παράδειγμα | |
---|---|
Βασικό URL ζωντανής γραμμικής ροής | https://dai.google.com/linear/hls/event/<asset_key> |
(με καθορισμένο στοιχείο διαφημίσεων) | https://dai.google.com/linear/hls/event/<asset_key> |
(με κλειδιά-τιμές που έχουν παρακαμφθεί) | https://dai.google.com/linear/hls/event/<asset_key> |
(με δήλωση περιεχομένου που προορίζεται για παιδιά) |
https://dai.google.com/linear/hls/event/<asset_key> |
(με ένα στοιχείο διαφημίσεων ΚΑΙ κλειδιά-τιμές που έχουν παρακαμφθεί ΚΑΙ ένα προσαρμοσμένο description_url ΚΑΙ μια δήλωση περιεχομένου που απευθύνεται σε παιδιά) |
https://dai.google.com/linear/hls/event/<asset_key> |
Δυναμική ενημέρωση παραμέτρων στόχευσης κατά τη διάρκεια συγκεκριμένης ζωντανής ροής
Μπορείτε να ενημερώσετε δυναμικά τα δεδομένα στόχευσης για έναν συγκεκριμένο χρήστη στη μέση της παρακολούθησης της ροής, χρησιμοποιώντας τη μέθοδο replaceAdTagParameters στο Κιτ ανάπτυξης λογισμικού IMA DAI.