Přizpůsobení s více sloty (Preview)

Důležité

Od 20. září 2023 nebudete moct vytvářet nové prostředky personalizace. Služba Personalizace se vyřadí z provozu 1. října 2026.

Přizpůsobení více slotů (Preview) umožňuje cílit na obsah ve webových rozloženích, karuselech a seznamech, kde se uživatelům zobrazí více než jedna akce (například produkt nebo část obsahu). Pomocí rozhraní API pro přizpůsobení s více sloty můžete mít modely AI v personalizaci zjistit, jaké kontexty uživatelů a produkty řídí určité chování, zvažování a učení se z umístění v uživatelském rozhraní. Personalizace může například zjistit, že některé produkty nebo obsah více kliknutí jako boční panel nebo zápatí než hlavní zvýraznění na stránce.

V tomto článku se dozvíte, proč přizpůsobení s více sloty zlepšuje výsledky, jak ji povolit a kdy ji používat. Tento článek předpokládá, že jste obeznámeni s rozhraními API personalizace, jako Rank jsou a Reward, a máte koncepční znalosti o tom, jak ho používáte ve své aplikaci. Pokud personalizaci neznáte a jak funguje, přečtěte si následující informace, než budete pokračovat:

• Co je Personalizace
• Jak personalizace funguje

Důležité

Přizpůsobení s více sloty je ve verzi Public Preview. Funkce, přístupy a procesy se změní na základě zpětné vazby uživatelů. Povolením verze Preview s více sloty se trvale zakáže další funkce Personalizace ve smyčce. Přizpůsobení s více sloty nelze vypnout, jakmile je povolena smyčka Personalizace. Přečtěte si tento dokument a před konfigurací smyčky Personalizace pro více slotů zvažte dopad.

Kdy použít personalizaci s více sloty

Kdykoli uživatelům zobrazíte produkty nebo obsah, můžete zákazníkům zobrazit více než jednu položku. Příklad:

• Rozložení webů pro domovské stránky: Mnoho dlaždic a oblastí stránek je vyhrazené ke zvýraznění obsahu v polích, bannerech a bočních panelech různých tvarů a velikostí. Přizpůsobení více slotů se dozví, jak charakteristiky tohoto rozložení ovlivňují volby a akce zákazníků.
• Karusels: Karusels of dynamicky se měnící obsah potřebuje několik položek na cyklus. Přizpůsobení více slotů může zjistit, jak posloupnost a dokonce doba trvání zobrazení ovlivňuje kliknutí a zapojení.
• Související produkty/ obsah a vložené odkazy: Je běžné zapojit uživatele vkládáním nebo prokládáním odkazů na další obsah a produkty v bannerech, bočních pruhech, vignettech a zápatích. Přizpůsobení více slotů vám může pomoct přidělovat vaše odkazy tam, kde se s největší pravděpodobností více používají.
• Výsledky hledání nebo seznamy: Pokud funkce vyhledávání aplikace, ve které výsledky zadáte jako seznamy nebo dlaždice, můžete pomocí přizpůsobení více slotů vybrat, které položky se mají zvýraznit v horní části s ohledem na více metadat než tradičnírankery.
• Dynamické kanály a seznamy stop: Přizpůsobení více slotů může pomoct určit krátkou posloupnost pro seznam videí nebo skladeb, které se mají přehrávat v dynamickém kanálu.

Přizpůsobení více slotů umožňuje deklarovat "sloty" v uživatelském rozhraní, pro které je potřeba zvolit akce. Umožňuje vám také poskytnout další informace o slotech, aby personalizace mohla použít ke zlepšení umístění produktu - například je to velká krabice nebo malá krabice? Zobrazuje titulek nebo jenom funkci? Je to v zápatí nebo bočním panelu?

Jak používat přizpůsobení více slotů

1. Povolení přizpůsobení více slotů
2. Vytvoření objektu JSON pro požadavek Rank
3. Volání rozhraní Rank API definující sloty a základní akce
4. Volání rozhraní API programu Rewards

Povolení přizpůsobení více slotů

Níže najdete informace o rozdílech mezi přizpůsobením s jedním slotem a více sloty , abyste pochopili a rozhodli, jestli je pro vás přizpůsobení s více sloty užitečné. Přizpůsobení s více sloty je funkce Preview: Doporučujeme vám vytvořit novou smyčku Personalizace, pokud chcete otestovat rozhraní API pro přizpůsobení s více sloty, protože povolení je nevratné a bude mít vliv na smyčku Personalizace spuštěnou v produkčním prostředí.

Jakmile se rozhodnete převést smyčku na přizpůsobení s více sloty, musíte pro tuto smyčku Personalizace jednou postupovat takto:

Upgrade instance personalizace na více slotů

Poznámka:

Přizpůsobení s více sloty (Preview) má vliv na další funkce služby Personalizace. Tuto změnu nelze vrátit zpět. Před povolením přizpůsobení s více sloty si přečtěte téma Přizpůsobení více slotů (Preview).

1. Zakažte automatickou optimalizaci na webu Azure Portal v prostředku Personalizace v části Správa prostředků na stránce Nastavení modelu a učení, vypněte a uložte automatickou optimalizaci.

Poznámka:

Přizpůsobení více slotů nebude fungovat, pokud nezakážete automatickou optimalizaci. V budoucnu bude podporována automatická optimalizace pro přizpůsobení více slotů.

2. Aktualizace personalizace na více slotů na webu Azure Portal v prostředku Personalizace v části Správa prostředků na stránce Nastavení modelu a učení vyberte Exportovat nastavení učení. Pole argumentů ve staženého souboru JSON začne na --cb_explore_adf. Změňte tento soubor na --ccb_explore_adf a uložte soubor. CB (kontextové bandity) a CCB (podmíněné kontextové bandity) jsou algoritmy Personalizace, které používá pro přizpůsobení s jedním slotem a více sloty. ADF (závislé na akcích) znamená, že se akce vyjadřují nebo identifikují s funkcemi.

Na stejné kartě na portálu v části Nastavení importu výuky vyhledejte naposledy upravený soubor JSON a nahrajte ho. Tím se vaše instance Personalizace aktualizuje tak, aby byla personalizátorem pro více slotů a nyní bude podporovat více slotů Rank and Rewards calls.

Vytvoření objektu JSON pro požadavek pořadí

Použití personalizace s více sloty vyžaduje rozhraní API, které se mírně liší od rozhraní API pro přizpůsobení s jedním slotem.

Deklarujete sloty, které jsou k dispozici pro přiřazení akcí v každé žádosti o volání pořadí v objektu slotů:

• Pole slotů: Musíte deklarovat pole slotů. Sloty jsou seřazené: pozice každého slotu v poli záleží. Důrazně doporučujeme objednat definice slotů na základě toho, kolik odměn/ kliknutí/převodů každý slot získá, počínaje tím, který získá nejvíce. Například byste místo malého zápatí umístili velké pole "hero" pro web jako slot 1. Všechny ostatní věci jsou stejné, Personalizace přiřadí akce s větší pravděpodobností získání odměn dříve v posloupnosti.
• ID slotu: Musíte dát slotId každému slotu – řetězec jedinečný pro všechny ostatní sloty v tomto volání pořadí.
• Funkce slotu: Měli byste poskytnout další metadata, která popisují a dále odlišují od ostatních slotů. Ty se nazývají funkce. Při určování funkcí slotů musíte dodržovat stejné pokyny doporučené pro funkce kontextu a akcí (viz: Funkce pro kontext a akce). Typické funkce slotu pomáhají identifikovat velikost, pozici nebo vizuální charakteristiky prvku uživatelského rozhraní. Například position: "top-left", , size: "big"animated: "no"nebo sidebar: "true" sequence: "1".
• Akce směrného plánu: Musíte zadat ID akce směrného plánu pro každý slot. To znamená, že ID akce, která by se v tomto slotu zobrazila, pokud personalizace neexistuje. To je nutné k trénování personalizace v režimu Apprentice a k tomu, aby měl smysluplné číslo při provádění offline hodnocení.
• Máte dostatek akcí: Ujistěte se, že voláte pořadí s více akcemi než sloty, aby personalizace mohl přiřadit alespoň jednu akci ke každému slotu. Personalizace nebude opakovat doporučení akcí napříč sloty: Odpověď pořadí přiřadí každou akci maximálně k jednomu slotu.

Je v pořádku, pokud přidáte nebo odeberete sloty v průběhu času, přidáte a změníte jejich funkce nebo pole znovu seřadíte: Personalizace se přizpůsobí a bude trénovat na základě nových informací.

Tady je příklad slots objektu s některými ukázkovými funkcemi. I když bude většina objektu slots stabilní (protože uživatelská rozhraní mají tendenci se pomalu měnit), většina z nich se často nezmění: Ale musíte se ujistit, že ke každému volání pořadí přiřadíte příslušná ID baselineAction.

"slots": [ 
    { 
      "id": "BigHighlight", 
      "features": [ 
            { 
              "size": "Large", 
              "position": "Left-Middle" 
            }
        ],
        "baselineAction": "BlackBoot_4656" 
    }, 

    { 
      "id": "Sidebar1", 
      "features": [ 
            { 
              "size": "Small", 
              "position": "Right-Top" 
            } 
        ],
        "baselineAction": "TrekkingShoe_1122"  
    }  
  ]

Použití odpovědi rozhraní Rank API

Odpověď pořadí více slotů z výše uvedeného požadavku může vypadat takto:

{ 
  "slots": [ 
        { 
          "id": "BigHighlight", 
          "rewardActionId": "WhiteSneaker_8181" 
        }, 
        { 
          "id": "SideBar1", 
          "rewardActionId": "BlackBoot_4656" 
        } 
    ], 
  "eventId": "123456D0-BFEE-4598-8196-C57383D38E10" 
} 

Vezměte bonusActionId pro každý slot a použijte ho k odpovídajícímu vykreslení uživatelského rozhraní.

Volání rozhraní API pro odměnu

Personalizace se naučí, jak zvolit akce, které maximalizují získanou odměnu. Vaše aplikace bude sledovat chování uživatelů a vypočítá skóre odměny pro personalizaci na základě pozorované reakce. Pokud uživatel například klikl na akci v sadě "slotId": "SideBar1",, odešlete "1" personalizaci, aby poskytl pozitivní posílení pro volby akce.

Rozhraní API odměny určuje ID události pro odměnu v adrese URL:

https://{endpoint}/personalizer/v1.0/events/{eventId}/reward

Například odměna za výše uvedenou událost s ID: 123456D0-BFEE-4598-8196-C57383D38E10/odměna bude odeslána na https://{endpoint}/personalizer/v1.0/events/123456D0-BFEE-4598-8196-C57383D38E10/reward/reward:

{ 
  "reward": [ 
    { 
      "slotId": "BigHighlight", 
      "value": 0.2 
    }, 
    { 
      "slotId": "SideBar1", 
     "value": 1.0 
    }, 
  ] 
} 

V jednom volání rozhraní API pro odměnu nemusíte zadávat všechny skóre odměny. Rozhraní API odměny můžete volat vícekrát, přičemž každý z nich má odpovídající id události a id slotu. Pokud se pro slot v události neobdrží žádné skóre odměny, personalizace implicitně přiřadí odměnuDefault nakonfigurovanou pro smyčku (obvykle 0).

Rozdíly mezi přizpůsobením s jedním slotem a více sloty

Existují rozdíly v tom, jak používáte rozhraní API pořadí a odměn s přizpůsobením s jedním a více sloty:

Popis	Přizpůsobení s jedním slotem	Přizpůsobení více slotů
Pořadí prvků žádosti o volání rozhraní API	Odešlete objekt context a seznam akcí.	Odesíláte kontext, seznam akcí a seřazený seznam slotů.
Žádost o pořadí určující směrný plán	Personalizace provede první akci v seznamu akcí jako základní akci (položka, kterou by aplikace zvolila, pokud personalizace neexistuje).	Musíte zadat směrný kód ActionID, který by byl použit v každém slotu.
Odpověď volání rozhraní API pro řazení	Vaše aplikace zvýrazní akci uvedenou v poli rewardsActionId.	Odpověď obsahuje jiný bonusActionId pro každý slot zadaný v požadavku. Vaše aplikace zobrazí tyto akce rewardsActionId v každém slotu.
Volání rozhraní API pro odměny	Zavoláte rozhraní API odměny s skóre odměny, které vypočítáte z toho, jak uživatelé komunikovali s rewardsActionId pro toto konkrétní ID události. Pokud uživatel například na něj klikl, pošlete odměnu 1.	Zadáváte odměnu pro každý slot vzhledem k tomu, jak dobře akce s rewardsActionId elicitoval požadované chování uživatele. Můžete ho odeslat v jednom nebo několika voláních rozhraní API pro odměnu se stejným ID události.

Dopad povolení více slotů pro smyčku Personalizace

Pokud navíc povolíte více slotů, zvažte následující:

Popis	Přizpůsobení s jedním slotem	Přizpůsobení více slotů
Neaktivní události a aktivace	Při volání rozhraní API pro aktivaci aktivuje personalizace událost, očekává skóre odměny nebo přiřadí nakonfigurovanou výchozí odměnu, pokud dojde k překročení doby čekání na odměnu.	Personalizace aktivuje a očekává odměny za všechny sloty zadané v id události.
Režim učňů	Rozhraní API pro přizpůsobení pořadí vždy vrací akci směrného plánu a trénuje interní modely tak, že vyhodnotí akci směrného plánu.	Rozhraní API pro přizpůsobení pořadí vrátí akci směrného plánu pro každý slot zadaný v poli baselineAction. Personalizace bude trénovat interní modely na imitování prvního
Rychlost učení	Učí se jenom z jedné zvýrazněné akce.	Může se učit z interakcí s jakýmkoli slotem. Obvykle to znamená více chování uživatelů, které můžou přinést odměny, což by vedlo k rychlejšímu učení pro personalizaci.
Offline vyhodnocení	Porovnává výkon personalizace s výchozími a optimalizovanými nastaveními učení na základě toho, jakou akci byste zvolili.	(Omezení verze Preview) Vyhodnocuje pouze výkon prvního slotu v poli. Pro přesnější vyhodnocení doporučujeme zajistit, aby slot s většinou odměn byl první v poli.
Automatická optimalizace (Preview)	Smyčka Personalizace může pravidelně provádět offline vyhodnocení na pozadí a optimalizovat nastavení výuky bez zásahu správce.	(Omezení verze Preview) Automatická optimalizace je zakázaná pro smyčky Personalizace s povolenými rozhraními API s více sloty.

Další kroky

• Jak používat přizpůsobení s více sloty
• Ukázka: Poznámkový blok Jupyter se smyčkou přizpůsobení s více sloty