Meta Signals Gateway Plugin

Meta Signals Gateway Plugin

Overview

The Meta Signals Gateway plugin enables robust server-side tracking for your hotel website by integrating with the Meta Conversions API Gateway. This solution helps bypass intelligent tracking prevention (ITP) and ad blockers, ensuring more accurate data collection for your Meta (Facebook/Instagram) advertising campaigns.

This plugin serves as the client-side bridge that connects your website to your Meta Conversions API Gateway instance.

What is Stape.io ?

Stape.io  is a popular hosting provider for server-side tracking infrastructure. We recommend using Stape.io  to host your Meta Conversions API Gateway because it offers:

  • Easy "Click & Go" setup.
  • Custom domain support (crucial for establishes first-party context).
  • Scalable infrastructure without managing your own cloud servers (AWS/GCP).

Setting up Meta Conversions API Gateway on Stape.io 

To use this plugin, you must first have a running instance of the Meta Conversions API Gateway.

Step 1: Create a Stape.io  Account

  1. Go to Stape.io  and create an account.
  2. In the dashboard, click "Create Container".

Step 2: Choose Conversions API Gateway

  1. Give your container a name (e.g., "My Hotel CAPIG").
  2. Select "Meta Conversions API Gateway" as the container type (Note: This is distinct from Server-side Google Tag Manager).
  3. Choose a server location closest to your main customer base.
  4. Click Create Container.

Step 3: Configure Custom Domain (The Host)

Important: For the gateway to work effectively as a first-party tool, you must map a subdomain of your hotel's website to the Stape server.

  1. In your Stape container settings, find the Domains section.
  2. Add a custom subdomain, such as metrics.your-hotel-domain.com or capig.yourweb.com.
  3. Stape will provide DNS records (usually an A record).
  4. Update your DNS settings at your domain registrar with these records.
  5. Once verified, this subdomain (e.g., https://metrics.your-hotel-domain.com) will be your Host URL.

Step 4: Connect to Meta

  1. Follow the on-screen instructions in the Stape/CAPIG interface to log in with your Facebook account.
  2. Connect the gateway to your Meta Pixel and Business Manager.
  3. Note down the Pixel ID you are connecting.

Helpful Resources

Configuring the Plugin

Once your gateway is running, configure the plugin in the Hotelwize CMS to start sending data.

  1. Log in to the Hotelwize CMS.
  2. Go to your website.
  3. Navigate to Plugins > Analytics.
  4. Locate Meta Signals Gateway.
  5. Click Edit or Configure.
  6. Fill in the configuration fields described below.
  7. Save and Publish your changes.

Configuration Fields

FieldDescriptionExample
Host URLThe full URL of your custom domain configured in Step 3. Must include https://.https://metrics.your-hotel-domain.com
Pixel IDThe ID of the Meta Pixel connected to your gateway instance.123456789012345
Debug ModeEnable this to see detailed logs in the browser's developer console. specific to the Signals Gateway script. Useful for testing availability.Checked for testing, Unchecked for production

What to Expect

Once enabled, the plugin will load the lightweight Meta Signals script from your Host URL.

1. Cookies

The plugin will set first-party cookies to maintain user identity compliant with ITP and strict privacy settings:

  • _cbp: Stores the browser ID for the Conversions API. (First-party, Persistent, ~3 months)
  • cee: Stores event coordination data. (First-party, Persistent, ~3 months)

2. Data Flow

  1. Browser: Events on your website (PageViews, etc.) are captured.
  2. Gateway: Data is sent securely to your Host URL (metrics.your-hotel-domain.com).
  3. Meta: The Gateway server deduplicates and enriches the data, then sends it to Meta via the Conversions API.

3. Verification

You can verify the setup by:

  • Checking the Network tab in your browser's developer tools for requests sent to your Host URL.
  • Using the "Test Events" tool in Facebook Events Manager (Server tab).

    • Related Articles

    • Plugins Overview

      Website builder relies on plugins to manage and render external services or special functionalities. The use of plugins and the associate middleware service allows centralized cookie and tracker management and platform extensibility. Plugins can be ...

    • Hotelwize Liquid Plugin Configuration

      Hotelwize Liquid Plugin is a integrated booking engine user interface seamlessly integrating the booking engine flow into the website, achieving an enhanced user experience and high conversion rates. All canvases support the Hotelwize Liquid plugin, ...

    • iCal Availability Calendar

      Overview Display a month availability calendar to the website. Uses iCalendar feed to display available / occupied dates for a room or villa. This plugin is activated per page and accepts different feed per page. Activate To activate the plugin go to ...

    • HTML Badge

      Overview In many cases you want to add a badge or a reward snippet in the website, like booking.com, TripAdvisor or Expedia. Adding these widgets will break GDPR compliance and PCI compliance of the website, since these scripts are using tracking ...

    • How-To: Add 3rd party application on my website

      We understand that several 3rd party services provide various functionalities to online marketers community. The ability to add extra functionalities on a website without programming knowledge and / or previous experience with every CMS is ...