電商儀表板文檔

主題

E-commerce API Services - Auto-generated Documentation v0.0.0

E-commerce API Services - Auto-generated Documentation / CampaignScoringApiService / CampaignScoringApiService

Class: CampaignScoringApiService ​

Defined in: CampaignScoringApiService.ts:99

Extends ​

  • BaseApiService<any, any>

Constructors ​

Constructor ​

new CampaignScoringApiService(supabase): CampaignScoringApiService

Defined in: CampaignScoringApiService.ts:102

Parameters ​

supabase ​

SupabaseClient

Returns ​

CampaignScoringApiService

Overrides ​

BaseApiService<any, any>.constructor

Properties ​

supabase ​

protected supabase: SupabaseClient

Defined in: base/BaseApiService.ts:11

Inherited from ​

BaseApiService.supabase

tableName ​

protected tableName: string

Defined in: base/BaseApiService.ts:12

Inherited from ​

BaseApiService.tableName

viewName? ​

protected optional viewName: string

Defined in: base/BaseApiService.ts:13

Inherited from ​

BaseApiService.viewName

Methods ​

applySearch() ​

protected applySearch(query, _search): any

Defined in: base/BaseApiService.ts:192

應用搜尋條件（子類別可覆寫）

Parameters ​

query ​

any

string

Returns ​

any

Inherited from ​

BaseApiService.applySearch

calculateCampaignRanking() ​

calculateCampaignRanking(campaigns, scoringConfig?): Promise<ApiResponse<CampaignPerformanceRankingItem[]>>

Defined in: CampaignScoringApiService.ts:209

獨立計算活動排行榜

Parameters ​

campaigns ​

AttributionAnalysis[]

活動歸因數據陣列

scoringConfig? ​

ScoringConfig

評分配置 (可選)

Returns ​

Promise<ApiResponse<CampaignPerformanceRankingItem[]>>

活動排行榜

calculateCampaignScoring() ​

calculateCampaignScoring(campaigns, scoringConfig?): Promise<ApiResponse<{ campaignRanking: CampaignPerformanceRankingItem[]; config: Required<ScoringConfig>; layerPerformance: LayerPerformance[]; summary: { avgScore: number; topPerformer: null | CampaignPerformanceRankingItem; totalCampaigns: number; totalOrders: number; totalRevenue: number; }; timestamp: string; }>>

Defined in: CampaignScoringApiService.ts:123

執行活動評分計算

Parameters ​

campaigns ​

AttributionAnalysis[]

活動歸因數據陣列

scoringConfig? ​

ScoringConfig

評分配置 (可選)

Returns ​

Promise<ApiResponse<{ campaignRanking: CampaignPerformanceRankingItem[]; config: Required<ScoringConfig>; layerPerformance: LayerPerformance[]; summary: { avgScore: number; topPerformer: null | CampaignPerformanceRankingItem; totalCampaigns: number; totalOrders: number; totalRevenue: number; }; timestamp: string; }>>

包含分層效果、排行榜和統計的評分結果

calculateLayerPerformance() ​

calculateLayerPerformance(campaigns): Promise<ApiResponse<LayerPerformance[]>>

Defined in: CampaignScoringApiService.ts:182

獨立計算分層效果分析

Parameters ​

campaigns ​

AttributionAnalysis[]

活動歸因數據陣列

Returns ​

Promise<ApiResponse<LayerPerformance[]>>

分層效果統計

create() ​

create(entity): Promise<ApiResponse<any>>

Defined in: base/BaseApiService.ts:107

建立新資料

Parameters ​

entity ​

Partial<TEntity>

Returns ​

Promise<ApiResponse<any>>

Inherited from ​

BaseApiService.create

delete() ​

delete(id): Promise<ApiResponse<boolean>>

Defined in: base/BaseApiService.ts:161

刪除資料

Parameters ​

id ​

string

Returns ​

Promise<ApiResponse<boolean>>

Inherited from ​

BaseApiService.delete

findById() ​

findById(id): Promise<ApiResponse<any>>

Defined in: base/BaseApiService.ts:82

根據 ID 查詢單筆資料

Parameters ​

id ​

string

Returns ​

Promise<ApiResponse<any>>

Inherited from ​

BaseApiService.findById

findMany() ​

findMany(options): Promise<ApiResponse<any[]>>

Defined in: base/BaseApiService.ts:24

查詢多筆資料

Parameters ​

options ​

QueryOptions = {}

Returns ​

Promise<ApiResponse<any[]>>

Inherited from ​

BaseApiService.findMany

getDefaultScoringConfig() ​

getDefaultScoringConfig(): Required<ScoringConfig>

Defined in: CampaignScoringApiService.ts:233

獲取預設評分配置

Returns ​

Required<ScoringConfig>

getQueryBuilder() ​

protected getQueryBuilder(): QueryBuilder<any>

Defined in: base/BaseApiService.ts:184

獲取查詢建構器

Returns ​

QueryBuilder<any>

Inherited from ​

BaseApiService.getQueryBuilder

handleError() ​

protected handleError(error): ApiResponse<any>

Defined in: base/BaseApiService.ts:200

統一的錯誤處理

Parameters ​

error ​

any

Returns ​

ApiResponse<any>

Inherited from ​

BaseApiService.handleError

mapDbToEntity() ​

protected mapDbToEntity(dbItem): any

Defined in: CampaignScoringApiService.ts:112

將資料庫實體轉換為前端實體 子類別必須實作此方法

Parameters ​

dbItem ​

any

Returns ​

any

Overrides ​

BaseApiService.mapDbToEntity

mapEntityToDb() ​

protected mapEntityToDb(entity): Partial<TDbEntity>

Defined in: base/BaseApiService.ts:226

將前端實體轉換為資料庫實體 子類別可覆寫此方法

Parameters ​

entity ​

Partial<TEntity>

Returns ​

Partial<TDbEntity>

Inherited from ​

BaseApiService.mapEntityToDb

update() ​

update(id, updates): Promise<ApiResponse<any>>

Defined in: base/BaseApiService.ts:132

更新資料

Parameters ​

id ​

string

updates ​

Partial<TEntity>

Returns ​

Promise<ApiResponse<any>>

Inherited from ​

BaseApiService.update

validateScoringConfig() ​

validateScoringConfig(config): object

Defined in: CampaignScoringApiService.ts:247

驗證評分配置的有效性

Parameters ​

config ​

ScoringConfig

Returns ​

object

error? ​

optional error: string

valid ​

valid: boolean