Delen via

Veelgestelde vragen over het Intelligent Recommendations-account

  • Artikel

Dit artikel biedt antwoorden op veelvoorkomende vragen of problemen die zich kunnen voordoen bij het gebruik van Intelligent Recommendations.

Inhoud

Accountonderhoud

Deze sectie is voor vragen met betrekking tot het configureren of onderhouden van Intelligent Recommendations-accounts.

Terug naar boven

Hoe maak ik een Intelligent Recommendations-account?

Ga voor stappen voor het configureren van uw account naar Configuratieoverzicht.

Terug naar boven

Hoe maak ik modellerings- en leveringsresources?

Ga voor stappen voor het maken van modellerings- en leveringsresources naar stap 5 van de snelstartgids voor het maken van een account.

Terug naar boven

Hoe kan ik contact opnemen met het ondersteuningsteam van Intelligent Recommendations?

Voor vragen of problemen die niet zijn beantwoord, kunt u het ondersteuningsteam van Intelligent Recommendations bereiken door een ondersteuningsticket te openen in de Microsoft Azure-portal.

  1. Selecteer in het linkermenu de optie Hulp + ondersteuning.
  2. Selecteer Een ondersteuningsaanvraag maken.
  3. Vul het formulier helemaal in. Er wordt een ondersteuningsticket gemaakt.

Terug naar boven

Waar kan ik de leveringseindpunt-URL vinden?

Voor stappen om de leveringseindpunt-URL te vinden, gaat u naar uw Intelligent Recommendations-account op de Azure Portal en zoekt u naar de eindpunt-resource die u wilt gebruiken. Van daaruit kunt u de leveringseindpunt-URL kopiëren. Ga voor meer informatie naar de snelstartgids voor het bekijken van aanbevelingsresultaten.

Terug naar boven

Fouten in het gegevenscontract oplossen

Om de foutenlogboeken te begrijpen die in het gegevenscontract worden geretourneerd, gaat u naar Soorten fouten.

Terug naar boven

Hoe kan ik de foutenlogboeken voor mijn modelleringsexemplaar bekijken?

Als u de foutenlogboeken voor uw modelleringsexemplaar wilt bekijken, stelt u uw account in om foutmodellering in te schakelen. Ga voor meer informatie naar Foutregistratie instellen. Ga voor meer informatie over de soorten fouten die kunnen worden geretourneerd naar Soorten fouten.

Terug naar boven

Waarom zie ik geen logboeken die naar mijn map met logboeken zijn geschreven?

Als u geen logboeken ziet die naar uw speciale logboekmap zijn geschreven, kunt u controleren of uw IR-account schrijftoegang tot de relevante container heeft:

  1. Ga naar uw Intelligent Recommendations-account.
  2. Selecteer het tabblad Rapporten.
  3. Klik op de knop Toegang controleren
  4. Als in het geretourneerde bericht wordt aangegeven dat de configuratie voor toegang tot het opslagaccount ontbreekt, moet u schrijfmachtigingen voor toegang tot de bijbehorende container verlenen. Als in het geretourneerde bericht wordt aangegeven dat het aangevraagde opslagaccount niet bestaat of u geen machtigingen hebt, controleert u of de opgegeven URL correct is.

Wat gebeurt er als ik de datum-tijdstempel verkeerd configureer?

Als u problemen ondervindt met uw tijdstempels, wordt het product verwijderd uit de lijst met beschikbare kandidaten en uitgefilterd uit aanbevelingen. Om dit probleem op te lossen, controleert u eerst de invoer van de gegevensentiteit ItemsAndVariants en zorgt u ervoor dat de releasedatum de ondersteunde datum-tijdnotatie heeft (dit is "jjjj-MM-ddTHH: mm:ss.fffZ").

Terug naar boven

Problemen met het lezen van model.json-CSV's

Het openen van de CSV's in Excel of een andere niet-CSV-vriendelijke tool kan lege kolommen verwijderen die vereist zijn in de CSV-indeling voor gegevensentiteiten. We raden u aan uw CSV's te openen en te controleren in Kladblok of een gerelateerde app die de inhoud niet wijzigt.

Terug naar boven

Als u uw invoergegevens tegelijkertijd probeert te modelleren en bij te werken, kan dit soms leiden tot het modelleren van gegevens uit gemengde gegevensversies en ongewenste aanbevelingsresultaten. Zie onze Handleiding met best practices voor meer informatie over hoe u uw invoergegevens correct bijwerkt.

Terug naar boven

API-resultaten en foutregistratie

Dit gedeelte is bestemd voor vragen met betrekking tot API-resultaten of documentatie voor foutregistratie.

Terug naar boven

Hoe kan ik controleren of ik een gemachtigde gebruiker ben voor het plaatsen van API-aanvragen?

Gebruikers moeten worden toegevoegd aan de lijst met gemachtigde gebruikers voor een eindpunt-resource voordat ze de service kunnen aanroepen. Ga voor meer informatie over het controleren van de status van gemachtigde gebruikers naar stap 2 van de snelstartgids voor het samenstellen van API-aanvragen.

Terug naar boven

De aanvraag is mislukt, maar de URL is correct.

Als de URL correct is, is het mogelijk dat de gebruiker die de aanvraag doet, niet voorkomt op de lijst met gemachtigde gebruikers voor deze eindpuntresource.

Ga voor meer informatie over het controleren van de status van gemachtigde gebruikers naar stap 2 van de snelstartgids voor het samenstellen van API-aanvragen.

Terug naar boven

Ik heb net een account gemaakt, maar ik zie geen resultaten.

Als de service net is opgestart, kan het enige tijd duren voordat de resultaten beschikbaar zijn. U kunt de modelleringsstatus volgen voor elk van de modellen die u hebt gemaakt. Voor meer informatie zie onze Handleiding voor rapporten over modelleringsstatus.

U kunt ook de map met logboeken bekijken voor meer informatie over eventuele problemen met uw gegevenscontract en of u wijzigingen of correcties moet aanbrengen.

Als u nog steeds geen resultaten kunt zien, controleert u of u aan uw Intelligent Recommendations-account een machtiging hebt verleend om gegevens uit de relevante container te lezen:

  1. Ga naar uw Intelligent Recommendations-account.
  2. Selecteer het tabblad Modellering.
  3. Kies het relevante modelleringsonderdeel.
  4. Selecteer het tabblad Verbindingsreeks.
  5. Klik op de knop Toegang controleren.
  6. Als in het geretourneerde bericht wordt aangegeven dat de configuratie voor toegang tot het opslagaccount ontbreekt, moet u leesmachtigingen voor toegang tot de bijbehorende container verlenen. Als in het geretourneerde bericht wordt aangegeven dat het aangevraagde opslagaccount niet bestaat of u geen machtigingen hebt, controleert u of de opgegeven URL correct is.

Controleer ook of de juiste mappen en bestanden in het opslagaccount zijn geplaatst. Zie voor meer informatie Het model.json-bestand downloaden en de hoofdmap configureren.

Terug naar boven

Hoe kan ik de modelleringsstatus volgen?

Klanten van Intelligent Recommendations kunnen de modelleringsstatus volgen voor elk van de modellen die ze op hun accounts hebben gemaakt. Na het configureren van een model maakt de service periodiek een statuslogboekbestand om te rapporteren over de huidige status van alle algoritmen (voor uw modelleringslaag). Zie voor meer informatie over toegang tot deze logboeken Handleiding voor rapporten over modelleringsstatus.

Terug naar boven

Waar zijn mijn logboekbestanden of waarom zijn ze leeg?

Uw logbestanden zijn mogelijk leeg als u niet de juiste machtigingen van Inzender van opslagblobgegevens hebt verleend of naar de onjuiste verbindingsreeks hebt verwezen. Volg onze snelstartgids om te bevestigen.

Zorg er ook voor dat uw foutregistratiebestanden correct zijn geconfigureerd en controleer of uw verbindingsreeks voor uw modelleringsinstantie verwijst naar de map die uw logboekbestanden bevat.

Terug naar boven

Waarom geven alleen bepaalde producten of bepaalde lijsten geen resultaten?

Over het algemeen kunnen onvoldoende interacties voor een bepaald item of een bepaalde gebruiker van invloed zijn op de kwaliteit van de resultaten of het ontbreken van geretourneerde resultaten. Soms hebben nieuwe producten ook wat tijd nodig om signalen op te vangen voordat ze in bepaalde aanbevelingslijsten verschijnen. U kunt uw productprestaties met behulp van de dashboards altijd nader bekijken.

Terug naar boven

De trendinglijst-API houdt rekening met zowel de leeftijd van een product als de interacties ervan bij het scoren (bepalen van de rangorde) van elk item in de lijst.

Tel eerst het aantal interacties in een bepaald tijdvenster, en dan de modelfactoren met de leeftijd van het product (dagen sinds de releasedatum zoals deze in de catalogus staat). Hoe nieuwer een item is, hoe hoger de score, en naarmate een product 'veroudert', neemt de score exponentieel af.

Om de resultaten in Trending te beheren, moet u twee configureerbare velden aanpassen in de map Reco Configuration-gegevensentiteit:

  • TrendingListMaxAgeDays: hiermee stelt u de maximumleeftijd in dagen van een product in. Een product dat meer dan TrendingListMaxAgeDays dagen geleden is uitgebracht, wordt niet weergegeven in de trending-lijst.
  • TrendingListTransactionsIntervalDays: hiermee stelt u het tijdvenster in waarin interacties worden geaggregeerd. Een item kan ouder zijn dan deze waarde, maar alleen interacties van minder dan TrendingListTransactionsIntervalDays dagen geleden worden meegeteld.

Pas deze instellingen aan in uw Reco Configuration-gegevensentiteit en publiceer uw model opnieuw. Dan zou u de resultaten van de aanbevelingen moeten zien.

Terug naar boven

Wat moet ik doen als mijn resultaten bij "selecties voor u" leeg zijn?

De mogelijkheid "selecties voor u" is alleen beschikbaar voor modelleringsexemplaren met een functieset die is gemarkeerd als Standaard of Premium. Als u hebt bevestigd dat de functieset correct is geconfigureerd, bekijkt u de gebruikers nader voor wie u aanbevelingen probeert te krijgen. Een gebruikers-id zonder historische interactiegegevens (zoals eerdere aankopen) levert geen resultaten op bij het aanroepen van 'selecties voor u'. Controleer ook of de gebruiker zich onlangs heeft afgemeld voor het ontvangen van gepersonaliseerde aanbevelingen. Elke gebruiker die zich heeft afgemeld voor personalisatie, ontvangt geen gepersonaliseerde aanbevelingen.

Terug naar boven

Waarom zie ik geen aanbevelingen voor vergelijkbare artikelen?

Aanbevelingen voor vergelijkbare artikelen zijn gebaseerd op vergelijkbare afbeeldingen, en deze aanbevelingen worden alleen getoond aan klanten die de Premium-functieset hebben geselecteerd en foto's van hun items in het gegevenscontract hebben gedeeld. Controleer of u de Premium-functieset voor uw model hebt geselecteerd en dat afbeeldingen correct zijn geconfigureerd zoals beschreven in Gegevensentiteiten voor toewijzing van afbeelding aan artikel.

Terug naar boven

Waar kan ik de volledige lijst met API-statuscodes vinden?

De volledige lijst van API-statuscodes is beschikbaar op de pagina Voorbeeld API-aanvragen.

Welke parameters worden door Intelligent Recommendations ondersteund voor het volgen van API-verzoeken?

Het is optioneel om een of meer van de volgende tracerings-id's als headerparameters toe te voegen aan uw API-verzoeken. Als u problemen ondervindt met uw API-verzoeken, kunnen we door een of meer van die parameters toe te voegen uw verzoeken effectiever volgen en onderzoeken op basis van de relevante id's die u opgeeft.

Sleutelparameter voor header description
CorrelationId
trace-id
parent-id Kan naar behoefte worden gebruikt om verzoeken te groeperen, bijvoorbeeld van dezelfde gebruiker, regio, enz.

Die headerparameters kunnen aan elk verzoektype worden toegevoegd, ongeacht de URI, queryparameters, scenario, enz.

Zie ook

Snelstartgids: Intelligent Recommendations instellen en uitvoeren met voorbeeldgegevens
Aan de slag: een geverifieerde API-aanroep plaatsen
API-statuscodes
Error Logs
Configuratieoverzicht
Overzicht van gegevenscontracten