Important Update about Required Parameters for the Facebook Conversions Connector

[Tony_Taliaferro]

Beginning February 15th, 2021, website events that are shared using the Facebook Conversions API require additional parameters to remain operational. This notification describes the new parameters and how to configure them using your Facebook Conversions connector.

About

The new parameters for the Facebook Conversions connector are intended to improve the quality of events used for ad delivery and campaign performance. These parameters are required and must be added to your current Facebook Conversions connector configuration in order for the connector to remain operational.

In addition to ensuring the new parameters are added and configured, Tealium recommends checking the following items throughout your Facebook Conversions connector configuration:

• action sources
• website events
• URLs sent
• User Agent attributes sent

What's New

The following new parameters are now available in the connector marketplace for the Facebook Conversions connector and must be added and configured before February 15, 2021:

Web

• client_user_agent
  • Required if the Action Source is set to website.
  • The user agent for the browser corresponding to the event.
  • EventStream
    If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the attribute User Agent in EventStream.
  • AudienceStream
    If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the vistor's last User Agent in AudienceStream.
  • Customer Information Parameters (Facebook Documentation).

• action_source
  
  • Required.
  • This field allows you to specify where your conversions occurred.
  • Valid action sources are:
    • email
    • website
    • app
    • phone_call
    • chat
    • physical_store
    • system_generated
    • other
  • Server Event Parameters (Facebook Documentation).
• event_source_url
  
  • Required if the Action Source is set to website.
  • The browser URL where the event happened.
  • EventStream
    If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the attribute Current URL in EventStream.
  • AudienceStream
    If the Action Source is set to website and this field is not mapped, it will automatically be mapped to the attribute Last Event URL in AudienceStream.
  • Server Event Parameters (Facebook Documentation).

Non-Web

• action_source
  
  • Required.
  • This field allows you to specify where your conversions occurred.
  • Valid action sources are:
    • email
    • website
    • app
    • phone_call
    • chat
    • physical_store
    • system_generated
    • other
  • Server Event Parameters (Facebook Documentation).

For detailed information about using and configuring the Facebook Conversions connector, see the Facebook Conversions Connector Setup Guide.