Cosa imparerai

Scopri come abilitare e utilizzare la funzionalità delle pagine ospitate di Klaviyo, che ti consente di scrivere codice personalizzato per le tue pagine delle preferenze, pagine di iscrizione e pagine per annullare l'iscrizione.

Questo articolo è rivolto agli sviluppatori; al momento Klaviyo non offre servizi per aiutarti a sviluppare codice personalizzato, né fornisce assistenza per la risoluzione dei problemi del codice personalizzato. Per saperne di più sulle nostre pagine di consenso dell’app integrate, vai al nostro articolo sui Primi passi con le pagine di consenso.

Prima di iniziare

Solo gli account con funzionalità e-mail a pagamento che hanno superato la verifica dell’account possono abilitare le pagine ospitate personalizzate.

Prima di configurare una pagina ospitata, abilita questa funzionalità:

  1. Vai su Impostazioni > Altro.
  2. Scegli Pagine di consenso.
  3. In Pagine ospitate personalizzate, fai clic su Abilita pagine personalizzate.
The Custom Hosted Pages section on the Consent Pages tab in Klaviyo showing the switch to enable hosted pages.
The Custom Hosted Pages section on the Consent Pages tab in Klaviyo showing the switch to enable hosted pages.

Un dominio dedicato personalizzato è facoltativo: non devi configurarne uno per abilitare le pagine ospitate.

Crea una pagina di consenso personalizzata

  1. Vai su Impostazioni > Altro.
  2. Fai clic su Pagine ospitate.
  3. Accanto a Pagine, fai clic sul simbolo + per aggiungere una nuova pagina.
  4. Assegna un nome a questa pagina (ad es. unsubscribe.tmpl), quindi clicca su Aggiungi pagina. Puoi usarla per una pagina delle preferenze, per iscriviti o per annullare l'iscrizione alle e-mail, e creare più di 1 pagina se necessario.

I nomi delle pagine ospitate non possono contenere spazi, perché questo causa un errore. Evita gli spazi o usa i trattini bassi per separare i titoli.

  1. Progetta una pagina HTML che includa i campi e le funzionalità che preferisci. Esempi di campi che puoi inserire per una pagina di consenso personalizzata includono:
    • Opzioni per la frequenza delle e-mail:
      • Un'opzione per annullare l'iscrizione
      • Un’opzione per ricevere tutti gli e-mail
      • Opzioni di frequenza per newsletter giornaliere, settimanali, mensili, ecc.
    • Informazioni che puoi usare per indirizzare e segmentare:
      • Una casella di controllo per indicare se l’utente vuole o meno gli annunci di saldi
      • Una casella di controllo per indicare se l’utente vuole annunci sui prodotti
      • Una casella di controllo che indica se l’utente desidera ricevere aggiornamenti del blog
      • Altre liste a cui l'utente potrebbe voler iscriversi
Esempio di codice HTML per una pagina di consenso

Usa questo esempio nel tuo unsubscribe.tmpl per raccogliere le preferenze sul tipo di e-mail e sulla frequenza di annullare l'iscrizione. Prima di usarlo, sostituisci il logo di esempio, il nome dell'azienda e il link all'informativa sulla privacy con i tuoi.

Email Preferences

{% if form.non_field_errors %}
{% for error in form.non_field_errors %} {{ error }}{% if not forloop.last %}
{% endif %} {% endfor %}
{% endif %}
{% if form.errors|lookup:'$email' %}

{% for error in form.errors|lookup:'$email' %}{{ error }}{% endfor %}

{% endif %}
" style="--bg: #2d2d30;--headerBg: #1e1e1e;--border: #3e3e3e;--filenameText: #cccccc;" data-astro-cid-djropyco>
text
<!DOCTYPE html>
<html lang="en">
   <head>
      <meta charset="utf-8">
      <meta http-equiv="X-UA-Compatible" content="IE=edge">
      <meta name="viewport" content="width=device-width, initial-scale=1">
      <!-- Latest compiled and minified CSS -->
      <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
      <style type="text/css">
        /* Space out content a bit */
        body {
            padding-top: 20px;
            padding-bottom: 20px;
        }

        form {
            margin-bottom: 18px;
        }

        /* Custom page header */
        .header {
            border-bottom: 1px solid #e5e5e5;
            margin-bottom: 10px;
        }

        .header h1 {
            margin: 10px 0;
        }

        .required-fields {
            text-align: right;
        }

        .required-fields span {
            color: #a94442;
            font-weight: bold;
        }

        .list-group-item label {
            font-weight: normal;
            margin-top: 17px;
        }

        .list-group-item label input[type="checkbox"] {
            margin-right: 4px;
        }

        .form-group span.required {
            position: absolute;
            top: 0;
            right: 0;
            font-size: 20px;
            color: #a94442;
            font-weight: bold;
            user-select: none;
        }

        label.error {
            color: #a94442;
            font-weight: bold;
            margin-top: 4px;
        }

        .form-actions {
            margin: 25px 0;
        }

        .form-control+.form-control {
            margin-top: 6px;
        }

        .panel-group .panel-title .closed-icon,
        .panel-group .panel-title .open-icon {
            margin-right: 0.5em;
            top: 2px;
        }

        .panel-group .panel-title a:hover,
        .panel-group .panel-title a:active {
            text-decoration: none;
        }

        .panel-group .panel-title a:hover .text,
        .panel-group .panel-title a:active .text {
            text-decoration: underline;
        }

        .panel-group .panel-title .closed-icon {
            display: none;
        }

        .panel-group.closed .panel-title .open-icon {
            display: none;
        }

        .panel-group.closed .panel-title .closed-icon {
            display: inline;
        }

        /* Custom page footer */
        .footer {
            padding-top: 18px;
            border-top: 1px solid #e5e5e5;
        }

        /* Customize container */
        @media (min-width: 768px) {
            .container {
                max-width: 730px;
            }
        }
    </style>
      <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
      <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
      <!--[if lt IE 9]>
      <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
      <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
      <![endif]-->
   </head>
   <body>
      <div class="container">
         <div class="header">
            <img src="http://via.placeholder.com/300x75" />
            <h1>Email Preferences</h1>
         </div>
         <form action="" id="preferences_form" method="POST" role="form" class="form-horizontal">
            {% if form.non_field_errors %}
            <div class="alert alert-danger">
               {% for error in form.non_field_errors %}
               {{ error }}{% if not forloop.last %}<br />{% endif %}
               {% endfor %}
            </div>
            {% endif %}
            <input type="hidden" name="$fields" value="EmailInterests,EmailFrequency" />
            <input type="hidden" name="$list_fields" value="EmailInterests" />
            <!-- <input type="hidden" name="$unsubscribed_url" value="/p/preferences_updated" /> -->
            <!-- <input type="hidden" name="$updated_profile_url" value="/p/preferences_updated" /> -->
            <!--<p class="required-fields">
               <span>*</span> Required Information
               </p>-->
            <div class="form-group{% if form.errors|lookup:'$email' %} has-error{% endif %}">
               <label for="email" class="col-sm-3 control-label">Email Address<span class="required">*</span></label>
               <div class="col-sm-9">
                  <input type="email" class="form-control" id="email" name="$email" value="{% if request.POST|lookup:'$email' %}{{ request.POST|lookup:'$email' }}{% else %}{{ person.email|default:'' }}{% endif %}" />
                  {% if form.errors|lookup:'$email' %}
                  <p class="help-block">{% for error in form.errors|lookup:'$email' %}{{ error }}{% endfor %}</p>
                  {% endif %}
               </div>
            </div>
            <div class="form-group">
               <label for="first_name" class="col-sm-3 control-label">First Name</label>
               <div class="col-sm-9">
                  <input type="text" class="form-control" id="first_name" name="$first_name" value="{% if request.POST|lookup:'$email' %}{{ request.POST|lookup:'$first_name' }}{% else %}{{ person.first_name|default:'' }}{% endif %}" />
               </div>
            </div>
            <div class="form-group">
               <label for="last_name" class="col-sm-3 control-label">Last Name</label>
               <div class="col-sm-9">
                  <input type="text" class="form-control" id="last_name" name="$last_name" value="{% if request.POST|lookup:'$email' %}{{ request.POST|lookup:'$last_name' }}{% else %}{{ person.last_name|default:'' }}{% endif %}" />
               </div>
            </div>
            <div class="form-group">
               <label for="interests" class="col-sm-3 control-label">Interests</label>
               <div class="col-sm-9">
                  <div class="checkbox">
                     <label>
                     <input type="checkbox" name="EmailInterests" value="New Releases" {% if 'New Releases' in person.EmailInterests or 'New Releases' in request.POST.EmailInterests %}checked="checked"{% elif not person.EmailInterests and not request.POST.EmailInterests %}{% endif %} />
                     New Product Releases
                     </label>
                  </div>
                  <div class="checkbox">
                     <label>
                     <input type="checkbox" name="EmailInterests" value="Promotions" {% if 'Promotions' in person.EmailInterests or 'Promotions' in request.POST.EmailInterests %}checked="checked"{% elif not person.EmailInterests and not request.POST.EmailInterests %}{% endif %} />
                     Promotions & Sales
                     </label>
                  </div>
                  <div class="checkbox">
                     <label>
                     <input type="checkbox" name="EmailInterests" value="Blog" {% if 'Blog' in person.EmailInterests or 'Blog' in request.POST.EmailInterests %}checked="checked"{% elif not person.EmailInterests and not request.POST.EmailInterests %}{% endif %} />
                     Latest from the Blog
                     </label>
                  </div>
                  <div class="checkbox">
                     <label>
                     <input type="checkbox" name="EmailInterests" value="Events" {% if 'Events' in person.EmailInterests or 'Events' in request.POST.EmailInterests %}checked="checked"{% elif not person.EmailInterests and not request.POST.EmailInterests %}{% endif %} />
                     Events
                     </label>
                  </div>
               </div>
            </div>
            <div class="form-group">
               <label for="interests" class="col-sm-3 control-label">How often would you like to hear from us?</label>
               <div class="col-sm-9">
                  <div class="radio">
                     <label>
                        <!-- Default value. -->
                        <input type="radio" name="EmailFrequency" id="email_frequency_0" value="All" {% if person.EmailFrequency == 'All' or request.POST.EmailFrequency == 'All' %}checked="checked"{% elif not person.EmailFrequency and not request.POST.EmailFrequency %}checked="checked"{% endif %} />
                        Twice per Week
                     </label>
                  </div>
                  <div class="radio">
                     <label>
                     <input type="radio" name="EmailFrequency" id="email_frequency_1" value="Weekly" {% if person.EmailFrequency == 'Weekly' or request.POST.EmailFrequency == 'Weekly' %}checked="checked"{% endif %} />
                     Once per Week
                     </label>
                  </div>
                  <div class="radio">
                     <label>
                     <input type="radio" name="EmailFrequency" id="email_frequency_2" value="Monthly" {% if person.EmailFrequency == 'Monthly' or request.POST.EmailFrequency == 'Monthly' %}checked="checked"{% endif %} />
                     Once per Month
                     </label>
                  </div>
               </div>
            </div>
            <div class="checkbox">
               <label>
               <input type="checkbox" name="$unsubscribe" value="true" />
               <span class="text">Unsubscribe me.</span>
               </label>
            </div>
            <div class="clearfix form-actions">
               <div class="pull-right">
                  <button type="submit" class="btn btn-default btn-primary">Update Preferences</button>
               </div>
            </div>
         </form>
         <footer class="footer">
            <p>
               © 2017 Company Name — <a href="https://www.klaviyo.com" target="_blank">Privacy Policy</a>
            </p>
         </footer>
      </div>
      <!-- /container -->
      <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
      <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
      <!-- Latest compiled and minified JavaScript -->
      <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
      <script src="//cdnjs.cloudflare.com/ajax/libs/jquery-validate/1.13.1/jquery.validate.min.js"></script>
      <script>
        $(function() {
            $('#preferences_form').validate({
                rules: {
                    $email: {
                        required: true
                    }
                },
                messages: {
                    $email: 'Please enter your email address.',
                    $first_name: 'Please enter your first name.',
                    $last_name: 'Please enter your last name.'
                }
            });
            // Toggle validation based on selection.
            $('input[name="$unsubscribe"]').on('change', function() {
                $('form .form-actions button[type="submit"]').toggleClass('cancel', $(this).is(':checked'));
            });
        });
        $('input[name="$unsubscribe"]').on('change', function(){
          $('input[type=checkbox]').not(this).prop('checked', false);
        });
        $('input[type=checkbox]').not('input[name="$unsubscribe"]').on('change', function(){
          $('input[name="$unsubscribe"]').prop('checked', false);
        });
    </script>
   </body>
</html>

L'esempio memorizza gli interessi e la frequenza delle e-mail come Proprietà del profilo. Usa queste proprietà per segmentare campagne e flussi; la scelta di una frequenza non pianifica automaticamente le e-mail. L'opzione di annullamento dell'iscrizione segue le impostazioni di annullamento dell'iscrizione dell'account e della lista.

Fai clic su Salva, poi su Anteprima per controllare la pagina prima di assegnarla a una pagina di consenso.

Imposta il reindirizzamento di una pagina ospitata dopo l’invio (facoltativo)

Per impostazione predefinita, dopo l’invio riuscito di una pagina ospitata (ad esempio una pagina delle preferenze ospitata), l’utente viene reindirizzato a 1 di 2 destinazioni:

  • Se hanno richiesto di annullare l'iscrizione, verranno reindirizzati alla pagina di conferma dell'annullamento dell'iscrizione.
  • Se ha aggiornato il profilo (o ha fatto qualsiasi cosa che non sia una richiesta di annullamento dell'iscrizione), l'utente verrà reindirizzato alla pagina di conferma (riuscita) delle preferenze.

Se il link è associato a un elenco che ha pagine di consenso personalizzate, Klaviyo usa la pagina di conferma dell’elenco. Altrimenti, usa l’impostazione predefinita dell’account.

L'HTML di esempio include questi input di reindirizzamento facoltativi, commentati in modo da non sovrascrivere il comportamento predefinito:

text
<!-- <input type="hidden" name="$unsubscribed_url" value="/p/preferences_updated" /> --><!-- <input type="hidden" name="$updated_profile_url" value="/p/preferences_updated" /> -->

Per personalizzare un reindirizzamento, rimuovi <!-- e --> attorno al campo di input corrispondente, sostituisci il suo value="..." con l'URL che vuoi usare, poi fai clic su Salva. Usa $unsubscribed_url per le richieste di annullare l'iscrizione e $updated_profile_url per gli altri invii riusciti. Se usi /p/preferences_updated, crea e salva prima una pagina ospitata denominata preferences_updated.tmpl.

Aggiungi risorse personalizzate alle pagine ospitate (facoltativo)

Se vuoi usare il tuo file CSS, il tuo file JS o le tue immagini nella tua pagina ospitata, caricali facendo clic sul simbolo + accanto a Risorse e fai riferimento a questi elementi nel codice sorgente della pagina.

Usa il seguente tag per fare riferimento a una risorsa che hai caricato nel tuo account Klaviyo: {% asset_url 'style.css' %}

source code of your consent page showing uploaded custom asset tag
source code of your consent page showing uploaded custom asset tag

Utilizzo delle pagine di consenso personalizzate

Puoi sostituire le pagine predefinite del tuo account per le preferenze, iscriviti e annullare l'iscrizione alle e-mail con pagine personalizzate con codice personalizzato. Puoi anche configurare singole liste in modo che usino le proprie pagine con codice personalizzato.

  • Se hai personalizzato le pagine di consenso per una lista specifica, le campagne inviate solo a quella lista e le e-mail nei flussi attivati da quella lista utilizzano quelle pagine.
  • Le liste senza pagine di consenso personalizzate usano le pagine di consenso predefinite del tuo account. Anche le e-mail non associate a una singola lista, incluse le e-mail dei flussi attivate da una metrica, le campagne inviate a più liste o segmenti o le e-mail personali, useranno le pagine di consenso predefinite.

Cambia le pagine del consenso predefinite in pagine ospitate

Se vuoi sostituire 1 o più pagine di consenso predefinite dell'account (ad esempio, la pagina delle preferenze, la pagina iscriviti o la pagina di annullare l'iscrizione alle e-mail) con pagine con codice personalizzato, segui questi passaggi:

  1. Clicca sul nome della tua azienda nell'angolo in basso a sinistra di Klaviyo.
  2. Seleziona Impostazioni.
Account tab in the bottom left corner with settings selected from the navigation menu
Account tab in the bottom left corner with settings selected from the navigation menu
  1. Seleziona Altro > Pagine di consenso.
  2. Clicca sul menu a discesa con i 3 puntini nella pagina di consenso che intendi sostituire e seleziona Usa pagina ospitata.
The Consent Pages tab in Klaviyo showing an the additional options menu open on an example preference page.
The Consent Pages tab in Klaviyo showing an the additional options menu open on an example preference page.
  1. Nella finestra di dialogo che viene visualizzata, seleziona il file della tua pagina personalizzata e clicca su Salva.

Per le e-mail del flusso che non vengono attivate da un elenco o per le campagne inviate a più elenchi o segmenti, sostituisci le pagine di consenso predefinite del tuo account con pagine con codice personalizzato seguendo i passaggi riportati sopra. I flussi attivati da una lista possono utilizzare le pagine di consenso personalizzate di quella lista.

Usa pagine di consenso personalizzate per un elenco

Dovrai configurare ogni singola lista per cui vuoi usare una pagina personalizzata invece delle pagine di consenso predefinite.

  1. Vai all’elenco che vuoi collegare a una pagina personalizzata.
  2. Fai clic sulla scheda Pagine di consenso.
  3. Se la lista usa le pagine di consenso predefinite, fai clic su Personalizza per questa lista. Salta questo passaggio se la lista ha già pagine di consenso personalizzate.
  4. Nella pagina di consenso che vuoi sostituire con una pagina personalizzata, fai clic sul menu a discesa con i 3 puntini e seleziona Usa pagina ospitata.

The Subscribe & preferences pages tab for an example list in Klaviyo showing the additional actions menu open on the preferences page.
The Subscribe & preferences pages tab for an example list in Klaviyo showing the additional actions menu open on the preferences page.

Puoi assegnare le pagine ospitate alla pagina delle preferenze, alla pagina di iscrizione e alla pagina di annullamento dell'iscrizione alle e-mail. Le e-mail di conferma non supportano le pagine ospitate.

  1. Nella finestra di dialogo che viene visualizzata, seleziona il file della tua pagina personalizzata e clicca su Salva.

Nelle tue e-mail, dovresti comunque utilizzare i tag standard di Klaviyo per annullare l'iscrizione e gestire le preferenze (ad es. {% unsubscribe %} e {% manage_preferences %}). Questi tag verranno compilati come link nelle tue e-mail live e porteranno automaticamente i destinatari alle tue pagine personalizzate.

FAQ sulle pagine ospitate

Devo aggiungere del JavaScript alla mia pagina perché questo modulo venga inviato correttamente?
Poiché il tuo modulo personalizzato si trova all’interno di una pagina ospitata, non ti servono JavaScript aggiuntivi né un URL di azione per inviarlo. Imposta il metodo <form> su POST, come nell’esempio. Usa nelle tue e-mail i tag standard di Klaviyo per annullare l'iscrizione o gestire le preferenze, in modo che il link risultante identifichi il profilo corretto.

Questa pagina deve essere in HTML?
Questa pagina deve essere in HTML. Puoi includere immagini aggiuntive, fogli di stile e altro collegandoli o caricando singoli file in Risorse e facendovi riferimento nella tua pagina.

Klaviyo può aiutarmi a creare una pagina personalizzata?
Al momento Klaviyo non offre servizi per creare codice personalizzato e non forniamo assistenza per la risoluzione dei problemi del codice personalizzato. La funzionalità Pagine ospitate è pensata per offrire una tela bianca a sviluppatori o marketer esperti di codice.

Scopri di più sulle funzionalità di personalizzazione con le pagine di consenso integrate di Klaviyo in Primi passi con le pagine di consenso.

Risorse aggiuntive

Questo articolo è stato utile?
Usa questo modulo solo per il feedback sull'articolo. Scopri come contattare l'assistenza.

Esplora altri contenuti di Klaviyo

Community
Entra in contatto con altre aziende simili, partner ed esperti di Klaviyo per trovare ispirazione, condividere approfondimenti e ottenere risposte a tutte le tue domande.
Partner
Assumi un esperto certificato Klaviyo per aiutarti con un compito specifico o per la gestione continua del marketing.
Assistenza

Accedi all'assistenza tramite il tuo account.

Assistenza via e-mail (prova gratuita e account a pagamento) Disponibile 24 ore su 24, 7 giorni su 7

Chat/assistente virtuale
La disponibilità può variare in base alla località e al tipo di piano