ווידג'טים: המלצות

ניתן להשתמש ברכיב המותאם אישית <devsite-recommendations> כדי לספק המלצות לתוכן לקוראים שלך. אתם יכולים לאפשר למערכת ליצור המלצות, לספק המלצות מפורשות בעצמכם או לארוז קטעי המלצות קיימים במסמך כדי לשמור על עקביות בהצגה, בנתונים סטטיסטיים של קליקים ובממשק משתמש עשיר (כולל תיאורים ותמונות).

שימוש

כדי להשתמש בווידג'ט הזה, צריך ליצור רכיב <devsite-recommendations>. אם אתם רוצים לספק המלצות באופן מפורש, אתם יכולים להוסיף כמה קישורים בתוך הרכיב. נכון לעכשיו, המלצות שנוצרות על ידי המערכת יסופקו כשהאלמנט ריק, אבל נאפשר לכותבים להתנסות בעתיד עם המלצות שנוצרות על ידי קבלת המלצות מפורשות, וכן להשתמש בהן כקלט לאלגוריתם.

אם אתם מספקים המלצות מפורשות, עליכם להוסיף תגי עיצוב בתוך הרכיב. המערכת תחלץ את מאפייני href של כל תגי <a> שיזוהו כשהרכיב מחובר, וישתמשו בהם לצורך הצגת ההמלצות.

אם מספקים יותר משלוש המלצות, תיבחר בחירה אקראית. עם זאת, הסדר של ההמלצות יישאר זהה לסדר הקלט, כך שהמלצות עם עדיפות גבוהה יותר תמיד יוצגו בפינה הימנית העליונה.

אם לא רוצים שהמלצות ספציפיות יופיעו בתוצאות שנוצרו, אפשר ליצור רכיב <devsite-recommendations> ריק עם אוסף של <link rel="disallow" href="/path">. כל תג <link> עם המאפיין rel=disallow ועם המאפיין href יזוהה באופן אוטומטי ויוסרו מההמלצות שנוצרו.

אם רוצים לקבל המלצות רק מקבוצת משנה ספציפית של דפים, אפשר להשתמש בתגי Nomenclature בשדה query כדי לסנן את התוצאות. התחביר הוא k:category:value. לדוגמה, k:language:typescript. רשימת התגים יכולה להיות רשימה מופרדת בפסיקים (k:language:typescript,k:language:swift) כדי לכלול דפים שמכילים אחד מהתגים.

הקטעים הבאים מתארים את תגי העיצוב, איך הוא מוצג בתנאים רגילים ואיך הוא מוצג למכונות או לסוכני משתמש פשוטים.

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>

תוצאה

סוכני משתמש פשוטים

הערה: טקסט הקישור מוצג כאשר JavaScript מושבת

דוגמה עם איסורים

Markup

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

תוצאה

התוצאות תלויות בהמלצות, והן עשויות להשתנות, ולכן הפלט ייראה זהה לפלט ממודל ההמלצות.

גלישת תוכן קיים

הרכיב יכול לשפר בהדרגה את תגי העיצוב הקיימים בדפים שלכם, כך שתוכלו לשדרג קישורים קיימים על ידי גלישתם ב-<devsite-recommendations>.

הקישורים החדשים יאמצו את כל הפונקציונליות וכללי המדיניות של פלטפורמת ההמלצות, כמו איסוף נתונים ומרכזי בקרה של ניסויים, אבל גם התוכן יוחלף במטא-נתונים עשירים, כולל תיאורים ותמונות. יכול להיות שהמערכת לא תכלול קישורים מסוימים (למשל, קישורים עם בקרת גישה או דפים ללא מטא-נתונים).

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>

תוצאה

קהילות לדוגמה

הערה: כל תגי העיצוב כאן יוחלפו בממשק המשתמש של ההמלצה.

מידע נוסף על Google Developers זמין בקבוצות GDE. אם המיקום שאתם רוצים ליצור קהילה, כדאי להסתכל על GDG. לבסוף, אם שאתם לומדים כרגע, אל תפספסו את DSCs שלנו.

שימוש בקובצי Markdown

בקובץ Markdown (.md), חשוב לוודא שהרכיב המותאם אישית מוקף ברכיב HTML סטנדרטי, כמו <section> או <div>:

תוכן מעורב

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

קטע Markdown

קטע ב-HTML

הערה: טקסט הקישור מוצג כאשר JavaScript מושבת

כותרת לדוגמה

המלצות

Markdown בלבד

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

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

</devsite-recommendations><pre>

תוצאה

כותרת לדוגמה

מאפייני המערכת

בשלב זה המאפיינים הנתמכים היחידים הם לשליטה בהתנהגות המערכת, והם לא אמורים להידרש למשתמשים רגילים.

yield (אופציונלי) אם תספקו אותו, הרכיב יניב המלצות לכל רכיב אחר בדף שלא יניב תפוקה. בדרך כלל, האתר עצמו משתמש באפשרות הזו כדי למקם המלצות בדף באופן אוטומטי, אבל כדי להציג אותן רק כשאין מופעים אחרים.

סינון באמצעות שמות

Markup

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

תוצאה