Loader Facebook Conversion
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:
- 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.
- 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.
- 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
Learn more: about column formatting please refer to the Facebook help website.
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
|
event_name (required)
|
String, event_name is also used in deduplication.
|
|
event_time (required)
|
Integer, Unix timestamp
Warning: This needs to be earlier than 7 days ago otherwise, the request would be invalid.
|
|
user_gender (required)
|
String, m(male) or f(female)
|
| and at least one user's information (prefix user_) is required |
|
Other possible inputs
|
custom_currency
|
String, must be valid ISO 4217 currency code
|
|
custom_value
|
Float
|
|
event_id
|
String
This ID can be any unique string chosen by the advertiser. event_id is used to deduplicate events sent by both Facebook Pixel and Conversions API. event_name is also used in deduplication.
For deduplication, the eventID from a browser event must match the event_id in the corresponding server event.
Learn more: about event id from here.
|
|
user_browser_id
|
String, fbp browser cookie
Learn more: about fbp browser cookies here
|
|
user_city
|
String
|
|
user_click_id
|
String , fbc browser cookie
Learn more: about fbc browser cookies here
|
|
user_client_ip_address
|
String
|
|
user_country
|
String, lowercase two-letter country code, eg. us
|
|
user_date_of_birth
|
String, “yyyymmdd” eg: 19971226
|
|
user_email
|
String
|
|
user_external_id
|
String, any unique id from advertisers
Learn more: about external id here
|
|
user_facebook_login_id
|
Integer, ID issued by Facebook
Learn more: about ID issued by Facebook here
|
|
user_first_name
|
String
|
|
user_last_name
|
String
|
|
user_lead_id
|
Integer, ID from Facebook’s Lead Ads
Learn more: about ID from Facebook Lead Ads here
|
|
user_phone
|
String
|
|
user_state
|
String
|
|
user_subscription_id
|
String
|
|
user_zip
|
String
|
|
|
Data Out
|
N/A
|
Learn more: about the folder structure here.
Learn more: about even deduplication from here.
Parameters
|
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.
|
