Integrazione .NET - Guida rapida

Lo scopo di questa guida è illustrare come eseguire un'integrazione di base di CrowdHandler .NET nella propria applicazione MVC.

Per ulteriori personalizzazioni e configurazioni avanzate, si prega di consultare ladocumentazione NuGet del progetto all'indirizzo .

1.) Aggiungi un riferimento al tuo progetto.#

Il modo più semplice per farlo è utilizzare NuGet: cerca il Crowdhandler.MVCSDK pacchetto nel gestore di pacchetti NuGet oppure, in alternativa, tramite la CLI di .NET.

dotnet add package Crowdhandler.MVCSDK

2.) Applica l'attributo "Crowdhandler Filter" alle azioni del tuo controller.#

ExampleTicketingController.cs

using Crowdhandler.MVC5SDK;

namespace MyTicketingApp.Controllers
{
    public class TicketingController : Controller
    {
        [CrowdhandlerFilter]
        public ActionResult Index()
        {
            return View();
        }
    }
}

Imposta i modelli di URL da ignorare passando al filtro il parametro "Exclusions" con un'espressione regolare contenente i modelli che non desideri vengano presi in considerazione per l'accodamento.

ExampleTicketingController.cs

using Crowdhandler.MVCSDK;

namespace MyTicketingApp.Controllers
{
    public class TicketingController : Controller
    {
        [CrowdhandlerFilter(Exclusions = @"^(\/contact-us.*)|((?!.*\?).*(\.(avi|css|eot|gif|ICO|jpg|jpeg|js|json|mov|mp4|mpeg|mpg|og[g|v]|pdf|png|svg|ttf|txt|wmv|woff|woff2|xml)))$")]
        public ActionResult Index()
        {
            return View();
        }
    }
}

3.) Inserire la configurazione di CrowdHandler.#

* Le chiavi pubbliche e private sono disponibili nella sezione Account -> API del pannello di controllo amministrativo di CrowdHandler.

tramite app.config oppure web.config

<appSettings>
    <add key="CROWDHANDLER_PUBLIC_KEY" value="YOUR_PUBLIC_KEY"/>
    <add key="CROWDHANDLER_PRIVATE_KEY" value="YOUR_PRIVATE_KEY"/>
</appSettings>

In alternativa, possono essere iniettati direttamente nel filtro.

using Crowdhandler.MVC5SDK;

namespace MyTicketingApp.Controllers
{
    public class TicketingController : Controller
    {
        [CrowdhandlerFilter(PrivateApiKey = "YOUR_PRIVATE_KEY", PublicApiKey = "YOUR_PUBLIC_KEY")]
        public ActionResult Index()
        {
            return View();
        }
    }
}

* Un elenco completo dei parametri configurabili e delle relative impostazioni predefinite è disponibile nella sezione 2b della documentazione di NuGet.

https://www.nuget.org/packages/Crowdhandler.MVCSDK/

4.) Installare l'integrazione JavaScript di CrowdHandler#

Perché devo farlo se sto integrando CrowdHandler lato server?

Per garantire che l'integrazione avvenga il più rapidamente possibile, le funzionalità non considerate fondamentali vengono trasferite sul lato client tramite la nostra integrazione JavaScript.

Se questa funzionalità non è essenziale per il funzionamento del sistema, posso saltare questo passaggio?

In teoria sì, ma in pratica lo sconsigliamo. L'installazione dell'integrazione JavaScript abilita funzionalità quali il monitoraggio delle prestazioni delle pagine e il mantenimento intelligente delle sessioni.

Il primo è un requisito indispensabile affinché la nostra funzione di regolazione automatica funzioni correttamente, oltre a fornire informazioni sulle prestazioni della vostra applicazione sotto carico.

Quest'ultimo sincronizza le informazioni relative alla sessione tra il lato client e il backend di CrowdHandler, evitando che gli utenti attivi di recente, che hanno superato la durata della sessione configurata in CrowdHandler, vengano inviati inutilmente al validatore di sessione di CrowdHandler per una nuova convalida.

Come si installa l'integrazione JavaScript?

Il codice JavaScript può essere installato tramite Google Tag Manager, inserendolo direttamente nel tag del tuo modello principale o in qualsiasi altro modo che ritieni più opportuno.

Qui puoi trovare le istruzioni su come installare la nostra integrazione JavaScript.

5.) Modificare il tipo di integrazione in .NET nel pannello di controllo di CrowdHandler.#

La selezione dell'implementazione può essere effettuata dalla schermata dei domini.

6.) E adesso?#

Una volta completati i passaggi per l'integrazione con .NET, ti consigliamo di consultare la nostra guida introduttiva, che ti aiuterà a familiarizzare con la creazione e la configurazione delle sale d'attesa dal pannello di controllo di CrowdHandler.