Elementul personalizat <devsite-recommendations>
poate fi folosit pentru a oferi recomandări de conținut cititorilor dvs. Puteți lăsa sistemul să genereze recomandări , puteți oferi singur recomandări explicite sau puteți încheia secțiunile de recomandări existente ale documentului dvs. pentru o prezentare coerentă, statistici de clic și o interfață de utilizator bogată (inclusiv descrieri și imagini).
Utilizare
Pentru a utiliza acest widget, creați un element <devsite-recommendations>
. Dacă doriți să oferiți recomandări în mod explicit, adăugați câteva link-uri în cadrul elementului. În prezent, recomandările generate de sistem vor fi furnizate atunci când elementul este gol, dar lucrările viitoare vor permite autorilor să experimenteze cu recomandări generate atunci când sunt furnizate recomandări explicite, precum și să le utilizeze ca intrări la algoritm.
Dacă oferiți recomandări explicite, atunci furnizați o markup în cadrul elementului. Orice etichetă <a>
detectată atunci când elementul este conectat vor avea atributele href
extrase și utilizate pentru recomandări.
Dacă oferiți mai mult de trei recomandări, va fi aleasă o selecție aleatorie. Cu toate acestea, ordonarea recomandărilor va rămâne aceeași cu cea a intrărilor, astfel încât recomandările cu prioritate mai mare vor apărea întotdeauna în partea stângă.
Dacă nu doriți să apară recomandări specifice în rezultatele generate, puteți crea un element <devsite-recommendations>
gol cu o colecție de <link rel="disallow" href="/path">
. Orice etichetă <link>
cu rel=disallow
și un atribut href
vor fi detectate și eliminate automat din recomandările generate.
Dacă doriți doar recomandări dintr-un anumit subset de pagini, puteți utiliza etichete de nomenclatură într-un câmp query
pentru a filtra rezultatele. Sintaxa este k:category:value
. De exemplu, k:language:typescript. Lista de etichete poate fi o listă separată prin virgulă ( k:language:typescript,k:language:swift
) pentru a include pagini care conțin oricare dintre etichete.
Exemplu cu linkuri
Următoarele secțiuni descriu marcajul, cum se redă în condiții normale și cum se redă către mașini sau agenți simpli de utilizare.
Markup
<devsite-recommendations>
<p>Note: link text is displayed when JavaScript is off</p>
<ul>
<li><a href="/maps/documentation">Maps docs</a></li>
<li><a href="/analytics">Analytics</a></li>
<li><a href="/machine-learning/crash-course">MLCC</a></li>
</ul>
</devsite-recommendations>
Rezultat
Agenți de utilizator simpli
Notă: textul linkului este afișat când JavaScript este dezactivat
Exemplu cu interdicții
Markup
<devsite-recommendations>
<link rel="disallow" href="/maps/documentation">
<link rel="disallow" href="/analytics">
<link rel="disallow" href="/machine-learning/crash-course">
</devsite-recommendations>
Rezultat
Deoarece rezultatele depind de recomandări, care se pot schimba, rezultatul va apărea la fel ca rezultatul din modelul de recomandări.
Încheierea conținutului existent
Elementul poate îmbunătăți treptat marcajele existente pe paginile dvs., astfel încât să puteți actualiza link-urile existente prin împachetarea acestora cu <devsite-recommendations>
.
Noile legături vor adopta toate funcționalitățile și politicile platformei de recomandare, cum ar fi colectarea de date și tablourile de bord pentru experimente, dar conținutul va fi, de asemenea, înlocuit cu metadate bogate, inclusiv descrieri și imagini, și pot exclude unele legături (de exemplu, acces controlat sau pagini fără metadate).
Markup
<devsite-recommendations>
<h2>Example communities</h2>
<p>Note: All markup here will be replaced with the recommendation UI.</p>
<p>
For more information on Google Developers, check out our <a href="/community/experts">GDEs</a>. If
you are looking to form a community, take a look at <a href="/community/gdg">GDGs</a>. Lastly, if
you're currently studying, don't miss our <a href="/community/dsc">DSCs</a>.
</p>
</devsite-recommendations>
Rezultat
Notă: toate marcajele de aici vor fi înlocuite cu interfața de utilizare de recomandare. Pentru mai multe informații despre Google Developers, consultați GDE-urile noastre . Dacă doriți să formați o comunitate, aruncați o privire la GDG-uri . În cele din urmă, dacă în prezent studiezi, nu rata DSC-urile noastre. Exemple de comunități
Utilizare în fișierele Markdown
Într-un fișier Markdown ( .md ), asigurați-vă că elementul personalizat este împachetat cu un element HTML standard, cum ar fi <section>
sau <div>
:
Conținut mixt
## Markdown section
* Markdown list
* [Markdown link](/foo)
## HTML section
<div>
<devsite-recommendations>
<p>Note: link text is displayed when JavaScript is off</p>
<h2>Sample heading</h2>
<a href="/recommended">Recommended</a>
</devsite-recommendations>
</div>
Secțiunea Markdown
- Lista de reduceri
- Link de reducere
secțiunea HTML
Notă: textul linkului este afișat când JavaScript este dezactivat
Antetul eșantionului
RecomandatReducere pură
<pre><devsite-recommendations>
## Sample heading
* Note: link text is displayed when JavaScript is off
* [Maps documentation](/maps/documentation)
</devsite-recommendations><pre>
Rezultat
{% text %}Antetul eșantionului
- Notă: textul linkului este afișat când JavaScript este dezactivat
- Documentația hărților
Atributele sistemului
În prezent, singurele atribute acceptate sunt pentru controlul comportamentului sistemului și nu ar trebui să fie necesare utilizatorilor normali.
yield
(opțional) Dacă este furnizat, elementul va ceda oricăror alte elemente de recomandare nepersive de pe pagină. Acesta este de obicei folosit de site-ul însuși pentru a plasa automat recomandări pe o pagină, dar pentru a le afișa numai atunci când nu sunt prezente alte instanțe.
Filtrarea cu Nomenclatură
Markup
<devsite-recommendations query="k:language:typescript">
</devsite-recommendations>