Integrate Module

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

1. Un visitatore del sito carica una pagina che avvia un get richiesta di dati partner.
2. Il partner Adobe riceve il get richiede e crea pacchetti delle variabili appropriate in un oggetto JSON. Viene restituito l’oggetto JSON.
3. Il sito riceve l’oggetto JSON e le chiamate setVars per assegnare le informazioni contenute nell’oggetto JSON alle variabili Adobe Analytics
4. Viene inviata una richiesta di immagine ai server di raccolta dati Adobe.

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.

1. Accedi a experiencecloud.adobe.com utilizzando le credenziali Adobe ID.
2. Fai clic sull’icona a 9 quadrati in alto a destra, quindi fai clic sul logo a colori di Analytics.
3. Nella navigazione in alto, fai clic su Admin > All admin > Code manager.
4. Scarica la libreria AppMeasurement JavaScript più recente.
5. Una volta scaricato, decomprimi il file e individua AppMeasurement_Module_Integrate.js.

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 JavaScript legacy, è necessario accedere al codice sorgente del sito web della tua organizzazione.

1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
2. Fai clic sulla proprietà tag che desideri modificare.
3. Fai clic sulla scheda Estensioni, quindi fai clic su Configura in Adobe Analytics.
4. Apri il pannello a soffietto "Configura il tracciatore con codice personalizzato", quindi fai clic su "</> Apri editor".
5. Incolla il codice del modulo di integrazione nella finestra modale del codice. Una volta completato, fai clic su Salva.

Integrare i metodi del modulo

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

aggiungi

Il add Il metodo 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 beacon Il metodo crea una richiesta di immagine e la indirizza 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.

ottenere

Il 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");

• Nome partner: In genere, l’organizzazione collabora con il partner Adobe per determinare il valore del nome del partner.
• URL dell’oggetto JSON: URL di un oggetto JSON contenente le variabili partner da incorporare in una richiesta di immagine.
• Parametri stringa query: Informazioni sull'account del partner che identificano l'organizzazione nel sistema del partner. Il partner Adobe utilizza queste informazioni per identificare il set di dati.

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 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 setVars Il metodo consente al client di popolare le variabili di Analytics utilizzando i dati partner recuperati. I dati dei partner possono essere il risultato di un get metodo, assegnazione statica o 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 script Il metodo consente a un partner Adobe di chiamare codice JavaScript aggiuntivo dal sito partner se vengono soddisfatte determinate condizioni (ad esempio, se è impostata la variabile campaign).

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.