A simple Yandex Mertika (Яндекс Метрика) tag.js package for Angular 6+.
Demo is here demo
Working code for this demo at stackblitz example
Install via npm package manager
npm install @kolkov/ngx-metrika --save
Add the package to your app.module.ts
.
Then simple add property yaCounterId
to the environment
constant or use inline
import { RouterModule } from '@angular/router';
import { NgxMetrikaModule } from '@kolkov/ngx-metrika';
@NgModule({
imports: [
RouterModule.forRoot([]),
NgxMetrikaModule.forRoot({
id: environment.yaCounterId,
...
defer: true,
webvisor: true,
clickmap: true,
trackLinks: true,
accurateTrackBounce: true,
})
]
})
The package will listen to route changes by default, you just need to instantiate service in the root of the project.
export class AppComponent {
constructor(private ym: NgxMetrikaService) { }
}
NgxMetrika is a service that also allows you to track pageviews manually.
this.ym.hit.emit();
// or with custom params
this.ym.hit.emit({url: '/custom',{
title: 'Lesson Feed',
referer: 'https://angularfirebase.com/lessons'
}});
ReachGoal expect an action.
this.ym.reachGoal.next({target: 'TARGET_NAME'})
You can optionally pass in addtional params.
function goalCallback () {
console.log('request to Metrika sent successfully');
}
const options: CommonOptions = {
params: {
productId: product.id,
productName: product.name,
},
callback: goalCallback,
}
this.ym.reachGoal.next({target: 'ADD_TO_CART', options});
Many analytics events are tracked based on user interaction, such as button clicks. Just tell it which DOM event to track.
<button ymGoal trackOn="click" target="TRACKED">Track Me</button>
This will register a general Target in Yandex Metrika based on the target name.
You can pass optional params to the directive like so:
<div ymGoal
target="PROGUCT_DRAGGED"
[params]="{ targetLabel: 'Something cool just happened' }">
Some Product...
</div>
The directive will produce the following event on dragstart.
Within the download you'll find the following directories and files. You'll see something like this:
metrika/
└── projects/
├── ngx-metrika/
└── ngx-metrika-app/
ngx-metrika/
- library
ngx-metrika-app/
- demo application
The documentation for the ngx-metrika
is hosted at our website ngx-metrika
Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.
Editor preferences are available in the editor config for easy use in common text editors. Read more and download plugins at https://editorconfig.org.
For transparency into our release cycle and in striving to maintain backward compatibility, ngx-metrika
is maintained under the Semantic Versioning guidelines.
See the Releases section of our project for changelogs for each release version.
Andrey Kolkov