Los códigos personalizados en StockCrowd son herramientas que utilizas para segmentar y analizar las donaciones de forma más eficiente. Estos códigos te permiten categorizar donaciones y se reflejan en los Eventos (webhooks) y en los reportes de aportaciones.

Puedes crear códigos personalizados a dos niveles: a nivel de organización, que aplica a todas las campañas, o a nivel de campaña, que aplica solo a esa campaña en concreto.

Existen dos tipos principales de códigos personalizados que puedes configurar según tus necesidades: códigos a nivel de organización y códigos a nivel de campaña. Cada uno tiene características específicas y alcances diferentes.

A nivel de organización, configuras los códigos desde Datos de registro, seleccionando Editar e ir a la parte donde puedes agregar los códigos personalizados. Esta es la ubicación central donde estableces códigos que aplicarán a múltiples campañas.

En la pantalla de configuración, ves la interfaz donde se gestionan los códigos personalizados. Esta es la zona de administración central para tus códigos a nivel de organización.

Para agregar un nuevo código, debes hacer clic en el icono de la cruz y asignar el alcance que tendrá. El alcance determina dónde aparecerá el código: puedes elegir que aparezca en todas las campañas y páginas P2P (retos), solo en campañas o solo en retos. De esta forma, tienes diferentes alcances disponibles según tus necesidades.

En esta pantalla, seleccionas el alcance del código. Las opciones disponibles te permiten elegir si el código aplicará a todas las campañas, solo a campañas o solo a páginas P2P.

Seguidamente, asignas el nombre del código y el valor del código. Este nombre es lo que aparecerá como encabezado en los reportes, y el valor es el contenido que se reflejará en las donaciones.

En esta pantalla, escribes el nombre del código y asignas su valor. Este es el paso donde defines exactamente qué información contendrá cada código personalizado.

Este uso es ideal cuando quieres que todas las campañas compartan el mismo código y valor. Esto es especialmente útil para integraciones de StockCrowd con un CRM o para diferenciar las donaciones que vienen de StockCrowd de otras fuentes.

Si a nivel organización dejas el valor del código en blanco, tienes la flexibilidad de personalizarlo en cada una de las campañas sin tener que escribir nuevamente el nombre del código. Solo necesitas agregar el valor, permitiendo que cada campaña tenga un valor diferente mientras mantiene el mismo nombre de código.

Los códigos a nivel de campaña se crean de la misma forma que a nivel de organización, pero la diferencia principal es que solo aplican a la campaña específica en la que los estableces. Por esa razón, no puedes seleccionar el alcance. Para configurarlos, accedes a la campaña, seleccionas Contenido, luego Datos Generales, haces clic en Editar, y aparecerá la opción para configurar los códigos.

El proceso para agregar un nuevo código es idéntico al que usas a nivel de organización. Un punto importante a recordar es que los códigos ya configurados a nivel organización aparecerán de forma predeterminada en las campañas y no podrás editarlos ni eliminarlos desde el nivel de campaña.

En esta pantalla ves la configuración de códigos a nivel de campaña. Los códigos de organización ya aparecen aquí, y puedes agregar códigos adicionales específicos para esta campaña.

Entender cómo se comportan los códigos cuando los modificas, agregas o eliminas es clave para mantener la coherencia de tus datos. El comportamiento depende del nivel en el que se creó cada código (organización o campaña) y de su relación de herencia.

Cuando creas un código a nivel de organización, este se propaga automáticamente a los niveles inferiores (campañas y sus páginas P2P), siempre que ese código no exista ya en ese nivel. Si en una campaña o reto ya modificaste el valor de un código específico, el sistema respeta esa configuración local: los cambios que hagas después a nivel de organización no sobrescriben el valor que definiste localmente.

Modificar el valor de un código no altera los datos históricos. Para garantizar la integridad de los reportes, el sistema guarda una copia "espejo" del código en el momento exacto en que se crea cada transacción. Es decir, aunque cambies el valor de un código más adelante, los reportes de donaciones anteriores seguirán mostrando el valor que estaba vigente cuando se realizó cada pago. Solo las donaciones nuevas tomarán el valor actualizado.

Eliminar un código a nivel de organización lo elimina en cascada en todas las campañas y retos asociados. En cuanto a la edición o eliminación local: si el código se creó originalmente a nivel de campaña, puedes editarlo o eliminarlo localmente; pero si el código proviene del nivel de organización, esa opción está restringida a nivel local. Para cambiarlo, debes hacerlo desde la sección de Datos de registro de tu organización. Esto mantiene la integridad de la estructura de códigos en toda la plataforma.

El alcance de un código determina exactamente dónde aparecerá y será utilizable. Dependiendo del alcance que selecciones a nivel organización, el código estará disponible en diferentes lugares dentro de tu plataforma.

Los alcances disponibles son:

Hay una excepción importante: cuando creas códigos personalizados a nivel de campaña y esa campaña es de tipo P2P, entonces sí puedes asignar el alcance. Las opciones en este caso son que el código aparezca solo en el Marketplace, solo en las páginas P2P de esa campaña, o en ambas opciones.

En esta pantalla ves las opciones de alcance específicas para campaña P2P. Puedes seleccionar si lo quieres solamente para el Marketplace, para las páginas P2P de esta campaña o para ambas opciones, dándote mayor control sobre dónde aparece cada código.

Los códigos personalizados, ya sean a nivel de organización o campaña, aparecerán automáticamente en tus reportes. Se mostrarán como columnas con el nombre del código, y el valor asignado será el contenido que aparecerá en las celdas correspondientes para cada donación.

En tu reporte, ves cómo los códigos personalizados aparecen como columnas adicionales. Cada donación muestra el valor correspondiente del código en su fila, permitiéndote analizar fácilmente la información segmentada.

Un Query String es una cadena de texto que contiene parámetros en formato de clave-valor, ubicados al final de una URL después del signo de interrogación (?). Se utiliza para pasar información adicional a un servidor web, como criterios de búsqueda, filtros, identificadores o datos para una página web.

Con esta funcionalidad, los códigos personalizados son actualizables desde una URL. Siempre que el código tenga marcada la opción de "actualizable", el valor por defecto que se había puesto a un código puede ser sobrescrito si la URL contiene un parámetro con otro valor. Esto te da flexibilidad para cambiar los valores dinámicamente según la fuente del tráfico.

Aquí ves la configuración de un código personalizado con la opción "actualizable" marcada. Esto significa que el valor de este código puede cambiar según los parámetros que agregues a la URL.

Esta funcionalidad aplica tanto a nivel de organización como de campaña y es especialmente útil para identificar la procedencia de las donaciones en campañas de marketing. Logras esto a través del código vía URL desde el Query String, permitiéndote rastrear exactamente de dónde viene cada donación.

Esta es una URL de campaña normal sin parámetros adicionales:

La URL que ves aquí es una dirección de campaña estándar. Esta es la URL base que usarás como punto de partida.

Pero para utilizar esta funcionalidad de Query String, debes modificar la URL agregando un parámetro después del signo de interrogación. Esto te permite personalizar el seguimiento según tu fuente de tráfico.

Supongamos que la misma URL se va a utilizar para redes sociales como Instagram y Facebook. Con esta técnica, podrás identificar desde dónde vienen los donativos, ya que la URL contendrá el parámetro que agregaste y que es específico para cada red social.

Instagram:

Esta URL incluye un parámetro específico para Instagram. Al usar esta URL en Instagram, sabrás exactamente que las donaciones que llegan a través de este enlace provienen de esa plataforma.

Facebook:

Esta URL contiene un parámetro diferente para Facebook. Cuando compartes este enlace en Facebook, el código capturará un valor distinto que te permitirá identificar donaciones de esa red social específicamente.

Incluso si otras organizaciones te ayudan a difundir la campaña, puedes agregar distintos parámetros para saber de qué organización que te está ayudando a compartir la campaña viene cada donativo. Esto es útil para colaboraciones y para agradecer a tus socios por su ayuda.

A nivel de reporte, puedes visualizar todos estos datos y así identificar exactamente de dónde viene cada donativo. El código capturado en el Query String aparecerá en tus reportes, dándote un análisis completo del origen de tus donaciones.

En tu reporte, ves cómo aparecen los valores del Query String en la columna del código personalizado. Esto te permite identificar rápidamente qué fuente envió cada donación.

También a nivel de Eventos (webhooks), podrás visualizar estos códigos. Los eventos te permiten ver en tiempo real los cambios y las nuevas donaciones con sus parámetros correspondientes.

En los eventos, ves los detalles completos de cada transacción incluyendo el código personalizado del Query String. Esto es especialmente útil para integraciones y para monitorear en tiempo real las donaciones según su origen.

Los códigos personalizados te permiten tener un control mucho más fino de tus donaciones y adaptar completamente la información a tus necesidades específicas. Esta es una herramienta poderosa para entender y optimizar tus esfuerzos de recaudación.

Un código personalizado a nivel de organización aplica a todas las campañas dentro de tu organización, lo que es útil para mantener consistencia y realizar análisis globales. Un código a nivel de campaña aplica solo a una campaña específica, permitiéndote tener códigos más personalizados para necesidades particulares de esa campaña. Los códigos de organización aparecen automáticamente en todas las campañas y no puedes editarlos a nivel de campaña.

Puedes usar la funcionalidad de Query String para rastrear donaciones de diferentes fuentes. Debes crear un código personalizado marcado como "actualizable" y luego agregar parámetros específicos a la URL de tu campaña. Por ejemplo, puedes usar ?source=instagram para Instagram y ?source=facebook para Facebook. Cada donación capturará el valor que incluiste en la URL, permitiéndote identificar exactamente de dónde vino cada donativo en tus reportes y eventos.

Si dejas el valor del código en blanco a nivel de organización, tienes la flexibilidad de personalizarlo en cada una de las campañas sin tener que volver a escribir el nombre del código. Solo necesitas completar el valor en cada campaña donde lo uses. Esta es una forma práctica de reutilizar nombres de códigos con valores diferentes según la campaña.

No. El sistema conserva el valor que tenía el código en el momento de cada transacción, gracias a una copia "espejo" que se guarda al crearse cada donación. Por eso los reportes históricos no se ven afectados cuando cambias un valor. Solo las donaciones nuevas tomarán el valor actualizado.

Los códigos personalizados aparecen automáticamente en tus reportes como columnas adicionales, donde ves los valores asignados para cada donación. También aparecen en los eventos (webhooks) si utilizas integraciones con otros sistemas. La ubicación específica donde el donante ve o interactúa con el código depende del alcance que hayas seleccionado: en todas las campañas y P2P, solo en campañas, o solo en páginas P2P.

No, no puedes editar ni eliminar los códigos que configuraste a nivel de organización desde el nivel de campaña. Los códigos de organización aparecen de forma predeterminada en todas las campañas (según su alcance) y son de solo lectura. Si necesitas cambiar un código de organización, debes hacerlo desde la sección de Datos de registro de tu organización. Sin embargo, puedes crear códigos adicionales específicos a nivel de campaña que sí puedes editar o eliminar.