Παράμετροι URL ετικέτας διαφήμισης VAST

Παράμετροι URL ετικέτας διαφήμισης VAST

Ένα URL ετικέτας διαφήμισης VAST χρησιμοποιείται από ένα πρόγραμμα αναπαραγωγής για την ανάκτηση διαφημίσεων βίντεο και ήχου. Μπορείτε να δημιουργήσετε ένα URL ετικέτας διαφήμισης VAST με μη αυτόματο τρόπο ή να τροποποιήσετε ένα υπάρχον URL χρησιμοποιώντας τις παρακάτω παραμέτρους και έπειτα να το δοκιμάσετε με το Εργαλείο ελέγχου σουίτας VAST. Μπορείτε, επίσης, να κάνετε ελέγχους και δοκιμές, χρησιμοποιώντας αυτά τα δείγματα ετικετών.

Γενικές απαιτήσεις URL

  • Πρωτόκολλο: Οι ετικέτες διαφημίσεων VAST υποστηρίζουν τόσο http όσο και https. Τα URL παρακολούθησης εμφανίσεων τηρούν την τρέχουσα ρύθμιση SSL και εμφανίζονται ως http ή https. Η αναλογία κλικ/εμφανίσεων και η παρακολούθηση κλικ χρησιμοποιούν τη μορφή http, εφόσον πραγματοποιούν ανακατεύθυνση από άλλη σελίδα.
  • Τομέας: Η χρήση δυναμικών τομέων που δημιουργούνται μέσω της μακροεντολής αντιστοίχισης μοτίβων ή οποιασδήποτε άλλης δυναμικής μεθόδου δεν επιτρέπεται και θα οδηγήσει σε σφάλμα.
  • Ζωντανή επισκεψιμότητα: Τα URL ετικετών διαφημίσεων για ροή ζωντανού βίντεο πρέπει να περιέχουν το στοιχείο /live στη διαδρομή τους, προκειμένου να διασφαλιστεί η δυνατότητα διαχείρισης όγκων αυξημένης κίνησης, όπου όλα τα διαφημιστικά διαλείμματα προβάλλονται ταυτόχρονα.

Παράδειγμα ετικέτας διαφήμισης VAST

Ένα δείγμα URL ετικέτας διαφήμισης VAST, με παραμέτρους και εκχωρημένες τιμές, θα έχει περίπου την εξής μορφή:

https://securepubads.g.doubleclick.net/gampad/ads?env=vp&gdfp_req=1&output=vast&iu=/1234/video-demo&sz=400x300&unviewed_position_start=1&ciu_szs=728x90,300x250

 σελιδοδείκτηςΜετάβαση σε συγκεκριμένη παράμετρο στη λίστα

aconp
ad_rule
ad_type
addtl_consent
afvsz
allcues
an
ciu_szs
correlator
cmsid
cust_params
description_url
dth
env
excl_cat
gdfp_req
gdpr
gdpr_consent
givn

hl
iabexcl
idtype
ipd
ipe
is_lat
iu
lip
ltd
max_ad_duration
min_ad_duration
mridx
msid
nofb
npa
omid_p
output
paln
plcmt

pmad
pmnd
pmxd
pod
pp
ppt
ppid
ppos
ppsj
ptpl
ptpln
pubf
pvid
pvid_s
pvtf
rdid
rdp
schain
scor

sdk_apis
sdmax
sid
ssss
sz
tfcd
trt
unviewed_position_start
url
vad_type
vconp
vid
vid_d
vpa
vpi
vpmute
vpos
wta

Παράμετρος Λεπτομέρειες
aconp

(Συνεχής αναπαραγωγή ήχου)

Συνιστάται σύμφωνα με τις Οδηγίες μέτρησης ήχου MRC

Η παράμετρος συνεχούς αναπαραγωγής ήχου δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν το πρόγραμμα αναπαραγωγής πρόκειται να αναπαράγει συνεχόμενα το περιεχόμενο ήχου.

Αυτή η παράμετρος πρέπει να μην ορίζεται, στην περίπτωση που δεν είναι γνωστή.

Παράδειγμα χρήσης

Συνεχής αναπαραγωγή ΕΝΕΡΓΗ:
aconp=2

Συνεχής αναπαραγωγή ΑΝΕΝΕΡΓΗ:
aconp=1

ad_rule

(Κανόνας διαφήμισης)

Η παράμετρος κανόνα διαφήμισης δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν θα εμφανίζεται δημιουργικό VAST ή μια απόκριση κανόνων διαφήμισης.

Η προεπιλεγμένη ρύθμιση για κανόνες διαφήμισης εξαρτάται από μια ρύθμιση δικτύου Ad Manager. Μπορείτε να παρακάμψετε τη ρύθμιση για συγκεκριμένες ετικέτες διαφημίσεων, χρησιμοποιώντας τα παρακάτω παραδείγματα.

Παράδειγμα χρήσης

Αίτημα για δημιουργικό VAST:
ad_rule=0

Αίτημα για κανόνες διαφήμισης (VMAP):
ad_rule=1

Απαίτηση

Απαιτείται Απαιτείται για κανόνες διαφήμισης βίντεο

ad_type

(Τύπος διαφήμισης)

Οι παράμετροι τύπου διαφήμισης δέχονται μια σταθερή τιμή που υποδεικνύει τους τύπους διαφήμισης που πρέπει να εμφανίζονται για το αίτημα.

Αυτή η παράμετρος απαιτείται μόνο για διαφημίσεις ήχου.

Όταν το στοιχείο ad_type έχει οριστεί σε audio ή audio_video, η παράμετρος vpmute πρέπει να οριστεί σε 0.

Παραδείγματα χρήσης

Επιτρέπονται μόνο διαφημίσεις ήχου:
ad_type=audio

Επιτρέπονται τόσο οι διαφημίσεις βίντεο με δυνατότητα παράβλεψης όσο και οι διαφημίσεις βίντεο χωρίς δυνατότητα παράβλεψης:
ad_type=video

Επιτρέπονται τόσο οι διαφημίσεις ήχου όσο και οι διαφημίσεις βίντεο:
ad_type=audio_video
(Η συγκεκριμένη τιμή επιτρέπει και στις δύο μορφές να ανταγωνίζονται, αλλά προβάλλεται μόνο η μία.)

Ο τύπος διαφήμισης audio_video προορίζεται για χρήση μόνο για την προβολή δημιουργικών βίντεο σε περιεχόμενο ήχου που υποστηρίζει αναπαραγωγή διαφημίσεων βίντεο ή δημιουργικών ήχου σε προγράμματα αναπαραγωγής βίντεο σε ροή για περιεχόμενο που παρέχει δυνατότητα ακρόασης από τη φύση του. Για παράδειγμα, ροές αθλητικών, videocast, ειδήσεις κ.λπ. Διαβάστε περισσότερα σχετικά με τον ήχο σε περιεχόμενο βίντεο.

Επιτρέπονται μόνο διαφημίσεις βίντεο με δυνατότητα παράβλεψης:
ad_type=skippablevideo

Επιτρέπονται μόνο διαφημίσεις βίντεο χωρίς δυνατότητα παράβλεψης:
ad_type=standardvideo

Απαίτηση

Απαιτείται Απαιτείται για διαφημίσεις ήχου

afvsz

(Μη γραμμικά μεγέθη διαφημίσεων)

Η παράμετρος μη γραμμικών μεγεθών διαφημίσεων δέχεται σταθερές τιμές οι οποίες πρέπει να είναι μια λίστα διαχωρισμένη με κόμματα που περιέχει τα μη γραμμικά μεγέθη διαφημίσεων τα οποία μπορούν να προβληθούν στην υποδοχή διαφήμισης βίντεο.

Πρέπει να επιλέγεται κάποιο από τα μεγέθη που υποστηρίζονται:

  • 200x200
  • 250x250
  • 300x250
  • 336x280
  • 450x50
  • 468x60
  • 480x90
  • 729x90

Κατά τη χρήση του Κιτ ανάπτυξης λογισμικού IMA, αυτό το πεδίο θα αντικατασταθεί και θα συμπληρωθεί με όλα τα υποστηριζόμενα μεγέθη που εμπίπτουν εντός των παραμέτρων nonLinearAdSlotWidth και nonLinearAdSlotHeight.

Αυτή η παράμετρος μπορεί να παραλείπεται ή να μένει κενή όταν υποστηρίζονται μη γραμμικά μεγέθη.

Παράδειγμα χρήσης

Υποστηρίζονται όλα τα μεγέθη:
afvsz=200x200,250x250,300x250,336x280,
450x50,468x60,480x90,728x90

Το μέγιστο πλάτος είναι 250:
afvsz=200x200,250x250

Το μέγιστο ύψος είναι 60:
afvsz=450x50,468x60

Το μέγιστο πλάτος είναι 100:
//empty; no values supported

 

Απαίτηση

Απαιτείται Απαιτείται για μη γραμμικές διαφημίσεις βίντεο όταν δεν χρησιμοποιείται το Κιτ ανάπτυξης λογισμικού IMA

allcues

(Όλα τα σημεία υπόδειξης)

Αυτή η παράμετρος δέχεται μεταβλητές τιμές οι οποίες είναι μια λίστα διαχωρισμένη με κόμματα που περιέχει σημεία υπόδειξης, σε χιλιοστά του δευτερολέπτου. Για κάθε τιμή, το Ad Manager εμφανίζει ένα διαφημιστικό διάλειμμα.

Οι παράμετροι vid_d και allcues χρησιμοποιούνται για την προβολή διαφημίσεων κατά τη διάρκεια του βίντεο χωρίς απορρόφηση περιεχομένου. Για την εμφάνιση διαφημίσεων κατά τη διάρκεια του βίντεο απαιτούνται επίσης οι κανόνες διαφήμισης.

Εάν χρησιμοποιούνται υποδείξεις βάσει χρόνου στους κανόνες διαφήμισης (για παράδειγμα, Κάθε N δευτερόλεπτα ή Σε συγκεκριμένες χρονικές στιγμές), τότε χρησιμοποιούνται αυτές που ορίζονται στον κανόνα διαφήμισης και οι υποδείξεις που μεταβιβάζονται στην παράμετρο allcues παραβλέπονται. Οι διαφημίσεις κατά τη διάρκεια του βίντεο εξακολουθούν να απαιτούν διάρκεια, επομένως εξακολουθεί να είναι απαραίτητη η μεταβίβαση της παραμέτρου vid_d.

Παράδειγμα χρήσης

Σημεία υπόδειξης στα 10 και 20 δευτερόλεπτα:
allcues=10000,20000

ciu_szs

(Μεγέθη συνοδευτικών)

Η παράμετρος μεγεθών συνοδευτικών διαφημίσεων δέχεται μεταβλητές τιμές οποίες είναι μια λίστα διαχωρισμένη με κόμματα που περιέχει τα μεγέθη των συνοδευτικών διαφημίσεων.

Οι τιμές που διαχωρίζονται με κάθετο (|) υποδεικνύουν μια υποδοχή διαφήμισης πολλών μεγεθών.

Παράδειγμα χρήσης

ciu_szs=728x90,300x250

Μεγέθη με υποδοχή διαφήμισης πολλών μεγεθών:
ciu_szs=728x90,300x200|300x250

cmsid

(Αναγνωριστικό πηγής περιεχομένου)

vid

(Αναγνωριστικό βίντεο)

Οι παράμετροι αναγνωριστικού πηγής περιεχομένου και αναγνωριστικού βίντεο δέχονται μεταβλητές τιμές. 

Για να στοχεύσετε διαφημίσεις σε περιεχόμενο βίντεο, η κύρια ετικέτα βίντεο πρέπει να περιλαμβάνει και τις δύο αυτές παραμέτρους.

Η παράμετρος cmsid είναι ένας μοναδικός αριθμός για κάθε πηγή περιεχομένου. Για να τον εντοπίσετε στο Ad Manager, κάντε κλικ στην επιλογή Βίντεο και έπειτα Πηγές περιεχομένου και έπειτα στο όνομα της πηγής.

Η παράμετρος vid είναι μια συμβολοσειρά ή ένας αριθμός που ταυτοποιεί ένα συγκεκριμένο βίντεο. Η εκχώρηση αυτού του αναγνωριστικού γίνεται από το CMS που φιλοξενεί το περιεχόμενό σας. Για να το εντοπίσετε στο Ad Manager, κάντε κλικ στο στοιχείο Βίντεο και έπειτα Περιεχόμενο και έπειτα στο συγκεκριμένο περιεχόμενο βίντεο.

Παράδειγμα χρήσης

cmsid=[value]&vid=[value]

Εάν δημιουργείτε μια ετικέτα για Εισαγωγή δυναμικής διαφήμισης με βίντεο κατά απαίτηση, θα πρέπει να χρησιμοποιήσετε τις μακροεντολές που θα εισάγουν δυναμικά τη σωστή πηγή περιεχομένου και το σωστό αναγνωριστικό βίντεο. 

Για παράδειγμα: cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%

Απαίτηση

Απαιτείται Απαιτείται για στόχευση περιεχομένου βίντεο

correlator

(Παράμετρος συσχέτισης)

Η παράμετρος συσχέτισης δέχεται μια μεταβλητή τιμή η οποία χρησιμοποιείται από κοινού από πολλά αιτήματα που προέρχονται από την ίδια προβολή σελίδας. Χρησιμοποιείται για την υλοποίηση ανταγωνιστικών εξαιρέσεων, συμπεριλαμβανομένων εκείνων σε περιβάλλοντα χωρίς cookie.

Εάν χρησιμοποιείται το Κιτ ανάπτυξης λογισμικού IMA, η τιμή παραμέτρου συσχέτισης ορίζεται αυτόματα. Εάν το πρόγραμμα αναπαραγωγής επιχειρήσει να ορίσει αυτήν την τιμή, το SDK την αντικαθιστά με τη δική του τιμή.

Εάν δεν χρησιμοποιείται το Κιτ ανάπτυξης λογισμικού IMA, βεβαιωθείτε ότι έχετε ορίσει μια πραγματικά τυχαία, θετική, ακέραια τιμή, η οποία δεν επαναχρησιμοποιείται από πολλές προβολές σελίδας.

Παράδειγμα χρήσης

correlator=4345645667

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

cust_params

(Προσαρμοσμένες παράμετροι κλειδιών-τιμών)

Η παράμετρος προσαρμοσμένων παραμέτρων δέχεται μεταβλητές τιμές οι οποίες είναι ζεύγη κλειδιών-τιμών που σας επιτρέπουν να ορίσετε συγκεκριμένη στόχευση, όπως δημογραφικά στοιχεία, συγκεκριμένα σημεία σε μια σελίδα ή μια συγκεκριμένη σελίδα ή σελίδες.

Παράδειγμα χρήσης

Δείτε παραδείγματα σχετικά με τον τρόπο προσθήκης ζευγών κλειδιών/τιμών.

description_url

(URL περιγραφής)

Η παράμετρος URL περιγραφής δέχεται μια μεταβλητή τιμή που πρέπει να περιγράφει το βίντεο που αναπαράγεται στη σελίδα. Περιγράψτε τη σελίδα με 1-3 παραγράφους που περιγράφουν το περιεχόμενο. Για παράδειγμα, συρράψτε δυναμικά το περιεχόμενο της σελίδας description_url από προκαθορισμένα μπλοκ. Μάθετε περισσότερα σχετικά με την παροχή ενός διακριτού URL περιγραφής.

Η τιμή description_url πρέπει να είναι κωδικοποιημένη κατά URL για τα προγράμματα αναπαραγωγής βίντεο ιστοσελίδων και συσκευών CTV/OTT και μη κωδικοποιημένη για τα προγράμματα αναπαραγωγής βίντεο σε εφαρμογές για κινητά.

Αυτή η παράμετρος δεν ορίζεται αυτόματα από το Κιτ ανάπτυξης λογισμικού IMA. Πρέπει να οριστεί μη αυτόματα.

Παράδειγμα χρήσης

Κωδικοποίηση URL:
description_url=
https%3A%2F%2Fwww.sample.com%2Fgolf.html

Χωρίς κωδικοποίηση:
description_url=
https://www.sample.com/golf.html

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό, για εφαρμογές και για το Ad Exchange

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

dth

(Υπόδειξη τύπου συσκευής)

Η παράμετρος υπόδειξης τύπου συσκευής δέχεται μια σταθερή τιμή που συμβάλλει στη μείωση της λανθασμένης κατηγοριοποίησης συσκευών, ειδικά σε περιβάλλοντα συνδεδεμένων τηλεοράσεων και αποκωδικοποιητών.

Μια λανθασμένη κατηγοριοποίηση συσκευής μπορεί να προκύψει από ακούσια σφάλματα από τον εκδότη ή τον OEM της συνδεδεμένης τηλεόρασης. Αυτή η παράμετρος θα χρησιμοποιηθεί σε συνδυασμό με άλλα χαρακτηριστικά ταυτοποίησης, προκειμένου η Google να επισημαίνει αυτόματα περιπτώσεις όπου το απόθεμα συνδεδεμένης τηλεόρασης μπορεί να κατηγοριοποιηθεί εκ νέου.

Παραδείγματα χρήσης

Αιτήματα από:

  • Κινητό με λειτουργίες: dth=1
  • Smartphone: dth=2
  • Υπολογιστής: dth=3
  • Tablet: dth=4
  • Συνδεδεμένη τηλεόραση: dth=5
  • Κονσόλα παιχνιδιών: dth=6
  • Αποκωδικοποιητής: dth=7

Απαίτηση

προτεινόμενες Συνιστάται για Δημιουργία εσόδων μέσω προγραμματισμού σε συνδεδεμένη τηλεόραση.

Αυτή η παράμετρος συνιστάται για υλοποιήσεις PAL και PAI (εκτός SDK). Δεν απαιτείται για IMA SDK ή DAI SDK.

env

(Περιβάλλον)

Η παράμετρος περιβάλλοντος δέχεται μια σταθερή τιμή που υποδεικνύει ένα αίτημα σε ροή ή ότι το αίτημα προέρχεται συγκεκριμένα από ένα πρόγραμμα αναπαραγωγής βίντεο.

Οι πιθανές τιμές είναι instream, που μπορεί να χρησιμοποιηθεί για διαφημίσεις βίντεο και ήχου ή vp που μπορεί να χρησιμοποιηθεί μόνο για διαφημίσεις βίντεο.

Παράδειγμα χρήσης

Βίντεο ή/και ήχος:
env=instream

Μόνο βίντεο:
env=vp

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

excl_cat

(Κατηγορία αποκλεισμού)

Η παράμετρος κατηγορίας εξαίρεσης δέχεται μεταβλητές τιμές και χρησιμοποιείται για τον αποκλεισμό τυχόν στοιχείων γραμμής που περιέχουν την εν λόγω ετικέτα εξαίρεσης, ώστε να μην είναι κατάλληλα για ένα συγκεκριμένο αίτημα για διαφήμιση. Αυτή η παράμετρος λειτουργεί με το στοιχείο cust_params.

Παράδειγμα χρήσης

&cust_params=excl_cat%3Dairline_excl_label%7C

gdfp_req

(Ένδειξη σχήματος Ad Manager)

Η παράμετρος ένδειξης σχήματος Ad Manager δέχεται μια σταθερή τιμή η οποία υποδεικνύει ότι ο χρήστης είναι στο σχήμα Ad Manager.

Παράδειγμα χρήσης

gdfp_req=1

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

gdpr

(GDPR)

Η παράμετρος GDPR δέχεται σταθερές τιμές και χρησιμοποιείται από εκδότες που επιθυμούν την ενσωμάτωση με το IAB TCF v2.0. Τα άμεσα αιτήματα VAST δεν διαβάζουν αυτόματα τις τιμές, αλλά γίνονται αποδεκτά όταν προστίθενται στις ετικέτες διαφημίσεων.

Μόνο οι τιμές 0 και 1 είναι έγκυρες για αυτήν την παράμετρο, όπου το 0 σημαίνει ότι δεν ισχύει η παράμετρος GDPR και το 1 σημαίνει ότι η παράμετρος GDPR ισχύει. Αν ισχύει η παράμετρος GDPR, πρέπει επίσης να καταχωρίσετε μια έγκυρη συμβολοσειρά TC, χρησιμοποιώντας την παράμετρο gdpr_consent.

Μπορείτε να διαβάσετε περισσότερα σχετικά με τις τιμές που μεταβιβάζονται σε αυτήν την παράμετρο στις γενικές οδηγίες για την υλοποίηση του πλαισίου ή στην ενότητα Συμβολοσειρά TC της προδιαγραφής IAB TCF v2.0.

Παράδειγμα χρήσης

Ισχύει η παράμετρος GDPR:
gdpr=1

Η παράμετρος GDPR δεν ισχύει:
gdpr=0

givn
paln

(Αριθμός nonce των βίντεο)

For integrations that use the Programmatic Access Library (PAL), the video nonce parameter accepts a variable string value.

The nonce is URL safe—you don't need to URL-encode it.

Note: If you previously provided a nonce using the legacy paln parameter, it is strongly recommended to migrate to the givn parameter and stop sending paln. Do not include both parameters.

Usage example

You can read more about the value passed to this parameter in the getting started guides for PAL.

hl

(Γλώσσα)

Η παράμετρος γλώσσας δέχεται μια σταθερή τιμή η οποία χρησιμοποιείται για την υποβολή αιτημάτων για διαφημίσεις στη συγκεκριμένη γλώσσα και για τη γλώσσα της επιλογής διαφημίσεων και την απόδοση της διαφήμισης βίντεο κατά τη δυναμική κατανομή σε βίντεο στο Ad Exchange ή το AdSense.

Η τιμή της παραμέτρου μπορεί να είναι οποιοσδήποτε κωδικός ISO 639-1 (δύο γράμματα) ή ISO 639-2 (τρία γράμματα). Δείτε μια λίστα έγκυρων κωδικών.

Εάν παραλειφθεί, η προεπιλεγμένη τιμή είναι οποιαδήποτε γλώσσα με στόχευση διαφημίσεων βάσει γλώσσας στο Ad Exchange.

Παράδειγμα χρήσης

hl=it

Απαίτηση

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

iabexcl

(URL εξαίρεσης IAB)

Η παράμετρος URL iabexcl δέχεται μια λίστα κατηγοριών διαχωρισμένων με κόμματα.

Παράδειγμα χρήσης

Το iabexcl=3,14,527 εξαιρεί τις κατηγορίες "Επαγγελματικά φορτηγά", "Οχήματα εκτός δρόμου" και "Ράγκμπι".

Μάθετε περισσότερα σχετικά με την Ταξινόμηση περιεχομένου IAB.

ipd

(Τομέας συνεργάτη αποθέματος)

Η παράμετρος τομέα συνεργάτη αποθέματος δέχεται μεταβλητές τιμές οι οποίες πρέπει να οριστούν στις δηλώσεις partnerpartnerdomain στο αρχείο app-ads.txt (ή στο αρχείο ads.txt) του εκδότη. 

Η παράμετρος inventorypartnerdomain είναι μια προδιαγραφή του IAB που βοηθά τους εκδότες να προσδιορίσουν έναν τομέα ενός συνεργάτη κοινής χρήσης αποθέματος για τους σκοπούς επικύρωσης του αρχείου ads.txt/app-ads.txt.

Η δήλωση IPD είναι ιδιαίτερα σημαντική σε περιπτώσεις κοινής χρήσης αποθέματος όπου το απόθεμα διαφημίσεων από το οποίο προέρχεται ένα αίτημα μπορεί να ανήκει σε άλλον συνεργάτη (τον συνεργάτη κοινής χρήσης αποθέματος).

Μάθετε περισσότερα σχετικά με το αρχείο ads.txt/app-ads.txt και τους συνεργάτες κοινής χρήσης αποθέματος.

ipe

(Οντότητα που κάνει ping εμφανίσεις)

Η παράμετρος οντότητας που κάνει ping εμφανίσεις αποδέχεται μια σταθερή τιμή η οποία χρησιμοποιείται για να υποδείξει ping εμφανίσεων και μετατροπές που προέρχονται από τον διακομιστή, όχι από την εφαρμογή πελάτη.

Παράδειγμα χρήσης

Σηματοδότηση από την πλευρά του διακομιστή (SSB):
ipe=ssb

iu

(Στοιχείο διαφημίσεων)

Η παράμετρος στοιχείου διαφημίσεων δέχεται μια μεταβλητή τιμή η οποία πρέπει να ορίζεται στο τρέχον στοιχείο διαφημίσεων, με τη μορφή:

/network_id/.../ad_unit

Παράδειγμα χρήσης

iu=/6062/videodemo

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

lip

(Τελευταία θέση στην ομάδα διαφημίσεων)

Η παράμετρος για την τελευταία θέση στην ομάδα διαφημίσεων δέχεται μια σταθερή τιμή για να υποδείξει ένα αίτημα από την τελευταία θέση σε μια ομάδα διαφημίσεων.

Αυτή η παράμετρος είναι μόνο για βασικές ομάδες διαφημίσεων.

Παράδειγμα χρήσης

lip=true

ltd

(Περιορισμένες διαφημίσεις)

Η παράμετρος περιορισμένων διαφημίσεων δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν η προβολή των διαφημίσεων θα γίνεται με περιορισμένο τρόπο όταν δεν υπάρχει συναίνεση για τη χρήση cookie ή άλλων τοπικών αναγνωριστικών.

Προειδοποίηση

Σε αντίθεση με άλλες παραμέτρους URL, η ρύθμιση ltd=1 αλλάζει τη συμπεριφορά του Κιτ ανάπτυξης λογισμικού IMA έτσι ώστε να αντιμετωπίζει το αίτημα ως αίτημα χωρίς αναγνωριστικό και να μην επιτρέπει την αποθήκευση.

Παράδειγμα χρήσης

ltd=1

min_ad_duration

(Ελάχιστη διάρκεια διαφήμισης)

max_ad_duration

(Μέγιστη διάρκεια διαφήμισης)

Οι παράμετροι διάρκειας διαφημίσεων δέχονται μεταβλητές τιμές που, όταν λαμβάνονται μαζί, προσδιορίζουν το εύρος διάρκειας με το οποίο πρέπει να αντιστοιχιστεί μια διαφήμιση σε χιλιοστά του δευτερολέπτου.

Χρησιμοποιήστε αυτήν την παράμετρο για να περιορίσετε τη διάρκεια μεμονωμένης διαφήμισης για μεμονωμένα αιτήματα για διαφημίσεις και βελτιστοποιημένα αιτήματα για ομάδες διαφημίσεων.

Παράδειγμα χρήσης

min_ad_duration=15000&max_ad_duration=30000

mridx

(Αριθμός σταδίου κατά τη διάρκεια του βίντεο)

Η παράμετρος αριθμού κατά τη διάρκεια του βίντεο δέχεται μια μεταβλητή τιμή η οποία υποδεικνύει τον αριθμό σειράς της διαφήμισης κατά τη διάρκεια του βίντεο (για παράδειγμα, κατά τη διάρκεια του βίντεο 1, κατά τη διάρκεια του βίντεο 2 κ.λπ.).

Παράδειγμα χρήσης

mridx=2

msid

(Αναγνωριστικό εφαρμογής)

an

(Όνομα εφαρμογής)

Οι παράμετροι αναγνωριστικού εφαρμογής και ονόματος εφαρμογής δέχονται μεταβλητές τιμές οι οποίες πρέπει να εφαρμόζονται σε αιτήματα που αποστέλλονται από εφαρμογές για κινητά και συνδεδεμένες συσκευές τηλεόρασης, καθώς απαιτούνται από τις περισσότερες διαφημίσεις βίντεο μέσω προγραμματισμού.

Το Κιτ ανάπτυξης λογισμικού IMA θα συμπληρώσει αυτόματα και τις δύο παραμέτρους, αλλά θα πρέπει να προσδιοριστούν με μη αυτόματο τρόπο σε περιβάλλοντα εκτός SDK, συμπεριλαμβανομένων των απευθείας κλήσεων VAST ή όταν χρησιμοποιείτε τη Βιβλιοθήκη πρόσβασης μέσω προγραμματισμού (PAL) ή το Απόθεμα με έλεγχο ταυτότητας εκδότη (PAI).

Παρόλο που το όνομα της εφαρμογής θα πρέπει να είναι σε αναγνώσιμη μορφή, σε iOS και tvOS δεν είναι δυνατή η πρόσβαση του SDK στο αναγνωριστικό εφαρμογής. Σε αυτές τις περιπτώσεις, η παράμετρος msid δεν αποστέλλεται και το SDK αποστέλλει το πακέτο εφαρμογής μέσω της παραμέτρου an.

Παράδειγμα χρήσης

msid=com.package.publisher&an=sample%20app

Τα αναγνωριστικά εφαρμογών έχουν διαφορετικά ονόματα και μορφοποίηση στα διάφορα app store. Ανατρέξτε στις οδηγίες του IAB για τον προσδιορισμό εφαρμογών ή σε παραδείγματα συνηθισμένων μοναδικών αναγνωριστικών.

Για πλατφόρμες στις οποίες δεν υπάρχει app store, το IAB συνιστά στους εκδότες να χρησιμοποιούν την ακόλουθη μορφή για τα αναγνωριστικά καταστημάτων: com.publisher.deviceplatform

Απαίτηση

Απαιτείται Και οι δύο παράμετροι απαιτούνται για την εφαρμογή

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

nofb

(Εναλλακτικό βίντεο απενεργοποιημένο)

Η παράμετρος απενεργοποιημένης εναλλακτικής δέχεται μια σταθερή τιμή για να υποδείξει ότι το αίτημα για διαφήμιση δεν πρέπει να εμφανίζει ένα playlist με διαφημίσεις εναλλακτικού βίντεο.

Παράδειγμα χρήσης

Απενεργοποιημένη εναλλακτική:
nofb=1

npa

(Μη εξατομικευμένη διαφήμιση)

Η παράμετρος μη εξατομικευμένων διαφημίσεων δέχεται μια σταθερή τιμή για να υποδείξει ότι το αίτημα για διαφήμιση πρέπει να αντιμετωπίζεται ως μη εξατομικευμένο.

Πρέπει είτε να ορίσετε ρητά την παράμετρο npa=1 είτε να συμπεριλάβετε απλά την παράμετρο npa (χωρίς καθορισμένη τιμή), για να προσθέσετε στο αίτημα την ετικέτα μη εξατομικευμένο. Τα αιτήματα για διαφημίσεις που δεν διαθέτουν αυτήν την παράμετρο ή στα οποία η παράμετρος έχει οριστεί σε nap=0, χρησιμοποιούν από προεπιλογή εξατομικευμένες διαφημίσεις.

Παράδειγμα χρήσης

Μη εξατομικευμένες διαφημίσεις:
npa=1

omid_p

(Όνομα συνεργάτη OMID)

Η παράμετρος ονόματος συνεργάτη OMID δέχεται μια μεταβλητή τιμή η οποία υποδεικνύει το όνομα του συνεργάτη που ενσωματώνει τη μέτρηση OMID και την έκδοση συνεργάτη.

Αυτή η παράμετρος ισχύει μόνο για εκδότες που θέλουν τη μέτρηση Ενεργής προβολής, όταν χρησιμοποιούν το SDK Open Measurement (OM SDK). Δεν θα πρέπει να χρησιμοποιείται κατά τη χρήση του Κιτ ανάπτυξης λογισμικού IMA, καθώς ορίζεται αυτόματα.

Για να υποδείξετε την υποστήριξη OMID όταν χρησιμοποιείτε τη Βιβλιοθήκη πρόσβασης μέσω προγραμματισμού (PAL), πρέπει να χρησιμοποιήσετε τα omidPartnerName και omidPartnerVersion API προκειμένου να ορίσετε το όνομα και την έκδοση του συνεργάτη. Όταν δεν χρησιμοποιείτε PAL ή IMA, θα πρέπει να ορίσετε τις παραμέτρους omid_p και sdk_apis (τα υποστηριζόμενα API, που μπορούν επίσης να περιλαμβάνουν άλλα API διαχωρισμένα με κόμμα).

Παράδειγμα χρήσης

Όταν χρησιμοποιείτε PAL:
request.omidPartnerName = 'examplepartnername'
request.omidPartnerVersion = '1.0.0.0'

Όταν δεν χρησιμοποιείτε PAL:
omid_p=examplepartnername/1.0.0.0&sdk_apis=7

output

(Μορφή εξόδου διαφημίσεων)

Η παράμετρος μορφής εξόδου διαφημίσεων δέχεται μια σταθερή τιμή η οποία πρέπει να οριστεί στη μορφή εξόδου της διαφήμισης.

Χρησιμοποιήστε την παράμετρο output=vast για την προεπιλεγμένη έκδοση VAST που έχει οριστεί για το δίκτυό σας. Για συγκεκριμένες ετικέτες διαφημίσεων ή τμήματα του ιστοτόπου σας, μπορείτε να ζητήσετε συγκεκριμένες εκδόσεις VAST ή VMAP.

Για το VAST, εάν το πρόγραμμα αναπαραγωγής βίντεο χρησιμοποιεί το Κιτ ανάπτυξης λογισμικού IMA, η παράμετρος εξόδου για ένα αίτημα για διαφήμιση βίντεο θα είναι πάντα ρυθμισμένη σε output=xml_vast4. Αυτό δεν δημιουργεί κίνδυνο αξιοπιστίας, καθώς το SDK είναι συμβατό με όλες τις εκδόσεις VAST που ενδέχεται να προβάλλει κάποιος διακομιστής διαφημίσεων τρίτου μέρους.

Χρησιμοποιήστε την παράμετρο output=vmap για να εμφανιστεί η προεπιλεγμένη έκδοση VMAP που έχετε ενεργοποιήσει για το δίκτυό σας (για παράδειγμα, VMAP 1). Εάν εμφανίσετε το VAST εντός του VMAP, μπορείτε να χρησιμοποιήσετε την παράμετρο xml_vmap1_vast3 ή xml_vmap1_vast4, για να καθορίσετε την έκδοση VAST που θα εμφανιστεί.

Παράδειγμα χρήσης

Η προεπιλεγμένη ρύθμιση VAST του δικτύου σας:
output=vast

VAST 4:
output=xml_vast4

Η προεπιλεγμένη ρύθμιση VMAP του δικτύου σας:
output=vmap

VMAP 1:
output=xml_vmap1

VMAP 1, εμφάνιση VAST 4:
output=xml_vmap1_vast4

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

plcmt

(Τοποθέτηση)

Η παράμετρος τοποθέτησης δέχεται μια σταθερή τιμή η οποία χρησιμοποιείται για να υποδείξει αν το απόθεμα σε ροή δηλώνεται ή όχι ως σε ροή ή συνοδευτικό σύμφωνα με τις οδηγίες στις προδιαγραφές του IAB.

Για τα αιτήματα εκτός ροής, αυτό το πεδίο συμπληρώνεται αυτόματα για τους αγοραστές με βάση τη δηλωμένη μορφή αποθέματος και παρακάμπτει οποιαδήποτε δήλωση περιεχομένου σε ροή ή συνοδευτικού περιεχομένου.

Παράδειγμα χρήσης

Αίτημα σε ροή:
plcmt=1

Αίτημα συνοδευτικού περιεχομένου:
plcmt=2

Απαίτηση

 Απαιτείται Απαιτείται για τον ιστό και τη δημιουργία εσόδων μέσω προγραμματισμού

pmad

(Μέγιστος αριθμός διαφημίσεων σε ομάδα διαφημίσεων)

Η παράμετρος μέγιστου αριθμού διαφημίσεων σε ομάδα διαφημίσεων δέχεται μια μεταβλητή τιμή η οποία υποδεικνύει τον μέγιστο αριθμό των διαφημίσεων που υπάρχουν σε μια ομάδα διαφημίσεων.

Αυτή η παράμετρος αφορά συγκεκριμένα βελτιστοποιημένες ομάδες διαφημίσεων, οι οποίες είναι διαθέσιμες σε εκδότες με σύνθετο πακέτο βίντεο. Δεν πρέπει να χρησιμοποιείται για το VMAP (όταν ad_rule=1).

Παράδειγμα χρήσης

pmad=4

pmnd

(Ελάχιστη διάρκεια ομάδας διαφημίσεων)

pmxd

(Μέγιστη διάρκεια ομάδας διαφημίσεων)

Οι παράμετροι διάρκειας ομάδας διαφημίσεων δέχονται μεταβλητές τιμές που, όταν λαμβάνονται μαζί, προσδιορίζουν το εύρος διάρκειας με το οποίο πρέπει να αντιστοιχιστεί μια ομάδα διαφημίσεων, σε χιλιοστά του δευτερολέπτου.

Αυτές οι παράμετροι χρησιμοποιούνται για την υποβολή αιτήματος για πολλές διαφημίσεις. Αφορούν συγκεκριμένα βελτιστοποιημένες ομάδες διαφημίσεων, οι οποίες είναι διαθέσιμες σε εκδότες με σύνθετο πακέτο βίντεο. Δεν πρέπει να χρησιμοποιούνται για το VMAP (όταν ad_rule=1).

Παράδειγμα χρήσης

pmnd=0&pmxd=60000

pod

(Αριθμός ομάδας διαφημίσεων)

Η παράμετρος αριθμού ομάδας διαφημίσεων δέχεται μια μεταβλητή τιμή η οποία αντιπροσωπεύει τον αριθμό σειράς της ομάδας διαφημίσεων σε ένα βίντεο (για παράδειγμα, ομάδα διαφημίσεων 1, ομάδα διαφημίσεων 2 κ.λπ.).

Παράδειγμα χρήσης

pod=3

Απαίτηση

Απαιτείται Απαιτείται για ανταγωνιστικές εξαιρέσεις, περιορισμό συχνότητας και σχετικές λειτουργίες για να λειτουργεί σωστά.

pp

(Προφίλ δημιουργικού)

Η παράμετρος προφίλ δημιουργικού δέχεται μια μεταβλητή τιμή η οποία ελέγχει τα δημιουργικά που είναι κατάλληλα για προβολή βάσει της ρύθμισης διαμόρφωσης σε κάποιο προφίλ δημιουργικού βίντεο και ήχου.

Παράδειγμα χρήσης

pp=creative_profile

Απαίτηση

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

ppt

(Διαχείριση απορρήτου εκδοτών)

Η παράμετρος Διαχείριση απορρήτου εκδοτών δέχεται μια σταθερή τιμή η οποία χρησιμοποιείται για να υποδείξει αν θα απενεργοποιηθεί η εξατομίκευση διαφημίσεων για το αίτημα για διαφήμιση.

Μάθετε περισσότερα σχετικά με την παράμετρο Διαχείριση απορρήτου εκδοτών.

Παράδειγμα χρήσης

Απενεργοποίηση εξατομίκευσης διαφημίσεων:
ppt=1

ppid

(Αναγνωριστικό παρεχόμενο από τον εκδότη)

Η παράμετρος Αναγνωριστικό παρεχόμενο από τον εκδότη (PPID) δέχεται μια μεταβλητή τιμή του αναγνωριστικού και χρησιμοποιείται στον περιορισμό συχνότητας, την τμηματοποίηση και τη στόχευση κοινού, τη διαδοχική εναλλαγή διαφημίσεων και άλλα στοιχεία ελέγχου προβολής διαφημίσεων βάσει κοινού στις συσκευές.

Παράδειγμα χρήσης

ppid=12JD92JD8078S8J29SDOAKC0EF230337

ppos

(Θέση στην ομάδα διαφημίσεων)

Η παράμετρος για τη θέση στην ομάδα διαφημίσεων δέχεται μια μεταβλητή τιμή η οποία αντιπροσωπεύει τη θέση μέσα σε μια ομάδα διαφημίσεων (για παράδειγμα, θέση 1, θέση 2 κ.λπ.).

Αυτή η παράμετρος αφορά μόνο βασικές ομάδες διαφημίσεων και είναι απαραίτητη για την αυτόματη συμπλήρωση συνοδευτικών διαφημίσεων.

Παράδειγμα χρήσης

ppos=2

Απαίτηση

Απαιτείται Απαιτείται για ανταγωνιστικές εξαιρέσεις, περιορισμό συχνότητας και σχετικές λειτουργίες για να λειτουργεί σωστά.

ppsj

(JSON με χαρακτηριστικά ταυτοποίησης παρεχόμενα από τον εκδότη)

Η παράμετρος JSON με χαρακτηριστικά ταυτοποίησης παρεχόμενα από τον εκδότη δέχεται ένα αντικείμενο JSON με κωδικοποίηση base64 που περιέχει δεδομένα κοινού και περιβάλλοντος, τα οποία παρέχονται από τον εκδότη για τη βελτίωση της δημιουργίας εσόδων μέσω προγραμματισμού.

Μάθετε περισσότερα σχετικά με τα χαρακτηριστικά ταυτοποίησης παρεχόμενα από τον εκδότη και τις υποστηριζόμενες ταξινομίες.

Δείτε λεπτομέρειες σχετικά με τα έγκυρα ζεύγη κλειδιών-τιμών JSON στο
δείγμα του Κιτ ανάπτυξης λογισμικού IMA HTML5.

Παράδειγμα χρήσης

Αντικείμενο JSON:
{
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
  }]
}

Τιμή με κωδικοποίηση Base64:
eyJQdWJsaXNoZXJQcm92aWRlZFRheG9ub215U2lnbmFscyI6W3s
idGF4b25vbXkiOiJJQUJfQVVESUVOQ0VfMV8xIiwidmFsdWVzIj
pbIjEiLCIyODQiXX1dfQ

ptpl

(Αναγνωριστικό προτύπου διαφημιστικού διαλείμματος)

ptpln

(Όνομα προτύπου διαφημιστικού διαλείμματος)

Το αναγνωριστικό και το όνομα για το πρότυπο διαφημιστικού διαλείμματος αποδέχονται τιμές μεταβλητών και υποδεικνύουν ποιο πρότυπο διαφημιστικού διαλείμματος θα πρέπει να εφαρμόζεται στο αίτημα βελτιστοποιημένης ομάδας διαφημίσεων. Τα πρότυπα διαφημιστικών διαλειμμάτων σάς επιτρέπουν να ορίσετε τα διαφημιστικά σποτ ή τα προσαρμοσμένα διαφημιστικά σποτ που θα περιλαμβάνονται σε ένα διαφημιστικό διάλειμμα καθώς και τη σειρά με την οποία θα προβάλλονται.

Απαιτείται μόνο μία από τις 2 παραμέτρους (όνομα ή αναγνωριστικό) για την υποβολή αιτήματος για πρότυπο διαφημιστικού διαλείμματος.

Παράδειγμα χρήσης

Μπορείτε να βρείτε περισσότερες λεπτομέρειες σχετικά με τη ρύθμιση και την υποβολή αιτημάτων για πρότυπα διαφημιστικών διαλειμμάτων εδώ.
 
pubf

(Δημόσια κατώτατα όρια τιμών σε ετικέτες Ad Exchange)

pvtf

(Ιδιωτικά κατώτατα όρια τιμών σε ετικέτες Ad Exchange)

Το στοιχείο pubf είναι ισοδύναμο του στοιχείου google_ad_public_floor και το στοιχείο pvtf είναι ισοδύναμο του στοιχείου google_ad_private_floor. Χρησιμοποιούνται για την προσθήκη κατώτατων ορίων τιμών στις ετικέτες Ad Exchange.

Παράδειγμα χρήσης

pubf=123
pvtf=123

pvid

(Αναγνωριστικό συνόλου εφαρμογών)

pvid_s

(Εύρος συνόλου εφαρμογών)

Οι τιμές αναγνωριστικού συνόλου εφαρμογών είναι απαραίτητες για τη δημιουργία εσόδων όταν οι χρήστες εξαιρούνται από την εξατομίκευση σε συσκευές Android.

Η παράμετρος pvid δέχεται μια μεταβλητή τιμή που έχει οριστεί στο αναγνωριστικό συνόλου εφαρμογών Android, ενώ η παράμετρος pvid_s δέχεται μια σταθερή τιμή που αντιπροσωπεύει το εύρος του αναγνωριστικού συνόλου εφαρμογών (scope_app ή scope_developer).

Ενώ το IMA/PAL SDK μεταβιβάζει αυτόματα αυτό το πεδίο, οι εκδότες με υλοποιήσεις εκτός SDK πρέπει να καλέσουν το SDK συνόλου εφαρμογών και να μεταβιβάσουν αυτές τις παραμέτρους μη αυτόματα σε ένα αίτημα για διαφήμιση.

Ανατρέξτε στην τεκμηρίωση Android σχετικά με τον τρόπο ανάκτησης του αναγνωριστικού συνόλου εφαρμογών.

Παράδειγμα χρήσης

pvid=[AppSetID_value]
pvid_s=scope_app

Απαίτηση

Απαιτείται Απαιτείται για εφαρμογή

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

rdid
idtype
is_lat

(Αναγνωριστικά συσκευής με δυνατότητα επαναφοράς)

Τα αναγνωριστικά συσκευών με δυνατότητα επαναφοράς δέχονται μεταβλητές τιμές.

Με τις εγγενείς εφαρμογές (όχι στον ιστό ή στον ιστό για κινητά), το SDK μεταβιβάζει αναγνωριστικά συσκευών με δυνατότητα επαναφοράς για στόχευση χρηστών στα αιτήματα ροής σας με τις παραμέτρους για τα στοιχεία rdid, idtype και is_lat. Σε ροές SSB, θα πρέπει να τα μεταβιβάζετε με τη μορφή ρητών παραμέτρων, όπως θα κάνατε σε ένα αίτημα για διαφήμιση από την πλευρά της εφαρμογής-πελάτη. Μάθετε περισσότερα σχετικά με τα αναγνωριστικά συσκευών.

Σχεδόν όλες οι διαφημίσεις βίντεο μέσω προγραμματισμού απαιτούν την παρουσία αυτών των τιμών.

Προειδοποίηση

Από την έκδοση iOS 14.5, η Apple κατάργησε το χαρακτηριστικό ταυτοποίησης LAT. Αντ' αυτού, η Google βασίζεται στην παρουσία ενός μη μηδενικού IDFA για να υποδείξει ότι ο χρήστης έχει συναινέσει στην παρακολούθηση σε εκδόσεις iOS που υποστηρίζουν το App Tracking Transparency. Επομένως, απαιτείται ένα έγκυρο UserAgent που υποδεικνύει τη σωστή έκδοση του λειτουργικού συστήματος.

Παράδειγμα χρήσης

Δείτε αναλυτικά παραδείγματα αναγνωριστικών συσκευών με δυνατότητα επαναφοράς.

Απαίτηση

Απαιτείται Απαιτείται για εφαρμογή

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

rdp

(Περιορισμός επεξεργασίας δεδομένων)

Η παράμετρος περιορισμού επεξεργασίας δεδομένων δέχεται μια σταθερή τιμή για να υποδείξει ότι το αίτημα για διαφήμιση πρέπει να περιορίζει την επεξεργασία δεδομένων.

Πρέπει είτε να ορίσετε το rdp=1 είτε να συμπεριλάβετε απλώς το rdp (χωρίς ορισμένη τιμή), για να περιορίσετε την επεξεργασία δεδομένων. Τα αιτήματα για διαφημίσεις που δεν έχουν αυτήν την παράμετρο ή την έχουν ορίσει ως rdp=0, δεν θα περιορίζονται, εκτός και αν είναι ενεργοποιημένη η ρύθμιση δικτύου Περιορισμός επεξεργασίας δεδομένων.

Παράδειγμα χρήσης

rdp=1

schain

(Εφοδιαστική αλυσίδα)

Η παράμετρος εφοδιαστικής αλυσίδας δέχεται μια μεταβλητή τιμή, η οποία θα πρέπει να είναι σειριοποιημένο αντικείμενο SupplyChain. Όταν περιλαμβάνεται αυτή η παράμετρος, η Google προσαρτά έναν κόμβο σε τυχόν ληφθέντα αντικείμενα schain πριν από την αποστολή στους αγοραστές.

Ανατρέξτε στην πλήρη τεκμηρίωση του IAB για την κοινοποίηση πληροφοριών SupplyChain μέσω ετικέτας (αντί για το OpenRTB).

Δείτε τις απαιτήσεις για τη σωστή ανάλυση του schain

Με βάση την τεκμηρίωση του IAB, τα παρακάτω ορίζουν την σειριοποίηση για το αντικείμενο SupplyChain:

  • {SupplyChainObject}!{SupplyChainNode array}. Οι ιδιότητες SupplyChainObject και SupplyChainNode διαχωρίζονται με κόμμα, με τρόπο που επιτρέπει την παράλειψη των προαιρετικών πεδίων και τον προαιρετικό αποκλεισμό των διαχωριστικών τους κομμάτων.
  • Κάθε στοιχείο SupplyChainNode διαχωρίζεται με ένα "!".
  • Αν η τιμή οποιασδήποτε ιδιοκτησίας περιέχει χαρακτήρες που απαιτούν κωδικοποίηση URL (για παράδειγμα, "," ή "!"), η τιμή θα πρέπει να έχει κωδικοποίηση URL πριν από τη σειριοποίηση.

Σειρά σειριοποίησης

Οι ιδιότητες SupplyChainObject σειριοποιούνται με την εξής σειρά:

ver,complete

Οι ιδιότητες SupplyChainNode σειριοποιούνται με την εξής σειρά:

asi,sid,hp,rid,name,domain,ext

Σημείωση: Τα περιεχόμενα του στοιχείου ext αφορούν συγκεκριμένα την ανταλλαγή. Το Google Ad Manager δεν αναλύει αυτή την ιδιότητα.

Παραδείγματα του τρόπου σειριοποίησης του αντικειμένου SupplyChain

Ακολουθούν δύο παραδείγματα τρόπων σειριοποίησης του παραπάνω αντικειμένου SupplyChain:

Σειροποίηση με κόμματα για κενά προαιρετικά πεδία

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Σειριοποίηση χωρίς κόμματα για κενά προαιρετικά πεδία

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Μάθετε περισσότερα σχετικά με το αντικείμενο SupplyChain.

Παραδείγματα χρήσης

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Αν η τιμή για το asi ήταν exchange,1, τότε η σειριοποίηση με χαρακτήρες διαφυγής θα είχε την εξής μορφή:

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Απαίτηση

Απαιτείται Απαιτείται για εκδότες που αξιοποιούν διαμεσολαβητές πληρωμών πριν από το αίτημα στο Google Ad Manager. Σε αυτούς περιλαμβάνονται οι εκδότες που χρησιμοποιούν τεχνολογία διακομιστή διαφημίσεων τρίτου μέρους.

scor

(Συσχέτιση ροής)

Η παράμετρος συσχέτισης ροής δέχεται μια μεταβλητή τιμή η οποία πρέπει να είναι ένας ακέραιος που δημιουργείται για κάθε ροή βίντεο. Ο αριθμός πρέπει να είναι ο ίδιος μέσα σε μια ροή και μοναδικός μέσα σε μια προβολή σελίδας. Χρησιμοποιείται για ανταγωνιστικές εξαιρέσεις, περιορισμό συχνότητας και σχετικές λειτουργίες, εάν ένας χρήστης παρακολουθεί πολλά βίντεο στην ίδια σελίδα.

Παράδειγμα χρήσης

scor=17

Απαίτηση

Απαιτείται Απαιτείται για ανταγωνιστικές εξαιρέσεις, περιορισμό συχνότητας και σχετικές λειτουργίες για να λειτουργεί σωστά.

sdk_apis

(Πλαίσιο API SDK)

Η παράμετρος για το πλαίσιο του SDK API δέχεται μια λίστα με σταθερές ακέραιες τιμές διαχωρισμένες με κόμματα οι οποίες υποδεικνύουν όλα τα πλαίσια API που υποστηρίζει το πρόγραμμα αναπαραγωγής.

Δείτε μια λίστα με τις πιθανές τιμές για το πλαίσιο API.

Αυτή η παράμετρος υποστηρίζει API στη Βιβλιοθήκη πρόσβασης μέσω προγραμματισμού (PAL) για εκδότες που δεν χρησιμοποιούν το Κιτ ανάπτυξης λογισμικού IMA. Το Κιτ ανάπτυξης λογισμικού IMA παρακάμπτει τυχόν τιμές που έχουν οριστεί με τις τιμές που υποστηρίζονται από το Κιτ ανάπτυξης λογισμικού IMA.

Παράδειγμα χρήσης

sdk_apis=2,7,9

sdmax

(Μέγιστη διάρκεια διαφήμισης με δυνατότητα παράβλεψης)

Η παράμετρος αιτήματος για διαφήμιση sdmax (μέγιστη διάρκεια διαφήμισης με δυνατότητα παράβλεψης) δέχεται μια μεταβλητή τιμή που επιτρέπει στους εκδότες να καθορίσουν την επιθυμητή μέγιστη διάρκεια διαφήμισης για τις διαφημίσεις με δυνατότητα παράβλεψης.

Δέχεται μια τιμή διάρκειας σε χιλιοστά του δευτερολέπτου που αντιπροσωπεύει το ανώτερο όριο που θα πρέπει να επιτρέπεται για τη διάρκεια των δημιουργικών βίντεο/ήχου με δυνατότητα παράβλεψης για το συγκεκριμένο αίτημα για διαφήμιση.

Χρησιμοποιήστε την παράμετρο sdmax ανεξάρτητα για διαφημίσεις με δυνατότητα παράβλεψης ή σε συνδυασμό με την υπάρχουσα παράμετρο max_ad_duration, για να παράσχετε διαφορετικές μέγιστες διάρκειες για διαφημίσεις με δυνατότητα παράβλεψης και διαφημίσεις χωρίς δυνατότητα παράβλεψης.

Παράδειγμα χρήσης

Η χρήση των ακόλουθων ρυθμίσεων:

  • max_ad_duration = 15.000 (15 δευτερόλεπτα)
  • sdmax = 45.000 (45 δευτερόλεπτα)

Για τα ακόλουθα δημιουργικά:

  • Δημιουργικό Α: χωρίς δυνατότητα παράβλεψης, 30 δευτ.
  • Δημιουργικό Β: με δυνατότητα παράβλεψης, 30 δευτ.

Έχει το εξής αποτέλεσμα:

  • Το δημιουργικό Α θα φιλτραριστεί επειδή δεν διαθέτει δυνατότητα παράβλεψης και η διάρκειά του υπερβαίνει τη μέγιστη τιμή (χωρίς δυνατότητα παράβλεψης)
  • Το δημιουργικό Β δεν θα φιλτραριστεί επειδή, παρόλο που η διάρκειά του υπερβαίνει την τιμή max_ad_duration, έχει δυνατότητα παράβλεψης και η διάρκειά του δεν υπερβαίνει τη μέγιστη τιμή με δυνατότητα παράβλεψης.
sid

(Αναγνωριστικό περιόδου σύνδεσης)

Η παράμετρος αναγνωριστικού περιόδου σύνδεσης δέχεται μια μεταβλητή τιμή η οποία είναι ένα αναγνωριστικό διαφήμισης που διατηρεί το απόρρητο το οποίο χρησιμοποιείται μόνο για σκοπούς περιορισμού συχνότητας.

Το αναγνωριστικό περιόδου σύνδεσης υποστηρίζεται για αιτήματα βίντεο σε ροή από συνδεδεμένες τηλεοράσεις και σε απόθεμα βίντεο σε ροή από συσκευές εφαρμογών για κινητά. Δεν υποστηρίζεται προς το παρόν για τον ιστό.

Σύμφωνα με τις οδηγίες IFA του IAB, αυτή η παράμετρος θα πρέπει να συμπληρώνεται σε μορφή UUID. Μάθετε περισσότερα σχετικά με τα αναγνωριστικά συσκευών με δυνατότητα επαναφοράς για τη στόχευση χρήστη.

Μπορείτε να εξαιρεθείτε από τη μεταβίβαση του αναγνωριστικού περιόδου σύνδεσης ορίζοντας την παράμετρο sid=0.

Παράδειγμα χρήσης

123e4567-e89b-12d3-a456-426614174000

Απαίτηση

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

ssss

(Πηγή συρραφής από την πλευρά του διακομιστή)

Η παράμετρος πηγής συρραφής από την πλευρά του διακομιστή αποδέχεται μια σταθερή τιμή, η οποία πρέπει να οριστεί σε μια αναγνωρισμένη τιμή που παρέχεται από την Google για τον προμηθευτή τεχνολογίας συρραφής βίντεο.

Οι πάροχοι τεχνολογίας συρραφής βίντεο που χρησιμοποιούν τις ενσωματώσεις διακομιστή προς διακομιστή με την Google αποκτούν αυτήν την αξία από την Google και είναι σε θέση να σας την παρέχουν. Μπορείτε να επικοινωνήσετε με τον Υπεύθυνο λογαριασμού Google για τυχόν ερωτήσεις σχετικά με την τιμή που θα ορίσετε σε αυτήν την παράμετρο.

Παράδειγμα χρήσης

ssss=mystitcher

Απαίτηση

Απαιτείται Απαιτείται για υλοποιήσεις από την πλευρά του διακομιστή

sz

(Μέγεθος)

Η παράμετρος μεγέθους δέχεται μια μεταβλητή τιμή η οποία πρέπει να οριστεί στο μέγεθος της κύριας υποδοχής διαφήμισης βίντεο.

Τα πολλά μεγέθη θα πρέπει να διαχωρίζονται με τον χαρακτήρα της καθέτου (|).

Μην περιλαμβάνετε το γράμμα v μετά από το μέγεθος.

Παράδειγμα χρήσης

sz=400x300

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

Αυτή η παράμετρος είναι προαιρετική, αν ζητείται μόνο το στοιχείο ad_type=audio.

tfcd

(Ετικέτα για περιεχόμενο που προορίζεται για παιδιά)

Η παράμετρος προορίζεται για παιδιά δέχεται μια σταθερή τιμή η οποία προσθέτει στο αίτημα για διαφήμιση την ετικέτα προορίζεται για παιδιά.

Παράδειγμα χρήσης

tfcd=1

trt

(Τύπος επισκεψιμότητας)

Η παράμετρος τύπου επισκεψιμότητας δέχεται μια σταθερή τιμή που λειτουργεί ως αίτημα για αγορασμένη ή οργανική επισκεψιμότητα.

Το Κιτ ανάπτυξης λογισμικού IMA δεν συμπληρώνει μια προεπιλεγμένη τιμή, αν η παράμετρος τύπου επισκεψιμότητας λείπει από ένα αίτημα. Σε αυτές τις περιπτώσεις, ο διακομιστής παρέχει μια προεπιλεγμένη τιμή 0 (μη καθορισμένη επισκεψιμότητα).

Παράδειγμα χρήσης

Αίτημα για αγορασμένη επισκεψιμότητα:
trt=1

Αίτημα για οργανική επισκεψιμότητα:
trt=2

unviewed_position_start

(Καθυστερημένες εμφανίσεις)

Η παράμετρος καθυστερημένων εμφανίσεων δέχεται μια σταθερή τιμή για να υποδεικνύει τις καθυστερημένες εμφανίσεις για το βίντεο.

Παράδειγμα χρήσης

unviewed_position_start=1

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

url

(URL)

Η παράμετρος URL δέχεται μια μεταβλητή τιμή η οποία πρέπει να οριστεί στο πλήρες URL από το οποίο στάλθηκε το αίτημα. Αυτή η τιμή είναι απαραίτητη για να μπορέσουν οι αγοραστές να προσδιορίσουν και να κατανοήσουν το πλαίσιο της προέλευσης αυτού του αιτήματος. Στο μέτρο του δυνατού, αυτή η τιμή θα πρέπει να συμπληρώνεται δυναμικά στο αίτημα για διαφήμιση. 

Σε μια ιστοσελίδα, αυτό είναι το URL της σελίδας που προβάλλει το πρόγραμμα αναπαραγωγής βίντεο. Εάν χρησιμοποιείτε το Κιτ ανάπτυξης λογισμικού IMA, η τιμή του URL ορίζεται αυτόματα. Αν το πρόγραμμα αναπαραγωγής ορίσει αυτήν την τιμή, το Κιτ ανάπτυξης λογισμικού IMA θα λάβει υπόψη την τιμή που έχει οριστεί.

Σε μια εφαρμογή (για κινητά ή CTV), αυτή η τιμή θα πρέπει να ορίζεται σε ένα URL που αντιπροσωπεύει με ακρίβεια το απόθεμα βίντεο ή ήχου από το οποίο δημιουργούνται έσοδα. Για παράδειγμα, όταν ο χρήστης παρακολουθεί ένα βίντεο σε μια εφαρμογή για κινητά που διατίθεται επίσης σε ένα αντίστοιχο URL για υπολογιστές.*

Η τιμή αυτής της παραμέτρου θα πρέπει να κωδικοποιηθεί.

Παράδειγμα χρήσης

url=https%3A%2F%2Fwww.videoad.com%2Fgolf.html

* Για τις εφαρμογές, εάν δεν είναι δυνατός ο ορισμός αυτής της παραμέτρου σε μια μεταβλητή τιμή URL, συνιστάται ο ορισμός της με το παρακάτω μοτίβο:
url=https%3A%2F%2F<app/bundleid>.adsenseformobileapps.com

Απαίτηση

Απαιτείται Απαιτείται για τον ιστό και για εφαρμογή

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

vad_type

(Τύπος διαφήμισης βίντεο)

Η παράμετρος τύπου διαφήμισης βίντεο δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν πρέπει να εμφανιστεί μια γραμμική ή μη γραμμική διαφήμιση.

Παράδειγμα χρήσης

Εμφάνιση γραμμικής διαφήμισης:
vad_type=linear

Εμφάνιση μη γραμμικής διαφήμισης:
vad_type=nonlinear

vid_d

(Διάρκεια βίντεο)

Αυτή η παράμετρος δέχεται μια μεταβλητή τιμή η οποία προσδιορίζει τη διάρκεια του περιεχομένου, σε δευτερόλεπτα. 

Οι παράμετροι vid_d και allcues χρησιμοποιούνται για την προβολή διαφημίσεων κατά τη διάρκεια του βίντεο χωρίς απορρόφηση περιεχομένου. Για την εμφάνιση διαφημίσεων κατά τη διάρκεια του βίντεο απαιτούνται επίσης οι κανόνες διαφήμισης.

Παράδειγμα χρήσης

Διάρκεια περιεχομένου βίντεο 90.000 δευτερολέπτων (25 ώρες):
vid_d=90000

vconp

(Συνεχής αναπαραγωγή βίντεο)

Συνιστάται σύμφωνα με τις Οδηγίες μέτρησης βίντεο MRC

Η παράμετρος συνεχούς βίντεο δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν το πρόγραμμα αναπαραγωγής πρόκειται να αναπαράγει συνεχόμενα το περιεχόμενο βίντεο, όπως ισχύει σε μια τηλεοπτική μετάδοση.

Αυτή η παράμετρος πρέπει να μην ορίζεται, στην περίπτωση που δεν είναι γνωστή.

Παράδειγμα χρήσης

Συνεχής αναπαραγωγή ΕΝΕΡΓΗ:
vconp=2

Συνεχής αναπαραγωγή ΑΝΕΝΕΡΓΗ:
vconp=1

vpa

(Αυτόματη αναπαραγωγή βίντεο)

Προτείνεται σύμφωνα με MRC Οδηγίες μέτρησης βίντεο

Η παράμετρος αυτόματης αναπαραγωγής βίντεο δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν το περιεχόμενο βίντεο σε μια διαφήμιση θα ξεκινά αυτόματα μέσω αυτόματης αναπαραγωγής ή μετά από κλικ.

Οι πιθανές τιμές είναι click, αν η σελίδα περιμένει μια ενέργεια από τον χρήστη ή auto, αν η αναπαραγωγή του βίντεο ξεκινάει αυτόματα.

Αυτή η παράμετρος πρέπει να μην ορίζεται, στην περίπτωση που δεν είναι γνωστή.

Παράδειγμα χρήσης

Αυτόματη αναπαραγωγή:
vpa=auto

Κλικ για αναπαραγωγή:
vpa=click

Απαίτηση

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

vpi

(inred playlist βίντεο)

Η παράμετρος inred playlist βίντεο δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν θα γίνεται ή όχι προβολή ενσωματωμένου VMAP (εμφάνιση VAST εντός του VMAP).

Αυτή η παράμετρος μπορεί να χρησιμοποιηθεί για τη μείωση του λανθάνοντα χρόνου και την εγγύηση των ορίων συχνότητας και των ανταγωνιστικών εξαιρέσεων σε μια ροή βίντεο.

Παράδειγμα χρήσης

Εμφάνιση VAST:
vpi=1

Εμφάνιση ανακατευθύνσεων:
vpi=0

vpmute

(Σίγαση αναπαραγωγής βίντεο)

Προτείνεται σύμφωνα με MRC Οδηγίες μέτρησης βίντεο

Η παράμετρος βίντεο σε σίγαση δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν η αναπαραγωγή της διαφήμισης θα ξεκινά όταν το πρόγραμμα αναπαραγωγής βίντεο είναι σε σίγαση.

Παράδειγμα χρήσης

Σίγαση:
vpmute=1

Κατάργηση σίγασης:
vpmute=0

Απαίτηση

 Απαιτείται Απαιτείται για τον ιστό και τη δημιουργία εσόδων μέσω προγραμματισμού

vpos

(Θέση βίντεο)

Η παράμετρος θέσης βίντεο δέχεται μια σταθερή τιμή η οποία υποδεικνύει αν το αίτημα για διαφήμιση αποστέλλεται πριν το βίντεο, κατά τη διάρκεια του βίντεο ή μετά το βίντεο.

Παράδειγμα χρήσης

Πριν το βίντεο:
vpos=preroll

Κατά τη διάρκεια του βίντεο:
vpos=midroll

Μετά το βίντεο:
vpos=postroll

Απαίτηση

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

wta

(Γιατί αυτή η διαφήμιση)

Η παράμετρος "Γιατί αυτή η διαφήμιση;" δέχεται μια σταθερή τιμή, η οποία υποδεικνύει την υποστήριξη του προγράμματος αναπαραγωγής βίντεο για την απόδοση σήμανσης διαφημίσεων. Όταν δεν αποστέλλεται παράμετρος &wta, η προεπιλογή είναι &wta=1.

Η λειτουργία σήμανσης διαφημίσεων υποστηρίζεται αυτόματα κατά τη χρήση του IMA SDK. Όταν δεν χρησιμοποιείται το IMA SDK, τα προγράμματα αναπαραγωγής βίντεο θα πρέπει να υποστηρίζουν τις παραμέτρους VAST Icon και IconClickFallbackImage, όπως αναφέρεται στο πρότυπο IAB VAST.

Οι εκδότες πρέπει να στέλνουν την παράμετρο &wta=0, σε περίπτωση που ο εκδότης δεν θα αποδώσει το εικονίδιο Οι διαφημίσεις μου, όπως παρέχεται στην απόκριση VAST. Ένα αίτημα για διαφημίσεις με την παράμετρο &wta=1 ή χωρίς την παράμετρο &wta υποδεικνύει ότι ο εκδότης θα αποδίδει τις παρεχόμενες πληροφορίες "Οι διαφημίσεις μου".

Τα αιτήματα για διαφημίσεις ήχου ενδέχεται να στέλνουν την παράμετρο wta=1, στην περίπτωση που το εικονίδιο Οι διαφημίσεις μου, όπως παρέχεται στην απόκριση VAST, θα αποδοθεί σε συνοδευτικές διαφημίσεις ή θα παρασχεθεί με άλλον τρόπο στον χρήστη.

Για την επισκεψιμότητα από τον ΕΟΧ, τα αιτήματα με την παράμετρο &wta=0 δεν θα είναι κατάλληλα για δημιουργικά δέσμευσης όπου η σήμανση Google είναι ενεργοποιημένη.

Οι διαφημίσεις πρέπει να συμμορφώνονται με τις ισχύουσες ρυθμιστικές απαιτήσεις για τις διαφημίσεις που προβάλλονται στον Ευρωπαϊκό Οικονομικό Χώρο (ΕΟΧ). Σε αυτές περιλαμβάνεται ένας μηχανισμός μέσω του οποίου οι χρήστες μπορούν να αναφέρουν παράνομο περιεχόμενο. Οι εκδότες πρέπει να ειδοποιούν την Google για τυχόν αναφορές παράνομου περιεχομένου, χρησιμοποιώντας την κατάλληλη φόρμα.

Παράδειγμα χρήσης

Υποστηρίζονται τα εξής:

wta=1 ή καμία παράμετρος wta

Δεν υποστηρίζεται:
wta=0

Απαίτηση

Απαιτείται Απαιτείται για το Ad Exchange

Απαιτείται Απαιτείται για επισκεψιμότητα από τον ιστό και τις εφαρμογές στον ΕΟΧ

προτεινόμενες Συνιστάται για δημιουργία εσόδων μέσω προγραμματισμού

Σας βοήθησε αυτό;

Με ποιον τρόπο μπορούμε να το βελτιώσουμε;
Αναζήτηση
Διαγραφή αναζητήσεων
Κλείσιμο αναζήτησης
Κύριο μενού
12125264028999979170
true
Αναζήτηση στο Κέντρο Βοήθειας
true
true
true
true
true
148
false
false