datadog_api_client 2.58.0 → 2.59.1

data/examples/v2/product-analytics/QueryProductAnalyticsJourneyScalar.rb

@@ -0,0 +1,95 @@
+# Compute journey scalar analytics returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.query_product_analytics_journey_scalar".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::ProductAnalyticsAPI.new
+
+body = DatadogAPIClient::V2::ProductAnalyticsJourneyScalarRequest.new({
+  data: DatadogAPIClient::V2::ProductAnalyticsJourneyScalarRequestData.new({
+    attributes: DatadogAPIClient::V2::ProductAnalyticsJourneyScalarRequestAttributes.new({
+      from: 1756425600000,
+      query: DatadogAPIClient::V2::ProductAnalyticsJourneyScalarQuery.new({
+        compute: DatadogAPIClient::V2::ProductAnalyticsJourneyScalarCompute.new({
+          aggregation: "count",
+          target: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTarget.new({
+            type: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTargetType::NODE,
+            value: "A",
+          }),
+        }),
+        group_by: [
+          DatadogAPIClient::V2::ProductAnalyticsGraphQueryGroupBy.new({
+            facet: "@geo.country",
+            should_exclude_missing: false,
+            sort: DatadogAPIClient::V2::ProductAnalyticsGroupBySort.new({
+              aggregation: "count",
+              order: DatadogAPIClient::V2::QuerySortOrder::DESC,
+            }),
+            source: DatadogAPIClient::V2::ProductAnalyticsGraphQueryGroupBySource::USERS,
+            target: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTarget.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTargetType::NODE,
+              value: "A",
+            }),
+            value_filters: [],
+          }),
+        ],
+        search: DatadogAPIClient::V2::ProductAnalyticsJourneySearch.new({
+          expression: "A -> B",
+          filters: DatadogAPIClient::V2::ProductAnalyticsJourneySearchFilters.new({
+            audience_filters: DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceFilters.new({
+              accounts: [
+                DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceAccountQuery.new({
+                  name: "enterprise_accounts",
+                }),
+              ],
+              formula: "power_users AND NOT trial_segment",
+              segments: [
+                DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceSegmentQuery.new({
+                  name: "trial_segment",
+                  segment_id: "00000000-0000-0000-0000-000000000000",
+                }),
+              ],
+              users: [
+                DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceUserQuery.new({
+                  name: "power_users",
+                }),
+              ],
+            }),
+            graph_filters: [
+              DatadogAPIClient::V2::ProductAnalyticsJourneySearchGraphFilter.new({
+                name: DatadogAPIClient::V2::ProductAnalyticsJourneySearchGraphFilterName::TIME_TO_CONVERT,
+                operator: DatadogAPIClient::V2::ProductAnalyticsJourneySearchGraphFilterOperator::LESS_THAN_OR_EQUAL,
+                target: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTarget.new({
+                  type: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTargetType::NODE,
+                  value: "A",
+                }),
+                value: 60000,
+              }),
+            ],
+          }),
+          join_keys: DatadogAPIClient::V2::ProductAnalyticsJoinKeys.new({
+            primary: "@session.id",
+            secondary: [],
+          }),
+          node_objects: {
+            A: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view @view.name:Login",
+              }),
+            }), B: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:action @action.target.name:Submit",
+              }),
+            }),
+          },
+        }),
+      }),
+      to: 1756857600000,
+    }),
+    type: DatadogAPIClient::V2::ProductAnalyticsFormulaJourneyRequestType::FORMULA_JOURNEY_REQUEST,
+  }),
+})
+p api_instance.query_product_analytics_journey_scalar(body)

data/examples/v2/product-analytics/QueryProductAnalyticsJourneyTimeseries.rb

@@ -0,0 +1,95 @@
+# Compute journey timeseries analytics returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.query_product_analytics_journey_timeseries".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::ProductAnalyticsAPI.new
+
+body = DatadogAPIClient::V2::ProductAnalyticsFormulaJourneyRequest.new({
+  data: DatadogAPIClient::V2::ProductAnalyticsFormulaJourneyRequestData.new({
+    attributes: DatadogAPIClient::V2::ProductAnalyticsFormulaJourneyRequestAttributes.new({
+      from: 1756425600000,
+      query: DatadogAPIClient::V2::ProductAnalyticsFormulaJourneyQuery.new({
+        compute: DatadogAPIClient::V2::ProductAnalyticsGraphQueryCompute.new({
+          aggregation: "count",
+          target: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTarget.new({
+            type: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTargetType::NODE,
+            value: "A",
+          }),
+        }),
+        group_by: [
+          DatadogAPIClient::V2::ProductAnalyticsGraphQueryGroupBy.new({
+            facet: "@geo.country",
+            should_exclude_missing: false,
+            sort: DatadogAPIClient::V2::ProductAnalyticsGroupBySort.new({
+              aggregation: "count",
+              order: DatadogAPIClient::V2::QuerySortOrder::DESC,
+            }),
+            source: DatadogAPIClient::V2::ProductAnalyticsGraphQueryGroupBySource::USERS,
+            target: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTarget.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTargetType::NODE,
+              value: "A",
+            }),
+            value_filters: [],
+          }),
+        ],
+        search: DatadogAPIClient::V2::ProductAnalyticsJourneySearch.new({
+          expression: "A -> B",
+          filters: DatadogAPIClient::V2::ProductAnalyticsJourneySearchFilters.new({
+            audience_filters: DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceFilters.new({
+              accounts: [
+                DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceAccountQuery.new({
+                  name: "enterprise_accounts",
+                }),
+              ],
+              formula: "power_users AND NOT trial_segment",
+              segments: [
+                DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceSegmentQuery.new({
+                  name: "trial_segment",
+                  segment_id: "00000000-0000-0000-0000-000000000000",
+                }),
+              ],
+              users: [
+                DatadogAPIClient::V2::ProductAnalyticsJourneyAudienceUserQuery.new({
+                  name: "power_users",
+                }),
+              ],
+            }),
+            graph_filters: [
+              DatadogAPIClient::V2::ProductAnalyticsJourneySearchGraphFilter.new({
+                name: DatadogAPIClient::V2::ProductAnalyticsJourneySearchGraphFilterName::TIME_TO_CONVERT,
+                operator: DatadogAPIClient::V2::ProductAnalyticsJourneySearchGraphFilterOperator::LESS_THAN_OR_EQUAL,
+                target: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTarget.new({
+                  type: DatadogAPIClient::V2::ProductAnalyticsJourneyNodeTargetType::NODE,
+                  value: "A",
+                }),
+                value: 60000,
+              }),
+            ],
+          }),
+          join_keys: DatadogAPIClient::V2::ProductAnalyticsJoinKeys.new({
+            primary: "@session.id",
+            secondary: [],
+          }),
+          node_objects: {
+            A: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view @view.name:Login",
+              }),
+            }), B: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:action @action.target.name:Submit",
+              }),
+            }),
+          },
+        }),
+      }),
+      to: 1756857600000,
+    }),
+    type: DatadogAPIClient::V2::ProductAnalyticsFormulaJourneyRequestType::FORMULA_JOURNEY_REQUEST,
+  }),
+})
+p api_instance.query_product_analytics_journey_timeseries(body)

data/examples/v2/product-analytics/QueryProductAnalyticsList.rb

@@ -0,0 +1,30 @@
+# List analytics events returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.query_product_analytics_list".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::ProductAnalyticsAPI.new
+
+body = DatadogAPIClient::V2::ProductAnalyticsAnalyticsListRequest.new({
+  data: DatadogAPIClient::V2::ProductAnalyticsAnalyticsListRequestData.new({
+    attributes: DatadogAPIClient::V2::ProductAnalyticsAnalyticsListRequestAttributes.new({
+      from: 1771232048460,
+      query: DatadogAPIClient::V2::ProductAnalyticsAnalyticsListQuery.new({
+        columns: [
+          "@view.name",
+        ],
+        limit: 100,
+        query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+          data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+          search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+            query: "@type:view",
+          }),
+        }),
+      }),
+      to: 1771836848262,
+    }),
+    type: DatadogAPIClient::V2::ProductAnalyticsAnalyticsListRequestType::FORMULA_ANALYTICS_EXTENDED_LIST_REQUEST,
+  }),
+})
+p api_instance.query_product_analytics_list(body)

data/examples/v2/product-analytics/QueryProductAnalyticsRetentionGrid.rb

@@ -0,0 +1,104 @@
+# Compute a retention grid returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.query_product_analytics_retention_grid".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::ProductAnalyticsAPI.new
+
+body = DatadogAPIClient::V2::ProductAnalyticsRetentionGridRequest.new({
+  data: DatadogAPIClient::V2::ProductAnalyticsRetentionGridRequestData.new({
+    attributes: DatadogAPIClient::V2::ProductAnalyticsRetentionGridRequestAttributes.new({
+      exclude_anonymous_traffic: false,
+      from: 1756425600000,
+      query: DatadogAPIClient::V2::ProductAnalyticsRetentionGridQuery.new({
+        computation_scope: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortScope.new({
+          target: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTarget.new({
+            type: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTargetType::INDEX,
+            value: 0,
+          }),
+          type: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortScopeType::COHORT,
+        }),
+        compute: DatadogAPIClient::V2::ProductAnalyticsRetentionCompute.new({
+          aggregation: "count",
+          metric: DatadogAPIClient::V2::ProductAnalyticsRetentionComputeMetric::RETENTION_RATE,
+        }),
+        group_by: [
+          DatadogAPIClient::V2::ProductAnalyticsRetentionGroupBy.new({
+            facet: "@geo.country",
+            limit: 10,
+            should_exclude_missing: false,
+            sort: DatadogAPIClient::V2::ProductAnalyticsGroupBySort.new({
+              aggregation: "count",
+              order: DatadogAPIClient::V2::QuerySortOrder::DESC,
+            }),
+            target: DatadogAPIClient::V2::ProductAnalyticsRetentionGroupByTarget::COHORT,
+          }),
+        ],
+        search: DatadogAPIClient::V2::ProductAnalyticsRetentionSearch.new({
+          cohort_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+          filters: DatadogAPIClient::V2::ProductAnalyticsRetentionFilters.new({
+            audience_filters: DatadogAPIClient::V2::ProductAnalyticsAudienceFilters.new({
+              accounts: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceAccountSubquery.new({
+                  name: "",
+                }),
+              ],
+              formula: "u",
+              segments: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceSegmentSubquery.new({
+                  name: "",
+                  segment_id: "00000000-0000-0000-0000-000000000000",
+                }),
+              ],
+              users: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceUserSubquery.new({
+                  name: "u",
+                  query: "*",
+                }),
+              ],
+            }),
+          }),
+          retention_entity: DatadogAPIClient::V2::ProductAnalyticsRetentionEntity::USER_ID,
+          return_condition: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCondition::CONVERSION_ON_OR_AFTER,
+          return_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+        }),
+      }),
+      to: 1756857600000,
+    }),
+    type: DatadogAPIClient::V2::ProductAnalyticsRetentionGridRequestType::RETENTION_GRID_REQUEST,
+  }),
+})
+p api_instance.query_product_analytics_retention_grid(body)

data/examples/v2/product-analytics/QueryProductAnalyticsRetentionList.rb

@@ -0,0 +1,99 @@
+# List the entities behind a retention cell returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.query_product_analytics_retention_list".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::ProductAnalyticsAPI.new
+
+body = DatadogAPIClient::V2::ProductAnalyticsRetentionListRequest.new({
+  data: DatadogAPIClient::V2::ProductAnalyticsRetentionListRequestData.new({
+    attributes: DatadogAPIClient::V2::ProductAnalyticsRetentionListRequestAttributes.new({
+      from: 1756425600000,
+      query: DatadogAPIClient::V2::ProductAnalyticsRetentionListQuery.new({
+        columns: [
+          DatadogAPIClient::V2::ProductAnalyticsRetentionListColumn.new({
+            field: DatadogAPIClient::V2::ProductAnalyticsRetentionListColumnField.new({
+              path: "@usr.email",
+            }),
+          }),
+        ],
+        computation_scope: DatadogAPIClient::V2::ProductAnalyticsRetentionCellScope.new({
+          cohort_target: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTarget.new({
+            type: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTargetType::INDEX,
+            value: 0,
+          }),
+          return_period_target: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTarget.new({
+            type: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTargetType::INDEX,
+            value: 0,
+          }),
+          type: DatadogAPIClient::V2::ProductAnalyticsRetentionCellScopeType::CELL,
+        }),
+        limit: 100,
+        search: DatadogAPIClient::V2::ProductAnalyticsRetentionSearch.new({
+          cohort_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+          filters: DatadogAPIClient::V2::ProductAnalyticsRetentionFilters.new({
+            audience_filters: DatadogAPIClient::V2::ProductAnalyticsAudienceFilters.new({
+              accounts: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceAccountSubquery.new({
+                  name: "",
+                }),
+              ],
+              formula: "u",
+              segments: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceSegmentSubquery.new({
+                  name: "",
+                  segment_id: "00000000-0000-0000-0000-000000000000",
+                }),
+              ],
+              users: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceUserSubquery.new({
+                  name: "u",
+                  query: "*",
+                }),
+              ],
+            }),
+          }),
+          retention_entity: DatadogAPIClient::V2::ProductAnalyticsRetentionEntity::USER_ID,
+          return_condition: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCondition::CONVERSION_ON_OR_AFTER,
+          return_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+        }),
+      }),
+      to: 1756857600000,
+    }),
+    type: DatadogAPIClient::V2::ProductAnalyticsRetentionListRequestType::RETENTION_LIST_REQUEST,
+  }),
+})
+p api_instance.query_product_analytics_retention_list(body)

data/examples/v2/product-analytics/QueryProductAnalyticsRetentionScalar.rb

@@ -0,0 +1,104 @@
+# Compute retention scalar values returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.query_product_analytics_retention_scalar".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::ProductAnalyticsAPI.new
+
+body = DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequest.new({
+  data: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequestData.new({
+    attributes: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequestAttributes.new({
+      exclude_anonymous_traffic: false,
+      from: 1756425600000,
+      query: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionQuery.new({
+        computation_scope: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortScope.new({
+          target: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTarget.new({
+            type: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTargetType::INDEX,
+            value: 0,
+          }),
+          type: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortScopeType::COHORT,
+        }),
+        compute: DatadogAPIClient::V2::ProductAnalyticsRetentionCompute.new({
+          aggregation: "count",
+          metric: DatadogAPIClient::V2::ProductAnalyticsRetentionComputeMetric::RETENTION_RATE,
+        }),
+        group_by: [
+          DatadogAPIClient::V2::ProductAnalyticsRetentionGroupBy.new({
+            facet: "@geo.country",
+            limit: 10,
+            should_exclude_missing: false,
+            sort: DatadogAPIClient::V2::ProductAnalyticsGroupBySort.new({
+              aggregation: "count",
+              order: DatadogAPIClient::V2::QuerySortOrder::DESC,
+            }),
+            target: DatadogAPIClient::V2::ProductAnalyticsRetentionGroupByTarget::COHORT,
+          }),
+        ],
+        search: DatadogAPIClient::V2::ProductAnalyticsRetentionSearch.new({
+          cohort_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+          filters: DatadogAPIClient::V2::ProductAnalyticsRetentionFilters.new({
+            audience_filters: DatadogAPIClient::V2::ProductAnalyticsAudienceFilters.new({
+              accounts: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceAccountSubquery.new({
+                  name: "",
+                }),
+              ],
+              formula: "u",
+              segments: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceSegmentSubquery.new({
+                  name: "",
+                  segment_id: "00000000-0000-0000-0000-000000000000",
+                }),
+              ],
+              users: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceUserSubquery.new({
+                  name: "u",
+                  query: "*",
+                }),
+              ],
+            }),
+          }),
+          retention_entity: DatadogAPIClient::V2::ProductAnalyticsRetentionEntity::USER_ID,
+          return_condition: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCondition::CONVERSION_ON_OR_AFTER,
+          return_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+        }),
+      }),
+      to: 1756857600000,
+    }),
+    type: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequestType::FORMULA_RETENTION_REQUEST,
+  }),
+})
+p api_instance.query_product_analytics_retention_scalar(body)

data/examples/v2/product-analytics/QueryProductAnalyticsRetentionTimeseries.rb

@@ -0,0 +1,104 @@
+# Compute retention timeseries returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.query_product_analytics_retention_timeseries".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::ProductAnalyticsAPI.new
+
+body = DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequest.new({
+  data: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequestData.new({
+    attributes: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequestAttributes.new({
+      exclude_anonymous_traffic: false,
+      from: 1756425600000,
+      query: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionQuery.new({
+        computation_scope: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortScope.new({
+          target: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTarget.new({
+            type: DatadogAPIClient::V2::ProductAnalyticsRetentionIndexTargetType::INDEX,
+            value: 0,
+          }),
+          type: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortScopeType::COHORT,
+        }),
+        compute: DatadogAPIClient::V2::ProductAnalyticsRetentionCompute.new({
+          aggregation: "count",
+          metric: DatadogAPIClient::V2::ProductAnalyticsRetentionComputeMetric::RETENTION_RATE,
+        }),
+        group_by: [
+          DatadogAPIClient::V2::ProductAnalyticsRetentionGroupBy.new({
+            facet: "@geo.country",
+            limit: 10,
+            should_exclude_missing: false,
+            sort: DatadogAPIClient::V2::ProductAnalyticsGroupBySort.new({
+              aggregation: "count",
+              order: DatadogAPIClient::V2::QuerySortOrder::DESC,
+            }),
+            target: DatadogAPIClient::V2::ProductAnalyticsRetentionGroupByTarget::COHORT,
+          }),
+        ],
+        search: DatadogAPIClient::V2::ProductAnalyticsRetentionSearch.new({
+          cohort_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionCohortCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+          filters: DatadogAPIClient::V2::ProductAnalyticsRetentionFilters.new({
+            audience_filters: DatadogAPIClient::V2::ProductAnalyticsAudienceFilters.new({
+              accounts: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceAccountSubquery.new({
+                  name: "",
+                }),
+              ],
+              formula: "u",
+              segments: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceSegmentSubquery.new({
+                  name: "",
+                  segment_id: "00000000-0000-0000-0000-000000000000",
+                }),
+              ],
+              users: [
+                DatadogAPIClient::V2::ProductAnalyticsAudienceUserSubquery.new({
+                  name: "u",
+                  query: "*",
+                }),
+              ],
+            }),
+          }),
+          retention_entity: DatadogAPIClient::V2::ProductAnalyticsRetentionEntity::USER_ID,
+          return_condition: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCondition::CONVERSION_ON_OR_AFTER,
+          return_criteria: DatadogAPIClient::V2::ProductAnalyticsRetentionReturnCriteria.new({
+            base_query: DatadogAPIClient::V2::ProductAnalyticsEventQuery.new({
+              data_source: DatadogAPIClient::V2::ProductAnalyticsEventQueryDataSource::PRODUCT_ANALYTICS,
+              search: DatadogAPIClient::V2::ProductAnalyticsEventSearch.new({
+                query: "@type:view",
+              }),
+            }),
+            time_interval: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeInterval.new({
+              type: DatadogAPIClient::V2::ProductAnalyticsRetentionCalendarTimeIntervalType::CALENDAR,
+              value: DatadogAPIClient::V2::ProductAnalyticsCalendarInterval.new({
+                alignment: "monday",
+                quantity: 1,
+                timezone: "UTC",
+                type: DatadogAPIClient::V2::ProductAnalyticsCalendarIntervalType::WEEK,
+              }),
+            }),
+          }),
+        }),
+      }),
+      to: 1756857600000,
+    }),
+    type: DatadogAPIClient::V2::ProductAnalyticsFormulaRetentionRequestType::FORMULA_RETENTION_REQUEST,
+  }),
+})
+p api_instance.query_product_analytics_retention_timeseries(body)