meridian.analysis.optimizer.BudgetOptimizer

Exécute et génère des scénarios d'optimisation du budget sur votre modèle.

meridian.analysis.optimizer.BudgetOptimizer(
    meridian: meridian.model.model.Meridian
)

Trouve la répartition de budget optimale qui maximise le résultat en fonction de différents scénarios dans lesquels le budget, les données et les contraintes peuvent être personnalisés. Les résultats peuvent être affichés sous forme de graphiques et de page récapitulative de résultats au format HTML.

Méthodes

optimize

Afficher la source

optimize(
    use_posterior: bool = True,
    selected_times: (tuple[str | None, str | None] | None) = None,
    fixed_budget: bool = True,
    budget: (float | None) = None,
    pct_of_spend: (Sequence[float] | None) = None,
    spend_constraint_lower: (_SpendConstraint | None) = None,
    spend_constraint_upper: (_SpendConstraint | None) = None,
    target_roi: (float | None) = None,
    target_mroi: (float | None) = None,
    gtol: float = 0.0001,
    use_optimal_frequency: bool = True,
    use_kpi: bool = False,
    confidence_level: float = c.DEFAULT_CONFIDENCE_LEVEL,
    batch_size: int = c.DEFAULT_BATCH_SIZE
) -> meridian.analysis.optimizer.OptimizationResults

Trouve la répartition de budget optimale qui maximise le résultat.

Celui-ci correspond généralement aux revenus, mais lorsque le KPI n'est pas lié aux revenus et que les données sur les revenus par KPI ne sont pas disponibles, Meridian définit le résultat comme étant le KPI lui-même.

Args
use_posterior	Valeur booléenne. Si la valeur est True, le budget est optimisé en fonction de la distribution a posteriori du modèle. Sinon, la distribution a priori est utilisée.
selected_times	Tuple contenant les coordonnées de la dimension de l'heure de début et de fin pour la durée d'exécution de l'optimisation. Les valeurs de temps sélectionnées doivent correspondre aux coordonnées de la dimension temporelle Meridian dans le modèle sous-jacent. Par défaut, toutes les périodes sont utilisées. Le composant de début ou de fin peut être None pour représenter respectivement la première ou la dernière coordonnée temporelle.
fixed_budget	Valeur booléenne indiquant s'il s'agit d'une optimisation à budget fixe ou flexible. La valeur par défaut est True. Si la valeur est False, vous devez spécifier target_roi ou target_mroi.
budget	Nombre indiquant le budget total pour le scénario à budget fixe. Correspond par défaut au budget historique.
pct_of_spend	Liste numérique de taille n_total_channels contenant le pourcentage d'allocation des dépenses pour tous les canaux média et de couverture et fréquence. L'ordre doit correspondre à InputData.media avec des valeurs comprises entre 0 et 1, dont la somme est égale à 1. Par défaut, l'allocation historique est utilisée. Le budget et l'allocation sont utilisés conjointement pour déterminer les dépenses média non optimisées, qui sont utilisées pour calculer les métriques de performances non optimisées (par exemple, le ROI) et créer la plage possible de dépenses média avec les contraintes de dépenses.
spend_constraint_lower	Liste numérique de taille n_total_channels ou de type float (même contrainte pour tous les canaux) indiquant la limite inférieure des dépenses média. La limite inférieure des dépenses média est (1 - spend_constraint_lower) * budget * allocation). La valeur doit être comprise entre 0 et 1. La valeur par défaut est 0.3 pour un budget fixe et 1 pour un budget flexible.
spend_constraint_upper	Liste numérique de taille n_total_channels ou de type float (même contrainte pour tous les canaux) indiquant la limite supérieure des dépenses média. La limite supérieure des dépenses média est (1 + spend_constraint_upper) * budget * allocation). La valeur par défaut est 0.3 pour un budget fixe et 1 pour un budget flexible.
target_roi	Valeur float indiquant la contrainte de ROI cible. Utilisée uniquement pour les scénarios à budget flexible. Le budget est limité lorsque le ROI des dépenses totales atteint target_roi.
target_mroi	Valeur float indiquant la contrainte de ROI marginal cible. Utilisée uniquement pour les scénarios à budget flexible. Le budget est limité lorsque le ROI marginal des dépenses totales atteint target_mroi.
gtol	Valeur flottante indiquant l'erreur relative acceptable pour le budget utilisé dans la configuration de la grille. Le budget sera arrondi à 10*n, où n est le plus petit entier pour que (budget - rounded_budget) soit inférieur ou égal à (budget * gtol). gtol doit être inférieur à 1.
use_optimal_frequency	Si la valeur est True, utilise optimal_frequency calculé par le modèle Meridian entraîné pour l'optimisation. Si la valeur est False, utilise la fréquence historique.
use_kpi	Si la valeur est True, l'optimisation est effectuée sur le KPI. Par défaut, il s'agit des revenus.
confidence_level	Seuil de calcul des intervalles de confiance.
batch_size	Nombre maximal de tirages par chaîne dans chaque lot. Le calcul est exécuté par lots pour éviter l'épuisement de la mémoire. Si une erreur de mémoire se produit, essayez de réduire batch_size. Le calcul sera généralement plus rapide avec des valeurs batch_size plus élevées.

Renvoie
Un objet OptimizationResults contenant des ensembles de données pour une allocation de budget optimisée, ainsi que certaines des valeurs intermédiaires utilisées pour les générer.