meridian.analysis.optimizer.OptimizationResults

L'allocazione del budget ottimizzata.

meridian.analysis.optimizer.OptimizationResults(
    meridian: meridian.model.model.Meridian,
    analyzer: meridian.analysis.analyzer.Analyzer,
    use_posterior: bool,
    use_optimal_frequency: bool,
    spend_ratio: np.ndarray,
    spend_bounds: tuple[np.ndarray, np.ndarray],
    _nonoptimized_data: xr.Dataset,
    _nonoptimized_data_with_optimal_freq: xr.Dataset,
    _optimized_data: xr.Dataset,
    _optimization_grid: xr.Dataset
)

Si tratta di un oggetto dataclass contenente i set di dati generati da BudgetOptimizer. Questi set di dati includono:

• nonoptimized_data: le metriche del budget non ottimizzate (in base alla frequenza storica).
• nonoptimized_data_with_optimal_freq: le metriche del budget non ottimizzate basate sulla frequenza ottimale.
• optimized_data: le metriche del budget ottimizzate.
• optimization_grid: le informazioni sulla griglia utilizzate per l'ottimizzazione.

Le metriche (variabili di dati) sono: ROI, mROI, risultato incrementale, CPIK.

Inoltre, sono memorizzati anche alcuni valori intermedi e riferimenti al modello e all'analizzatore adattati all'origine. Sono utili per la visualizzazione e il debugging.

Attributi
meridian	Il modello Meridian adattato utilizzato per creare questa allocazione del budget.
analyzer	L'analizzatore associato al modello precedente.
use_posterior	Indica se la distribuzione a posteriori è stata utilizzata per ottimizzare il budget. Se False, è stata utilizzata la distribuzione a priori.
use_optimal_frequency	Indica se è stata utilizzata la frequenza ottimale per ottimizzare il budget.
spend_ratio	Il rapporto di spesa utilizzato per scalare le metriche del budget non ottimizzato alle metriche del budget ottimizzato.
spend_bounds	I limiti di spesa utilizzati per scalare le metriche del budget non ottimizzato alle metriche del budget ottimizzato.
nonoptimized_data	Le metriche del budget non ottimizzate (in base alla frequenza storica).
nonoptimized_data_with_optimal_freq	Le metriche del budget non ottimizzate in base alla frequenza ottimale.
optimized_data	Le metriche del budget ottimizzate.
optimization_grid	Le informazioni sulla griglia utilizzate per l'ottimizzazione.
template_env	Un ambiente modello condiviso associato a questo budget ottimizzato.

Metodi

get_response_curves

Visualizza codice sorgente

get_response_curves() -> xr.Dataset

Calcola le curve di risposta in base allo scenario di ottimizzazione del budget.

Questo metodo è un wrapper per Analyzer.response_curves(), che imposta i seguenti argomenti in modo che siano coerenti con lo scenario di ottimizzazione del budget specificato nella chiamata BudgetOptimizer.optimize() che ha restituito questo risultato. In particolare:

1. spend_multiplier corrisponde alla griglia di ottimizzazione discreta, tenendo conto della dimensione del passo della griglia e di eventuali limiti di vincolo a livello di canale.
2. selected_times, by_reach e use_optimal_frequency corrispondono ai valori impostati in BudgetOptimizer.optimize().

Resi
Un set di dati restituito da Analyzer.response_curves(), per ogni scenario di ottimizzazione del budget specificato nella chiamata BudgetOptimizer.optimize() che ha restituito questo risultato.

output_optimization_summary

Visualizza codice sorgente

output_optimization_summary(
    filename: str, filepath: str
)

Genera e salva l'output del riepilogo dell'ottimizzazione HTML.

plot_budget_allocation

Visualizza codice sorgente

plot_budget_allocation(
    optimized: bool = True
) -> alt.Chart

Grafica un grafico a torta che mostra la spesa allocata per ciascun canale.

Args
optimized	Se True, viene mostrata la spesa ottimizzata. Se False, viene mostrata la spesa non ottimizzata.

Resi
Un grafico a torta Altair che mostra la spesa per canale.

plot_incremental_outcome_delta

Visualizza codice sorgente

plot_incremental_outcome_delta() -> alt.Chart

Grafica un grafico a cascata che mostra la variazione del risultato incrementale.

plot_response_curves

Visualizza codice sorgente

plot_response_curves(
    n_top_channels: (int | None) = None
) -> alt.Chart

Grafica le curve di risposta, con vincoli di spesa, per ciascun canale.

Args
n_top_channels	Numero facoltativo di canali principali per spesa da includere. Per impostazione predefinita, sono inclusi tutti i canali.

Resi
Un grafico Altair che mostra le curve di risposta con i dettagli dell'ottimizzazione.

plot_spend_delta

Visualizza codice sorgente

plot_spend_delta() -> alt.Chart

Grafica un grafico a barre che mostra la variazione ottimizzata della spesa per canale.

__eq__

__eq__(
    other
)

Restituisce self==value.