Go Headless

Build Apps

Client

API Preview

Develop Websites

REST

Velo

GraphQL (Alpha)

# About Marketing Tags

With Wix Marketing Tags, site owners can embed marketing tags in their website. The supported marketing tags are:

* [**Google Ads Conversion tag**](https://support.google.com/tagmanager/answer/6105160?hl=en&ref_topic=6334091)

    > **Note:** The **Google Ads Conversion tag** was previously called **Google AdWords tag**.
* [**Google Analytics tag**](https://support.google.com/tagmanager/topic/6333310?hl=en&ref_topic=3002579)


    > **Note:** Both [**Google Universal Analytics tags**](https://support.google.com/tagmanager/answer/6107124?hl=en&ref_topic=6333310) and [**Google Analytics 4 tags**](https://support.google.com/tagmanager/answer/9442095?hl=en&ref_topic=6333310) are supported.
* [**Yandex Metrica tag**](https://yandex.com/support/metrica/index.html)
* [**Facebook Pixel tag**](https://developers.facebook.com/docs/facebook-pixel/)
* [**Google tag**](https://support.google.com/tagmanager/answer/6102821?hl=en&ref_topic=3441530)


These marketing tags enable site owners to track user activity, ad conversion rates, and more.

> **Note:** Only one marketing tag of each type is supported per Wix site.


The Marketing Tags APIs allow your app to:

* List marketing tags
* Create and update marketing tags
* Delete marketing tags


## Terminology

* **Domain:** Specifies which website is associated with the marketing tag.

    > **Note:** When the site owner changes the domain of a Wix site, the embedded marketing tags won’t load anymore. To update the domain use the [Upsert Marketing Tag](https://dev.wix.com/api/rest/marketing/marketing-tags/upsert-marketing-tag) endpoint. Currently, there is no way to sign up for notifications when a site owner changes their domain name.
* **Tracking ID:** Specifies which external ID is associated with the site owner. Learn more about each tracking ID in the corresponding object description. These are the supported external IDs:

    | Marketing Tag | External ID Name | ID Format| 
    |-|-|-|
    | Google Ads Conversion tag | Conversion ID | AW-123456789 |
    | Google Universal Analytics tag | Analytics ID | UA-12345-1 |
    | Google Analytics 4 tag | Measurement ID | G-12345  |
    | Yandex Metrica tag | Tag number | 123456789 |
    | Facebook Pixel tag | Pixel ID  | 123456789  |
    | Google tag | Tag Manager Container ID | GTM-12345 |


# Example Flow: Wix Marketing Tags

This article shares a possible use case your app could support, as well as an example flow. You're certainly not limited to this use case, but it can be a helpful jumping off point as you plan your app's implementation.


## Manage Marketing Tags

Your app could help site owners manage their marketing tags after they have updated their site structure. First, you’ll list the existing tags. Then your app will update the associated domains.


### Step 1: List the Embedded Marketing Tags

First, your app will call the [List Marketing Tags endpoint](https://dev.wix.com/api/rest/marketing/marketing-tags/list-marketing-tags) to retrieve the marketing tags that the owners have previously embedded. 

```sh
curl -X GET \
    https://www.wixapis.com/marketing/v1/tags \
    -H 'Content-Type: application/json' \
    -H 'Authorization: <AUTH>'
```

In the response of the call, you can see that the associated domains are out-dated, and thus the marketing tags won’t load anymore. 


```json
{"tags": [
    {
        "id": "994ba324-682c-4d81-abd6-84e4be44ba3c",
        "type": "GOOGLE_ADS",
        "enabled": true,
        "google_ads":   {
            "domain": "old-domain.com",
            "tracking_id": "AW-672490861"
        }
    },
    {
        "id": "123ba321-678c-4d81-abd6-84e4be44ba3c",
        "type": "FACEBOOK_PIXEL",
        "enabled": true,
        "facebook_pixel":   {
            "domain": "old-domain.com",
            "tracking_id": "123456789"
        }
    }
]}
```



### Step 2: Update an Embedded Marketing Tag

Then, you’ll do a separate call of the [Upsert Marketing Tag endpoint](https://dev.wix.com/api/rest/marketing/marketing-tags/upsert-marketing-tag) for each tag to change the associated domain. You’ll need to pass the new domain in the body of each call, as shown in the example below for the Google Ads Conversion tag.

```sh
curl -X POST \
    https://www.wixapis.com/marketing/v1/tags  \
    -H 'Content-Type: application/json' \
    -H 'Authorization: <AUTH>'
    -d '{
             "tag": {
                 "enabled": true,
                 "google_ads": {
                  "domain": "new-domain.com",
                  "tracking_id": "AW-672490861",
                 }
               }
             }'
```

type

DeleteMarketingTagRequest

DeleteMarketingTagResponse

tagType

DeleteMarketingTagV2Request

DeleteMarketingTagV2Response

Domain associated with the Facebook Pixel tag.

domain

Pixel ID in 123456789 format.
Specifies which Facebook Pixel is associated with the site owner.

trackingId

FacebookPixel

Domain associated with the Google Ads Conversion tag.

Conversion ID in AW-123456789 format.
Specifies which Google property is associated with the site owner.

GoogleAds

Domain associated with the Google Analytics tag.

Whether IP addresses of site visitors are hidden from Google.

ipAnonymization

Measurement ID for Google Analytics 4 tags in G-12345 format,
or Analytics ID for Google Universal Analytics tags in UA-12345-1 format.
Specifies which Google property is associated with the site owner.

GoogleAnalytics

Tag Manager Container ID in GTM-12345 format.
Specifies which Google Tag Manager Container is associated with the site owner.

GoogleTagManager

ListMarketingTagsRequest

Information about which marketing tags to retrieve.

byType

Filter

ListMarketingTagsResponse

Whether this tag is enabled.
Defaults to `true`.

enabled

MarketingTag

Type

A [Facebook Pixel tag](https://developers.facebook.com/docs/facebook-pixel/)
allows site owners to track Facebook ad-driven visitor activity on their site.

A [Google Ads Conversion tag](https://support.google.com/tagmanager/answer/6105160?hl=en&ref_topic=6334091)
lets site owners analyze what a visitor does after clicking on a Google ad.

A [Google Analytics tag](https://support.google.com/tagmanager/topic/6333310?hl=en&ref_topic=3002579)
lets site owners track page views, where visitors are coming from, how long they stay, and
what keywords they used to find the site. Both [Google Universal Analytics Tags](https://support.google.com/tagmanager/answer/6107124?hl=en&ref_topic=6333310)
and [Google Analytics 4 tags](https://support.google.com/tagmanager/answer/9442095?hl=en&ref_topic=6333310)
are supported.

A [Google tag](https://support.google.com/tagmanager/answer/6102821?hl=en&ref_topic=3441530)
lets site owners implement a quick and easy tag management system that keeps
3rd party code snippets organized.

A [TikTok Pixel](https://ads.tiktok.com/help/article?aid=9663)
allows site owners to share visitor events to TikTok on their site.

A [Yandex Metrica tag](https://yandex.com/support/metrica/index.html) lets site
owners build visual reports of visitor activity that helps them evaluate the
performance of their marketing campaigns.

params

Specifies which TikTok Pixel is associated with the site owner.

TikTokPixel

UpsertMarketingTagRequest

UpsertMarketingTagResponse

Domain associated with the Yandex Metrica tag.

Yandex Tag Number in 123456789 format.
Specifies which Yandex tag is associated with the site owner.

List Marketing Tags

Permission Scopes