meridian.analysis.optimizer.OptimizationResults

Répartition optimisée du budget

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
)

Il s'agit d'un objet de classe de données contenant des ensembles de données issus de BudgetOptimizer. Ces ensembles de données incluent les éléments suivants :

  • nonoptimized_data : métriques sur le budget non optimisé (basées sur la fréquence historique).
  • nonoptimized_data_with_optimal_freq : métriques sur le budget non optimisé basées sur la fréquence optimale.
  • optimized_data : métriques sur le budget optimisé.
  • optimization_grid : informations sur la grille utilisées pour l'optimisation.

Les métriques (variables de données) sont les suivantes : ROI, ROIm, résultat incrémental et CPIK.

Certaines valeurs intermédiaires et références à l'analyseur et au modèle ajusté source sont également stockées ici. Elles sont utiles pour la visualisation et le débogage.

meridian Modèle Meridian ajusté qui a été utilisé pour créer cette répartition de budget.
analyzer Analyseur lié au modèle ci-dessus.
use_posterior Indique si la distribution a posteriori a été utilisée pour optimiser le budget. Si la valeur est False, la distribution a priori a été utilisée.
use_optimal_frequency Indique si la fréquence optimale a été utilisée pour optimiser le budget.
spend_ratio Ratio des dépenses utilisé pour adapter les métriques sur le budget non optimisé à celles sur le budget optimisé.
spend_bounds Limites de dépenses utilisées pour adapter les métriques sur le budget non optimisé à celles sur le budget optimisé.
nonoptimized_data Métriques sur le budget non optimisé (basées sur la fréquence historique).
nonoptimized_data_with_optimal_freq Métriques sur le budget non optimisé basées sur la fréquence optimale.
optimized_data Métriques sur le budget optimisé.
optimization_grid Informations sur la grille utilisées pour l'optimisation.
template_env Environnement de modèle partagé lié à ce budget optimisé.

Méthodes

get_response_curves

Afficher la source

get_response_curves() -> xr.Dataset

Calcule les courbes de réponse par scénario d'optimisation du budget.

Cette méthode est un wrapper pour Analyzer.response_curves(), qui définit les arguments suivants pour qu'ils soient cohérents avec le scénario d'optimisation du budget spécifié dans l'appel BudgetOptimizer.optimize() ayant renvoyé ce résultat. En particulier :

  1. spend_multiplier correspond à la grille d'optimisation discrète, en tenant compte de la taille de pas de la grille et de toutes les limites de contrainte au niveau du canal.
  2. selected_times, by_reach et use_optimal_frequency correspondent aux valeurs définies dans BudgetOptimizer.optimize().

Renvoie
Un ensemble de données renvoyé par Analyzer.response_curves(), par scénario d'optimisation du budget spécifié dans l'appel BudgetOptimizer.optimize() ayant renvoyé ce résultat.

output_optimization_summary

Afficher la source

output_optimization_summary(
    filename: str, filepath: str
)

Génère et enregistre le récapitulatif de l'optimisation HTML.

plot_budget_allocation

Afficher la source

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

Représente les dépenses allouées à chaque canal sous la forme d'un graphique à secteurs.

Args
optimized Si la valeur est True, les dépenses optimisées sont affichées. Si la valeur est False, les dépenses non optimisées sont affichées.

Renvoie
Graphique à secteurs Altair représentant les dépenses par canal.

plot_incremental_outcome_delta

Afficher la source

plot_incremental_outcome_delta() -> alt.Chart

Représente l'évolution du résultat incrémental sous la forme d'un graphique en cascade.

plot_response_curves

Afficher la source

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

Représente les courbes de réponse (avec des contraintes de dépenses) pour chaque canal.

Args
n_top_channels Nombre facultatif des principaux canaux à inclure en fonction des dépenses. Par défaut, tous les canaux sont inclus.

Renvoie
Graphique Altair affichant les courbes de réponse avec les détails d'optimisation.

plot_spend_delta

Afficher la source

plot_spend_delta() -> alt.Chart

Représente la variation optimisée des dépenses par canal sous la forme d'un graphique à barres.

__eq__

__eq__(
    other
)

Renvoie self==value.