技術情報

トラッキング画像の変更方法

 

トラッキングのために、画像ビーコンを使用する場合、Matomoはデフォルトで透明な1×1のGIF画像を提供します。

Matomo 4.5.0では、代わりにカスタム画像を提供することが可能です。そのためには設定を調整する必要があります。

画像を指定するには、画像への絶対ファイルパスを指定するか、Base64エンコードされた画像を直接設定します。サポートされているファイル形式はGIF、JPEG、PNGです。

[Tracker]
custom_image = "/path/to/my/image.gif"

または

[Tracker]
custom_image = "iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAIAAAACDbGyAAAACXBIWXMAAC4jAAAuIwF4pT92AAAAB3RJTUUH5QgLFiABlwQnpwAAABl0RVh0Q29tbWVudABDcmVhdGVkIHdpdGggR0lNUFeBDhcAAAAUSURBVAjXY/wjLMyABJgYUAGpfABbJQEsALGyNgAAAABJRU5ErkJggg=="

設定された画像が存在しないか、サポートされていない形式の場合、Matomo は代わりに透過 GIF を提供するようにフォールバックします。壊れた Base64 画像文字列を設定すると、壊れた画像を提供することになります。
カスタム画像が正しく配信されているかどうかをテストするには、ブラウザでトラッキングURLを開きます。例)https://demo.matomo.cloud/matomo.php?idsite=1.