> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione Web SDK personalizzata per Rokt Thanks

> Questo articolo è rivolto ai brand che non usano Shopify Checkout ma vogliono comunque sfruttare le offerte Rokt Thanks di Aftersell.

Panoramica

Se il tuo negozio usa un **flusso di checkout personalizzato**, puoi comunque accedere alle offerte Rokt Thanks installando il **Rokt Web SDK** (un piccolo snippet JavaScript).

L'installazione dell'SDK è in genere semplice e richiede competenze tecniche minime. Se necessario, il team di supporto tecnico di Aftersell può assisterti durante tutto il processo.

***

<div id="initial-questions">
  ## Domande iniziali
</div>

Prima di iniziare, rispondi alle seguenti domande per garantire un'integrazione senza intoppi:

1. **Puoi (tu o qualcuno del tuo team di engineering) aggiungere uno snippet di codice alla pagina di conferma?**\
   La pagina di conferma, nota anche come **pagina di ringraziamento**, appare subito dopo il checkout.
2. **Quali dati utente o proprietà sono disponibili sulla pagina di conferma?**\
   Avremo bisogno di accedere a [proprietà specifiche](https://www.notion.so/rokt/Custom-Web-SDK-integration-for-Rokt-Thanks-306ee2db8608815899eadad3811b5ff3) relative agli articoli acquistati e alle informazioni sul cliente. Più dati sono disponibili, più le tue offerte Rokt Thanks saranno pertinenti e accurate.
3. **Esiste un modo semplice per accedere a questi dati usando JavaScript?**\
   Per esempio, puoi interrogare i dettagli del carrello o dell'ordine sulla pagina di conferma?

***

<div id="implementation-steps">
  ## Passaggi di implementazione
</div>

<div id="step-1-review-and-confirm">
  ## Passaggio 1: verifica e conferma
</div>

* Rivedi le domande sopra e conferma a quali proprietà di dati è possibile accedere.
* Quando sei pronto a procedere, avrai bisogno di un **accountId**, che ti verrà fornito da un engineer di Aftersell.

Per creare il tuo account, fornisci i seguenti dettagli:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
{  
  "firstName": "",  
  "lastName": "",  
  "primaryEmail": "",  
  "websiteUrl": "",  
  "countryCode": "",  
  "brand": ""  
}
```

***

<div id="step-2-choose-installation-method">
  ## Passaggio 2: scegli il metodo di installazione
</div>

Decidi se preferisci:

* **Installare l'integrazione da solo**, oppure
* **Lavorare direttamente con un engineer di Aftersell** (per la configurazione assistita potrebbe essere richiesto un ambiente di test).

Se scegli di installarla da solo, puoi seguire la [**documentazione di Rokt**](https://docs.rokt.com/developers/integration-guides/getting-started/?layer1=siteMonetization) o i passaggi riassunti qui sotto.\
Non tutti i passaggi della guida di configurazione di Rokt sono necessari, ma la guida viene fornita come riferimento.

***

<div id="step-3-install-the-integration-script">
  ## Passaggio 3: installa lo script di integrazione
</div>

a. **Copia lo [script di integrazione di partenza](#)** (fornito qui sotto).

b. **Aggiungi lo script** tra i tag `<head></head>` di qualsiasi pagina in cui vuoi mostrare un'offerta Rokt Thanks (in genere la tua pagina di conferma dell'ordine).

i. Compila tutte le **proprietà dei dati cliente e transazionali** richieste.

ii. Sostituisci `"rokt_account_id_here"` con l'**accountId** fornito dal tuo engineer Aftersell.

c. **Testa la tua implementazione** usando la [guida di test di Rokt](https://docs.rokt.com/developers/integration-guides/web/testing) per assicurarti che i posizionamenti si carichino correttamente.

d. Lavora con il nostro team per personalizzare il posizionamento in modo che corrisponda al look and feel del tuo brand.

<div id="properties-bolded-and-italicized-properties-are-highly-recommended">
  ## Proprietà (le proprietà in ***grassetto e corsivo*** sono altamente consigliate)
</div>

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
const cartItems = [  
        {  
            'itemPrice': '',  
            'itemQuantity': '',  
            'majorcat': '',  
            'majorcatid': '',  
            'minorcat': '',  
            'minorcatid': '',  
            'productname': '',  
            'sku': '',  
        },  
        {  
        ...  
        }  
]
```

Proprietà cliente/ordine

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
{  
        attributes: {  
          
	        // Required  
	        amount: '', //In $  
	        firstname: '',  
	        lastname: '',  
	        billingzipcode: '',  
	        Country: '',  
	        Language: '',  
	        currency: '',  
	        cartItems: JSON.stringify(cartItems), //From above  
	        email: '',  
	  
	        //Order Data  
	        clientcustomerid: '',  
	        cartId: '',  
	        subtotal: '',  
	        totalTax: '',  
	        totalShipping: '',  
	        margin: '',  
	        paymenttype: '',  
	        ccbin: '',  
	  
	        //Customer Data  
	        customerType: '',  
	        hasAccount: '',  
	        isReturning: '',  
	        lastVisited: '',  
	        isLoyalty: '',  
	        loyaltyTier: '',  
	        mobile: '',  
	        title: '',  
	        age: '',  
	        gender: '',  
	        dob: '',  
	        billingAddress1: '',  
	        billingAddress2: '',  
	        billingCity: '',  
	        billingState: '',  
	        billingCountry: '',  
	        shippingAddress1: '',  
	        shippingAddress2: '',  
	        shippingCity: '',  
	        shippingState: '',  
	        shippingZipcode: '',  
	        shippingCountry: '',  
  
        },
```

<div id="starter-script">
  ## Script di partenza
</div>

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
<!-- Main Tag -->  
<script type="module">  
    const target = document.head || document.body;  
    const script = document.createElement("script");  
    script.type = "text/javascript";  
    script.src = "https://apps.rokt.com/wsdk/integrations/launcher.js";  
    script.fetchpriority = "high";  
    script.crossOrigin = "anonymous";  
    script.async = true;  
    script.id = "rokt-launcher";  
    target.appendChild(script);  
    await new Promise((resolve) =>  
        window.Rokt  
        ? resolve()  
        : document  
            .getElementById("rokt-launcher")  
            .addEventListener("load", () => resolve())  
    );  
  
    const launcher = await window.Rokt.createLauncher({   
        accountId:'rokt_account_id_here',  
        sandbox: true,  
    });  
      
    const cartItems = [  
        {  
            'itemPrice': '',  
            'itemQuantity': '',  
            'majorcat': '',  
            'majorcatid': '',  
            'minorcat': '',  
            'minorcatid': '',  
            'productname': '',  
            'sku': '',  
        },  
        {  
            'itemPrice': '',  
            'itemQuantity': '',  
            'majorcat': '',  
            'majorcatid': '',  
            'minorcat': '',  
            'minorcatid': '',  
            'productname': '',  
            'sku': '',  
        }  
    ];   
  
    const selection = await launcher.selectPlacements({  
        identifier: 'order_confirmation_page_identifier',  
        attributes: {  
          
        // Required  
        amount: '',  
        firstname: '',  
        lastname: '',  
        billingzipcode: '',  
        Country: '',  
        Language: '',  
        currency: '',  
        cartItems: JSON.stringify(cartItems),  
        email: '',  
  
        //Order Data  
        clientcustomerid: '',  
        cartId: '',  
        subtotal: '',  
        totalTax: '',  
        totalShipping: '',  
        margin: '',  
        paymenttype: '',  
        ccbin: '',  
  
        //Customer Data  
        customerType: '',  
        hasAccount: '',  
        isReturning: '',  
        lastVisited: '',  
        isLoyalty: '',  
        loyaltyTier: '',  
        mobile: '',  
        title: '',  
        age: '',  
        gender: '',  
        dob: '',  
        billingAddress1: '',  
        billingAddress2: '',  
        billingCity: '',  
        billingState: '',  
        billingCountry: '',  
        shippingAddress1: '',  
        shippingAddress2: '',  
        shippingCity: '',  
        shippingState: '',  
        shippingZipcode: '',  
        shippingCountry: '',  
  
        },  
    });  
  
</script>
```
