DocumentazioneCampaignDocumentazione di Campaign Standard

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

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore

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, vedere Pubblicazione.

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

  1. Creazione di elementi dati

  2. Creazione di regole per i casi d'uso che si desidera supportare:

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'applicazione mobile, fare clic sulla scheda Data Elements.

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

  3. Nel campo Name, ad esempio, digita in mcid.

  4. Dall'elenco a discesa Extension, selezionare Mobile Core. Quindi Experience Cloud ID nel menu a discesa del tipo Data element.

  5. Per creare l'elemento dati Pkey, fare clic su Add data element.

  6. Nel campo Name, ad esempio, digitare pkey.

  7. Dall'elenco a discesa Extension, selezionare Adobe Campaign Standard. Quindi pkey nel menu a discesa del tipo Data element.

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

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

  10. Dall'elenco a discesa Extension, selezionare Adobe Campaign Standard. Quindi, Campaign Server nel menu a discesa del tipo Data element.

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, vai a 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'applicazione mobile, fare clic sulla scheda Rules e quindi su Create New Rule.

  2. Digitare un nome, ad esempio Mobile Core - Raccogli PII.

  3. Nella sezione Events, fare clic su Add.

  4. Dall'elenco a discesa Extension, selezionare Mobile Core. Quindi, Collect PII nel menu a discesa Event type.

  5. Fai clic su Keep changes.

  6. Nella sezione Actions, fare clic su Add.

  7. Dall'elenco a discesa Extension, selezionare Mobile Core. Quindi, Send PII nel menu a discesa Action type.

  8. In URL, immettere il seguente URL:

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}

  9. Selezionare la casella di controllo Add Post Body.

  10. In 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 racchiusi tra percentuali doppie, ad esempio %%mcid%%, mentre le variabili di contesto dell’app devono essere racchiuse tra percentuali singole, ad esempio %contextdata.email%.

  11. In Content Type, digitare application/json.

  12. In 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 regola seguente nell'interfaccia utente di Data Collection:

  1. Nell'interfaccia utente di Data Collection, dal dashboard dell'applicazione mobile, selezionare la scheda Rules e fare clic su Add Rule.

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

  3. Nella sezione Events, fare clic su Add.

  4. Dall'elenco a discesa Extension, selezionare Adobe Campaign Standard. Quindi, In-App click tracking nel menu a discesa Event type.

  5. Fai clic su Keep changes.

  6. Nella sezione Actions, fare clic su Add.

  7. Dall'elenco a discesa Extension, selezionare Mobile Core. Quindi, Send postback nel menu a discesa Event type.

  8. In URL, digitare il seguente URL:

    code language-none 
    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}

  9. Selezionare la casella di controllo Add post body.

  10. In Post Body, digitare {}.

  11. In Content Type, digitare application/json.

  12. In 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, in modo da 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, vedere 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'applicazione mobile, fare clic sulla scheda Rules e quindi su Add Rule.

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

  3. Nella sezione Events, fare clic su Add.

  4. Dall'elenco a discesa Extension, selezionare Mobile Core. Quindi, Track Action nel menu a discesa Event type.

  5. Dall'elenco a discesa Action, selezionare Action, selezionare equals e digitare tracking.

  6. Fai clic su Keep changes. Nella sezione Actions, fare clic su Add.

  7. Dall'elenco a discesa Extension, selezionare Mobile Core. Quindi, Send postback nel menu a discesa Action type.

  8. In URL, immettere il seguente URL:

    code language-none 
    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}

  9. Selezionare la casella di controllo Add post body.

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

  11. In Content Type, digitare application/json.

  12. In Timeout, selezionare 0.

Postback posizione location-postback

  1. Nell'interfaccia utente di Data Collection, dal dashboard dell'applicazione mobile, fare clic sulla scheda Rules e quindi su Add Rule.

  2. Digita un nome, ad esempio Postback località.

  3. Nella sezione Events, fare clic su Add.

  4. Crea un evento, ad esempio Enter POI (Inserisci POI) o Exit POI (Esci POI). Dall'elenco a discesa Extension, selezionare Places - Beta. Quindi, Inserisci POI o Esci POI nel menu a discesa Event type.

  5. Immetti un nome, ad esempio Places - Beta - Enter POI or Exit POI.

  6. Nella sezione Actions, fare clic su Add.

  7. Dall'elenco a discesa Extension, selezionare Mobile Core. Quindi, Send postback dal menu a discesa Action type.

  8. Immetti un nome, ad esempio Mobile Core - Send Location Postback.

  9. In URL, immettere il seguente URL:

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/

  10. Selezionare la casella di controllo 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 sul lato sinistro sono supportati in Adobe Campaign Standard e non richiedono alcuna configurazione. Se sono necessari dati aggiuntivi, è necessario eseguire estensioni di risorse personalizzate in Adobe Campaign Standard.

  11. In Content Type, digitare application/json.

  12. In Timeout, selezionare 5.

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