ePrivacy and GPDR Cookie Consent by Cookie Consent Skip to main content

Loader Facebook Conversion API

Overview

This component adds events to the Facebook Conversion API.

Requirements

To use the Facebook loader, one needs to authorize the Facebook account. Authorization can be done in 2 ways:

  1. The user who has access to an Ad account in Facebook Business Manager and has access to Audiences click on the “Authorize” button in the same browser where one logged in in his Facebook Ad account.
  2. Authorization link can be copied by an analyst working in Meiro Integrations and sent for authorization to a person who has the required level of access and should open the link in the same browser where one logged in in his Facebook Ad account.
  3. Users would then have to set up a Facebook pixel with conversion API.

    Learn more: How to set up a Facebook pixel with conversion API here.


    Learn more: How to verify that the events have been received on Facebook here.

 

 Data In/Data Out

Data In

CSV for events should be located in /data/in/tables/imports.csv

Data Out

N/A

The structure of the input data are as follows: 

Required Input

  • user_gender are m(male) or f(female)
  • event_name
  • event_time 
  • and at least one of user information (prefix user_) is required.
 
  • event_name | string
  • event_time | integer - Unix timestamp

Warning: This needs to be earlier than 7 days ago otherwise the request would be invalidinvalid.

 

  • event_id | string
  • custom_value | float
  • custom_currency | string - must be valid  ISO 4217 currency code
  • user_email | string
  • user_phone | string
  • user_gender | string - must be “m” or “f”
  • user_date_of_birth | string - “yyyymmdd” eg: “19971226”
  • user_last_name | string
  • user_first_name | string
  • user_city | string
  • user_state | string
  • user_zip | string
  • user_country | string - lower case two-letter country code, eg. “us”
  • user_external_id | string - any unique id from advertisers

    Learn more: about external id here

  • user_client_ip_address | string
  • user_client_user_agent | string
  • user_click_id | string - _fbc browser cookie

    Learn more: about fbc browser cookies here

  • user_browser_id | string - _fbp browser cookie

    Learn more: about fbp browser cookies here

  • user_subscription_id | string
  • user_facebook_login_id | integer - ID issued by Facebook

    Learn more: about ID issued by Facebook here

  • user_lead_id | integer - ID from Facebook’s Lead Ads

    Learn more: about ID from Facebook Lead Ads here

Warning: Requests to Facebook Conversion API are sent in batches of 1000 events, if any given event in a batch is invalid, the entire batch will be rejected.

Learn more: about column formatting please refer to the Facebook help website. 

 Learn more: about the folder structure here.

 

Parameters

1.png

Pixel_ID (required)

This is the Pixel ID of the Facebook Pixel you created. Conversion API events will be sent to this Pixel. 

Learn more: about Facebook Pixel with Conversion API here