Overview
The Conversion API aims to link advertisers' marketing data (such as website events, app events, business message events, and offline conversions) from their own servers, website platforms, mobile applications, or CRMs with a meta system that can optimize ad targeting, reduce cost-per-result, and measure ad performance.
getting Started
Required parameters
Parameter name | type | describe |
|---|---|---|
Meta Pixel | STRING | Facebook/Meta Pixel ID, used to uniquely identify your advertising account and website tracking. How to obtain: View in the Meta "Event Manager": 1. Enter the "Event Manager" 2. Select "Data Source" 3. Find the pixel ID on the "Overview" page |
Meta Pixel Access Token | STRING | Facebook/Meta pixel access token for API call authentication. How to obtain: Generate in the Meta "Event Manager": 1. Enter the "Event Manager" 2. Select "Data Source" 3. Enter the "Settings" page 4. Click "Generate Access Token" For details, please refer to this link - Access Password |
Using Meta Offline Conversions
In the CDP backend, add a Meta Offline Conversions destination for the source, configure all parameters, set the status to enabled, and save.
Tracking Identifier
fbp | Browser ID |
fbc | Click number |
lead_id | Potential customer number |
page_id | Public Homepage Number |
page_scoped_user_id | Public Homepage Scope User ID |
whatsapp_business_account_id | WhatsApp business account + ctwa_clid combination |
ctwa_clid | WhatsApp direct access to ad number |
Instagram business account ID | Instagram business account ID + ig_sid combination |
ig_sid | Instagram direct link to ad number |
anon_id | Your Installation ID. This field represents a unique application installation instance. Note: This parameter only applies to app events. |
Madid | Your mobile advertiser ID, Android device's ad ID, or Apple device's ad identifier (IDFA). |
event
The destination supports the transformation of the following events, along with the corresponding event parameters. The list provides the mapping relationship between Meta and TTO CDP events.
Meta Platform Events | CDP Standard Events | describe |
|---|---|---|
Add payment details | AddPaymentInfo | Someone added a payment profile during the checkout process. Content Ids | Contents | Currency | Amount |
Add to cart | AddToCart | Add items to cart Type | Content Ids | Contents | Currency | Amount |
Add to wishlist | AddToWishlist | Add items to your wish list Content Ids | Contents | Currency | Amount |
Sign Up | SignUp | When a user completes a registration form or subscription Currency | Amount |
Contact | Contact | Contact your company via phone, text message, email, chat room, or other means. |
Qualified Lead | QualifiedLead | Submit a form or register for a trial |
Lead | Lead | Submit a form or register for a trial |
Start Checkout | BeginCheckout | The user entered the checkout process but did not complete it. Quantity | Content Ids | Contents | Currency | Amount |
Converted Lead | ConvertedLead | The time required to assess potential customer conversion and closing (i.e., completing a purchase). |
Purchase | Purchase | Someone completed the purchase or checkout process. Quantity | Content Ids | Contents | Currency | Amount |
Schedule | Schedule | A user schedules a visit to one of your branch offices. |
Donate | Donate | User donations to your organization or cause |
Start Trial | StartTrial | Start a free trial of a product or service Estimated Lifetime | Currency | Amount |
Submit your application | SubmitForm | Users need the products, services, or programs you provide. |
subscription | Subscribe | Paid subscription to products or services provided by users |
Imported Lead | ImportedLead | Potential customers for business style messages Source | Channel | Customer Parameters | Custom Parameters |
Order Created | OrderCreated | Business style message inquiry and order creation Source | Channel | Customer Parameters | Custom Parameters |
Order shipped | OrderShipped | Business inquiry order has been sent. Source | Channel | Customer Parameters | Custom Parameters |
Conversion effect
Meta recommends uploading events in real time for optimal results.
Meanwhile, the event time (event_time) is strictly limited to 7 days; otherwise, an error message is returned.
