Una oferta personalizada es un mensaje de marketing personalizable basado en reglas y restricciones de idoneidad.
Puede crear una oferta personalizada realizando una solicitud de POST al Offer Library al proporcionar su ID de contenedor.
La tabla siguiente muestra los valores válidos que comprenden el Content-Type y Accept campos en el encabezado de la solicitud:
Nombre del encabezado | Valor |
---|---|
Accept | application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1 |
Content-Type | application/schema-instance+json; version=1; schema="https://ns.adobe.com/experience/offer-management/personalized-offer;version=0.5" |
Formato de API
POST /{ENDPOINT_PATH}/{CONTAINER_ID}/instances
Parámetro | Descripción | Ejemplo |
---|---|---|
{ENDPOINT_PATH} |
Ruta de extremo para las API del repositorio. | https://platform.adobe.io/data/core/xcore/ |
{CONTAINER_ID} |
Contenedor donde se encuentran las ofertas personalizadas. | e0bd8463-0913-4ca1-bd84-6309134ca1f6 |
Solicitud
curl -X POST \
'https://platform.adobe.io/data/core/xcore/e0bd8463-0913-4ca1-bd84-6309134ca1f6/instances' \
-H 'Accept: application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1' \
-H 'Content-Type: application/schema-instance+json; version=1; schema="https://ns.adobe.com/experience/offer-management/personalized-offer;version=0.5"' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"xdm:name": "Sale offer",
"xdm:status": "draft",
"xdm:representations": [
{
"xdm:components": [
{
"dc:language": [
"en"
],
"@type": "https://ns.adobe.com/experience/offer-management/content-component-html",
"dc:format": "text/html"
}
],
"xdm:placement": "xcore:offer-placement:124e0be5699743d3"
}
],
"xdm:selectionConstraint": {
"xdm:startDate": "2020-10-01T16:00:00Z",
"xdm:endDate": "2021-12-13T16:00:00Z",
"xdm:eligibilityRule": "xcore:eligibility-rule:124e0faf5b8ee89b"
},
"xdm:rank": {
"xdm:priority": 1
},
"xdm:cappingConstraint": {
"xdm:globalCap": 150
},
"xdm:tags": [
"xcore:tag:124e147572cd7866"
]
}'
Respuesta
Una respuesta correcta devuelve información sobre la oferta personalizada recién creada, incluida su ID de instancia única y su ubicación @id
. Puede utilizar el ID de instancia en pasos posteriores para actualizar o eliminar la oferta personalizada.
{
"instanceId": "0f4bc230-13df-11eb-bc55-c11be7252432",
"@id": "xcore:personalized-offer:124e181c8b0d7878",
"repo:etag": 1,
"repo:createdDate": "2020-10-21T20:50:32.018624Z",
"repo:lastModifiedDate": "2020-10-21T20:50:32.018624Z",
"repo:createdBy": "{CREATED_BY}",
"repo:lastModifiedBy": "{MODIFIED_BY}",
"repo:createdByClientId": "{CREATED_CLIENT_ID}",
"repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"
}
Actualmente, las representaciones de ofertas y algunas restricciones de ofertas no son compatibles con el dispositivo móvil Experience Edge flujos de trabajo, por ejemplo Capping
. La variable Capping
valor de campo especifica el número de veces que se puede presentar una oferta en todos los usuarios. Para obtener más información, consulte Documentación de reglas y restricciones de idoneidad para la oferta.