@aws-sdk/client-personalize-events 3.379.1 → 3.385.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.
@@ -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;
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.379.1",
4
+ "version": "3.385.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.379.1",
25
- "@aws-sdk/credential-provider-node": "3.379.1",
24
+ "@aws-sdk/client-sts": "3.385.0",
25
+ "@aws-sdk/credential-provider-node": "3.385.0",
26
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
29
  "@aws-sdk/middleware-signing": "3.379.1",
30
- "@aws-sdk/middleware-user-agent": "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.378.0",
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",