Widgety: Odporúčania

Vlastný prvok <devsite-recommendations> možno použiť na poskytovanie odporúčaní obsahu vašim čitateľom. Môžete nechať systém generovať odporúčania , môžete sami poskytnúť explicitné odporúčania alebo môžete zabaliť existujúce sekcie odporúčaní vo svojom dokumente pre konzistentnú prezentáciu, štatistiky prekliknutí a bohaté používateľské rozhranie (vrátane popisov a obrázkov).

Použitie

Ak chcete použiť tento widget, vytvorte prvok <devsite-recommendations> . Ak chcete poskytnúť odporúčania explicitne, pridajte do prvku nejaké odkazy. V súčasnosti budú odporúčania generované systémom dodávané, keď je prvok prázdny, ale budúca práca umožní autorom experimentovať s vygenerovanými odporúčaniami, keď budú poskytnuté explicitné odporúčania, ako aj ich použiť ako vstupy do algoritmu.

Ak poskytujete explicitné odporúčania, poskytnite v rámci prvku nejaké označenie. Všetky značky <a> zistené pri pripojení prvku budú mať extrahované atribúty href a použité na odporúčania.

Ak zadáte viac ako tri odporúčania, vyberie sa náhodný výber. Poradie odporúčaní však zostane rovnaké ako poradie vstupu, takže odporúčania s vyššou prioritou sa budú vždy zobrazovať úplne vľavo.

Ak nechcete, aby sa vo vygenerovaných výsledkoch zobrazovali konkrétne odporúčania, môžete vytvoriť prázdny prvok <devsite-recommendations> s kolekciou <link rel="disallow" href="/path"> . Všetky značky <link> s rel=disallow a atribútom href budú automaticky zistené a odstránené z vygenerovaných odporúčaní.

Ak chcete odporúčania len z určitej podskupiny stránok, môžete použiť značky nomenklatúry v poli query na filtrovanie výsledkov. Syntax je k:category:value . Napríklad k:language:typescript. Zoznam značiek môže byť zoznam oddelený čiarkami ( k:language:typescript,k:language:swift ), aby zahŕňal stránky, ktoré obsahujú niektorú zo značiek.

Nasledujúce časti popisujú označenie, ako sa vykresľuje za normálnych podmienok a ako sa vykresľuje počítačom alebo jednoduchým užívateľským agentom.

Označenie 

<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>

Výsledok

Jednoduché user-agenty

Poznámka: Text odkazu sa zobrazí, keď je JavaScript vypnutý

Príklad s nepovolením

Označenie

<devsite-recommendations>
  <link rel="disallow" href="/maps/documentation">
  <link rel="disallow" href="/analytics">
  <link rel="disallow" href="/machine-learning/crash-course">
</devsite-recommendations>

Výsledok

Keďže výsledky závisia od odporúčaní, ktoré sa môžu meniť, výstup bude vyzerať rovnako ako výstup z modelu odporúčaní.

Zalamovanie existujúceho obsahu

Prvok môže postupne vylepšovať existujúce značky na vašich stránkach, takže existujúce odkazy môžete inovovať tak, že ich zabalíte do <devsite-recommendations> .

Nové odkazy prevezmú všetky funkcie a zásady platformy odporúčaní, ako je zhromažďovanie údajov a informačné panely experimentov, ale obsah bude tiež nahradený bohatými metadátami vrátane popisov a obrázkov a môže vylúčiť niektoré odkazy (napr. riadený prístup alebo stránky bez metadát).

Označenie 

<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>

Výsledok

Príklady komunít

Poznámka: Všetky značky tu budú nahradené používateľským rozhraním odporúčaní.

Viac informácií o Google Developers nájdete v našich GDE . Ak chcete vytvoriť komunitu, pozrite sa na GDGs . Nakoniec, ak práve študujete, nenechajte si ujsť naše DSC .

Použitie v súboroch Markdown

V súbore Markdown ( .md ) sa uistite, že je vlastný prvok zabalený do štandardného prvku HTML, ako je napríklad <section> alebo <div> :

Zmiešaný obsah 

## 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>

Sekcia Markdown

HTML sekcia

Poznámka: Text odkazu sa zobrazí, keď je JavaScript vypnutý

Vzorový nadpis

Odporúčané

Čistá markdown

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

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

</devsite-recommendations><pre>

Výsledok

{% doslovne %} {% endverbatim %}

Vzorový nadpis

{% doslovne %} {% endverbatim %}

Systémové atribúty

V súčasnosti sú jediné podporované atribúty určené na riadenie správania systému a bežní používatelia by ich nemali potrebovať.

yield (voliteľné) Ak je dodaný, prvok sa podvolí akýmkoľvek iným nevýťažným prvkom odporúčania na stránke. Toto zvyčajne používa samotná lokalita na automatické umiestňovanie odporúčaní na stránku, ale na ich zobrazenie iba vtedy, keď neexistujú žiadne iné inštancie.

Filtrovanie pomocou nomenklatúry

značkovanie 

<devsite-recommendations query="k:language:typescript">
</devsite-recommendations>

Výsledok