Integrare il modulo

Il modulo Integra consente ai partner Adobi di integrare le attività di raccolta dati con l’organizzazione. Questa integrazione offre l’opportunità di una connessione dati bidirezionale. In genere, l’utilizzo del modulo di integrazione è gestito da un partner Adobe.

Integrare il flusso di lavoro del modulo

Implementazione del modulo di integrazione

Un’organizzazione che lavora con un partner Adobe può utilizzare questi passaggi per iniziare a utilizzare correttamente il modulo di integrazione.

Ottieni il codice del modulo integrato

Per ottenere il codice del modulo è necessario avere accesso come amministratore di prodotto oppure appartenere a un profilo di prodotto con accesso al Code Manager. Il metodo per ottenere il codice del modulo è lo stesso per tutti i metodi di implementazione, inclusi i tag in Adobe Experience Platform.

Posizionare il modulo Integrate nell’implementazione

L’implementazione del modulo di integrazione sul sito richiede l’accesso a Raccolta dati di Adobe Experience Platform. Se utilizzi un’implementazione legacy di JavaScript, è necessario accedere al codice sorgente del sito web della tua organizzazione.

Integrare i metodi del modulo

Una volta implementato il modulo Integrate, puoi configurarlo per inviare e ricevere dati dal partner Adobe desiderato.

aggiungi

Il metodo add crea un'istanza di un oggetto partner, che funge da archivio intermedio di dati variabili durante la condivisione di dati tra sistemi partner e l'implementazione. Questo metodo è necessario per tutte le integrazioni. Se in una singola implementazione vengono utilizzati più partner, è necessario utilizzare un oggetto partner separato per ogni partner univoco.

s.Integrate.add("<partner_name>");

In genere, l’organizzazione collabora con un partner Adobe per determinare il valore del nome del partner.

beacon

Il metodo beacon crea una richiesta di immagine e la punta all'URL specificato. Queste richieste di immagini sono diverse dalle richieste di immagini standard. In genere, il metodo beacon invia i dati al partner Adobe anziché ai server di raccolta dati Adobe.

p.beacon("<partner_url>/track?qs1=value1&qs2=value2");

In genere, l’organizzazione collabora con il partner Adobe per determinare il valore del nome del partner. Le stringhe di query incluse nell’URL sono facoltative e dipendenti dal partner. Il modulo di integrazione include automaticamente una stringa di query contenente un numero casuale per impedire la memorizzazione nella cache del browser.

ritardo

Adobe sta lavorando con i team internamente per documentare questo metodo.

get

Il metodo get consente a un client di importare variabili partner e di memorizzarle nell'oggetto partner. Una volta che i dati sono nell’oggetto partner, possono essere assegnati alle variabili Analytics e inviati in una richiesta di immagine. Questo metodo chiama un URL che punta a un oggetto JSON contenente i dati desiderati.

s.Integrate.<partner_name>.get("<url_to_json_object>?pid=value1&pid2=value2");

Il modulo Integra aggiunge automaticamente più stringhe di query all’URL. Una stringa di query var specifica il nome dell’oggetto JSON che il modulo si aspetta dal partner. Viene aggiunto anche un numero casuale per impedire il caching del browser.

pronto

Adobe sta lavorando con i team internamente per documentare questo metodo.

useVars

Il metodo useVars consente al client di condividere i valori delle variabili con un partner Adobe.

s.Integrate.<partner_name>.useVars = function (s,p) {
    p.<partner_var1> = s.eVar1;
    p.<partner_var2> = s.eVar2;
}

In genere, l’organizzazione collabora con un partner Adobe per determinare i valori per il nome del partner e le variabili utilizzate dal partner.

setVars

Il metodo setVars consente al client di popolare le variabili di Analytics utilizzando i dati partner recuperati. I dati partner possono essere il risultato di un metodo get, di un'assegnazione statica o di qualsiasi altro meccanismo che popola l'oggetto partner con i dati.

s.Integrate.<partner_name>.setVars = function (s,p) {
    s.eVar1 = p.<partner_var1>;
    s.eVar2 = p.<partner_var2>;
}

In genere, l’organizzazione collabora con un partner Adobe per determinare i valori per il nome del partner e le variabili utilizzate dal partner.

script

Il metodo script consente a un partner Adobe di chiamare JavaScript aggiuntivo dal sito partner se vengono soddisfatte determinate condizioni (ad esempio, se è impostata la variabile della campagna).

p.script("<partner_url>/script?qs1=value1&qs2=value2");

In genere, l’organizzazione collabora con il partner Adobe per determinare il valore del nome del partner. Le stringhe di query incluse nell’URL sono facoltative e dipendenti dal partner. Il modulo di integrazione include automaticamente una stringa di query contenente un numero casuale per impedire la memorizzazione nella cache del browser.