Widgeturi: Recomandări

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.

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

Exemple de comunități

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.

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

secțiunea HTML

Notă: textul linkului este afișat când JavaScript este dezactivat

Antetul eșantionului

Recomandat

Reducere pură

<pre><devsite-recommendations>
## Sample heading

* Note: link text is displayed when JavaScript is off
* [Maps documentation](/maps/documentation)

</devsite-recommendations><pre>

Rezultat

{% text %} {% endverbatim %}

Antetul eșantionului

{% text %}
{% endverbatim %}

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>

Rezultat