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

# Come installare Rokt Thanks su Tapcart

> Una guida alla configurazione per TapCart App Studio

<div id="what-is-rokt-thanks">
  ## Cos'è Rokt Thanks?
</div>

Rokt Thanks mostra offerte personalizzate e non invasive ai tuoi clienti nella schermata di conferma post-acquisto. È un modo semplice per generare entrate passive da ogni ordine senza influire sull'esperienza del cliente.

Questa guida spiega come installare Rokt Thanks all'interno della tua app mobile TapCart usando un Custom Code Block. La configurazione richiede solo pochi minuti.

<div id="before-you-start">
  ## Prima di iniziare
</div>

Ti serviranno le seguenti cose:

* **Piano TapCart Enterprise** - i Custom Code Block sono disponibili solo su Enterprise. Se non sei sicuro del tuo piano, verifica con il tuo referente TapCart.
* **Il tuo Rokt Account ID** - te lo fornirà il tuo account manager Aftersell. Se non lo hai ancora, contattaci e te lo invieremo.

<div id="step-1-create-a-custom-block">
  ## Passaggio 1: crea un Custom Block
</div>

Accedi alla tua dashboard TapCart e apri l'editor App Studio. Crea un nuovo Custom Block.

<div id="step-2-paste-the-code-snippet">
  ## Passaggio 2: incolla lo snippet di codice
</div>

Nell'editor del Custom Block, passa alla sezione Dev. Cancella qualsiasi codice segnaposto e incolla lo snippet qui sotto:

```jsx theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
import * as React from "react"
 
export default function RoktPlacement({
  blockConfig,
  tapcartData,
  translations,
  pageState,
  useActions,
}) {
  const containerRef = React.useRef(null)
 
  React.useEffect(() => {
    const loadRokt = async () => {
      try {
        await new Promise((resolve, reject) => {
          if (document.getElementById("rokt-launcher")) {
            resolve()
            return
          }
          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"
          script.addEventListener("load", () => resolve())
          script.addEventListener("error", (error) => reject(error))
          document.head.appendChild(script)
        })
 
        const launcher = await window.Rokt.createLauncher({
          accountId: "YOUR_ACCOUNT_ID",
          sandbox: true,
        })
 
        await launcher.selectPlacements({
          identifier: "TapCart.success",
          attributes: {
            email: tapcartData?.customer?.email || "",
            firstname:
              tapcartData?.customer?.firstName || "",
            lastname:
              tapcartData?.customer?.lastName || "",
          },
        })
      } catch (error) {
        console.error("Rokt SDK failed to load:", error)
      }
    }
 
    loadRokt()
  }, [])
 
  return <div id="rokt-placeholder" ref={containerRef} />
}
```

<Info>
  <div id="replace-your-account-id">
    ### Sostituisci il tuo Account ID
  </div>

  Nello snippet qui sopra, trova la riga `accountId: "YOUR_ACCOUNT_ID"` e sostituisci `YOUR_ACCOUNT_ID` con l'Account ID fornito dal tuo account manager Aftersell.

  Una volta aggiornato, salva il Custom Block.
</Info>

<div id="step-3-add-to-your-post-purchase-page">
  ## Passaggio 3: aggiungi alla tua pagina Post Purchase
</div>

Vai alla tua pagina Post Purchase nell'editor visuale di TapCart. Trascina il Custom Block che hai appena creato sulla pagina e rilascialo dove vuoi che compaiano le offerte.

<div id="step-4-let-us-know">
  ## Passaggio 4: faccelo sapere
</div>

Una volta completati i passaggi precedenti, avvisa il tuo account manager Aftersell. Finalizzeremo una rapida configurazione dal nostro lato e confermeremo quando tutto sarà attivo.

Lo snippet è inizialmente impostato in modalità sandbox (`sandbox: true`), che carica offerte di prova così puoi vedere in anteprima il posizionamento. `sandbox` è un'opzione del launcher nello snippet stesso, non un'impostazione dal nostro lato — quindi una volta che avremo confermato che tutto è a posto, modifica il Custom Block, cambia `sandbox: true` in `sandbox: false` e salva. Da quel momento inizierai a generare entrate.

<div id="summary">
  ## Riepilogo
</div>

| Passaggio | Azione                                                                                                         |
| --------- | -------------------------------------------------------------------------------------------------------------- |
| 1         | Crea un Custom Block nell'editor App Studio di TapCart                                                         |
| 2         | Incolla lo snippet di codice nella sezione Dev (sostituisci `YOUR_ACCOUNT_ID` con il tuo Account ID effettivo) |
| 3         | Trascina il Custom Block sulla tua pagina Post Purchase                                                        |
| 4         | Avvisa il tuo account manager Aftersell così possiamo finalizzare la configurazione                            |

<div id="frequently-asked-questions">
  ## Domande frequenti
</div>

**Devo essere su TapCart Enterprise?**

Sì. I Custom Code Block in App Studio richiedono il piano Enterprise di TapCart.

**Questo rallenterà la mia app?**

No. Lo script si carica in modo asincrono e non bloccherà il rendering della tua pagina.

**Posso scegliere dove compare l'offerta nella pagina?**

Assolutamente. Una volta salvato il Custom Block, puoi trascinarlo in qualsiasi posizione della tua pagina Post Purchase usando l'editor visuale di TapCart.

**Che tipo di offerte vedranno i miei clienti?**

Rokt Thanks propone offerte pertinenti e non invasive di inserzionisti premium, su misura per ogni cliente.