2.3.6 Destinos SDK
Configuración del proyecto de Adobe I/O
En este ejercicio volverá a utilizar Adobe I/O para consultar las API de Adobe Experience Platform. Si aún no ha configurado el proyecto de Adobe I/O, vuelva al Ejercicio 3 del módulo 2.1 y siga las instrucciones que se indican a continuación.
Autenticación en Adobe I/O
En este ejercicio volverá a utilizar Postman para consultar las API de Adobe Experience Platform. Si aún no configuró la aplicación Postman, vuelva al Ejercicio 3 del módulo 2.1 y siga las instrucciones que se indican a continuación.
Definir punto final y formato
Para este ejercicio, necesitará un punto final que configurar para que cuando una audiencia se califique, el evento de calificación se pueda transmitir a ese punto final. En este ejercicio, usará un extremo de ejemplo con https://pipedream.com/requestbin. Vaya a https://pipedream.com/requestbin, cree una cuenta y luego un área de trabajo. Una vez creado el espacio de trabajo, verá algo similar a esto.
Haga clic en copiar para copiar la dirección URL. Deberá especificar esta dirección URL en el siguiente ejercicio. La dirección URL de este ejemplo es https://eodts05snjmjz67.m.pipedream.net.
En cuanto al formato, se utiliza una plantilla estándar que transmite las cualificaciones o descualificaciones de la audiencia junto con metadatos como los identificadores de cliente. Las plantillas se pueden personalizar para satisfacer las expectativas de puntos finales específicos, pero en este ejercicio reutilizaremos una plantilla estándar, lo que dará como resultado una carga útil como esta que se transmitirá al punto final.
{
"profiles": [
{
"identities": [
{
"type": "ecid",
"id": "64626768309422151580190219823409897678"
}
],
"AdobeExperiencePlatformSegments": {
"add": [
"f58c723c-f1e5-40dd-8c79-7bb4ab47f041"
],
"remove": []
}
}
]
}
Creación de una configuración de servidor y plantilla
El primer paso para crear su propio destino en Adobe Experience Platform es crear una configuración de servidor y plantilla con Postman.
Para ello, abra su aplicación de Postman, vaya a la API de creación de destino, a servidores y plantillas de destino y haga clic para abrir la solicitud POST: crear una configuración de servidor de destino.
Entonces verá esto… En Encabezados, debe actualizar manualmente el valor de la clave x-sandbox-name y establecerlo en --aepSandboxName--. Seleccione el valor {{SANDBOX_NAME}}.
Reemplazar por --aepSandboxName--.
A continuación, vaya a Cuerpo. seleccione el marcador de posición {{body}}.
Ahora necesita reemplazar el marcador de posición {{body}} por el siguiente código:
{
"name": "Custom HTTP Destination",
"destinationServerType": "URL_BASED",
"urlBasedDestination": {
"url": {
"templatingStrategy": "PEBBLE_V1",
"value": "yourURL"
}
},
"httpTemplate": {
"httpMethod": "POST",
"requestBody": {
"templatingStrategy": "PEBBLE_V1",
"value": "{\n \"profiles\": [\n {%- for profile in input.profiles %}\n {\n \"identities\": [\n {%- for idMapEntry in profile.identityMap -%}\n {%- set namespace = idMapEntry.key -%}\n {%- for identity in idMapEntry.value %}\n {\n \"type\": \"{{ namespace }}\",\n \"id\": \"{{ identity.id }}\"\n }{%- if not loop.last -%},{%- endif -%}\n {%- endfor -%}{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ],\n \"AdobeExperiencePlatformSegments\": {\n \"add\": [\n {%- for segment in profile.segmentMembership.ups | added %}\n \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ],\n \"remove\": [\n {#- Alternative syntax for filtering segments by status: -#}\n {% for segment in removedSegments(profile.segmentMembership.ups) %}\n \"{{ segment.key }}\"{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ]\n }\n }{%- if not loop.last -%},{%- endif -%}\n {% endfor %}\n ]\n}"
},
"contentType": "application/json"
}
}
Después de pegar el código anterior, debe actualizar manualmente el campo urlBasedDestination.url.value y establecerlo en la dirección URL del webhook que creó en el paso anterior, que era https://eodts05snjmjz67.m.pipedream.net en este ejemplo.
Después de actualizar el campo urlBasedDestination.url.value, debería tener este aspecto. Haga clic en Enviar.
access_token válido(a). Para obtener un access_token válido, ejecute la solicitud POST - Obtener token de acceso en la colección Adobe IO - OAuth.Después de hacer clic en Enviar, se creará la plantilla de servidor y, como parte de la respuesta, verá un campo denominado instanceId. Escríbelo, ya que lo necesitará en el siguiente paso. En este ejemplo, instanceId es52482c90-8a1e-42fc-b729-7f0252e5cebd.
Cree la configuración de destino
En Postman, en API de creación de destino, vaya a Configuraciones de destino y haga clic para abrir la solicitud POST - Crear una configuración de destino. Entonces verá esto… En Encabezados, debe actualizar manualmente el valor de la clave x-sandbox-name y establecerlo en --aepSandboxName--. Seleccione el valor {{SANDBOX_NAME}} y reemplácelo por --aepSandboxName--.
A continuación, vaya a Cuerpo. seleccione el marcador de posición {{body}}.
Ahora necesita reemplazar el marcador de posición {{body}} por el siguiente código:
{
"name": "--aepUserLdap-- - Webhook",
"description": "Exports segment qualifications and identities to a custom webhook via Destination SDK.",
"status": "TEST",
"customerAuthenticationConfigurations": [
{
"authType": "BEARER"
}
],
"customerDataFields": [
{
"name": "endpointsInstance",
"type": "string",
"title": "Select Endpoint",
"description": "We could manage several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
"isRequired": true,
"enum": [
"US",
"EU",
"APAC",
"NZ"
]
}
],
"uiAttributes": {
"documentationLink": "https://experienceleague.adobe.com/docs/experience-platform/destinations/home.html?lang=es",
"category": "streaming",
"connectionType": "Server-to-server",
"frequency": "Streaming"
},
"identityNamespaces": {
"ecid": {
"acceptsAttributes": true,
"acceptsCustomNamespaces": false
}
},
"segmentMappingConfig": {
"mapExperiencePlatformSegmentName": true,
"mapExperiencePlatformSegmentId": true,
"mapUserInput": false
},
"aggregation": {
"aggregationType": "BEST_EFFORT",
"bestEffortAggregation": {
"maxUsersPerRequest": "1000",
"splitUserById": false
}
},
"schemaConfig": {
"profileRequired": false,
"segmentRequired": true,
"identityRequired": true
},
"destinationDelivery": [
{
"authenticationRule": "NONE",
"destinationServerId": "yourTemplateInstanceID"
}
]
}
Después de pegar el código anterior, debe actualizar manualmente el campo destinationDelivery. destinationServerId y debe establecerlo en instanceId de la plantilla de servidor de destino que creó en el paso anterior, que era 52482c90-8a1e-42fc-b729-7f0252e5cebd en este ejemplo. A continuación, haga clic en Enviar.
A continuación, verá esta respuesta.
El destino se creará en Adobe Experience Platform. Vamos allí y vamos a comprobarlo.
Ir a Adobe Experience Platform. Después de iniciar sesión, llegará a la página principal de Adobe Experience Platform.
Antes de continuar, debe seleccionar una zona protegida. La zona protegida que se va a seleccionar se denomina --aepSandboxName--. Después de seleccionar la zona protegida adecuada, verá el cambio en la pantalla y ahora se encuentra en la zona protegida dedicada.
En el menú de la izquierda, ve a Destinos, haz clic en Catálogo y desplázate hacia abajo hasta la categoría Transmisión. Ahora verá su destino disponible allí.
Vincule la audiencia al destino
En Destinos > Catálogo, haga clic en Configurar en el destino para empezar a agregar audiencias al nuevo destino.
Escriba un valor aleatorio para token de portador, como 1234. Haga clic en Conectar con destino.
Entonces verá esto… Como nombre de destino, use --aepUserLdap-- - Webhook. Seleccione un punto final de su elección, en este ejemplo EU. Haga clic en Next.
Si lo desea, puede seleccionar una política de control de datos. Haga clic en Next.
Seleccione la audiencia que creó anteriormente, que se llama --aepUserLdap-- - Interest in Galaxy S24. Haga clic en Next.
Entonces verá esto… Asegúrese de asignar SOURCE FIELD --aepTenantId--.identification.core.ecid al campo Identity: ecid. Haga clic en Next.
Haga clic en Finalizar.
El destino ya está activo. Las nuevas cualificaciones de audiencia se transmitirán ahora al webhook personalizado.
Prueba de la activación de audiencia
Vaya a https://dsn.adobe.com. Después de iniciar sesión con su Adobe ID, verá esto. Haga clic en los 3 puntos … del proyecto del sitio web y, a continuación, haga clic en Ejecutar para abrirlo.
A continuación, verá cómo se abre el sitio web de demostración. Seleccione la URL y cópiela en el portapapeles.
Abra una nueva ventana del explorador de incógnito.
Pegue la dirección URL del sitio web de demostración, que copió en el paso anterior. Luego se le pedirá que inicie sesión con su Adobe ID.
Seleccione el tipo de cuenta y complete el proceso de inicio de sesión.
Luego verá el sitio web cargado en una ventana de incógnito del explorador. Para cada ejercicio, deberá utilizar una ventana nueva del explorador de incógnito para cargar la URL del sitio web de demostración.
En este ejemplo, desea responder a un cliente específico que ve un producto específico.
En la página de inicio de Citi Signal, ve a Teléfonos y dispositivos y haz clic en el producto Galaxy S24.
Ya se ha visto la página de productos del Galaxy S24, por lo que su audiencia podrá acceder a su perfil en los minutos siguientes.
Cuando abra el Visor de perfiles y vaya a Audiencias, verá que la audiencia cumple los requisitos.
Ahora, vuelva al gancho web abierto en https://eodts05snjmjz67.m.pipedream.net, donde debería ver una nueva solicitud entrante, que se origina en Adobe Experience Platform y que contiene el evento de calificación de audiencia.
Pasos siguientes
Ir a Resumen y beneficios
Volver a CDP en tiempo real: cree una audiencia y tome medidas
Volver a Todos los módulos