Ein Fallback-Angebot wird an Kunden gesendet, wenn keine anderen Angebote für sie geeignet sind. Die Schritte zum Einrichten eines Fallback-Angebots bestehen darin, eine oder mehrere Darstellungen zu erstellen (ähnlich wie beim Erstellen eines Angebots).
Durch Ausführung einer einzelnen GET-Anfrage an die Offer Library-API können Sie eine Liste aller Fallback-Angebote anzeigen.
API-Format
GET /{ENDPOINT_PATH}/offers?offer-type=fallback&{QUERY_PARAMS}
Parameter | Beschreibung | Beispiel |
---|---|---|
{ENDPOINT_PATH} |
Der Endpunktpfad für persistente APIs. | https://platform.adobe.io/data/core/dps |
{QUERY_PARAMS} |
Optionale Abfrageparameter zum Filtern der Ergebnisse. | limit=2 |
Anfrage
curl -X GET 'https://platform.adobe.io/data/core/dps/offers?offer-type=fallback&limit=2' \
-H 'Accept: *,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}'
Beim Auflisten von Ressourcen können Sie Abfrageparameter nutzen, um Ergebnisse zu sortieren und zu filtern.
Zu den häufigsten Abfrageparametern für das Paging gehören:
Parameter | Beschreibung | Beispiel |
---|---|---|
property |
Ein optionaler Eigenschaftenfilter:
|
property=name!=abc&property=id~.*1234.*&property=description equivalent with property=name!=abc,id~.*1234.*,description. |
orderBy |
Sortieren Sie die Ergebnisse nach einer bestimmten Eigenschaft. Durch Hinzufügen eines „-“ vor dem Namen (orderby=-name) werden Elemente nach Namen in absteigender Reihenfolge sortiert (Z–A). Pfadausdrücke haben die Form von durch Punkte getrennten Pfaden. Dieser Parameter kann wie folgt wiederholt werden: orderby=field1[,-fields2,field3,...] |
orderby=id ,-name |
limit |
Begrenzt die Anzahl der zurückgegebenen Entitäten. | limit=5 |
Antwort
Bei einer erfolgreichen Antwort wird eine Liste von Fallback-Angeboten zurückgegeben, auf die zugegriffen werden kann.
{
"results": [
{
"created": "2023-06-08T14:04:41.011+00:00",
"modified": "2023-06-08T14:04:41.011+00:00",
"etag": 1,
"schemas": [
"https://ns.adobe.com/experience/offer-management/fallback-offer;version=0.8"
],
"createdBy": "{CREATED_BY}",
"lastModifiedBy": "{MODIFIED_BY}",
"id": "fallbackOffer1234",
"name": "Fallback Offer Web",
"description": "Fallback Offer Web Description",
"status": "draft",
"representations": [
{
"channel": "https://ns.adobe.com/xdm/channel-types/web",
"placement": "offerPlacement5678",
"components": [
{
"type": "imagelink",
"format": "image/png",
"deliveryURL": "https://mysite.com"
}
]
}
]
},
{
"created": "2022-10-07T11:23:55.885+00:00",
"modified": "2022-10-07T11:23:55.885+00:00",
"etag": 1,
"schemas": [
"https://ns.adobe.com/experience/offer-management/fallback-offer;version=0.7"
],
"createdBy": "{CREATED_BY}",
"lastModifiedBy": "{MODIFIED_BY}",
"id": "fallbackOffer5678",
"name": "Fallback Offer email",
"status": "approved",
"representations": [
{
"channel": "https://ns.adobe.com/xdm/channel-types/email",
"placement": "offerPlacement1234",
"components": [
{
"type": "component-text",
"format": "text/template",
"content": "Get free shipping!"
}
]
}
],
"labels": [
"core/C1"
]
}
],
"count": 2,
"total": 3,
"_links": {
"self": {
"href": "/offers?offer-type=fallback&href={SELF_HREF}&limit=2",
"type": "application/json"
},
"next": {
"href": "/offers?offer-type=fallback&href={NEXT_HREF}&limit=2",
"type": "application/json"
}
}
}