How to add offline events to Signals Gateway

File upload lets you send events to Meta that never passed through your website Pixel, such as in-store purchases, phone orders, app events, or CRM conversions. You format the data as a CSV and deliver it to Signals or CAPI Gateway, which processes and forwards it to your connected destination (e.g. Meta).

There are two methods: automatic upload via a cloud storage bucket (recommended for recurring data) and manual upload. Both use the same CSV format.

1. Create a Signals Gateway data pipeline (or open an existing one and click the + icon under Data Sources).

2. When prompted to choose a data source, select File upload and click Continue.

3. Give the data source a name and click Continue.

4. You'll see a confirmation screen with two options:

• Set up or use existing automatic file upload (recommended) - you can connect a cloud bucket.
• Manually upload your files - upload CSVs one at a time directly from the pipeline view.

Click Continue.

5. Complete the rest of the pipeline wizard. Connect your destination (e.g. Meta dataset), and click Done.

Automatic upload connects Signals Gateway to a cloud storage bucket. Once set up, your gateway processes any CSV files it finds in the bucket, then deletes them. No manual intervention needed after the initial configuration.

1. Go to Account settings → Automatic file uploads.

2. Select your cloud provider - AWS S3 or Google Cloud Storage.

From Account settings → Automatic file uploads you can:

• View the status and timestamp of the most recent job run.
• Modify bucket name or credentials via the ... menu.

To verify the integration, drop a sample CSV into your bucket and confirm the job completes successfully.

In this article, you can find a detailed header definition table to use when formatting your data files. Follow the format closely to help ensure the best results.

1. From the pipeline, click on your data source.

2. Open the Actions menu and click Upload event data.

3. Select your CSV file. Headers inside the file must match the field definitions described in this article.

Once uploaded, the filename appears along with the count of Uploaded and Excluded events.

After uploading, confirm events reached Meta:

1. 1.
   Open Events Manager → your dataset → Overview.
2. 2.
   Find your manually uploaded actions.
3. 3.
   Check Event Match Quality for uploaded events. If EMQ is <6.0, add more identity fields to your CSV.