決定項目のリスト list-decision-items
Journey Optimizer では、決定項目と呼ばれるマーケティングオファーを作成し、一元化されたカタログとコレクションを作成して整理できます。これらは、ニーズに正確に合わせて設計された標準属性とカスタム属性で構成されています。さらに、決定項目を表示可能なユーザーを定義できる、プロファイル制約が組み込まれています。
オファーライブラリ API に対して単一の GET リクエストを実行することで、すべての決定項目のリストを表示できます。
API 形式
GET /{ENDPOINT_PATH}/offer-items?{QUERY_PARAMS}
パラメーター
説明
例
{ENDPOINT_PATH}永続性 API のエンドポイントパス。
https://platform.adobe.io/data/core/dps{QUERY_PARAMS}結果をフィルタリングする条件となるクエリパラメーター(オプション)。
limit=2クエリパラメーターの使用 using-query-parameters
リソースを一覧表示する際に、クエリパラメーターを使用して結果をページングおよびフィルタリングできます。
ページング paging
ページングに最も一般的なクエリパラメーターは次のとおりです。
パラメーター
説明
例
propertyオプションのプロパティフィルターは次のとおりです。
- プロパティは AND 演算でグループ化されます。
- パラメーターは、property={PROPERTY_EXPR}[&property={PROPERTY_EXPR2}…] または property={PROPERTY_EXPR1}[,{PROPERTY_EXPR2}…] のように繰り返すことができます。
- プロパティ式は
[!]field[op]valueの形式を使用([==,!=,<=,>=,<,>,~]にop)し、正規表現をサポートします。
property=name!=abc&property=id~.*1234.*&property=description equivalent with property=name!=abc,id~.*1234.*,description.orderBy特定のプロパティで結果を並べ替えます。名前の前に - を追加すると(orderby=-name)、名前の降順(Z ~ A)で項目が並べ替えられます。パス式は、ドット区切りのパスの形式です。このパラメーターは、
orderby=field1[,-fields2,field3,...] のように繰り返すことができます。orderby=id、-namelimit返されるエンティティの数を制限します。
limit=5リクエスト
curl -X GET '<https://platform.adobe.io/data/core/dps/offer-items?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}' \
-H 'x-schema-id: {SCHEMA_ID}'
応答
応答が成功すると、自身がアクセス権を持っているオファー項目のリストが返されます。_<imsOrg> ノードには、カスタムの決定項目属性が格納されています。
{
"results": [
{
"created": "2024-06-10T16:00:34.014Z",
"modified": "2024-07-09T22:59:21.507Z",
"etag": 1,
"createdBy": "{CREATED_BY}",
"lastModifiedBy": "{MODIFIED_BY}",
"id": "offerItem5678",
"_experience": {
"decisioning": {
"offeritem": {
"fCapConstraintsLastIndex": 0,
"lifecycleStatus": "draft"
},
"decisionitem": {
"itemCalendarConstraints": {
"endDate": "2030-12-31T08:00:00.000Z",
"startDate": "2024-06-10T04:00:00.000Z"
},
"itemCatalogID": "itemCatalong1234",
"itemConstraints": {
"eligibilityRule": "rule1234",
"profileConstraintType": "eligibilityRule"
},
"itemDescription": "Offer item description",
"itemID": "offerItem5678",
"itemLabels": [],
"itemName": "Offer Item One",
"itemPriority": 1,
"itemTags": []
}
}
},
"_<imsOrg>": {
"some_field": "some value"
}
},
{
"created": "2024-06-04T17:51:52.849Z",
"modified": "2024-06-28T18:29:27.951Z",
"etag": 5,
"createdBy": "{CREATED_BY}",
"lastModifiedBy": "{MODIFIED_BY}",
"id": "offerItem1234",
"_experience": {
"decisioning": {
"offeritem": {
"frequencyCappingConstraints": [],
"fCapConstraintsLastIndex": 0,
"lifecycleStatus": "approved"
},
"decisionitem": {
"itemCalendarConstraints": {
"endDate": "2030-12-31T08:00:00.000Z",
"startDate": "2024-06-01T07:00:00.000Z"
},
"itemCatalogID": "itemCatalong1234",
"itemConstraints": {
"profileConstraintType": "none"
},
"itemDescription": "Offer item description",
"itemID": "offerItem1234",
"itemLabels": [],
"itemName": "Offer Item Two",
"itemPriority": 2,
"itemTags": []
}
}
},
"YOUR_CUSTOM_ATTRIBUTES": {
"some_field": "some value",
"some_boolean_field": true
}
}
],
"count": 2,
"total": 844,
"_links": {
"self": {
"href": "/offer-items?orderby=-modified&limit=2",
"type": "application/json"
},
"next": {
"href": "/offer-items?orderby=-modified&limit=2&start=2024-06-28T03:44:15.630Z",
"type": "application/json"
}
}
}
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76