Για προχωρημένους χρήστες, παραθέτουμε αυτή τη λίστα με τις παραμέτρους στιλ αναζήτησης που υποστηρίζονται προς το παρόν. Ο κώδικας που δημιουργείτε στο AdSense περιέχει όλες τις ρυθμίσεις παραμέτρων που χρησιμοποιούνται συχνότερα. Υπάρχουν δύο απαιτούμενες παράμετροι: pubId
και query
. Το AdSense παρέχει την παράμετρο pubId, ωστόσο εσείς πρέπει να επεξεργαστείτε τον κώδικα και να μεταβιβάσετε μια τιμή για την παράμετρο query
. Όλες οι άλλες παράμετροι είναι προαιρετικές και περιγράφονται παρακάτω.
Τύποι παραμέτρων
Υπάρχουν δύο τύποι παραμέτρων:
- Παράμετροι σε επίπεδο σελίδας που ισχύουν για όλα τα στοιχεία διαφημίσεων στη σελίδα
- Παράμετροι σε επίπεδο στοιχείου που ισχύουν για μεμονωμένα στοιχεία διαφημίσεων.
Ακολουθεί ένα παράδειγμα που προέρχεται από το πρόγραμμα δημιουργίας κώδικα με δύο αποκλεισμούς διαφημίσεων. Για να διαμορφώσετε αυτόν τον κώδικα, πρέπει να ορίσετε την απαιτούμενη παράμετρο query
στη συνάρτηση pageOptions
(π.χ. "query": myQuery
). Αυτή είναι η μόνη ενέργεια που απαιτείται, προκειμένου να ξεκινήσει η προβολή διαφημίσεων. Μπορείτε επίσης να ορίσετε προαιρετικές παραμέτρους στον αποκλεισμό σε επίπεδο σελίδας, καθώς και μεμονωμένες παραμέτρους σε επίπεδο στοιχείου στις συναρτήσεις adblock1
και adblock2
.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Περιγραφές παραμέτρων σε επίπεδο σελίδας
Αυτές οι παράμετροι πρέπει να καθορίζονται μόνο μία φορά ανά σελίδα. Επηρεάζουν όλα τα στοιχεία της σελίδας.
Απαιτείται
Παράμετρος | Περιγραφή και παραδείγματα |
---|---|
adPage |
Απαιτείται όταν ο χρήστης μεταβαίνει στην επόμενη ή στην προηγούμενη σελίδα αποτελεσμάτων
Η παράμετρος |
pubId |
Απαιτείται Αυτό είναι το αναγνωριστικό πελάτη AdSense. Η παράμετρος pubId είναι το τμήμα του αναγνωριστικού πελάτη που έπεται του "partner-". Για παράδειγμα, αν το αναγνωριστικό πελάτη είναι "partner-test-property", η παράμετρος pubId είναι "test-property". Πρόκειται για το πρωτόκολλο που εφαρμόζεται συνήθως για τις διαφημίσεις Προσαρμοσμένης αναζήτησης (CSA). Παράδειγμα: 'pubId' : 'test-property' |
query |
Απαιτείται Αυτό είναι το ερώτημα αναζήτησης που καταχωρίζεται από τον χρήστη. Η τιμή της παραμέτρου ερωτήματος δεν θα πρέπει να είναι κωδικοποιημένη. Παραδείγματα:
|
resultsPageBaseUrl |
Απαιτείται όταν υπάρχουν στοιχεία συναφούς αναζήτησης στη σελίδα Καθορίζει το URL της σελίδας αποτελεσμάτων αναζήτησης στην οποία το ερώτημα αναζήτησης είναι ο όρος συναφούς αναζήτησης στον οποίο έχει κάνει κλικ ο χρήστης. Η παράμετρος resultsPageBaseUr μπορεί να περιλαμβάνει τις δικές της παραμέτρους, εκτός από το ερώτημα αναζήτησης, το οποίο θα προστίθεται αυτόματα.
Παράδειγμα:
|
styleId |
Απαιτείται Καθορίζει το αναγνωριστικό του στιλ αναζήτησης που θα εφαρμοστεί στα στοιχεία διαφημίσεων ή στα στοιχεία συναφούς αναζήτησης στη σελίδα. Μάθετε περισσότερα σχετικά με τη χρήση των στιλ αναζήτησης. Έχετε υπόψη ότι, αν οριστεί η παράμετρος styleId για ένα αίτημα, οι διαφημίσεις ή οι συναφείς αναζητήσεις θα αποδίδονται με το στιλ, ενώ οι παράμετροι στιλ παλαιού τύπου θα παραβλέπονται. Αν η παράμετρος styleId δεν προσδιορίζεται στο αίτημα, θα αποδίδεται ένα στιλ προεπιλεγμένο από το σύστημα. Παράδειγμα
|
Προαιρετικό
Παράμετρος | Περιγραφή και παραδείγματα |
---|---|
linkTarget |
Προαιρετικά Καθορίζει αν με το κλικ σε μια διαφήμιση θα γίνεται άνοιγμα στο ίδιο παράθυρο ή σε νέο παράθυρο. Η προεπιλογή είναι "_top". Αυτή η παράμετρος μπορεί επίσης να χρησιμοποιηθεί σε επίπεδο στοιχείου.
Παράδειγμα: 'linkTarget' : '_blank' |
maxTermLength |
Προαιρετικά Καθορίζει τον μέγιστο αριθμό χαρακτήρων ενός όρου συναφούς αναζήτησης, συμπεριλαμβανομένων των κενών διαστημάτων. Δεν επιλέγεται μέγιστη τιμή, αν δεν έχει οριστεί. Παράδειγμα: 'maxTermLength' : 50 |
referrerAdCreative |
Προαιρετικά Αν ένας χρήστης μεταβεί στη σελίδα περιεχομένου, η οποία περιέχει ένα στοιχείο Συναφούς αναζήτησης για περιεχόμενο, κάνοντας κλικ σε μια διαφήμιση ή έναν σύνδεσμο σε άλλο ιστότοπο, και η συγκεκριμένη διαφήμιση ή ο σύνδεσμος βρίσκονται υπό τον έλεγχό σας, αυτή η παράμετρος θα πρέπει να οριστεί αυτολεξεί στο δημιουργικό της συγκεκριμένης διαφήμισης ή του συνδέσμου. Οι παρακάτω οδηγίες ισχύουν για τη χρήση αυτής της παραμέτρου:
Παραδείγματα: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Προαιρετικά Καθορίζει το όνομα της παραμέτρου URL για το ερώτημα αναζήτησης στη σελίδα αποτελεσμάτων αναζήτησης. Αν δεν προσδιορίζεται, ορίζεται από προεπιλογή το "q". Παράδειγμα: 'resultsPageQueryParam' : 'query' |
terms |
Προαιρετικά Αυτή η παράμετρος σας επιτρέπει να παρέχετε μια λίστα των δικών σας όρων συναφούς αναζήτησης, διαχωρισμένων με κόμματα, οι οποίοι θα εμφανίζονται με ένα αίτημα συναφούς αναζήτησης. Ωστόσο, η Google μπορεί να χρησιμοποιήσει ή να μην χρησιμοποιήσει τους όρους που παρέχονται εδώ. Παράδειγμα: 'terms' : 'cars rental, flight ticket' |
Ρυθμίσεις διαμόρφωσης
Παράμετρος | Περιγραφή και παραδείγματα | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Προαιρετικά Καθορίζει τους κανόνες φιλτραρίσματος που θα πρέπει να εφαρμόζει η Google σε διαφημίσεις που αντιστοιχούν στο ερώτημα αναζήτησης. Ακολουθούν οι έγκυρες ρυθμίσεις για την παράμετρο adsafe και ο αντίκτυπος κάθε τιμής στις διαφημίσεις που εμφανίζονται:
Σημείωση: Από προεπιλογή, η παράμετρος
adsafe έχει οριστεί σε "high".Παράδειγμα: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Προαιρετικά Η παράμετρος adtest χρησιμοποιείται για να δηλώσει ότι ένα αίτημα για διαφημίσεις αποτελεί δοκιμή. Όταν η παράμετρος adtest έχει την τιμή "on", η Google αντιμετωπίζει το αίτημα ως δοκιμή, ενώ δεν καταμετρά τις εμφανίσεις διαφημίσεων και δεν παρακολουθεί τον αριθμό των κλικ.
Όταν η παράμετρος Σημειώσεις:
Από προεπιλογή, η τιμή "adtest" έχει οριστεί σε "off". Παράδειγμα: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Προαιρετικά Μπορείτε να συμπεριλάβετε ένα κανάλι AdSense για Αναζήτηση, προκειμένου να παρακολουθείτε την απόδοση διαφορετικών σελίδων. Χρησιμοποιήστε το μοναδικό αναγνωριστικό καναλιού που δημιουργήσατε στον λογαριασμό σας AdSense. Μάθετε περισσότερα σχετικά με την παρακολούθηση της απόδοσης διαφημίσεων με προσαρμοσμένα κανάλια. Αν καταχωρίζετε πολλά κανάλια, διαχωρίστε τα με το σύμβολο +. Παραδείγματα: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Προαιρετικά Αυτή η παράμετρος προσδιορίζει τη γλώσσα που θα πρέπει να στοχεύουν οι διαφημίσεις για τις οποίες έχει υποβληθεί αίτημα. Η προεπιλεγμένη τιμή είναι "en". Η Google υποστηρίζει όλους τους κωδικούς γλώσσας του Google Ads API. Σημείωση: Οι διαφημιζόμενοι καθορίζουν τις γλώσσες που στοχεύουν οι διαφημίσεις τους. Αν συμπεριλάβετε αυτή την παράμετρο στο αίτημά σας, η Google εμφανίζει μόνο διαφημίσεις που στοχεύουν τη συγκεκριμένη γλώσσα ή όλες τις γλώσσες, αλλά δεν εγγυάται ότι το δημιουργικό θα είναι στη γλώσσα που έχετε καθορίσει.
Συνήθως, θα πρέπει να ορίσετε την παράμετρο Παραδείγματα: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Προαιρετικό
Η παράμετρος Η προεπιλεγμένη τιμή
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Προαιρετικό
Η παράμετρος Η προεπιλεγμένη τιμή
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Καταργήθηκε
Σημείωση: Η εξατομίκευση διαφημίσεων έχει πλέον καταργηθεί για το AdSense για Αναζήτηση. Για περισσότερες πληροφορίες, ανατρέξτε στο άρθρο: Χρήση νέων τομέων προβολής και κατάργηση της εξατομίκευσης διαφημίσεων στο AdSense για Αναζήτηση και σε άλλα προϊόντα διαφημίσεων αναζήτησης.
|
Περιγραφές παραμέτρων σε επίπεδο στοιχείου
Αυτές οι παράμετροι επηρεάζουν τον τρόπο με τον οποίο παρουσιάζονται στον χρήστη τα μεμονωμένα στοιχεία διαφημίσεων σε μια σελίδα. Κάθε παράμετρος μπορεί να οριστεί μεμονωμένα για κάθε στοιχείο διαφημίσεων.
Απαιτείται
Παράμετρος | Περιγραφή και παραδείγματα |
---|---|
container |
Απαιτείται Το αναγνωριστικό του κενού κοντέινερ διαφημίσεων <div id='afscontainer1'></div> στο οποίο θα πρέπει να εμφανίζεται η διαφήμιση.
Παράδειγμα:
|
Ρυθμίσεις διαμόρφωσης
Παράμετρος | Περιγραφή και παραδείγματα | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Προαιρετικά Καθορίζει μια συνάρτηση JavaScript για κλήση, όταν έχει γίνει φόρτωση των διαφημίσεων ή των συναφών αναζητήσεων ή όταν δεν προβάλλονται διαφημίσεις ή συναφείς αναζητήσεις. Η παράμετρος θα πρέπει να ορίζεται σε μια συνάρτηση επανάκλησης JavaScript που εφαρμόζετε, η οποία επιτρέπει την εκτέλεση μιας ενέργειας αφού ολοκληρωθεί η κλήση διαφήμισης. Η συνάρτηση επανάκλησης περιλαμβάνει τις εξής παραμέτρους:
Σημείωση: Ελέγξτε τη συνάρτηση επανάκλησης, για να βεβαιωθείτε ότι δεν δημιουργεί τυχόν σφάλματα, ειδικά εκείνα που ενδέχεται να επηρεάσουν τη φόρτωση της σελίδας σας.
Παράδειγμα επανάκλησης JavaScript: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // most likely do nothing } catch (e) { alert ("Error in callback function"); // Do something to handle error gracefully } } else { // as you always do when there is no ad coverage from Google } } }; |
||||||||
maxTop |
Προαιρετικό
Χρησιμοποιήστε αυτή την παράμετρο, για να καθορίσετε τον αριθμό των διαφημίσεων που θα εμφανίζονται στο επάνω μέρος του στοιχείου διαφημίσεων. Σημείωση: Αυτή η παράμετρος χρησιμοποιείται αντί για την παράμετρο
number . Αυτό το στοιχείο διαφημίσεων θα πρέπει να έχει επαρκές πλάτος, ώστε να μην αναδιπλώνεται η πρώτη γραμμή των διαφημίσεων. Η χρήση της παραμέτρου maxTop σε οποιαδήποτε άλλη τοποθέτηση στη σελίδα συνιστά παράβαση πολιτικής.Παράδειγμα:
|
||||||||
number |
Προαιρετικά Ο αριθμός των διαφημίσεων που πρέπει να εμφανίζονται σε αυτό το στοιχείο. Η προεπιλεγμένη τιμή είναι "2". Παράδειγμα:
|
||||||||
relatedSearches |
Προαιρετικά Ο αριθμός των συναφών αναζητήσεων που πρέπει να εμφανίζονται σε αυτό το στοιχείο. Αυτή η παράμετρος εμφανίζει τουλάχιστον τρεις σχετικές αναζητήσεις, εκτός αν οριστεί σε μηδέν. Αν δεν προσδιορίζεται, ορίζεται από προεπιλογή το "0". Παράδειγμα: 'relatedSearches' : 4 |
||||||||
width |
Προαιρετικά Καθορίζει το πλάτος του στοιχείου διαφημίσεων ή του στοιχείου συναφούς αναζήτησης σε pixel. Παραδείγματα: 'width' : '700px' 'width' : 700 |