@aws-sdk/client-personalize-events 3.378.0 → 3.382.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,4 +1,7 @@
|
|
|
1
1
|
import { Endpoint, EndpointParameters as __EndpointParameters, EndpointV2, Provider } from "@smithy/types";
|
|
2
|
+
/**
|
|
3
|
+
* @public
|
|
4
|
+
*/
|
|
2
5
|
export interface ClientInputEndpointParameters {
|
|
3
6
|
region?: string | Provider<string>;
|
|
4
7
|
useDualstackEndpoint?: boolean | Provider<boolean>;
|
package/dist-types/index.d.ts
CHANGED
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
*/
|
|
8
8
|
export * from "./PersonalizeEventsClient";
|
|
9
9
|
export * from "./PersonalizeEvents";
|
|
10
|
+
export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
|
|
10
11
|
export * from "./commands";
|
|
11
12
|
export * from "./models";
|
|
12
13
|
export { PersonalizeEventsServiceException } from "./models/PersonalizeEventsServiceException";
|
|
@@ -18,6 +18,7 @@ export declare class InvalidInputException extends __BaseException {
|
|
|
18
18
|
*/
|
|
19
19
|
export interface MetricAttribution {
|
|
20
20
|
/**
|
|
21
|
+
* @public
|
|
21
22
|
* <p>The source of the event, such as a third party.</p>
|
|
22
23
|
*/
|
|
23
24
|
eventAttributionSource: string | undefined;
|
|
@@ -29,6 +30,7 @@ export interface MetricAttribution {
|
|
|
29
30
|
*/
|
|
30
31
|
export interface Event {
|
|
31
32
|
/**
|
|
33
|
+
* @public
|
|
32
34
|
* <p>An ID associated with the event. If an event ID is not provided, Amazon Personalize generates
|
|
33
35
|
* a unique ID for the event. An event ID is not used as an input to the model. Amazon Personalize uses
|
|
34
36
|
* the event ID to distinquish unique events. Any subsequent events after the first with the
|
|
@@ -36,19 +38,23 @@ export interface Event {
|
|
|
36
38
|
*/
|
|
37
39
|
eventId?: string;
|
|
38
40
|
/**
|
|
41
|
+
* @public
|
|
39
42
|
* <p>The type of event, such as click or download. This property corresponds to the <code>EVENT_TYPE</code>
|
|
40
43
|
* field of your Interactions schema and depends on the types of events you are tracking.</p>
|
|
41
44
|
*/
|
|
42
45
|
eventType: string | undefined;
|
|
43
46
|
/**
|
|
47
|
+
* @public
|
|
44
48
|
* <p>The event value that corresponds to the <code>EVENT_VALUE</code> field of the Interactions schema.</p>
|
|
45
49
|
*/
|
|
46
50
|
eventValue?: number;
|
|
47
51
|
/**
|
|
52
|
+
* @public
|
|
48
53
|
* <p>The item ID key that corresponds to the <code>ITEM_ID</code> field of the Interactions schema.</p>
|
|
49
54
|
*/
|
|
50
55
|
itemId?: string;
|
|
51
56
|
/**
|
|
57
|
+
* @public
|
|
52
58
|
* <p>A string map of event-specific data that you might choose to record. For example, if a
|
|
53
59
|
* user rates a movie on your site, other than movie ID (<code>itemId</code>) and rating (<code>eventValue</code>)
|
|
54
60
|
* , you might also send the number of movie ratings made by the user.</p>
|
|
@@ -63,10 +69,12 @@ export interface Event {
|
|
|
63
69
|
*/
|
|
64
70
|
properties?: __LazyJsonString | string;
|
|
65
71
|
/**
|
|
72
|
+
* @public
|
|
66
73
|
* <p>The timestamp (in Unix time) on the client side when the event occurred.</p>
|
|
67
74
|
*/
|
|
68
75
|
sentAt: Date | undefined;
|
|
69
76
|
/**
|
|
77
|
+
* @public
|
|
70
78
|
* <p>The ID of the list of recommendations that contains the item the user interacted with. Provide a <code>recommendationId</code> to have Amazon Personalize implicitly record the
|
|
71
79
|
* recommendations you show your user as impressions data. Or provide a <code>recommendationId</code> if you use a metric attribution to measure the impact of recommendations.
|
|
72
80
|
* </p>
|
|
@@ -77,12 +85,14 @@ export interface Event {
|
|
|
77
85
|
*/
|
|
78
86
|
recommendationId?: string;
|
|
79
87
|
/**
|
|
88
|
+
* @public
|
|
80
89
|
* <p>A list of item IDs that represents the sequence of items you have shown the user. For example, <code>["itemId1", "itemId2", "itemId3"]</code>. Provide a list of
|
|
81
90
|
* items to manually record impressions data for an event. For more information on recording impressions data,
|
|
82
91
|
* see <a href="https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data">Recording impressions data</a>. </p>
|
|
83
92
|
*/
|
|
84
93
|
impression?: string[];
|
|
85
94
|
/**
|
|
95
|
+
* @public
|
|
86
96
|
* <p>Contains information about the metric attribution associated with an event. For more information about metric attributions, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html">Measuring impact of recommendations</a>.</p>
|
|
87
97
|
*/
|
|
88
98
|
metricAttribution?: MetricAttribution;
|
|
@@ -92,22 +102,26 @@ export interface Event {
|
|
|
92
102
|
*/
|
|
93
103
|
export interface PutEventsRequest {
|
|
94
104
|
/**
|
|
105
|
+
* @public
|
|
95
106
|
* <p>The tracking ID for the event.
|
|
96
107
|
* The ID is generated by a call to the
|
|
97
108
|
* <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html">CreateEventTracker</a> API.</p>
|
|
98
109
|
*/
|
|
99
110
|
trackingId: string | undefined;
|
|
100
111
|
/**
|
|
112
|
+
* @public
|
|
101
113
|
* <p>The user associated with the event.</p>
|
|
102
114
|
*/
|
|
103
115
|
userId?: string;
|
|
104
116
|
/**
|
|
117
|
+
* @public
|
|
105
118
|
* <p>The session ID associated with the user's visit. Your application generates the sessionId when a user first visits your website or uses your application.
|
|
106
119
|
* Amazon Personalize uses the sessionId to associate events with the user before they log in. For more information, see
|
|
107
120
|
* <a href="https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html">Recording Events</a>.</p>
|
|
108
121
|
*/
|
|
109
122
|
sessionId: string | undefined;
|
|
110
123
|
/**
|
|
124
|
+
* @public
|
|
111
125
|
* <p>A list of event data from the session.</p>
|
|
112
126
|
*/
|
|
113
127
|
eventList: Event[] | undefined;
|
|
@@ -121,10 +135,12 @@ export interface PutEventsRequest {
|
|
|
121
135
|
*/
|
|
122
136
|
export interface Item {
|
|
123
137
|
/**
|
|
138
|
+
* @public
|
|
124
139
|
* <p>The ID associated with the item.</p>
|
|
125
140
|
*/
|
|
126
141
|
itemId: string | undefined;
|
|
127
142
|
/**
|
|
143
|
+
* @public
|
|
128
144
|
* <p>A string map of item-specific metadata. Each element in the map consists of a key-value pair.
|
|
129
145
|
* For example, <code>\{"numberOfRatings": "12"\}</code>.</p>
|
|
130
146
|
* <p>The keys use camel case names that match the fields in the schema for the Items
|
|
@@ -139,10 +155,12 @@ export interface Item {
|
|
|
139
155
|
*/
|
|
140
156
|
export interface PutItemsRequest {
|
|
141
157
|
/**
|
|
158
|
+
* @public
|
|
142
159
|
* <p>The Amazon Resource Name (ARN) of the Items dataset you are adding the item or items to.</p>
|
|
143
160
|
*/
|
|
144
161
|
datasetArn: string | undefined;
|
|
145
162
|
/**
|
|
163
|
+
* @public
|
|
146
164
|
* <p>A list of item data.</p>
|
|
147
165
|
*/
|
|
148
166
|
items: Item[] | undefined;
|
|
@@ -179,10 +197,12 @@ export declare class ResourceNotFoundException extends __BaseException {
|
|
|
179
197
|
*/
|
|
180
198
|
export interface User {
|
|
181
199
|
/**
|
|
200
|
+
* @public
|
|
182
201
|
* <p>The ID associated with the user.</p>
|
|
183
202
|
*/
|
|
184
203
|
userId: string | undefined;
|
|
185
204
|
/**
|
|
205
|
+
* @public
|
|
186
206
|
* <p>A string map of user-specific metadata. Each element in the map consists of a key-value pair.
|
|
187
207
|
* For example, <code>\{"numberOfVideosWatched": "45"\}</code>.</p>
|
|
188
208
|
* <p>The keys use camel case names that match the fields in the schema for the Users
|
|
@@ -198,10 +218,12 @@ export interface User {
|
|
|
198
218
|
*/
|
|
199
219
|
export interface PutUsersRequest {
|
|
200
220
|
/**
|
|
221
|
+
* @public
|
|
201
222
|
* <p>The Amazon Resource Name (ARN) of the Users dataset you are adding the user or users to.</p>
|
|
202
223
|
*/
|
|
203
224
|
datasetArn: string | undefined;
|
|
204
225
|
/**
|
|
226
|
+
* @public
|
|
205
227
|
* <p>A list of user data.</p>
|
|
206
228
|
*/
|
|
207
229
|
users: User[] | undefined;
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export * from "./PersonalizeEventsClient";
|
|
2
2
|
export * from "./PersonalizeEvents";
|
|
3
|
+
export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
|
|
3
4
|
export * from "./commands";
|
|
4
5
|
export * from "./models";
|
|
5
6
|
export { PersonalizeEventsServiceException } from "./models/PersonalizeEventsServiceException";
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aws-sdk/client-personalize-events",
|
|
3
3
|
"description": "AWS SDK for JavaScript Personalize Events Client for Node.js, Browser and React Native",
|
|
4
|
-
"version": "3.
|
|
4
|
+
"version": "3.382.0",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
|
|
7
7
|
"build:cjs": "tsc -p tsconfig.cjs.json",
|
|
@@ -21,15 +21,15 @@
|
|
|
21
21
|
"dependencies": {
|
|
22
22
|
"@aws-crypto/sha256-browser": "3.0.0",
|
|
23
23
|
"@aws-crypto/sha256-js": "3.0.0",
|
|
24
|
-
"@aws-sdk/client-sts": "3.
|
|
25
|
-
"@aws-sdk/credential-provider-node": "3.
|
|
26
|
-
"@aws-sdk/middleware-host-header": "3.
|
|
24
|
+
"@aws-sdk/client-sts": "3.382.0",
|
|
25
|
+
"@aws-sdk/credential-provider-node": "3.382.0",
|
|
26
|
+
"@aws-sdk/middleware-host-header": "3.379.1",
|
|
27
27
|
"@aws-sdk/middleware-logger": "3.378.0",
|
|
28
28
|
"@aws-sdk/middleware-recursion-detection": "3.378.0",
|
|
29
|
-
"@aws-sdk/middleware-signing": "3.
|
|
30
|
-
"@aws-sdk/middleware-user-agent": "3.
|
|
29
|
+
"@aws-sdk/middleware-signing": "3.379.1",
|
|
30
|
+
"@aws-sdk/middleware-user-agent": "3.382.0",
|
|
31
31
|
"@aws-sdk/types": "3.378.0",
|
|
32
|
-
"@aws-sdk/util-endpoints": "3.
|
|
32
|
+
"@aws-sdk/util-endpoints": "3.382.0",
|
|
33
33
|
"@aws-sdk/util-user-agent-browser": "3.378.0",
|
|
34
34
|
"@aws-sdk/util-user-agent-node": "3.378.0",
|
|
35
35
|
"@smithy/config-resolver": "^2.0.1",
|