Decorazione dei Link

Attualmente, la decorazione dei link è una funzionalità che deve essere configurata dal team di Customer Success di Fanplayr. Contatta il tuo manager se desideri utilizzare questa funzionalità.

Fanplayr può essere integrato in più domini appartenenti allo stesso account. Normalmente, ogni dominio corrisponderebbe a una campagna separata e a una propria sessione di navigazione distinta per quella campagna. Tuttavia, ci sono scenari in cui potrebbe essere preferibile utilizzare un'unica campagna e sessione di navigazione su più domini.

La Decorazione dei Link è una funzionalità che permette a una sessione Fanplayr di continuare su più domini. Funziona aumentando i link sulla pagina in modo che includano l'identificatore di sessione Fanplayr per garantire che queste informazioni vengano propagate al dominio successivo.

Diverse tecniche possono essere impiegate per decorare i link sulle pagine. Queste tecniche possono essere applicate ampiamente a tutti i link della pagina, o applicate in modo più specifico per indirizzare solo determinati link. Ogni tecnica presenta vantaggi e compromessi, e il loro utilizzo dipenderà dalle esigenze del sito web e dalla sua progettazione:

• Riscrivere i link regolari (tag <a href="...">).
• Riscrivere gli URL di azione dei moduli.
• Monitorare i clic sulla pagina, quindi, se un link è stato cliccato, riscriverlo prima della navigazione.
• Aumentare le API del browser come window.open().

La decorazione dei link può essere abilitata configurando la seguente struttura JSON come preferenza account linkAugmentConfig:

[
  {
    // La configurazione funziona solo su hostname che corrispondono a questo pattern RegExp.
    domainPattern: 'store\\.com',
    // Decorerà solo i link che corrispondono a questo pattern RegExp.
    linkPattern: 'other-store\\.com',
    // Esegue il wrap di `window.open()` e decora il primo argomento.
    windowOpen: true,
    // Decora tutti gli anchor con href corrispondenti al pattern del link.
    rewriteHrefs: false,
    // Decora tutti i moduli con azioni corrispondenti al pattern del link.
    rewriteForms: false,
    // Ascolta tutti i clic sulla pagina e decora il link più vicino.
    monitorClicks: true,
    // Ritarda l'inizializzazione di X millisecondi.
    delay: 1000
  }
];

domainPattern

• Tipo: string
• Obbligatorio: Sì

Se l'URL corrente nel browser corrisponde a questo pattern, le regole nella configurazione vengono applicate alla visualizzazione della pagina corrente. Viene utilizzata solo la prima configurazione che corrisponde.

linkPattern

• Tipo: string (espressione regolare)
• Obbligatorio: Sì

Solo i link che corrispondono a questo pattern vengono decorati (modificati) per aggiungere parametri che aiutano a continuare la sessione dopo la navigazione.

delay

• Tipo: integer
• Predefinito: 0

Il numero di millisecondi da attendere prima di eseguire i metodi di configurazione della decorazione dei link.

windowOpen

• Tipo: boolean
• Predefinito: false

Metodo di decorazione Esegue il wrap del metodo window.open() per monitorare le chiamate a questa API del browser. Qualsiasi URL che corrisponda a linkPattern viene decorato prima di essere passato al metodo nativo del browser.

rewriteHrefs

• Tipo: boolean
• Predefinito: false

Metodo di decorazione Cerca tutti i tag <a> sulla pagina e li decora in-place se il loro attributo href corrisponde a linkPattern.

rewriteForms

• Tipo: boolean
• Predefinito: false

Metodo di decorazione Cerca tutti i tag <form> sulla pagina e decora quelli con un attributo action che corrisponde a linkPattern.

monitorClicks

• Tipo: boolean
• Predefinito: false

Metodo di decorazione Allega listener di eventi click e touchstart al documento utilizzando la fase di cattura. Quando l'utente interagisce con qualsiasi parte del documento, il tag <a> più vicino viene trovato e decorato se il suo attributo href corrisponde a linkPattern.