DocumentaciónCampaignDocumentación de Campaign Standard

Configuración de reglas de etiquetas para admitir casos de uso de Adobe Campaign Standard configuring-rules-launch

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

Creado para:

  • Experimentado
  • Administrador

En la interfaz de usuario de recopilación de datos, cree elementos de datos y reglas para enviar PII y otros datos desde aplicaciones móviles a Adobe Campaign Standard.

Para garantizar que todos los cambios de configuración en la IU de recopilación de datos surtan efecto, debe publicarlos. Para obtener más información, consulte Publicación.

Para crear reglas en la IU de recopilación de datos, siga estos pasos:

  1. Creación de elementos de datos

  2. Creando reglas para los casos de uso que desea admitir:

Creación de elementos de datos create-data-elements

Estos son los elementos de datos que recomendamos crear en la IU de recopilación de datos.
Puede crear elementos de datos adicionales según sus necesidades.

  • Experience Cloud ID
  • Pkey
  • Campaign server

Para crear estos elementos de datos:

  1. En la IU de recopilación de datos, en el panel de aplicaciones móviles, haga clic en la pestaña Data Elements.

  2. Para crear el elemento de datos Experience Cloud ID, haga clic en Create New Data Element.

  3. En el campo Name, por ejemplo, escriba mcid.

  4. En la lista desplegable Extension, seleccione Mobile Core. Luego Experience Cloud ID en la lista desplegable de tipo Data element.

  5. Para crear el elemento de datos Pkey, haga clic en Add data element.

  6. En el campo Name, por ejemplo, escriba pkey.

  7. En la lista desplegable Extension, seleccione Adobe Campaign Standard. Luego pkey en la lista desplegable de tipo Data element.

  8. Para crear el elemento de datos del servidor de Campaign, haga clic en Add data element.

  9. En el campo Name, escriba un nombre, por ejemplo, camp-server.

  10. En la lista desplegable Extension, seleccione Adobe Campaign Standard. A continuación, Campaign Server en la lista desplegable de tipo Data element.

Creación de reglas creating-rules

Debe crear reglas para lo siguiente:

Postback PII pii-postback

NOTE
Para enviar información PII de una aplicación móvil a Adobe Campaign, debe implementar una API de SDK. Para obtener más información, ve a CollectPII.

Para enviar datos PII a Adobe Campaign Standard, cree una regla en la IU de recopilación de datos:

  1. En la IU de recopilación de datos, en el panel de aplicaciones móviles, haga clic en la pestaña Rules y luego en Create New Rule.

  2. Escriba un nombre, por ejemplo, Mobile Core - Recopilar PII.

  3. En la sección Events, haga clic en Add.

  4. En la lista desplegable Extension, seleccione Mobile Core. A continuación, Collect PII en la lista desplegable Event type.

  5. Haga clic en Keep changes.

  6. En la sección Actions, haga clic en Add.

  7. En la lista desplegable Extension, seleccione Mobile Core. A continuación, Send PII en la lista desplegable Action type.

  8. En URL, escriba la siguiente dirección URL:

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

  9. Seleccione la casilla de verificación Add Post Body.

  10. En Post Body, escriba lo siguiente:

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

    MarketingCloudId permite reconciliar a los suscriptores de la aplicación con los destinatarios de la base de datos y, como resultado, es obligatorio. Puede especificar otros pares clave-valor según sus necesidades comerciales. En el ejemplo anterior, se están pasando el correo electrónico, el nombre y los apellidos desde la aplicación.

    Las claves (por ejemplo cusEmail, cusFirstName y cusLastName) deben coincidir con los ID de campo definidos en el recurso personalizado en la instancia de Adobe Campaign Standard. Las variables de valor (por ejemplo email, firstName y LastName) deben coincidir con las claves de los datos JSON enviados desde la aplicación móvil al llamar a la API collectPII de AMS desde el código de la aplicación.

    También puede pasar datos del ciclo vital en el postback Recopilar PII o un postback diferente según los déclencheur del evento. A continuación, se muestra un ejemplo del JSON de datos del ciclo vital:

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

    Los elementos de datos definidos en la IU de recopilación de datos deben incluirse en porcentajes dobles, por ejemplo %%mcid%%, y las variables de contexto de la aplicación deben incluirse en porcentajes únicos, por ejemplo %contextdata.email%.

  11. En Content Type, escriba application/json.

  12. En Timeout, seleccione 0.

Los datos de usuario ahora están configurados para enviarse a Campaign.

Postback de seguimiento en la aplicación inapp-tracking-postback

NOTE
Si utiliza Android ACPCore v1.4.0 o posterior/ iOS ACPCore v2.3.0 o posterior, no es necesario configurar los postbacks de seguimiento.

Para enviar datos de seguimiento a Adobe Campaign Standard con el fin de generar informes sobre cómo los usuarios interactúan con los mensajes en la aplicación móvil, cree la regla siguiente en la interfaz de usuario de la recopilación de datos:

  1. En la IU de recopilación de datos, en el panel de aplicaciones móviles, seleccione la pestaña Rules y haga clic en Add Rule.

  2. Escriba un nombre, por ejemplo, Adobe Campaign - Rastreo de clics en la aplicación.

  3. En la sección Events, haga clic en Add.

  4. En la lista desplegable Extension, seleccione Adobe Campaign Standard. A continuación, In-App click tracking en la lista desplegable Event type.

  5. Haga clic en Keep changes.

  6. En la sección Actions, haga clic en Add.

  7. En la lista desplegable Extension, seleccione Mobile Core. A continuación, Send postback en la lista desplegable Event type.

  8. En URL, escriba la siguiente dirección URL:

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

  9. Seleccione la casilla de verificación Add post body.

  10. En Post Body, escriba {}.

  11. En Content Type, escriba application/json.

  12. En Timeout, seleccione 0.

Postback de seguimiento de notificaciones push push-tracking-postback

NOTE
Si utiliza Android ACPCore v1.4.0 o posterior/ iOS ACPCore v2.3.0 o posterior, no es necesario configurar los postbacks de seguimiento.

Para enviar datos de seguimiento a Adobe Campaign Standard, lo que ayuda a realizar un seguimiento de las entregas de notificaciones push y de la interacción de los usuarios con la aplicación móvil, debe crear una regla en la IU de recopilación de datos.

Para obtener más información sobre el seguimiento push, consulte Seguimiento push.

Para realizar un seguimiento de las acciones de la aplicación, utilice la API trackAction. Para obtener más información, consulte Seguimiento de acciones de aplicaciones.

  1. En la IU de recopilación de datos, en el panel de aplicaciones móviles, haga clic en la pestaña Rules y luego en Add Rule.

  2. Escriba un nombre, por ejemplo, Adobe Campaign - rastreo de clics push.

  3. En la sección Events, haga clic en Add.

  4. En la lista desplegable Extension, seleccione Mobile Core. A continuación, Track Action en la lista desplegable Event type.

  5. En la lista desplegable Action, seleccione Action, seleccione equals y escriba seguimiento.

  6. Haga clic en Keep changes. A continuación, en la sección Actions, haga clic en Add.

  7. En la lista desplegable Extension, seleccione Mobile Core. A continuación, Send postback en la lista desplegable Action type.

  8. En URL, escriba la siguiente dirección URL:

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

  9. Seleccione la casilla de verificación Add post body.

  10. Agregue el cuerpo del anuncio, por ejemplo, { }.

  11. En Content Type, escriba application/json.

  12. En Timeout, seleccione 0.

Postback de ubicación location-postback

  1. En la IU de recopilación de datos, en el panel de aplicaciones móviles, haga clic en la pestaña Rules y luego en Add Rule.

  2. Escriba un nombre, por ejemplo, Ubicación postback.

  3. En la sección Events, haga clic en Add.

  4. Cree un evento, por ejemplo, Introducir punto de interés o Salida de punto de interés. En la lista desplegable Extension, seleccione Places - Beta. A continuación, Escriba el punto de interés o salga del punto de interés en la lista desplegable Event type.

  5. Escriba un nombre, por ejemplo, Places - Beta - Escriba el punto de interés o Punto de interés de salida.

  6. En la sección Actions, haga clic en Add.

  7. En la lista desplegable Extension, seleccione Mobile Core. Luego Send postback de la lista desplegable Action type.

  8. Escriba un nombre, por ejemplo, Núcleo móvil - Enviar ubicación Postback.

  9. En URL, escriba la siguiente dirección URL:

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

  10. Seleccione la casilla de verificación Add post body y agregue el cuerpo del anuncio, por ejemplo:

    code language-none 
    {
"locationData": {
    "distances": "{%%Distance%%}",
    "poiLabel": "{%%POILabel%%}",
    "latitude": "{%%Latitude%%}",
    "longitude": "{%%Longitude%%}",
    "appId": "{%%AppId%%}",
    "marketingCloudId": "{%%ECID%%}"
}
}
    note note
    NOTE
    En el ejemplo anterior, los elementos de datos del lado derecho deben configurarse en la IU de recopilación de datos aprovechando los pasos de Creación de elementos de datos. Los elementos de datos del lado izquierdo son compatibles con Adobe Campaign Standard y no necesitan ninguna configuración. Si necesita datos adicionales, debe realizar extensiones de recursos personalizadas en Adobe Campaign Standard.

  11. En Content Type, escriba application/json.

  12. En Timeout, seleccione 5.

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