AMP Client JS
:mega: JS Client for Advertising Management Platform
Installation
The preferred way to import AMP Client is CDN link. Two versions are available:
https://unpkg.com/@68publishers/amp-client/dist/amp-client.min.js
https://unpkg.com/@68publishers/amp-client/dist/amp-client.standalone.min.js
The only difference is the first one is bundled with components template
and merge
from the lodash library and the standalone version not.
If you are using the lodash on your website then use the standalone version of AMP client.
In that case, lodash has to be imported as a first.
Prefer to use CDN links with a labeled version to prevent BC breaks e.g.:
<script src="https://unpkg.com/@68publishers/amp-client@1.0/dist/amp-client.min.js"></script>
<script src="https://unpkg.com/@68publishers/amp-client@1.0/dist/amp-client.standalone.min.js"></script>
Installation via NPM
If you don't want to use CDN, you can install AMP Client manually via NPM.
$ npm install @68publishers/amp-client
$ yarn add @68publishers/amp-client
After that, you can require AMP Client like any other JavaScript library.
Versions compatibility matrix
Client Version | AMP version | API version | Note |
---|
~1.0.0 | 1.0 - 2.7 | 1 | |
~1.1.0 | 1.0 - 2.7 | 1 | API supports only GET requests (cannot set the method: "POST" option) |
~1.1.0 | 2.8 | 1 | |
~1.2.0 | 2.8 - 2.10 | 1 | Limited metrics functionality - banner_name , position_id , position_name , campaign_id and campaign_name fields are not sent. |
~1.2.0 | 2.11 | 1 | The option origin has no effect, as it is not handled by AMP. |
~1.3.0 | 2.12 | 1 | |
~1.4.0 | 2.12 | 1 | Adds support for server-side rendered banners (68publishers/amp-client-php). |
~1.4.0 | 2.13 | 1 | Missing support for embed banners on the client's side. Banners marked as embed in AMP administration will be generated normally. |
~1.5.0 | >=2.13 | 1 | |
Integration
For integration instructions follow the Integration guide.
License
@todo