Risolvere i problemi delle attività live troubleshoot-mobile-live

La vista Attività live in Adobe Experience Platform Assurance convalida la configurazione dell’app, controlla gli eventi di attività e consente di avviare, aggiornare o terminare le attività in remoto da una sessione di test.

Requisiti

Tre schede

Avvio, aggiornamento e fine da Assurance

Avvia attività live. apre una finestra di dialogo per scegliere il tipo di attività registrato, scegliere Unitario o Trasmissione, immettere un ID canale di trasmissione (solo trasmissione) e modificare un payload APS JSON precompilato. Il pulsante è disattivato o restituisce un errore se i requisiti di configurazione del token push-to-start, della versione di iOS o del canale non sono soddisfatti.

Invia aggiornamento. dalla scheda Panoramica di un’attività esistente, invia un evento Update (push di nuovo contenuto) o End. Per l’attività unitaria, il plug-in utilizza automaticamente il token di aggiornamento dell’attività. Per la trasmissione, esegue il targeting di tutti i dispositivi abbonati allo stesso ID canale di trasmissione. I payload devono essere JSON validi e corrispondere allo schema di attributi dell’attività; in caso contrario, la richiesta viene rifiutata.

Consulta la documentazione di Adobe Experience Platform Assurance per i passaggi di configurazione e connessione alla sessione.

Passa alla campagna attivata da API in Journey Optimizer e recupera:

• Nome e ID della campagna
• Versione della campagna (se applicabile)
• Tipo di campagna: Transazionale (unitario) o Marketing (broadcast)
• Configurazione della superficie: la superficie dell’app iOS utilizzata per l’attività Live
• Tipo di attività: il nome struct AttributeType configurato nella campagna

Quando effettui la chiamata API per attivare l’attività Live, salva:

• Payload della richiesta API, inclusi gli identificatori di profilo e i dati delle attività live
• Risposta API che include codice di stato, ID messaggio, ID richiesta
• Timestamp di quando è stata chiamata l’API
• Endpoint utilizzato, ad esempio /campaign/{CAMPAIGN_ID}/execute

Dalla richiesta API, recupera:

• Spazio dei nomi del profilo, ad esempio ECID, e-mail, ID cliente
• ID profilo utilizzato nella chiamata API

Assicurati di poter cercare questo profilo in Adobe Experience Platform. Scopri come cercare un profilo nella documentazione di Experience Platform.

Raccogli quanto segue dal dispositivo di prova:

• Modello del dispositivo, ad esempio iPhone 14 Pro
• Versione iOS
• Identificatore del bundle dell’app
• Token push APN
• Stato della connettività di rete al momento del test

1. In Journey Optimizer, passa a Cliente > Profili.
2. Cerca utilizzando lo spazio dei nomi e il valore di identità della richiesta API.
3. Se il profilo non viene trovato, non esiste o l’acquisizione non viene completata. Crea il profilo o attendi l’acquisizione prima di attivare l’attività Live.
4. Se il profilo viene trovato, procedi al passaggio 2 seguente per verificare se il token push è sincronizzato.

Puoi utilizzare Assurance per verificare la registrazione del token:

1. In Assurance, dall’elenco Eventi, filtrare o cercare gli eventi eventType = "liveActivity.pushToStart".
2. Seleziona Evento e controlla il payload.
3. Verifica che siano presenti i valori token, appId e attributeType.
4. Conferma se l’evento è stato inviato correttamente.

Puoi anche effettuare il check-in del profilo Adobe Experience Platform.

1. In Adobe Experience Platform, dal tuo Profilo, accedi alla scheda Eventi.
2. Cerca liveActivity.pushToStart eventi.
3. Controlla il timestamp e il payload pari.

Se non viene trovato alcun evento, l’app mobile non chiama Messaging.registerLiveActivity correttamente. È necessario correggere l’integrazione di SDK.

1. Dal tuo Profilo, accedi alla scheda Attributi.

2. Individuare liveActivityPushNotificationDetails.

3. Verifica la configurazione del token:

   code language-json
   { "liveActivityPushNotificationDetails": [ { "appId": "com.example.myapp", "token": "abc123def456...", "platform": "apns", "denylisted": false, "attributeType": "OrderTrackingAttributes", "identity": {} } ] }

Convalida ogni campo:

Se un campo non è corretto: aggiorna l’app mobile, registrati di nuovo utilizzando Messaging.registerLiveActivities, attendi 5-10 minuti, quindi ricontrolla.

Se manca liveActivityPushNotificationDetails: il token non è ancora stato sincronizzato. Attendere 5-10 minuti dopo la visualizzazione dell’evento liveActivity.pushToStart in Assurance.

1. In Journey Optimizer, apri Campaign e passa al menu Azioni.
2. Controlla la configurazione attività Live. La superficie deve essere configurata per l’app iOS con un identificatore bundle che corrisponde a appId nel liveActivityPushNotificationDetails del tuo profilo. Ad esempio, se il tuo profilo ha "appId": "com.example.myapp", la superficie deve avere come destinazione la stessa app.
3. Verifica che il tipo di attività nella configurazione della campagna corrisponda esattamente al attributeType nel liveActivityPushNotificationDetails del tuo profilo. Ad esempio, se il tuo profilo ha "attributeType": "FoodDeliveryLiveActivityAttributes", la campagna deve specificare lo stesso tipo di attività.

Durante l’esecuzione della campagna tramite API, assicurati che il payload segua la struttura corretta.

Payload unitario:

{
   "campaignId": "your-campaign-id",
   "recipients": [{
      "type": "aep",
      "userId": "user@example.com",
      "namespace": "email",
      "context": {
      "requestPayload": {
         "aps": {
            "content-available": 1,
            "timestamp": 1756984054,
            "event": "start",
            "attributes-type": "FoodDeliveryLiveActivityAttributes",
            "content-state": { ... },
            "attributes": { ... }
         }
      }
      }
   }]
}

Problemi comuni relativi al payload:

Critico: utilizza sempre la marca temporale più recente

• Il campo timestamp deve always essere l’ora Unix corrente (in secondi) nel momento in cui viene effettuata ogni chiamata API.
• Questo vale per tutti i tipi di evento: start, update e in particolareend.
• Impatto su aggiornamenti/richieste di fine: l’utilizzo di un timestamp non aggiornato o precedente causerà errori nelle richieste di aggiornamento e di fine o verrà ignorato dal dispositivo.
• NOT riutilizza i timestamp da richieste precedenti o utilizza valori memorizzati nella cache.
• Genera una nuova marca temporale per ogni chiamata API.

Campi facoltativi (tutti i tipi di eventi):

• requestId: identificatore univoco per il tracciamento (consigliato).
• alert: oggetto con title e body per la notifica (utile per richiamare l’attenzione sugli aggiornamenti).

Informazioni su dismissal-date:

• Campo facoltativo contenente il tempo dell’epoca Unix (secondi).
• Rilevante solo quandoevent: "end".
• Specifica quando l’attività Live deve essere rimossa automaticamente dal dispositivo.
• Se non viene fornito per l’evento finale, l’attività Live rimane visibile fino a quando l’utente non la chiude.
• Deve essere una marca temporale futura (successiva a timestamp).

Assicurati che il payload API corrisponda all’implementazione ActivityAttributes dell’app iOS. Il protocollo LiveActivityAttributes di Adobe SDK estende iOS ActivityAttributes e richiede una proprietà liveActivityData.

Convalida mapping:

1. ActivityAttributes deve implementare il protocollo LiveActivityAttributes di Adobe. Esempio:

   code language-swift
   struct FoodDeliveryLiveActivityAttributes: LiveActivityAttributes { public struct ContentState: Codable, Hashable { var orderStatus: String var estimatedDeliveryTime: String } // Adobe SDK requirement var liveActivityData: LiveActivityData // Your custom attributes var restaurantName: String }

   Nota che il campo liveActivityData è richiesto da Adobe SDK e deve essere incluso in tutte le implementazioni.

2. Il payload API deve rispecchiare la struttura di iOS:

   code language-json
   { "aps": { "event": "start", "timestamp": 1756984054, "attributes-type": "FoodDeliveryLiveActivityAttributes", "content-state": { "orderStatus": "Preparing", "estimatedDeliveryTime": "20 mins" }, "attributes": { "liveActivityData": { "liveActivityID": "order-12345" }, "restaurantName": "Pizza Palace" } } }

Elenco di controllo convalida:

• Includi tutti i campi ContentState in content-state (obbligatorio per tutti i tipi di evento).

• Includi tutti i campi LiveActivityAttributes in attributes (solo eventi di inizio), inclusi:

  • liveActivityData (obbligatorio; in genere contiene liveActivityID o un identificatore simile)
  • Tutti i campi personalizzati dalla struttura

• Fai corrispondere esattamente i nomi dei campi (distinzione maiuscole/minuscole).

• Tipi di dati corrispondenti (String, Int, Bool, oggetti nidificati).

• Mantieni struttura oggetto nidificata.

Errori comuni:

Per ulteriori esempi, consulta Crea pagina di attività Live.

Verifica dell’esecuzione dell’API e della consegna del payload tramite Assurance:

1. Apri la sessione di Assurance.

2. Esegui la chiamata API per attivare l’attività Live.

3. Nell’Elenco eventi, verificare che:

   • Eventi di esecuzione della campagna.
   • Eventi di consegna di attività live.
   • Eventi di errore di convalida del payload.

4. Esamina i payload degli eventi per verificare:

   • Il payload è stato elaborato correttamente.
   • Non si sono verificati errori di convalida.
   • L’attività live è stata inviata ai numeri APN.

1. Passa alla campagna attività live.

2. Fai clic sul pulsante Rapporti.

3. Selezionare Visualizza report completo.

4. Consulta le sezioni seguenti:

   1. Controlla le metriche Statistiche di invio per comprendere il successo della consegna:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
      Metrica	Che cosa significa	Cosa cercare
      Target	Numero di profili qualificati per il pubblico	Deve includere il profilo di test
      Invia	Totale notifiche push tentate	Deve corrispondere alle chiamate API
      Consegnate	Distribuito correttamente ai dispositivi	Confronta con invii per visualizzare il tasso di successo
      Inviare errori	Notifiche push non inviate	Numeri elevati
      Inviare esclusioni	Profili esclusi da Adobe Journey Optimizer	Controlla se il tuo profilo è stato escluso

   2. Se Invia errori > 0, controllare la tabella Motivi di errore per i codici di errore e i messaggi specifici:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Errore comune	Significato	Risoluzione
      Token non valido	Token push non valido o scaduto	Registra nuovamente i token di attività live dal dispositivo
      Token non trovato	Nessun token valido associato al profilo	Verifica che liveActivityPushNotificationDetails esista
      APN rifiutati	Il servizio di notifica push di Apple ha rifiutato il push	Verifica certificato APNs, ID bundle, ambiente
      Timeout di rete	Impossibile raggiungere gli APN	Problema transitorio; riprova la chiamata API

   3. Se Invia esclusioni > 0, controlla la tabella Motivi esclusi:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      Esclusione comune	Significato	Risoluzione
      Profilo rifiutato	L’utente ha rinunciato alle notifiche	Verifica lo stato del consenso del profilo
      Token	Token contrassegnato come non valido	Registra di nuovo il token o controlla lo stato di inserisce nell’elenco Bloccati della
      Profilo non idoneo	Il profilo non soddisfa i criteri della campagna	Rivedere le regole del pubblico della campagna

Ulteriori informazioni sono disponibili nella pagina del report della campagna di attività live.

1. Passa a Cliente > Profili in Journey Optimizer.

2. Cerca e apri il profilo.

3. Selezionare la scheda Eventi.

4. Filtra o cerca eventi con eventType = "message.feedback".

5. Cerca eventi di feedback corrispondenti al tipo liveActivityID e event della tua attività Live.

6. Esamina i seguenti campi chiave:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
   Campo	Valori possibili	Che cosa significa
   feedbackStatus	sent, error, denylist	Risultato della consegna dal provider di servizi
   serviceProvider	apns/apnsSandbox	Deve essere un APN per le attività iOS Live
   errorCode	Codice numerico o null	Codice di errore specifico per APNs, se non riuscito
   errorMessage	Descrizione errore o null	Messaggio di errore leggibile

7. Se feedbackStatus: "error":

   • Controlla errorCode e errorMessage per errori APN specifici
   • Gli errori APN comuni includono token scaduto, certificato non valido, ID bundle errato

8. Se non è stato trovato alcun evento di feedback:

   • È possibile che la notifica push non sia stata tentata
   • Verifica se il profilo è stato escluso nei Rapporti di Campaign come descritto nel passaggio 1 precedente.

1. Apri la sessione Assurance; deve essere attiva durante la chiamata API.

2. Esegui la chiamata API (inizio, aggiornamento o fine).

3. Nell’Elenco eventi, cerca gli eventi di consegna delle attività live.

4. Cerca gli eventi relativi alla consegna push APN.

5. Controllare la presenza dei seguenti indicatori:

   • Invia la richiesta al servizio APN: conferma l’invio del messaggio push ai server di Apple da parte di Adobe
   • Risposta APNs: indica se APNs ha accettato o rifiutato il messaggio push
   • Stato consegna: indicazione di esito positivo o negativo

6. Se vengono rilevati problemi, consulta i seguenti problemi comuni relativi alla consegna di APN:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Problema	Sintomo in Assurance	Risoluzione
   Certificato APNs scaduto	Errore di autenticazione	Rinnovare e caricare un nuovo certificato APN
   Ambiente errato (sviluppo e produzione)	Errore di mancata corrispondenza del token	Assicurati che il certificato corrisponda al tipo di build dell’app
   Mancata corrispondenza ID bundle	Identificatore bundle non valido	Verifica che l’ID del bundle di certificati corrisponda all’app
   Token scaduto	Errore InvalidToken da APNs	Registra nuovamente i token di attività live
   Limitazione di velocità	Troppe richieste	Ridurre la frequenza delle chiamate API

1. Verifica le metriche del ciclo di vita delle attività live nel rapporto della campagna.

   Nel rapporto della campagna, controlla la sezione Ciclo di vita attività in tempo reale:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
   Metrica	Cosa controllare
   Avvii remoti	Deve mostrare il numero di avvii attivati da API
   Aggiornamenti	Deve mostrare il conteggio degli eventi di aggiornamento
   Termina	Deve mostrare il conteggio degli eventi finali
   Conteggio totali	Volume evento attività live complessivo

   Se queste metriche sono pari a zero o non corrispondono alle chiamate API, si verifica un problema di consegna tra Adobe e APN.

2. Se Adobe mostra una consegna corretta ma il dispositivo non mostra l’attività Live:

   • Controlla i registri del dispositivo iOS per verificare la presenza di errori di attività live.
   • Verifica che l’app sia in primo piano o in background (non terminata).
   • Conferma connettività di rete per il dispositivo.
   • Esegui il test su più dispositivi per escludere problemi specifici del dispositivo.
   • Verifica che la versione di iOS sia 16.1 o successiva.

Se hai completato tutti i passaggi e il problema rimane non risolto, contatta l’Assistenza clienti Adobe con:

Informazioni richieste:

• ID e nome della campagna
• Spazio dei nomi e ID del profilo
• liveActivityID dal payload API
• Marca temporale delle chiamate API
• Schermate di:
• Rapporti sulle campagne (statistiche di invio, motivi di errore, motivi di esclusione)
• Eventi profilo (liveActivity.updateToken, message.feedback)
• Sessione Assurance che mostra gli eventi di consegna
• Payload completo della richiesta API
• Dettagli del certificato APNs (scadenza, ambiente, ID bundle)

1. Apri la sessione di Assurance.

2. Assicurati che la sessione sia stata attiva quando l’attività Live è stata avviata sul dispositivo.

3. Filtra o cerca eventi con eventType = "liveActivity.updateToken".

4. Seleziona l’evento e controlla il payload:

   • Verificare che il campo token contenga una stringa token di aggiornamento valida.
   • Controlla che liveActivityID corrisponda alla tua istanza di attività Live.
   • Conferma che activityType corrisponda al tuo attributes-type.

5. Se l’evento non viene trovato:

   • Il token di aggiornamento non è stato generato o acquisito da SDK.
   • Controlla se l’utente ha concesso le autorizzazioni per l’attività live.
   • Verifica che l’attività Live sia stata effettivamente avviata sul dispositivo.
   • Verifica che il SDK mobile sia correttamente integrato per acquisire i token di aggiornamento.

6. Se viene trovato un evento, procedere al passaggio 2.

1. Passa a Cliente > Profili in Journey Optimizer.

2. Cerca e apri il profilo.

3. Selezionare la scheda Eventi.

4. Cerca liveActivity.updateToken eventi.

5. Controlla i dettagli dell’evento:

   • Verifica che il timestamp sia recente (corrisponde all’avvio dell’attività Live).
   • Verificare che token e liveActivityID siano presenti.
   • Verificare che activityType sia corretto.

6. Se l’evento non viene trovato nel profilo:

   • L’evento del token di aggiornamento potrebbe non essere ancora stato acquisito nel profilo.
   • Attendere 5-10 minuti e ricontrollare.
   • Se manca ancora dopo 15 minuti, potrebbe esserci un problema di acquisizione dell’evento.

7. Se viene trovato un evento, il token di aggiornamento è stato sincronizzato. Procedere al passaggio 3.

1. Nella sessione di Assurance, esegui una chiamata API di aggiornamento o di fine.

2. Nell’Elenco eventi, cerca eventi di consegna attività live (eventi push APN).

3. Verifica la presenza di eventi che indicano:

   • Notifica push inviata ai numeri APN.
   • Risposta da APN (riuscita o errore).
   • Conferma della consegna.

4. Se è presente un evento di consegna APN: è stata inviata la notifica push. Se il dispositivo non viene ancora aggiornato, il problema potrebbe essere sul lato dispositivo (app che non gestisce il push, problemi di rete, ecc.).

5. Se manca l’evento di consegna APN: il token di aggiornamento potrebbe non essere memorizzato correttamente o associato al profilo nel sistema di Adobe.

6. Se sono presenti eventi di errore: controlla i dettagli dell’errore per specifici motivi di errore (token non valido, APN rifiutati, ecc.).

1. Apri la campagna di marketing con attivazione API in Journey Optimizer.

2. Passa alla sezione Pubblico e verifica:

   • Per la campagna viene selezionato un pubblico.
   • L’ID del pubblico corrisponde a quello utilizzato nel payload API.
   • Il pubblico contiene i profili previsti.

3. Passa alla sezione Azioni.

4. Controlla la configurazione attività in tempo reale:

   • La configurazione deve essere impostata per l’app iOS con l’identificatore del bundle corretto.
   • Il tipo di attività deve corrispondere a attributes-type nel payload API. Ad esempio, se il payload contiene "attributes-type": "AirplaneTrackingAttributes", la campagna deve specificare lo stesso tipo di attività.

La struttura del payload della trasmissione è diversa dalle campagne unitarie. Verifica che il payload segua il formato di trasmissione corretto.

Campi obbligatori per la trasmissione:

{
   "campaignId": "878a11d4-b519-47bd-8313-fecfee19857b",
   "audience": {
      "id": "8c3dbdea-2957-401f-acf0-3966fba1601e"
   },
   "context": {
      "requestPayload": {
      "aps": {
         "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==",
         "content-available": 1,
         "timestamp": 1771829292,
         "event": "update",
         "attributes-type": "AirplaneTrackingAttributes",
         "content-state": { ... },
         "attributes": { ... }
      }
      }
   }
}

Problemi comuni relativi al payload:

Campi critici specifici per la trasmissione:

• input-push-channel:

  • Obbligatorio per tutte le attività di trasmissione in diretta.
  • Funge da identificatore univoco per questa istanza di broadcast specifica.
  • Tutti i profili del pubblico ricevono attività live collegate a questo canale.
  • Deve corrispondere a channelID in liveActivityData.channelID (vedere il passaggio 3).
  • Deve essere creato per appID sul portale Apple Developer dal client.
  • Solo i canali creati per l’elemento appID specifico possono essere utilizzati per trasmettere le attività Live su tale app.

• audience.id:

  • Deve fare riferimento a un segmento di pubblico valido creato in Adobe Experience Platform.
  • Tutti i profili in questo pubblico sono destinati all’attività Live.
  • Il pubblico deve essere attivato e contenere profili con liveActivityPushNotificationDetails validi.

Usa sempre la marca temporale più recente:

• Il campo timestamp deve essere sempre l’ora Unix corrente (in secondi) per ogni chiamata API.
• Questo requisito si applica a tutti i tipi di evento: start, update e end.
• Critico per aggiornamenti/fine: l’utilizzo di marche temporali non aggiornate causa errori nelle richieste di aggiornamento e fine.
• Genera una nuova marca temporale per ogni chiamata API di trasmissione.

Campi facoltativi:

• dismissal-date: tempo epoca Unix per il licenziamento automatico (pertinente solo per eventi end)
• alert: oggetto con title e body per la notifica

Per informazioni sulle specifiche API complete, consulta la documentazione API di messaggistica Adobe Journey Optimizer.

Assicurati che i campi del payload corrispondano all’implementazione ActivityAttributes dell’app iOS e che input-push-channel corrisponda a channelID in liveActivityData.

1. Rivedi la definizione degli Attributi di attività di iOS.

Lo struct ActivityAttributes personalizzato deve implementare il protocollo LiveActivityAttributes di Adobe:

struct AirplaneTrackingAttributes: LiveActivityAttributes {
   public struct ContentState: Codable, Hashable {
      var journeyProgress: Int
   }

   // Adobe SDK requirement
   var liveActivityData: LiveActivityData

   // Your custom attributes
   var arrivalAirport: String
   var departureAirport: String
   var arrivalTerminal: String
}

1. Mappa i campi di iOS sul payload API della trasmissione.

Per tutti gli eventi, includere attributes e content-state:

      {
      "aps": {
         "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==",
         "event": "start",
         "timestamp": 1771829292,
         "attributes-type": "AirplaneTrackingAttributes",
         "content-state": {
         "journeyProgress": 0
         },
         "attributes": {
         "arrivalAirport": "DEL",
         "departureAirport": "MUM",
         "arrivalTerminal": "T1",
         "liveActivityData": {
            "channelID": "FEt0NgvLEfEAAOqA6AXdIQ=="
         }
         }
      }
      }

Critico: input-push-channel deve corrispondere achannelID

• Il valore input-push-channel nella radice di aps deve corrispondere esattamente a channelID in liveActivityData.
• Nell’esempio precedente, entrambi i valori sono "FEt0NgvLEfEAAOqA6AXdIQ==".
• Questa corrispondenza collega l’istanza di trasmissione ai dati dell’attività Live.
• Una mancata corrispondenza causa errori di consegna.

Punti di convalida chiave:

• Includi tutti i campi ContentState in content-state per tutti i tipi di evento.
• Includi tutti i campi LiveActivityAttributes personalizzati in attributes solo per gli eventi di inizio.
• Per gli eventi di inizio, liveActivityData.channelID deve corrispondere a input-push-channel.
• I nomi dei campi fanno distinzione tra maiuscole e minuscole e devono corrispondere esattamente.
• I tipi di dati devono corrispondere (String, Int, Bool, oggetti nidificati, ecc.).
• Per gli eventi di aggiornamento/fine, utilizzare lo stesso input-push-channel dell’evento iniziale originale.

Errori comuni:

Verifica dell’esecuzione dell’API e della consegna del payload tramite Assurance:

1. Apri la sessione di Assurance su un dispositivo di prova che fa parte del pubblico.

2. Esegui la chiamata API di trasmissione.

3. Nell’Elenco eventi cercare:

   • Eventi di esecuzione della campagna.
   • Eventi di consegna di attività live.
   • Eventi di errore che indicano errori di convalida del payload.

4. Ispeziona i payload degli eventi per confermare:

   • Il payload è stato elaborato correttamente.
   • input-push-channel è presente.
   • Non si sono verificati errori di convalida.
   • Le attività live sono state inviate ai numeri APN per i membri del pubblico.

In primo luogo, conferma se il profilo che deve ricevere l’attività Live fa effettivamente parte del pubblico.

1. Passa a Tipi di pubblico in Adobe Experience Platform.

2. Cerca e apri il pubblico utilizzando audience.id della tua campagna.

3. Fai clic su Sfoglia o Profili campione per visualizzare i membri del pubblico.

4. Cerca il profilo di test utilizzando lo spazio dei nomi e il valore di identità.

5. Se il profilo non è stato trovato nel pubblico:

   • Il profilo non soddisfa i criteri di pubblico o le regole dei segmenti.
   • Rivedi la definizione del pubblico per comprendere i requisiti di iscrizione.
   • Aggiorna i dati del profilo o la definizione del pubblico per includere il profilo.
   • Attendi il completamento della valutazione del pubblico (vedi il passaggio 2).

6. Se il profilo viene trovato nel pubblico: Procedi al passaggio 2 per verificare l’aggiornamento dei dati.

Identifica se il pubblico utilizza la valutazione in batch o in streaming, in quanto questa determina l’aggiornamento dei dati.

1. Nella pagina Dettagli pubblico, controlla il Metodo di valutazione:

   • Batch: valutato una volta al giorno secondo una pianificazione.
   • Streaming: valutato in tempo reale quando si verificano aggiornamenti del profilo.
   • Edge: valutato in tempo reale nelle posizioni edge.

Segui i passaggi appropriati per la risoluzione dei problemi in base al metodo di valutazione:

Se il pubblico utilizza la valutazione batch:

1. Comprendere le limitazioni del pubblico batch:

   • I tipi di pubblico in batch vengono valutati una volta al giorno (in genere durante la notte).
   • Lo snapshot del pubblico può risalire a un massimo di 24 ore.
   • Se un profilo ha registrato di recente token di attività Live, è possibile che tali token non siano presenti nell’istantanea corrente.
   • Gli aggiornamenti ai profili verranno rispecchiati solo nella successiva valutazione batch.

2. Controlla quando si è verificata l’ultima valutazione:

   • Nei dettagli del pubblico, cerca il timestamp Ultima valutazione.
   • Se liveActivityPushNotificationDetails del profilo è stato aggiornato dopo questa marca temporale, il pubblico contiene dati non aggiornati.

3. Risolvi dati non aggiornati:

   1. Opzione 1: attesa della valutazione batch pianificata

      • La successiva valutazione batch includerà i dati di profilo aggiornati.
      • Questo accade automaticamente una volta al giorno.
      • Consigliato per scenari non urgenti.

   2. Opzione 2: attivare la valutazione del pubblico su richiesta

      1. Passa a Tipi di pubblico in AEP.
      2. Seleziona il pubblico.
      3. Fai clic su Valuta ora o Attiva su richiesta.
      4. Attendi il completamento della valutazione (l’operazione può richiedere da diversi minuti ad ore, a seconda delle dimensioni del pubblico).
      5. Verifica che il profilo disponga ora di dati aggiornati nello snapshot del pubblico.
      6. Riprova la chiamata API di trasmissione.

Se il pubblico utilizza la valutazione in streaming:

1. Comprendere il comportamento del pubblico in streaming:

   • I tipi di pubblico in streaming valutano in tempo reale quando si verificano aggiornamenti del profilo.
   • Nuovi profili: dopo la creazione, puoi qualificarti se soddisfano i criteri del segmento.
   • Profili aggiornati: dopo l’aggiornamento è possibile qualificarsi o annullare la qualifica.
   • Profili non modificati esistenti: non vengono rivalutati a meno che non si verifichi un aggiornamento.

2. Identificare il problema:

   • Se un profilo esiste già e soddisfa i criteri del segmento, ma non si verifica alcun aggiornamento su tale profilo, potrebbe non essere aggiunto a un pubblico in streaming appena creato.
   • Il profilo deve ricevere un aggiornamento (qualsiasi modifica all’attributo) per attivare la rivalutazione.

3. Risolvi il problema:

   • Per i nuovi profili: sono qualificati automaticamente se i criteri sono soddisfatti. Non è necessaria alcuna azione.

   • Per i profili esistenti senza aggiornamenti recenti:

     • Effettua un aggiornamento minore al profilo (ad esempio, aggiorna un campo timestamp).
     • Questo attiva la valutazione in streaming e aggiunge il profilo al pubblico.
     • Alternativa: utilizza un pubblico batch o Edge per i profili esistenti.