Facebook connection
Overview overview
Activate profiles for your Facebook campaigns for audience targeting, personalization, and suppression based on hashed emails.
You can use this destination for audience targeting across Facebook’s family of apps that are supported by Custom Audiences, including Facebook, Instagram, Audience Network, and Messenger. Selection of the app that you want to run campaign against is indicated at the placement level in Facebook Ads Manager.
Use cases
To help you better understand how and when to use the Facebook destination, here are two sample use cases that Adobe Experience Platform customers can solve by using this feature.
Use case #1
An online retailer wants to reach existing customers through social platforms and show them personalized offers based on their previous orders. The online retailer can ingest email addresses from their own CRM to Adobe Experience Platform, build audiences from their own offline data, and send these audiences to the Facebook social platform, optimizing their advertising spending.
Use case #2
An airline has different customer tiers (Bronze, Silver, and Gold), and wants to provide each of the tiers with personalized offers via social platforms. However, not all customers use the airline’s mobile app, and some of them have not logged on to the company’s website. The only identifiers that the company has about these customers are membership IDs and email addresses.
To target them across social media, they can onboard the customer data from their CRM into Adobe Experience Platform, using the email addresses as identifiers.
Next, they can use their offline data including associated membership IDs and customer tiers to build new audiences that they can target through the Facebook destination.
Supported identities supported-identities
Facebook Custom Audiences supports the activation of identities described in the table below. Learn more about identities.
Supported audiences supported-audiences
This section describes which types of audiences you can export to this destination.
Export type and frequency export-type-frequency
Refer to the table below for information about the destination export type and frequency.
Facebook account prerequisites facebook-account-prerequisites
Before you can send your audiences to Facebook, make sure you meet the following requirements:
-
Your Facebook user account must have full access to the Facebook Business Account which owns the Ad account that you are using.
-
Your Facebook user account must have the Manage campaigns permission enabled for the Ad account that you plan to use.
-
The Adobe Experience Cloud business account must be added as an advertising partner in your Facebook Ad Account. Use
business ID=206617933627973
. See Add Partners to Your Business Manager in the Facebook documentation for details.note important IMPORTANT When configuring the permissions for Adobe Experience Cloud, you must enable the Manage campaigns permission. The permission is required for the Adobe Experience Platform integration. * Read and sign the Facebook Custom Audiences Terms of Service. To do so, go to `https://business.facebook.com/ads/manage/customaudiences/tos/?act=[accountID]&business_id=206617933627973`, where `accountID` is your Facebook Ad Account ID. Make sure the `business_id=206617933627973` section is present in the URL when you sign the Terms of Service.
note important IMPORTANT When signing the Facebook Custom Audiences Terms of Service, make sure to use the same user account that you used to authenticate in the Facebook API.
ID matching requirements id-matching-requirements
Facebook requires that no personally identifiable information (PII) is sent in clear. Therefore, the audiences activated to Facebook can be keyed off hashed identifiers, such as email addresses or phone numbers.
Depending on the type of IDs that you ingest into Adobe Experience Platform, you must adhere to their corresponding requirements.
Phone number hashing requirements phone-number-hashing-requirements
There are two methods to activate phone numbers in Facebook:
- Ingesting raw phone numbers: you can ingest raw phone numbers in the E.164 format into Platform. They automatically hashed upon activation. If you choose this option, make sure to always ingest your raw phone numbers into the
Phone_E.164
namespace. - Ingesting hashed phone numbers: you can pre-hash your phone numbers before ingestion into Platform. If you choose this option, make sure to always ingest your hashed phone numbers into the
Phone_SHA256
namespace.
Phone
namespace cannot be activated in Facebook.Email hashing requirements email-hashing-requirements
You can hash email addresses before ingesting them into Adobe Experience Platform, or use email addresses in clear in Experience Platform, and have Platform hash them on activation.
To learn about ingesting email addresses in Experience Platform, see the batch ingestion overview and the streaming ingestion overview.
If you select to hash the email addresses yourself, make sure to comply with the following requirements:
- Trim all leading and trailing spaces from the email string; example:
johndoe@example.com
, not<space>johndoe@example.com<space>
; - When hashing the email strings, make sure to hash the lowercase string;
- Example:
example@email.com
, notEXAMPLE@EMAIL.COM
;
- Example:
- Ensure that the hashed string is all lowercase
- Example:
55e79200c1635b37ad31a378c39feb12f120f116625093a19bc32fff15041149
, not55E79200C1635B37AD31A378C39FEB12F120F116625093A19bC32FFF15041149
;
- Example:
- Do not salt the string.
Attribute source data is not automatically hashed. When your source field contains unhashed attributes, check the Apply transformation option, to have Platform automatically hash the data on activation.
The Apply transformation option is only displayed when you select attributes as source fields. It is not displayed when you choose namespaces.
Using custom namespaces custom-namespaces
Before you can use the Extern_ID
namespace to send data to Facebook, make sure you synchronize your own identifiers using Facebook Pixel. See the Facebook official documentation for detailed information.
Connect to the destination connect
To connect to this destination, follow the steps described in the destination configuration tutorial. In the configure destination workflow, fill in the fields listed in the two sections below.
The video below also demonstrates the steps to configure a Facebook destination and activate audiences.
Hey everybody. This is Doug. In this video, I want to walk you through the configuration of a social destination in the platform. So here I am in the Destinations interface. And I’ve scrolled to the bottom where we have these social destinations. Now, at the time of this recording, you can see we have a Facebook destination. We have a LinkedIn destination. And actually, if we scroll up to the top. we also have Google Customer Match that is under the Advertising category. But it is configured the same as the social destinations down here. So, in this video, I’m just going to walk through one of them. I’m going to walk through the LinkedIn destination configuration. But you can just use that same example and use it for Facebook or Google Customer Match. Now, before I start clicking through, I will also say that it’s good to have some platform 101 type knowledge, so kind of knowing about the sources and profiles and segments and the schemas of your data that you’re bringing in and the identities that you’re using. These can all come into play as you configure this destination. So, let’s go ahead and select Activate or Configure if it’s the first time through. And again, assuming it’s the first time through, I’m going to select New Account. And I’m going to connect to a destination.
And this jumps me out and have me log in. So, I’ve got my information there, and I will sign in.
So, you can see that it says it’s connected to LinkedIn in this case. And then I’ll just hit Next.
And then I need to do this account authentication. So, this is going to be the name of the account destination here.
And then you’ll want to get your account ID, in this case from LinkedIn. Put it right there. And then choose a marketing action. And so this is where your data governance policies get enforced. So, I’m going to choose the marketing action. And let’s say that I just choose Cross site targeting. And if you have any data governance policies that don’t allow certain data to go to destinations that are using this marketing action, then that will take place here. And then I create the destination.
So, as you can see, that destination is created right there. Now, again, if you’re using one of the other destinations, you’ll still need to authenticate to your advertising account. Each platform will have its own rules. But your ad account just has to be eligible to be integrated with Adobe Experience Platform. And you’ll be able to find the partner-specific requirements in our documentation. So, once you’re authenticated, we’ll go up and click Next. I’ve got a few sample segments here. And so, let’s say that I want to market to my Luma customers with level Gold or Above. I’ll choose that segment. And as you can see, you can choose multiple segments. I’m going to leave it just as that one and click Next.
Now we come to the mapping, which is arguably, the most important part of this configuration, I guess, if there is a most important part. So, we’re going to click and add new mapping here. And what we’re mapping here is really identifiers. So, it’s a good idea to start with the target field. Now, as I click over here, this is going to give me a list of the available or of the supported identifiers for the partner that I have selected. So, in this case for LinkedIn. So, LinkedIn is supporting email with sha256 as well as mobile IDs. So, you can see here. Again, Facebook or Google will have different options available for you here to choose. So, I’m going to select the email and Select. Now we go to the source field and decide where we’re going to get that ID that’s going to match up in LinkedIn. And you have a couple of options here. You have attributes or identity namespace you can select. So, I’m going to do both of them just so you can kind of see the difference. If I select identity namespace, then I can choose either this email here, where it’s already sha256 lowercase, or I can choose email here. And I will just choose this one and select that. And I’m actually going to add one more mapping and choose email again.
And in this source field, and remember that again, in this case the source is the platform, and the target is the destination. We often use the word source to denote places where you’re going to get data coming into the platform, like sources up here. But again, in this case, the source is the platform, because we’re sending data to the destination. So, the source field, in this case, if I use an attribute, I can go to personal email. And let’s say address and select that. And you can see on this one, it has an extra field over here, because, since it’s just an attribute, we don’t really know what format that’s going to be in. And so, we can decide, you know what, in order to get that to be compliant with sha256, we do need to apply the transformation. So, we can select that box. Now depending on the segments that you’ve selected, you might want to even add additional mappings. What if I add maybe another one, that is idfa.
And I can select that. And then I can choose identity namespace here and choose idfa. And then I can do the same thing for Google as well. But this way it’ll look for profiles that have any of those namespaces or attributes in order to send those profiles out for that segment. After that, I just click Next to select a segment schedule. And so, I just select a start date. And then I can click Next And I can see and review everything in here. And then of course I can click Finish, and I’m good to go. I hope this has helped to walk through the process of the configuration of a social destination in the platform. Good luck. - -
Authenticate to destination authenticate
- Find the Facebook destination in the destination catalog and select Set Up.
- Select Connect to destination.
- Enter your Facebook credentials and select Log In.
Fill in destination details destination-details
To configure details for the destination, fill in the required and optional fields below. An asterisk next to a field in the UI indicates that the field is required.
- Name: A name by which you will recognize this destination in the future.
- Description: A description that will help you identify this destination in the future.
- Account ID: Your Facebook Ad Account ID. You can find this ID in your Facebook Ads Manager account. When entering this ID, always prefix it with
act_
.
Enable alerts enable-alerts
You can enable alerts to receive notifications on the status of the dataflow to your destination. Select an alert from the list to subscribe to receive notifications on the status of your dataflow. For more information on alerts, see the guide on subscribing to destinations alerts using the UI.
When you are finished providing details for your destination connection, select Next.
Activate audiences to this destination activate
-
To activate data, you need the View Destinations, Activate Destinations, View Profiles, and View Segments access control permissions. Read the access control overview or contact your product administrator to obtain the required permissions.
-
To export identities, you need the View Identity Graph access control permission.
{width="100" modal="regular"}
See Activate audience data to streaming audience export destinations for instructions on activating audiences to this destination.
In the Segment schedule step, you must provide the Origin of audience when sending audiences to Facebook Custom Audiences.
Mapping example: activating audience data in Facebook Custom Audience example-facebook
Below is an example of correct identity mapping when activating audience data in Facebook Custom Audience.
Selecting source fields:
- Select the
Email
namespace as source identity if the email addresses you are using are not hashed. - Select the
Email_LC_SHA256
namespace as source identity if you hashed customer email addresses on data ingestion into Platform, according to Facebook email hashing requirements. - Select the
PHONE_E.164
namespace as source identity if your data consists of non-hashed phone numbers. Platform will hash the phone numbers to comply with Facebook requirements. - Select the
Phone_SHA256
namespace as source identity if you hashed phone numbers on data ingestion into Platform, according to Facebook phone number hashing requirements. - Select the
IDFA
namespace as source identity if your data consists of Apple device IDs. - Select the
GAID
namespace as source identity if your data consists of Android device IDs. - Select the
Custom
namespace as source identity if your data consists of other type of identifiers.
Selecting target fields:
- Select the
Email_LC_SHA256
namespace as target identity when your source namespaces are eitherEmail
orEmail_LC_SHA256
. - Select the
Phone_SHA256
namespace as target identity when your source namespaces are eitherPHONE_E.164
orPhone_SHA256
. - Select the
IDFA
orGAID
namespaces as target identity when your source namespaces areIDFA
orGAID
. - Select the
Extern_ID
namespace as target identity when your source namespace is a custom one.
Exported data exported-data
For Facebook, a successful activation means that a Facebook custom audience would be created programmatically in Facebook Ads Manager. Audience membership would be added and removed as users are qualified or disqualified for the activated audiences.
Troubleshooting troubleshooting
400 Bad Request error message bad-request
When configuring this destination, you may receive the following error:
{"message":"Facebook Error: Permission error","code":"400 BAD_REQUEST"}
This error occurs when customers are using newly created accounts, and the Facebook permissions are not yet active.
business ID 206617933627973
, as shown in the URL template in the account prerequisites section.If you receive the 400 Bad Request
error message after following the steps in Facebook account prerequisites, allow a few days for the Facebook permissions to come into effect.