Skip to content

Yampi Integration

Learn how to set up OneClick Tracking on Yampi.

OneClick Tracking is a new feature for Meta Ads advertisers who use Yampi as their payment gateway. It provides immediate and accurate conversion tracking.

With OneClick Tracking, you see the volume of real conversions per period right in your Ads Manager, making a quick and clear audit easy, without the need for complicated dashboards that have to be kept up to date.

Note: OneClick Tracking eliminates the need for extra tracking tools!


  1. Log in to your OneClick Ads account.

  2. Go to the "OneClick Tracking" tab, available in the left sidebar of OneClick Ads.

    The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card

  3. Click "New Integration".

  4. Select the "E-commerce" product type and click Continue.

  5. Select the "Yampi" platform and click Continue.

5.1. Enter your store’s Alias. a. In the Yampi platform, click the button in the top right corner (your store’s logo) >> “Credenciais de API” (API Credentials) >> Copy the “Alias” and paste it into the OneClick Tracking field. Then click continue.

  1. Copy the Webhook URL and add it in the platform by following the steps below: a. Each ad account will have a unique, automatically generated link. b. This link is what connects your account to Yampi and tracks where conversions come from.

    6.1. Log in to your Yampi account. a. Go to Configurações >> Webhooks >> Novo Webhook (Settings >> Webhooks >> New Webhook) in the Yampi menu.

    image2

    6.2. Create a new Webhook. a. Paste the tracking URL provided by OneClick into the URL field.

    image3

    b. Choose the events:

    • “Pedido criado” (Order created)
    • “O status de um pedido foi atualizado” (An order’s status was updated)
    • “Pedido atualizado” (Order updated)
    • “Pedido aprovado” (Order approved)

    image4 c. Click “Salvar” (Save).

  1. Copy the UTM Script generated in OneClick Tracking.

    The UTM parameters step of OneClick Tracking, with the parameter to copy

    7.1. Paste it into the "URL parameters" field in ALL of your ads in Ads Manager, as shown below:

    The URL parameters field of an ad in Meta Ads Manager

  1. Add the UTM Passthrough Script to all your sales pages, so the UTMs are carried through to the final checkout page: a. You can install it on your website via Google Tag Manager or, preferably, directly in your website's header.
  1. Set the Attribution Mode.

    The Attribution Mode step of OneClick Tracking

  2. Set the Naming Convention that your campaigns, ad sets and ads will receive in your Ads Manager and click next.

The Campaign Naming step of OneClick Tracking Analysis periods and the Naming Convention preview


Wait at least 24 hours for the setup to take effect, and all your campaigns (those that receive conversions) will start recording conversions right inside Ads Manager.

Campaigns with the OneClick Tracking prefix in Ads Manager


  • Install and keep your pixel in the Yampi configuration.