meridian.model.adstock_hill.AdstockTransformer

メディアの Adstock 変換を計算します。

継承元: AdstockHillTransformer

meridian.model.adstock_hill.AdstockTransformer(
    alpha: tf.Tensor, max_lag: int, n_times_output: int
)

alpha 値が [0, 1) 以上、ディメンションが [..., n_media_channels] となる alpha パラメータのテンソル。バッチ ディメンション (...) は省略可能です。alpha = 0 は許可されているため、事前分布の点質量は 0 に設定できます（実質的に Adstock なし）。ただし、等比数列の和を求める数式が定義されていないため、alpha = 1 は許可されません。また、点質量を alpha = 1 に設定する実際的な理由もありません。
max_lag Adstock の計算に含める遅延期間の最大数（0 以上）を示す整数。
n_times_output 出力テンソルに含める期間の数を示す整数。メディア引数の期間数（media.shape[-2] など）を超えることはできません。出力期間は、メディア引数の最新の期間に対応しています。たとえば、media[..., -n_times_output:, :] は出力週のメディア施策を表します。

メソッド

forward

ソースを表示

forward(
    media: tf.Tensor
) -> tf.Tensor

指定された media テンソルの Adstock 変換を計算します。

地域 g、期間 t、メディア チャネル m の場合、Adstock は adstock_{g,t,m} = sum_{i=0}^max_lag media_{g,t-i,m} alpha^i として計算されます。

引数
media ディメンションが [..., n_geos, n_media_times, n_media_channels] のメディア値テンソル。バッチ ディメンション (...) は省略可能ですが、バッチ ディメンションを指定する場合は、alpha のバッチ ディメンションと一致させる必要があります。alpha にバッチ ディメンションが含まれている場合でも、メディアにバッチ ディメンションを指定する必要はありません。

戻り値
ディメンションが [..., n_geos, n_times_output, n_media_channels] のテンソル。Adstock で変換されたメディアを表します。