- User Guide
- Integration
- Audience Manager
Sending Audiences to Ad Channels
Create audiences in Airbridge and send their Airbridge Device ID list to ad channels. Audiences are automatically updated and sent to ad channels once a day, ensuring effective targeting and campaign optimization.
Airbridge Device ID
Airbridge Device ID is a Universally Unique ID used to identify devices. As a default, GAID for Android and IDFA for iOS are used. If GAID or IDFA is unavailable due to LAT (Limited Ad Tracking) or ATT (App Tracking Transparency), IDFV or a randomly generated value is used instead.
Airbridge can send audiences to the following ad channels.
Meta ads (facebook.business)
Google Ads (google.adwords)
TikTok For Business (tiktok)
Criteo (criteo_new)
RTB House (rtbhouse)
Appier (appier)
Remerge (remerge)
Persona.ly (personaly)
Some ad channels provide guidelines on the recommended audience size. The audience may not be sent successfully to the ad channel if the size is smaller than the recommended size. For more details, refer to the table below.
Ad Channel | Recommended Size | Reference Material |
|---|---|---|
Facebook Business | 1,000 or more | |
Google Ads | 5,000 or more | |
TikTok | 1000 or more | |
Criteo | 100,000 or more | - |
RTB House | - | - |
Navigate to [Audience]>[Audience Manager] and select the [Audience] tab to see the estimated audience size. The estimated audience size is calculated from a sample of 10% of all users and, therefore, can differ from the actual audience size.
If you want to re-estimate the audience size with fresh data, click the […] icon and click Re-estimate.
To send an audience to an ad channel, you must add a connection. Select the ad channel and ad account to receive the audience and configure the details. Once the connection is successfully added, the audience is immediately sent to the ad channel, followed by daily updates. You can add multiple connections as necessary.
Follow the steps below to add connections and send audiences to ad channels.
When is the audience sent?
As soon as a connection is added to an audience, Airbridge sends the audience through the connection. After that, Airbridge updates audience data and sends it through the connection daily at 4:00 PM (UTC).
1. Navigate to [Audience]>[Audience Manager], select the [Connection] tab and click Create a connection.
2. Select the ad channel you want to create the connection for. Refer to this article to find the list of supported ad channels.
3. Authenticate ad accounts. Depending on the ad channel you’ve selected, you need to log in to your ad account of the ad channel, or you need to enter the necessary credentials provided by the ad channel. Refer to the information below to learn more.
Ad accounts refer to accounts that are used to run current ad campaigns in ad channels. Authentication accounts refer to the accounts that have access to the ad accounts. To create a connection for some ad channels, 1-time login to the authentication account is required.
After selecting the ad channel, log in to the authentication account in the pop-up window. Once logged in, select the ad account you want to configure as the receiving end of the audience sent by Airbridge.
For more details on how to create connections for each ad channel, refer to the information below.
1. After selecting Meta ads from the modal window, log in to your authentication account in the pop-up window. The authentication account must have access to the ad account you want to configure as the receiving end of the connection.
2. Click Continue as your_account.
3. Select Opt in to current Business only and Airbridge. Click Continue.
5. Select Opt in to all current and future Pages. Click Continue.
6. Click Save to grant access to Airbridge.
7. Click Got it to connect your Facebook account with Airbridge.
8. Select the ad account to send audiences. Click Confirm.
1. After selecting Google Ads from the modal window, log in to your authentication account in the pop-up window. The authentication account must have access to the ad account you want to configure as the receiving end of the audience sent by Airbridge. Note that the authentication account must have a Standard or Admin access level.
2. Click Allow to grant access to Airbridge.
3. Select the ad account to send audiences. Click Confirm.
1. After selecting TikTok for Business from the modal window, log in to your authentication account in the pop-up window. The authentication account must have access to the ad account you want to configure as the receiving end of the audience sent by Airbridge.
2. Click Confirm to grant access to Airbridge.
3. Select the ad account to send audiences. Click Confirm.
1. After selecting Criteo from the modal window, log in to your authentication account in the pop-up window. The authentication account must have been assigned the administrator role in the Commerce Growth dashboard.
2. Scroll down in the popup window and click Approve to grant access to Airbridge.
3. Select the ad account to send audiences. Click Confirm.
After selecting the ad channel, enter the credentials into the modal window. For more details on the required credentials for each ad channel, refer to the information below.
Request the following credentials to your RTB House account manager and enter them into the modal window.
Account ID
API Key
Request the following credentials to your Appier account manager and enter them into the modal window.
API Key
Attention
The final path that appears after entering the credentials must be shared with your Remerge account manager. The final path can also be found when clicking Details of the connection in the [Connection] tab.
Request the following credentials to your Remerge account manager and enter them into the modal window.
Client Path
S3 Access Key ID
S3 Secret Access Key
The following credentials are required to create a connection to send audience data to Persona.ly. Request the credentials from Persona.ly. The API Keys are different by platform. You may enter the API Key for only 1 platform or for both to create a connection.
Android API Key
iOS API Key
If you want to send an audience to an ad channel, you need to add a connection to the audience. Follow the steps below.
1. Navigate to [Audience]>[Audience Manager], select the [Audience] tab, and click Add connection of the audience you want to send to an ad channel.
If you want to create a new audience, refer to this article.
2. Select the ad channel you want to send the audience to.
3. Select the connection. If there is no connection you want to select, create a new connection. Depending on the ad channel, the ways to create a new connection differ.
Logging in to the authentication account: Click the Login button below the connection drop-down menu.
Entering credentials: Click Create a connection from the connection drop-down menu.
4. Configure sending details and click Done. The details include:
For Platform, which is only required for certain ad channels, select between Android and iOS to send only either GAIDs or IDFAs.
For Send as, enter the audience name you want to see in the ad channel. The name you have set in Airbridge is automatically entered for your convenience with the
abr-as prefix.User identifier shows the type of identifiers sent to the ad channel. GAID and IDFA are selected by default.
Sending frequency shows the frequency of audience updates to the ad channel. The audience is sent daily at 4:00 PM (UTC).
5. Confirm that the connection is added to the list. The status will change from “Waiting” to “Success” when the audience is sent to the ad channel for the first time. The status update may be subject to a delay of up to 30 minutes, depending on the ad channel.
The audience delivery status can be monitored by audiences and by connections.
Attention
Even though Airbridge successfully sends audiences to ad channels daily at 4:00 PM (UTC), you may have to wait before utilizing the audiences for targeting. This delay occurs because ad channels may require additional time to identify users suitable for targeting from the received audiences.
Select the [Audience] tab and click an audience, or click the […] icon and select Connection to open the side panel.
From the connection list, you can monitor the audience delivery status by the connections the audience is sent. Click […] and select See details to view the connection details. When selecting Delete, Airbridge will no longer send the audience to the ad channel through the connection.
Read on to learn more about the connection status by audience.
Status | Description |
|---|---|
Waiting | Airbridge is preparing to send the audience. |
Success | The audience is being sent successfully, daily at 4:00 PM (UTC). |
Incomplete delivery | The size of the audience received by the ad channel is smaller than the the size of the audience sent by Airbridge. Click the […] icon and select Send again to send the audience manually. |
Invalid auth info | The audience couldn’t be sent due to an authentication error linked to the ad account. Select [Ad Account]>[Action]>[Re-authenticate] to update the authentication credentials and send the audience again. |
Error on the ad channel's side | The audience couldn’t be sent due to an error from the ad channel. Resolve the error in the ad channel’s dashboard and come back to the Airbridge dashboard. Click the […] icon and select Send again to push the audience again. |
Temporary error | The audience couldn’t be sent due to a temporary error. Click the […] icon and select Send again to push the audience again. If this error persists, contact us via [Help]>[Submit a request]. |
In the [Connection] tab, you can see the audience delivery status of all connections. The table also shows the number of audiences being sent through each connection.
If you have configured to send multiple audiences to a single ad account, the connection status of the ad account will show “Failed” even when only one of the audiences fails to be sent. Hover over the status tag to see the description.
Read on to learn more about the connection status by ad account.
Status | Description |
|---|---|
Waiting | Airbridge is preparing to send one or more audiences. |
Success | All audiences are being sent successfully, daily at 4:00 PM (UTC). |
Incomplete delivery | The size of one or more audiences received by the ad channels are smaller than the size of the audiences sent by Airbridge. |
Failed | One or more audiences couldn’t be sent due to an authentication error with the ad account or the personal account linked to the ad account. Or one or more audiences couldn’t be sent due to an error from the ad channel or a temporary error. |
Click the connection to see the list of all audiences sent through the connection and their audience delivery status. To get additional details about each connection, click the […] icon and select See details. If you select Delete, Airbridge will no longer send the audience through the connection.
Note that the status shown in the connection list is the same as the connection status by audience found in the [Connection] tab.
If you encounter issues while sending audiences, follow the instructions below depending on the status tag.
The audience delivery status tag may show “Success,” but the number of users actually sent to the ad channel could be 0. This is because, at the time of audience delivery, no users meet the conditions defining the audience, so the count could be 0.
To resolve the issue, navigate to the [Audience] tab and check the estimated audience size. If the estimated audience size is 0, modify the conditions.
If the estimated audience size is larger than 0, check whether the when clause has been configured as during last 1 day, and the “Include Today” option is checked. With today included, Airbridge may have to sort out users within a very short period of time, from limited data. Note that Airbridge sen audiences daily at 4:00 PM (UTC).
Let’s say the when clause for an audience is set to “during the last 1 day, including today,” and your app time zone is set to “Asia/Seoul,” which is UTC +09:00. In this case, every day, Airbridge has to sort out users who have meet all the set conditions only within the 1 hour-window, between 3:00 PM (UTC) and 4:00 PM (UTC). This increases the likelihood of having no users meeting the set conditions, resulting in an audience with 0 user count even if the connection status shows “Success.”
If the status tag shows “Invalid credentials,” navigate to the [Connection] tab, click the [Action] icon, and select Re-authenticate. Once the authentication credentials are updated, audiences that could not be sent due to invalid credentials will be sent to the ad channel again.
The re-authentication method varies depending on your initial authentication method:
Log in to the authentication account: Log in to a new authentication account that has access to ad accounts.
Enter credentials: Check the credentials and enter them correctly again.
If your audience couldn’t be sent to specific ad channels due to “Invalid credentials,” read the information below before re-authenticating.
Make sure that the audience complies with the Meta Advertising Standards.
To view audiences in Meta Ads Manager, select the [Audiences] tab from the left menu bar.
Make sure you have enabled 2-step verification in your Google Ads account, under [Admin]>[Access and security]>[Security].
Make sure that the ad account has a Standard or Admin access level in your Google Ads account, under [Admin]>[Access and security]>[Users].
To view audiences in your Google Ads dashboard, navigate to [Tools]>[Shared library]>[Audience manager].
If the status tag shows “Error in ad channel,” resolve the error in the ad channel first.
Then, come back to Airbridge and navigate to the [Audience] tab, find the audience with the status tag “Error in ad channel,” click the […] icon and select [Connection]. Then, click the […] icon and select Send again. The audience is sent again as soon as you select Send again.
The connection status will change from “Waiting” to “Success” when the audience is successfully sent to the ad channel.
If your audience couldn’t be sent to specific ad channels due to an “Error on the ad channel's side,” read the information below before sending the audience again.
Make sure you have agreed to Meta’s Customer List Custom Audiences Terms in Meta Ads Manager.
Make sure the audiences viewable in Meta Ads Manager are ready to be used.
To view audiences in Meta Ads Manager, select the [Audiences] tab from the left menu bar.
If the connection status shows “Incomplete delivery” or “Temporary error,” navigate to [Connection] or click an ad account in the [Ad account] tab. Click the […] icon, and select Send again to push the audience again. The audience is pushed again as soon as you select Send again.
The connection status will change from “Waiting” to “Success” when the audience is successfully sent to the ad channel.
If your audience couldn’t be sent to specific ad channels due to a “Temporary error,” read the following before pushing the audience again.
Check if the audience complies with Google Ads’ policy; if not, consult directly with Google Ads. To view audiences in your Google Ads dashboard, navigate to [Tools]>[Shared library]>[Audience manager].
Was this page helpful?