Table of contents

Important: this documentation is not applicable to your currently selected format stories!

amp-call-tracking

Description

Dynamically replaces a phone number in a hyperlink to enable call tracking.

Required Scripts

<script async custom-element="amp-call-tracking" src="https://cdn.ampproject.org/v0/amp-call-tracking-0.1.js"></script>

Supported Layouts

container fill fixed fixed-height flex-item responsive

Usage

Dynamically replaces a phone number in a hyperlink to enable call tracking. Executes a CORS request to substitute the number.

The <amp-call-tracking> tag must wrap a normal anchor tag that hyperlinks a phone number. This phone number will be replaced with the values provided by a CORS endpoint.

<amp-call-tracking config="https://example.com/calltracking.json">
  <a href="tel:123456789">+1 (23) 456-789</a>
</amp-call-tracking>

Each unique CORS endpoint is called only once per page.

Attributes

`config` (required)

Defines a CORS URL. The URL's protocol must be HTTPS. The response must consist of a valid JSON object with the following fields:

phoneNumber (required): Specifies the phone number to call when the user clicks the link.
formattedPhoneNumber (optional): Specifies the phone number to display. If not specified, the value in phoneNumber is used.

Your XHR endpoint must implement the requirements specified in the CORS Requests in AMP.

Validation

See amp-call-tracking rules in the AMP validator specification.

Need more help?

You've read this document a dozen times but it doesn't really cover all of your questions? Maybe other people felt the same: reach out to them on Stack Overflow.

Go to Stack Overflow

Found a bug or missing a feature?

The AMP project strongly encourages your participation and contributions! We hope you'll become an ongoing participant in our open source community but we also welcome one-off contributions for the issues you're particularly passionate about.

Go to GitHub