Una decisione contiene la logica su cui si basa la selezione di un’offerta.
Puoi visualizzare un elenco di tutte le decisioni all’interno di un contenitore eseguendo una singola richiesta GET al Offer Library API.
Formato API
GET /{ENDPOINT_PATH}/{CONTAINER_ID}/queries/core/search?schema={SCHEMA_ACTIVITIES}&{QUERY_PARAMS}
Parametro | Descrizione | Esempio |
---|---|---|
{ENDPOINT_PATH} |
Percorso dell’endpoint per le API dell’archivio. | https://platform.adobe.io/data/core/xcore/ |
{CONTAINER_ID} |
Il contenitore in cui si trovano le decisioni. | e0bd8463-0913-4ca1-bd84-6309134ca1f6 |
{SCHEMA_ACTIVITIES} |
Definisce lo schema associato alle decisioni. | https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5 |
{QUERY_PARAMS} |
Parametri di query facoltativi in base ai quali filtrare i risultati. | limit=2 |
Richiesta
curl -X GET \
'https://platform.adobe.io/data/core/xcore/e0bd8463-0913-4ca1-bd84-6309134ca1f6/queries/core/search?schema=https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5&limit=2' \
-H 'Accept: *,application/vnd.adobe.platform.xcore.hal+json; schema="https://ns.adobe.com/experience/xcore/hal/results"' \
-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}'
Puoi utilizzare i parametri di query per visualizzare e filtrare i risultati quando elenchi le risorse.
I parametri di query più comuni per il paging includono:
Parametro | Descrizione | Esempio |
---|---|---|
q |
Stringa di query facoltativa da cercare nei campi selezionati. La stringa di query deve essere in minuscolo e può essere racchiusa tra virgolette doppie per impedire che venga tokenizzata e per evitare caratteri speciali. I caratteri `+ - = && | |
qop |
Applica l’operatore AND o OR ai valori nel parametro della stringa di query q. | AND / OR |
field |
Elenco facoltativo di campi a cui limitare la ricerca. Questo parametro può essere ripetuto come segue: field=field1[,campo=campo2,…] e (le espressioni di percorso sono sotto forma di percorsi separati da punti, ad esempio _instance.xdm:name) | _instance.xdm:name |
orderBy |
Ordinare i risultati per una proprietà specifica. Aggiunta di un - prima del titolo (orderby=-title ) ordinerà gli elementi in base al titolo in ordine decrescente (Z-A). |
-repo:createdDate |
limit |
Limita il numero di decisioni restituite. | limit=5 |
Risposta
In caso di esito positivo, la risposta restituisce un elenco di decisioni presenti all’interno del contenitore a cui hai accesso.
{
"containerId": "e0bd8463-0913-4ca1-bd84-6309134ca1f6",
"schemaNs": "https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5",
"requestTime": "2020-10-21T22:38:32.838180Z",
"_embedded": {
"results": [
{
"instanceId": "286f6f80-026b-11eb-9439-ad36e372cbf1",
"schemas": [
"https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5"
],
"productContexts": [
"acp"
],
"repo:etag": 5,
"repo:createdDate": "2020-09-29T15:48:02.808677Z",
"repo:lastModifiedDate": "2020-10-15T15:49:26.673560Z",
"repo:createdBy": "{CREATED_BY}",
"repo:lastModifiedBy": "{MODIFIED_BY}",
"repo:createdByClientId": "{CREATED_CLIENT_ID}",
"repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}",
"_instance": {
"xdm:fallback": "xcore:fallback-offer:1233160780eaa2ef",
"xdm:name": "A2: Cross Channel Activity",
"xdm:endDate": "2020-10-09T07:00:00.000Z",
"xdm:startDate": "2020-09-29T07:00:00.000Z",
"xdm:status": "live",
"xdm:criteria": [
{
"xdm:placements": [
"xcore:offer-placement:122204529514a2c0"
],
"xdm:optionSelection": {
"xdm:filter": "xcore:offer-filter:122a120f234dac7f"
}
},
{
"xdm:placements": [
"xcore:offer-placement:122201b2150d98c2"
],
"xdm:optionSelection": {
"xdm:filter": "xcore:offer-filter:1222058c3f0d98de"
}
}
],
"@id": "xcore:offer-activity:12317fe6aeec9330"
},
"_links": {
"self": {
"name": "https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5#286f6f80-026b-11eb-9439-ad36e372cbf1",
"href": "/e0bd8463-0913-4ca1-bd84-6309134ca1f6/instances/286f6f80-026b-11eb-9439-ad36e372cbf1",
"@type": "https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5"
}
},
"sandboxName": "ode-prod-va7-edge-testing"
},
{
"instanceId": "4e0206d0-0e6a-11eb-884a-c1a1104e3d7d",
"schemas": [
"https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5"
],
"productContexts": [
"acp"
],
"repo:etag": 1,
"repo:createdDate": "2020-10-14T22:12:10.300775Z",
"repo:lastModifiedDate": "2020-10-14T22:12:10.300775Z",
"repo:createdBy": "{CREATED_BY}",
"repo:lastModifiedBy": "{MODIFIED_BY}",
"repo:createdByClientId": "{CREATED_CLIENT_ID}",
"repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}",
"_instance": {
"xdm:fallback": "xcore:fallback-offer:1233160780eaa2ef",
"xdm:name": "LBAR",
"xdm:endDate": "2021-02-28T08:00:00.000Z",
"xdm:startDate": "2020-10-14T07:00:00.000Z",
"xdm:status": "live",
"xdm:criteria": [
{
"xdm:placements": [
"xcore:offer-placement:122204529514a2c0"
],
"xdm:optionSelection": {
"xdm:filter": "xcore:offer-filter:122a120f234dac7f"
}
}
],
"@id": "xcore:offer-activity:124527ab00b2ebbc"
},
"_links": {
"self": {
"name": "https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5#4e0206d0-0e6a-11eb-884a-c1a1104e3d7d",
"href": "/e0bd8463-0913-4ca1-bd84-6309134ca1f6/instances/4e0206d0-0e6a-11eb-884a-c1a1104e3d7d",
"@type": "https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5"
}
},
"sandboxName": "ode-prod-va7-edge-testing"
}
],
"total": 7,
"count": 2
},
"_links": {
"self": {
"href": "/e0bd8463-0913-4ca1-bd84-6309134ca1f6/queries/core/search?schema=https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5&limit=2",
"@type": "https://ns.adobe.com/experience/xcore/hal/results"
},
"next": {
"href": "/e0bd8463-0913-4ca1-bd84-6309134ca1f6/queries/core/search?start=4e0206d0-0e6a-11eb-884a-c1a1104e3d7d&orderby=instanceId&schema=https://ns.adobe.com/experience/offer-management/offer-activity;version=0.5&limit=2",
"@type": "https://ns.adobe.com/experience/xcore/hal/results"
}
}
}