Configurazione dell’integrazione dei dati Campaign-Punti di interesse

Configurazione dell’integrazione dei dati Campaign-Punti di interesse con gli SDK Adobe Experience Platform

NOTA

L’app mobile deve già essere configurata in Adobe Campaign Standard utilizzando Adobe Experience Platform SDK. Per i passaggi dettagliati, consulta questa pagina.

Le applicazioni mobili utilizzate per raccogliere i dati sulla posizione devono essere configurate da un amministratore nell'interfaccia di Adobe Campaign.

Per poter utilizzare Adobe Experience Platform Location Services con le applicazioni mobili configurate con Adobe Experience Platform SDK, devi:

  1. Aggiungi le estensioni Places e Places Monitor alla configurazione dell’app mobile in Adobe Experience Platform Launch. Imposta la tua app mobile in Adobe Campaign. Consulta Installare l’estensione Luoghi in Adobe Experience Platform Launch e Installare l’estensione Monitor Luoghi in Experience Platform Launch.

  2. Una volta configurate le estensioni, crea elementi dati all'interno di Adobe Experience Platform Launch per recuperare i dati da queste estensioni. Per creare gli elementi dati, fai riferimento a questa pagina .

  3. Quindi, in Adobe Experience Platform Launch, devi creare regole per supportare i casi di utilizzo per dispositivi mobili tra i punti di interesse e Adobe Campaign.
    Questa regola viene attivata quando un utente immette un carattere geografico Point of Interest. Per creare la regola, fai riferimento a questa pagina .

  4. Definisci il tuo Points of Interest in Luoghi. Consulta Creare un punto di interesse.

  5. Assicurati di accedere all’app mobile e ai dati sulla posizione raccolti in Adobe Campaign. Consulta Accesso alle app mobili utilizzate per raccogliere i dati sulla posizione e Accesso ai dati sulla posizione raccolti.

Configurazione dell’integrazione dei dati Campaign-Punti di interesse tramite SDK V4

Le applicazioni mobili utilizzate per raccogliere i dati sulla posizione devono essere configurate da un amministratore nell'interfaccia di Adobe Campaign.

Per utilizzare la funzione dati del punto di interesse con le applicazioni mobili configurate con SDK V4, devi:

  1. Accesso ad Adobe Analytics per dispositivi mobili. Controlla il tuo contratto di licenza o contatta il tuo responsabile dell'account Adobe per maggiori informazioni.

  2. Imposta la tua app mobile in Adobe Campaign. Consulta Configurazione di un’app mobile in Campaign.

  3. Configura l’app mobile nell’interfaccia di Adobe Mobile Services. Questo ti consente di garantire che i dati raccolti da Adobe Mobile Services vengano inviati ad Adobe Campaign. Consulta Configurazione di un’app mobile in Adobe Mobile Services.

  4. Esegui la configurazione specifica dell’app mobile:

    • Crea un pacchetto con l’app mobile il file di configurazione scaricato dall’interfaccia di Adobe Mobile Services .
    • Integra l’SDK di Experience Cloud Mobile nella tua app mobile. Consulta Integrazione dell'SDK in un'applicazione mobile.
  5. Definire i punti di interesse nell’interfaccia di Adobe Mobile Services. Consulta Definizione dei punti di interesse in Adobe Mobile Services.

  6. Definisci i dati da raccogliere dagli abbonati all’app mobile. Consulta Raccolta dei dati dei punti di interesse degli abbonati.

  7. Assicurati di accedere all’app mobile e ai dati sulla posizione raccolti in Adobe Campaign. Consulta Accesso alle app mobili utilizzate per raccogliere i dati sulla posizione e Accesso ai dati sulla posizione raccolti.

Configurazione di un’app mobile in Adobe Campaign tramite SDK V4

Per raccogliere i dati dei punti di interesse con Adobe Campaign, devi configurare l’app mobile da cui Adobe Campaign riceverà i dati.

  1. Fai clic sul logo Adobe Campaign nell’angolo in alto a sinistra, quindi seleziona Administration > Channels > Mobile app.

  2. Fare clic su Create per impostare un'applicazione.

  3. Immetti un nome nel campo Application name e fai clic su Create.

    Non compilare la sezione Device-specific settings. Questo vale solo per la configurazione delle applicazioni che ricevono le notifiche push.

Nella sezione Mobile application properties sono elencati due URL: Collect PII endpoint e Location Services endpoint. Saranno utilizzati nell’interfaccia di Adobe Mobile Services. Consulta Configurazione di un’app mobile in Adobe Mobile Services.

  • L’ Collect PII endpoint URL viene utilizzato per raccogliere gli ID Experienci Cloud e i token di registrazione degli utenti dall’app mobile al momento del suo avvio. Quando un utente accede all’applicazione utilizzando credenziali come e-mail, nome, cognome, ecc., questi dati vengono anche raccolti e utilizzati per riconciliare il token di registrazione dell’utente con un profilo Adobe Campaign.
  • L’ URL Location Services endpoint viene utilizzato per raccogliere dati sulla posizione, ad esempio latitudine, longitudine e raggio di un utente da un punto di interesse.

Ora puoi utilizzare questi valori in Adobe Mobile Services per completare la configurazione, come spiegato nella sezione Configurazione di un’app mobile nella sezione Adobe Mobile Services .

Configurazione di un’app mobile V4 in Adobe Mobile Services

Per inviare i dati raccolti da Adobe Mobile Services ad Adobe Campaign, devi configurare i postback nell’interfaccia di Mobile Services.

Sono necessarie informazioni specifiche disponibili nei parametri dell’app mobile impostati in Adobe Campaign (consulta Configurazione di un’app mobile in Campaign):

  • IMS Organization ID
  • Collect PII Endpoint
  • Location Services endpoint

Devi avere accesso ad Adobe Analytics per eseguire la configurazione seguente. Se non sei un utente Adobe Analytics, contatta il tuo amministratore Adobe Campaign.

  1. Accedi a mobilemarketing.adobe.com.

  2. Crea l'applicazione o selezionane una esistente.

  3. Passa alla pagina Manage App Settings .

  4. Nella sezione Servizio ID visitatore , seleziona Abilita e seleziona la tua organizzazione dall’elenco a discesa. Fai clic su Salva.

    ATTENZIONE

    Questa organizzazione deve essere la stessa utilizzata nell'istanza di Adobe Campaign.

  5. Fai clic su Manage Postbacks.

  6. Crea un postback.

    • Seleziona PII come Postback Type.

    • Nel campo URL , copia l’ URL Collect PII Endpoint dall’app mobile configurata nell’interfaccia di Adobe Campaign, preceduto dal nome del server. Consulta Configurazione di un’app mobile in Campaign.

    • Compila il campo Post Body come segue:

      Per iOS:

      {
      "userKey": "{userKey}",
      "pushPlatform":"apns",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      

      Per Android:

      {
      "userKey": "{userKey}",
      "pushPlatform":"gcm",
      "marketingCloudId":"{%mcid%}",
      "cusEmail":"{email}",
      "cusFirstName":"{firstName}",
      "cusLastName":"{lastName}"
      }
      
    • Imposta Tipo di contenuto come application/json.

    • In Quali tag di dati attivano il postback?, seleziona un evento, in genere Launched e exists.

    • Fai clic su Save & Activate.

  7. Crea un secondo postback.

    • Seleziona Postback come Postback Type.

    • Nel campo URL , copia l’ URL Location Services Endpoint dall’app mobile configurata nell’interfaccia di Adobe Campaign, preceduto dal nome del server. Consulta Configurazione di un’app mobile in Campaign.

    • Compila il campo Post Body come segue:

      {
      "locationData":{
      "distances":"{a.loc.dist}",
      "poiLabel":"{a.loc.poi}",
      "latitude.a":"{a.loc.lat.a}",
      "latitude.b":"{a.loc.lat.b}",
      "latitude.c":"{a.loc.lat.c}",
      "longitude.a":"{a.loc.lon.a}",
      "longitude.b":"{a.loc.lon.b}",
      "longitude.c":"{a.loc.lon.c}",
      "appId":"{a.appid}",
      "marketingCloudId":"{mid}"
      }
      }
      
    • Imposta Tipo di contenuto come application/json.

    • In Quali tag di dati attivano il postback?, seleziona campaign.test e exists.

    • Fai clic su Save & Activate.

NOTA

Per informazioni dettagliate sulla configurazione dei postback, consulta la documentazione di Adobe Mobile Services.

Integrazione dell'SDK in un'applicazione mobile

Il kit di sviluppo software (SDK) del servizio core Mobile facilita l’integrazione di un’app mobile in Adobe Campaign.

Questo passaggio è descritto in questo page.

Definizione dei punti di interesse in Adobe Mobile Services

Per definire i punti di interesse utilizzati per raccogliere i dati sulla posizione:

  1. Passa all’interfaccia di Adobe Mobile Services .

  2. Aggiungi la tua applicazione.

    Per ulteriori informazioni sulla gestione delle applicazioni in Mobile Services, consulta la documentazione di Adobe Mobile Services.

  3. Definisci i punti di interesse.

    Per ulteriori informazioni sulla gestione dei punti di interesse, consulta la documentazione di Adobe Mobile Services.

Raccolta dei dati dei punti di interesse degli abbonati

Una risorsa personalizzata specifica ti consente di definire i dati da raccogliere dagli abbonati alle tue applicazioni.

Questo passaggio è descritto nella pagina Configurazione di un’app mobile tramite SDK V4 .

Accesso alle app mobili utilizzate per raccogliere i dati sulla posizione

Per accedere alle applicazioni create correttamente in Adobe Campaign:

  1. Fai clic sul logo Adobe Campaign nell’angolo in alto a sinistra.

  2. Seleziona Administration > Channels > Mobile app (SDK v4) o Mobile app (AEP SDK) a seconda dell’SDK.

  3. Seleziona un’app mobile dall’elenco per visualizzarne le proprietà.

Nella scheda Mobile application subscribers viene visualizzato anche un elenco degli utenti abbonati all’applicazione. Gli abbonati sono tutti gli utenti che hanno installato l’applicazione sul loro dispositivo mobile. I profili del database di Adobe Campaign sono identificati con un token di registrazione.

Accesso ai dati sulla posizione raccolti

Una volta effettuata la configurazione, i dati dei punti di interesse raccolti sono elencati nella scheda Places di ciascun profilo. Per accedere all’elenco:

  1. Seleziona un profilo.

  2. Fai clic sul pulsante Edit profile properties a destra.

  3. Seleziona la scheda Places.

Sono elencati i dati dei punti di interesse raccolti per il profilo corrente. I dati sulla posizione vengono memorizzati nel database Adobe Campaign per sei mesi.

Per ulteriori informazioni sull’accesso e la modifica dei profili, consulta Profili.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now