Abilita registrazione debug per la raccolta dati

I metodi seguenti controllano l’output di diagnostica di Web SDK. Non abilitano la registrazione della libreria di tag per un’implementazione autonoma di Web SDK.

debugEnablednel comando configure: impostare debugEnabled su true nella chiamata configure esistente. Questa impostazione è utile negli ambienti di sviluppo. Se implementato nel codice del sito, consente la registrazione per i visitatori che eseguono tale configurazione.

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  debugEnabled: true
});

Modificare il valore di configurazione in false o ometterlo nelle distribuzioni successive per ripristinare il valore predefinito. Non eseguire configure una seconda volta sulla stessa istanza per attivare/disattivare la registrazione; utilizzare invece setDebug. Una sostituzione di debug locale può avere la precedenza sul valore di configurazione. Vedere debugEnabled per il riferimento alla configurazione.

Comando setDebug: eseguire il comando sull’istanza appropriata di Web SDK nella console del browser:

alloy("setDebug", { enabled: true });

Al termine, disattivala:

alloy("setDebug", { enabled: false });

L’esecuzione di questo comando nella console cambia l’istanza locale, non i browser degli altri visitatori. Se inserisci lo stesso comando nel codice del sito distribuito, questo influisce sui visitatori che eseguono tale codice. La sostituzione locale può persistere nei diversi caricamenti di pagina per tale istanza nella stessa sessione della scheda di origine quando è disponibile l’archiviazione del browser. Per ulteriori informazioni, vedere setDebug.

Parametro alloy_debug della stringa di query: aggiungi alloy_debug=true all’URL della pagina, quindi carica la pagina:

https://example.com/?alloy_debug=true

Utilizzare &alloy_debug=true se l’URL contiene già parametri di query. Questo parametro abilita la registrazione locale senza modificare il codice distribuito. Web SDK legge il parametro quando viene creata ogni istanza, quindi lo applica a ogni istanza di Web SDK sulla pagina. Quando l’archiviazione del browser è disponibile, l’impostazione persiste per la sessione della stessa origine della scheda, pertanto la rimozione del solo parametro non disattiva la registrazione. Caricare la pagina con alloy_debug=false o eseguire setDebug con enabled: false per disabilitarla. Se l’URL contiene ancora alloy_debug=true, il ricaricamento abilita di nuovo la registrazione.

Adobe Experience Platform Debugger: apri Adobe Experience Platform Debugger, seleziona la sezione Web SDK e abilita il debug nella relativa scheda di configurazione. Disattivare l’opzione al termine dell’operazione.

Questa procedura abilita l’output di diagnostica. L’utilizzo del debugger per la richiesta o l’ispezione di Edge è incluso nelle richieste di controllo della raccolta dati.

In una pagina con una libreria di tag, esegui quanto segue nella console del browser:

_satellite.setDebug(true);

Questo comando espone i messaggi della libreria di tag, incluso l’output _satellite.logger. Per le istanze di Web SDK gestite dall’estensione tag Web SDK, l’estensione utilizza la modalità di debug del tag durante la configurazione di SDK e inoltra le successive modifiche alla modalità di debug. Non si supponga che l’attivazione del debug per un’istanza di Web SDK autonoma o configurata esternamente consenta anche la registrazione dei tag.

L’estensione tag Web SDK non fornisce un interruttore di debug nell’interfaccia utente di configurazione dei tag. Utilizza il metodo della console per un’istanza gestita dall’estensione. Tienilo fuori dalle regole dei tag.

Per disabilitare la modalità di debug dei tag e la registrazione SDK gestita dall’estensione corrispondente:

_satellite.setDebug(false);

La modalità di debug dei tag viene memorizzata nell’archivio locale del browser per l’origine della pagina. Persiste durante il caricamento delle pagine e il riavvio del browser fino a quando non lo disattivi o cancelli i dati del sito e non abilita la registrazione per altri visitatori. Per informazioni dettagliate sull’ambito e sulla persistenza, vedere _satellite.setDebug().

La libreria di tag notifica l’estensione solo quando cambia la modalità di debug dei tag. Se la modalità di debug dei tag è già attiva ma mancano i messaggi di Web SDK, è possibile che la disconnessione di SDK sia stata disattivata da un’esclusione di Web SDK da setDebug o alloy_debug. Eseguire _satellite.setDebug(false) e quindi _satellite.setDebug(true) oppure utilizzare lo stesso metodo Web SDK che ha impostato l’override.

Server SDK scrive l’output di diagnostica nella console del server e non nel browser del visitatore.

Imposta debugEnabled: true nella chiamata configure lato server esistente per abilitare la registrazione per l’istanza e gli handle forRequest creati da tale configurazione. Il valore predefinito è false. Vedere debugEnabled per un esempio di configurazione completo.

Per un’indagine mirata, chiamare setDebug sull’handle con ambito di richiesta restituito da forRequest. La registrazione delle modifiche solo per tale handle consente di eseguire il debug di una singola richiesta senza abilitarla per tutti i visitatori:

const visitor = alloy.forRequest({ request: req });

await visitor.setDebug({ enabled: true });
await visitor.sendEvent({
  xdm: { eventType: "web.webpagedetails.pageViews" }
});

Quando si chiama setDebug nell’istanza di primo livello, la registrazione delle modifiche viene eseguita solo per le chiamate effettuate direttamente sull’istanza e non per i relativi handle di richiesta, fino a quando non viene disabilitata o il processo non viene riavviato. Per modificare la baseline per tutti gli handle di richiesta, aggiornare debugEnabled nella configurazione del server.

I messaggi identificano l’istanza tra parentesi quadre, ad esempio [alloy], e includono configurazione, input/risultati di metodi, avvisi ed errori. Esamina l’output del processo server o la destinazione di registro a cui viene indirizzato dall’ambiente di hosting.

Utilizza l’API setLogLevel di Mobile Core per selezionare la gravità di diagnostica. Android utilizza LoggingMode.ERROR per impostazione predefinita; iOS utilizza LogLevel.error per impostazione predefinita. Imposta il livello desiderato durante l’inizializzazione dell’app prima di riprodurre il problema.

Android: abilita la registrazione dettagliata nell’app di sviluppo:

import com.adobe.marketing.mobile.LoggingMode
import com.adobe.marketing.mobile.MobileCore

MobileCore.setLogLevel(LoggingMode.VERBOSE)

Visualizza l’output in Logcat di Android Studio per il processo dell’app in esecuzione. I messaggi SDK per dispositivi mobili utilizzano il tag AdobeExperienceSDK, quindi filtrare con tag:AdobeExperienceSDK e assicurarsi che il visualizzatore di log consenta il debug e la visualizzazione dettagliata dei messaggi. Ripristina registrazione a livello di errore al termine:

MobileCore.setLogLevel(LoggingMode.ERROR)

iOS: abilita la registrazione della traccia nell’app di sviluppo:

import AEPCore
import AEPServices

MobileCore.setLogLevel(.trace)

Visualizza la console dell’app in esecuzione in Xcode e filtra per AEP SDK. Ripristina registrazione a livello di errore al termine:

MobileCore.setLogLevel(.error)

Il ritorno al livello di errore riduce l’output diagnostico e non elimina gli errori. Queste chiamate modificano la registrazione nell’app in esecuzione, non in altre installazioni. Assicurati che il codice di inizializzazione non riabiliti la registrazione dettagliata al prossimo avvio o in una build di produzione.

Per Java, Objective-C, livelli supportati e dettagli sulle versioni, consulta il riferimento API core Mobile. Per React Native o Flutter, utilizza l’API esposta dal wrapper Mobile SDK anziché copiare le chiamate native direttamente nel codice wrapper. Per informazioni sull’ispezione degli eventi connessi anziché sull’output della console di runtime, vedere Assurance.