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 invalid.

 

  • 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 externalcolumn idformatting please refer tohere the Facebook help website. 

 

  • 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.

 

Required input

user_gender (required)m(male) or f(female)

event_name (required)

string
event_time  (required)

 integer - Unix timestamp

 

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

and at least one user's information (prefix user_) is required 

Other possible inputs

event_id string
custom_valuefloat
custom_currencystring - must be valid  ISO 4217 currency code
user_emailstring
user_phonestring
user_genderstring - must be “m” or “f”
user_date_of_birthstring - “yyyymmdd” eg: “19971226”
user_last_namestring
user_first_namestring
user_citystring
user_statestring
user_zipstring
user_countrystring - lower case two-letter country code, eg. “us”
user_external_id

string - any unique id from advertisers

 

Learn more: about columnexternal formattingid pleasehere

refer

 

to
user_client_ip_address

string

user_client_user_agent

string

user_click_id

string , fbc browser cookie

 

Learn more: about fbc browser cookies here

the
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 helpLead website.Ads here

 

 

 

Data Out

N/A

 

 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