Configurazione dell’integrazione di Campaign con i dati Punti di interesse configuring-campaign-points-of-interest-data-integration

Configurazione dell’integrazione dei dati Campaign-Punti di interesse con gli SDK di Adobe Experience Platform configuring-campaign-poi-aep-sdk

NOTE
L'app mobile deve essere già configurata in Adobe Campaign Standard mediante l'SDK di Adobe Experience Platform. Per i passaggi dettagliati, fai riferimento a questa pagina.

Le app 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 app mobili configurate con Adobe Experience Platform SDK, è necessario:

  1. Aggiungi l'estensione Places alla configurazione della tua app mobile nell'interfaccia utente di Data Collection. Configura l’app mobile in Adobe Campaign. Consulta Installare l'estensione Luoghi.

  2. Una volta configurate le estensioni, crea elementi dati nell’interfaccia utente di Data Collection per recuperare dati da queste estensioni. Consulta questa pagina per creare gli elementi dati.

  3. Quindi, nell’interfaccia utente di Data Collection, devi creare regole per supportare i casi d’uso per dispositivi mobili tra Point of Interests e Adobe Campaign.
    Questa regola verrà attivata quando un utente immette un elemento Point of Interest delimitato geograficamente. Fai riferimento a questa pagina per creare la regola.

  4. Definisci Points of Interest in Places. Vedere 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 configuring-campaign-poi-sdkv4

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

Per utilizzare la funzione dati Punto di interesse con le applicazioni mobili configurate con SDK V4, è necessario:

  1. Accedere ad Adobe Analytics per dispositivi mobili. Controlla il contratto di licenza o contatta il responsabile dell’account Adobe per ulteriori informazioni.

  2. Configura l’app mobile in Adobe Campaign. Consulta Configurazione di un'app mobile in Campaign.

  3. Configura la tua app mobile nell’interfaccia di Adobe Mobile Services. Questo consente di assicurarsi che i dati raccolti da Adobe Mobile Services vengano inviati ad Adobe Campaign. Vedi Configurazione di un'app mobile in Adobe Mobile Services.

  4. Esegui la configurazione specifica dell’app mobile:

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

  6. Definisci i dati da raccogliere dagli abbonati all’app mobile. Vedi 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 setting-up-a-mobile-app-in-campaign

Per poter 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 nell'angolo in alto a sinistra, quindi seleziona Administration > Channels > Mobile app.

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

  3. Immettere un nome nel campo Application name e fare clic su Create.

    Non compilare la sezione Device-specific settings. Questo si applica solo alla configurazione di applicazioni che ricevono notifiche push.

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

  • L'URL Collect PII endpoint viene utilizzato per raccogliere gli ID Experienci Cloud e i token di registrazione degli utenti dall'app mobile all'avvio. Quando un utente accede all’applicazione utilizzando credenziali quali e-mail, nome, cognome e così via, questi dati vengono raccolti e utilizzati anche 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 come latitudine, longitudine e raggio di un utente da un punto di interesse.

È ora possibile utilizzare questi valori in Adobe Mobile Services per completare la configurazione, come spiegato nella sezione Configurazione di un'app mobile in Adobe Mobile Services.

Configurazione di un’app mobile V4 in Adobe Mobile Services configuring-a-mobile-app-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.

Saranno necessarie informazioni specifiche che è possibile trovare nei parametri delle app mobili impostati in Adobe Campaign (vedere Configurazione di un'app mobile in Campaign):

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

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

  1. Accedi a mobilemarketing.adobe.com.

  2. Crea l’applicazione o selezionane una esistente.

  3. Passare alla pagina Manage App Settings.

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

    note caution
    CAUTION
    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:

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

      Per Android:

      code language-none
      {
      "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?, selezionare qualsiasi 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:

      code language-none
      {
      "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?, selezionare campaign.test e exists.

    • Fai clic su Save & Activate.

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

Integrazione dell’SDK in un’app mobile integrating-the-sdk-into-a-mobile-application

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

Questo passaggio è descritto in questa pagina.

Definizione dei punti di interesse in Adobe Mobile Services defining-points-of-interest-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 l’applicazione.

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

  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 collecting-subscribers--points-of-interest-data

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 accessing-mobile-apps-used-to-collect-location-data

Per accedere alle applicazioni create correttamente in Adobe Campaign:

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

  2. Selezionare 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 inoltre visualizzato un elenco degli 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 accessing-collected-location-data

Al termine della configurazione, i dati dei punti di interesse raccolti vengono elencati nella scheda Places di ciascun profilo. Per accedere all'elenco:

  1. Seleziona un profilo.

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

  3. Seleziona la scheda Places.

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

Per ulteriori informazioni sull'accesso e la modifica dei profili, vedere Profili.

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff