Criar uma oferta personalizada
- Tópicos:
- Gestão de decisões
- API
Criado para:
- Experiente
- Desenvolvedor
Uma oferta personalizada é uma mensagem de marketing personalizável baseada em regras de elegibilidade e restrições.
Você pode criar uma oferta personalizada fazendo uma solicitação POST para a API Offer Library.
Cabeçalhos Accept e Content-Type
A tabela a seguir mostra os valores válidos que compõem o campo Content-Type no cabeçalho da solicitação:
| Nome do cabeçalho | Valor |
|---|---|
| Tipo de conteúdo | application/json |
Formato da API
POST /{ENDPOINT_PATH}/offers/{ID}?offer-type=personalized
| Parâmetro | Descrição | Exemplo |
|---|---|---|
{ENDPOINT_PATH} | O caminho do endpoint para APIs de persistência. | https://platform.adobe.io/data/core/dps/ |
Solicitação
curl -X POST 'https://platform.adobe.io/data/core/dps/offers?offer-type=personalized' \
-H 'Content-Type: application/json' \
-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 '{
"name": "Test personalized offer with frequency constraint",
"status": "draft",
"representations": [
{
"channel": "https://ns.adobe.com/xdm/channel-types/web",
"placement": "offerPlacement1234",
"components": [
{
"type": "html",
"format": "text/html",
"language": [
"en-us"
],
"content": "Hello You qualify for our Discount of 60%"
}
]
}
],
"selectionConstraint": {
"startDate": "2022-07-27T05:00:00.000+00:00",
"endDate": "2023-07-29T05:00:00.000+00:00",
"profileConstraintType": "none"
},
"rank": {
"priority": 0
},
"cappingConstraint": {},
"frequencyCappingConstraints": [
{
"enabled": false,
"limit": 1,
"startDate": "2023-05-15T14:25:49.622+00:00",
"endDate": "2023-05-25T14:25:49.622+00:00",
"scope": "global",
"entity": "offer",
"repeat": {
"enabled": false,
"unit": "month",
"unitCount": 1
}
}
]
}'
Resposta
Uma resposta bem-sucedida retorna os detalhes da oferta personalizada recém-criada, incluindo a id. Você pode usar o id em etapas posteriores para atualizar ou excluir sua oferta personalizada.
{
"etag": 1,
"createdBy": "{CREATED_BY}",
"lastModifiedBy": "{MODIFIED_BY}",
"id": "{ID}",
"sandboxId": "{SANDBOX_ID}",
"createdDate": "2023-05-31T15:09:11.771Z",
"lastModifiedDate": "2023-05-31T15:09:11.771Z",
"createdByClientId": "{CREATED_CLIENT_ID}",
"lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"
}
Limitações
Atualmente, as representações de oferta e algumas restrições de oferta não são compatíveis com os fluxos de trabalho móveis Experience Edge, por exemplo Capping. O valor do campo Capping especifica o número de vezes que uma oferta pode ser apresentada entre todos os usuários. Para obter mais detalhes, consulte Documentação de regras e restrições de qualificação da oferta.