Configurazione delle regole di tag per supportare casi d’uso di Adobe Campaign Standard configuring-rules-launch

Nell’interfaccia utente di Data Collection, crea elementi dati e regole per inviare dati PII e altri dati dalle app mobili a Adobe Campaign Standard.

Per fare in modo che tutte le modifiche alla configurazione nell’interfaccia utente di Data Collection abbiano effetto, devi pubblicare tali modifiche. Per ulteriori informazioni, consulta Pubblicazione.

Per creare regole nell’interfaccia utente di Data Collection, effettua le seguenti operazioni:

Creazione di elementi dati create-data-elements

Di seguito sono riportati gli elementi dati che consigliamo di creare nell’interfaccia utente di Data Collection.
Puoi creare elementi di dati aggiuntivi in base alle tue esigenze.

  • Experience Cloud ID
  • Pkey
  • Campaign server

Per creare questi elementi dati:

  1. Nell’interfaccia utente di Data Collection, dal dashboard dell’app mobile, fai clic su Data Elements scheda.

  2. Per creare Experience Cloud ID elemento dati, fai clic su Create New Data Element.

  3. In Name campo, ad esempio digitare mcid.

  4. Dalla sezione Extension a discesa, seleziona Mobile Core. Then Experience Cloud ID nel Data element elenco a discesa tipo.

  5. Per creare l’elemento dati Pkey, fai clic su Add data element.

  6. In Name campo, ad esempio digitare pkey.

  7. Dalla sezione Extension a discesa, seleziona Adobe Campaign Standard. Then pkey nel Data element elenco a discesa tipo.

  8. Per creare l’elemento dati del server Campaign, fai clic su Add data element.

  9. In Name digitare un nome, ad esempio camp-server.

  10. Dalla sezione Extension a discesa, seleziona Adobe Campaign Standard. Allora, Campaign Server nel Data element elenco a discesa tipo.

Creazione di regole creating-rules

È necessario creare regole per i seguenti elementi:

Postback PII pii-postback

NOTE
Per inviare informazioni PII da un’app mobile ad Adobe Campaign, devi implementare un’API SDK. Per ulteriori informazioni, consulta CollectPII.

Per inviare dati PII a Adobe Campaign Standard, crea una regola nell’interfaccia utente di Data Collection:

  1. Nell’interfaccia utente di Data Collection, dal dashboard dell’app mobile, fai clic su Rules quindi tab Create New Rule.

  2. Digita un nome, ad esempio: Core mobile - Raccolta PII.

  3. In Events , fare clic su Add.

  4. Dalla sezione Extension a discesa, seleziona Mobile Core. Allora, Collect PII nel Event type a discesa.

  5. Fai clic su Keep changes.

  6. In Actions , fare clic su Add.

  7. Dalla sezione Extension a discesa, seleziona Mobile Core. Allora, Send PII nel Action type a discesa.

  8. In entrata URL, immetti il seguente URL:

    code language-none
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}
    
  9. Seleziona la Add Post Body casella di controllo.

  10. In entrata Post Body, digitare quanto segue:

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

    MarketingCloudId consente di riconciliare gli abbonati all’app con i destinatari nel database ed è, di conseguenza, obbligatorio. Puoi specificare altre coppie chiave-valore in base alle tue esigenze aziendali. Nell’esempio precedente, e-mail, nome e cognome vengono trasmessi dall’app.

    Le chiavi (ad esempio cusEmail, cusFirstName e cusLastName) devono corrispondere agli ID campo definiti nella risorsa personalizzata nell’istanza di Adobe Campaign Standard. Le variabili di valore (ad esempio e-mail, firstName e LastName) devono corrispondere alle chiavi nei dati JSON inviati dall’app mobile durante la chiamata dell’API collectPII di AMS dal codice dell’app.

    Puoi anche trasmettere i dati del ciclo di vita nel postback Raccogli PII o in un postback diverso a seconda dei trigger dell’evento. di seguito è riportato un esempio di JSON per i dati del ciclo di vita:

    code language-none
    {
    "marketingCloudId":"{%%mcid%%}",
    "pushPlatform":"{%contextdata.pushPlatform%}",
    "cusDayslastlaunch": "{%%DaysSinceLastUse%%}",
    "cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}",
    "cusLaunches": "{%%Launches%%}"
    }
    

    Gli elementi dati definiti nell’interfaccia utente di Data Collection devono essere inclusi in percentuali doppie, ad esempio %%mcid%%Le variabili di contesto e dell'app devono essere racchiuse in percentuali singole, ad esempio %contextdata.email%.

  11. In entrata Content Type, tipo application/json.

  12. In entrata Timeout, selezionare 0.

I dati utente sono ora configurati per l’invio a Campaign.

Postback del tracciamento in-app inapp-tracking-postback

NOTE
Se utilizzi Android ACPCore v1.4.0 o versione successiva/ iOS ACPCore v2.3.0 o versione successiva, non è necessario configurare i postback di tracciamento.

Per inviare i dati di tracciamento a Adobe Campaign Standard per generare rapporti sull’interazione degli utenti con i messaggi in-app nell’app mobile, crea la seguente regola nell’interfaccia utente di Data Collection:

  1. Nell’interfaccia utente di Data Collection, dal dashboard dell’app mobile, seleziona la Rules e fai clic su Add Rule.

  2. Digita un nome, ad esempio: Adobe Campaign - Tracciamento dei clic in-app.

  3. In Events , fare clic su Add.

  4. Dalla sezione Extension a discesa, seleziona Adobe Campaign Standard. Allora, In-App click tracking nel Event type a discesa.

  5. Fai clic su Keep changes.

  6. In Actions , fare clic su Add.

  7. Dalla sezione Extension a discesa, seleziona Mobile Core. Allora, Send postback nel Event type a discesa.

  8. In entrata URL, digita il seguente URL:

    code language-none
    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}
    
  9. Seleziona la Add post body casella di controllo.

  10. In entrata Post Body, tipo {}.

  11. In entrata Content Type, tipo application/json.

  12. In entrata Timeout, selezionare 0.

Postback tracciamento notifiche push push-tracking-postback

NOTE
Se utilizzi Android ACPCore v1.4.0 o versione successiva/ iOS ACPCore v2.3.0 o versione successiva, non è necessario configurare i postback di tracciamento.

Per inviare i dati di tracciamento a Adobe Campaign Standard, che consente di tenere traccia delle consegne delle notifiche push e dell’interazione degli utenti con l’app mobile, è necessario creare una regola nell’interfaccia utente di Data Collection.

Per ulteriori informazioni sul tracciamento push, consulta Tracciamento push.

Per tenere traccia delle azioni eseguite nell’app, utilizza l’API trackAction. Per ulteriori informazioni, consulta Tracciare le azioni eseguite nell’app.

  1. Nell’interfaccia utente di Data Collection, dal dashboard dell’app mobile, fai clic su Rules e fai clic su Add Rule.

  2. Digita un nome, ad esempio: Adobe Campaign - tracciamento dei clic push.

  3. In Events , fare clic su Add.

  4. Dalla sezione Extension a discesa, seleziona Mobile Core. Allora, Track Action nel Event type a discesa.

  5. Dalla sezione Action a discesa, seleziona Action, seleziona equals, e tipo tracciamento.

  6. Fai clic su Keep changes. Quindi, nella Actions , fare clic su Add.

  7. Dalla sezione Extension a discesa, seleziona Mobile Core. Allora, Send postback nel Action type a discesa.

  8. In entrata URL, immetti il seguente URL:

    code language-none
    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}
    
  9. Seleziona la Add post body casella di controllo.

  10. Aggiungi il corpo del post, ad esempio { }.

  11. In entrata Content Type, tipo application/json.

  12. In entrata Timeout, selezionare 0.

Postback posizione location-postback

  1. Nell’interfaccia utente di Data Collection, dal dashboard dell’app mobile, fai clic su Rules e fai clic su Add Rule.

  2. Digita un nome, ad esempio: Postback posizione.

  3. In Events , fare clic su Add.

  4. Crea un evento, ad esempio Enter POI (Inserisci POI) o Exit POI (Esci POI). Dalla sezione Extension a discesa, seleziona Places - Beta. Allora, Inserisci POI o Esci da POI nel Event type a discesa.

  5. Immetti un nome, ad esempio: Places - Beta - Inserisci POI o Esci da POI.

  6. In Actions , fare clic su Add.

  7. Dalla sezione Extension a discesa, seleziona Mobile Core. Allora, Send postback dal Action type a discesa.

  8. Immetti un nome, ad esempio: Core mobile - Postback della posizione di invio.

  9. In entrata URL, immetti il seguente URL:

    code language-none
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/
    
  10. Seleziona la Add post body e aggiungere il corpo del post, ad esempio:

    code language-none
    {
    "locationData": {
        "distances": "{%%Distance%%}",
        "poiLabel": "{%%POILabel%%}",
        "latitude": "{%%Latitude%%}",
        "longitude": "{%%Longitude%%}",
        "appId": "{%%AppId%%}",
        "marketingCloudId": "{%%ECID%%}"
    }
    }
    
    note note
    NOTE
    Nell’esempio precedente, gli elementi dati sul lato destro devono essere configurati nell’interfaccia utente di Data Collection sfruttando i passaggi descritti in Creazione di elementi dati. Gli elementi dati a sinistra sono supportati in Adobe Campaign Standard e non richiedono alcuna configurazione. Se hai bisogno di dati aggiuntivi, devi eseguire estensioni di risorse personalizzate in Adobe Campaign Standard.
  11. In entrata Content Type, tipo application/json.

  12. In entrata Timeout, selezionare 5.

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