Facebook / Meta Ads

Facebook / Meta Ads is a digital advertising platform offered by Meta, allowing businesses to create and display ads on the Facebook, Instagram, Messenger, WhatsApp, and other Meta platforms. Advertisers can target specific demographics, interests, behaviors, and locations, and choose various ad formats like images, videos, and carousels to reach their desired audience. The platform provides detailed performance metrics, enabling advertisers to measure the effectiveness of their campaigns and make data-driven optimizations.

Features

Feature nameSupported
Column HashingTrueField level
BlockingTrueField level
IncrementalTrue
Custom dataTrue
HistoryFalse
ReSyncTrueTable level
TemplatesTrue

Data Schema

Meta APIs Scopes

The Weld App asks for the following scopes when setting up the integration:

  • ads_read
  • ads_management
  • business_management

๐Ÿ”ง Setup Guide - ELT

Step 1 - Begin Configuration

  1. In the connector setup form, enter the destination schema name of your choice.
  2. Click Authorize to allow Weld to access your Meta account using OAuth. You will be redirected to your Meta account.

Step 2 - Approve and finalize

  1. Approve Weld to access your Meta account.
  2. When authorization is complete, you will be redirected back to the Weld connections overview. The configuration is complete.

Step 3 - Connection Settings

  1. Select all the Meta Ads accounts that you would to sync data from.
  2. Limit historical data to only sync data after the selected date to only include that data in the initial sync.

Step 4 - Data To Sync

  1. Select the pre-built reports you wish to include in the sync.
    You can view the schema, remove columns or hash sensitive information.
  2. Custom Reports : Create your customized Meta Ads reports tailored to your specific requirements. By defining dimensions, breakdowns, fields, and other criteria, you can extract actionable insights from your advertising data.

Step 5 - Configure Sync

  1. Select how often you would like the data to sync.
  2. Provide a unique destination table name.

Weld will take over from here and commence syncing data from your Meta Ads account.


๐Ÿ“ˆ Data Modelling

  1. Access Data Post-Sync: Once the initial synchronization is complete, your Meta Ads data is available for querying in the SQL editor within Weld's Data Transform.
  2. Find Meta Ad Tables: In Transform, expand the facebook_ads folder under Data Sources to see available tables.
  3. Explore Table Schema: Click on a table to view its schema and understand the structure and type of data.
  4. Create SQL Queries: Begin a new page in Transform to start crafting your SQL queries.
  5. Utilize AI Assistance: For help with queries, click the icon to talk to Ed Ed Logo, our AI Assistant, and input details about your querying needs.
  6. Save and Organize Queries: Save your refined queries in a specific folder for future reference.

For additional information on data Transform or SQL tips, you can refer to our SQL Tutorial.

๐Ÿ“‚ Table Summary

Weld supports data replication of both object and report Meta Ads data.

  • Objects

    • Description: Objects represent the structural and operational setup of an advertising entity. This includes configurations, targeting settings, and relationships with other entities in the advertising ecosystem.
    • Example: ad_group
  • Reports

    • Description: Reports focus on the performance metrics and results of the entity. They provide detailed data about how well the entity is performing on a daily basis.
    • Example: ad_group_report

Objects Overview

  • Core Entities: Essential to Meta Ads, representing foundational data. Provides information on what the entity is and how it is set up:
    • Advertisers
    • Campaign
    • Ad Group
    • Ad

Reports Overview

  • Performance Metrics: Includes detailed metrics and statistics for reporting on Ads, Ad Groups, and Campaigns. Indicate how well the entity is performing, based on various performance metrics.
  • Granularity: Data availability is detailed, offered on a daily and hourly basis.
  • Additional Reporting Dimensions: Reports can also be created based on Country, Language, Age, Gender, and Platform.

Custom Report Builder

Our custom report builder allows you to create personalized Meta Ads reports tailored to your specific requirements. By defining dimensions, breakdowns, fields, and other criteria, you can extract actionable insights from your advertising data. Here's how to use it:

Fields

  1. Name:

    • Description: Specifies the name of the report.
    • Input Type: Text
    • Requirement: Mandatory
    • Example: "Ad conversions"
  2. Required dimensions:

    • Description: Define the necessary dimensions that should be part of the report. These dimensions represent the primary categorization of data.
    • Input Type: Dropdown
    • Requirement: Mandatory
    • Default: Date
  3. Action breakdown (0/10):

    • Description: Break down actions (like conversions) by specific types or sources. For example, breaking down link clicks by device type.
    • Input Type: Multi-select (up to 10 selections allowed)
    • Requirement: Optional
    • Example: action_type, action_device
  4. Breakdowns (0/24):

    • Description: Additional ways to segment the data in your report. This provides a more granular view.
    • Input Type: Multi-select (up to 24 selections allowed)
    • Requirement: Optional
    • Example: Age, Gender, Location
  5. Fields (0/76):

    • Description: Choose the specific metrics and attributes you want to include in the report.
    • Input Type: Multi-select (up to 76 selections allowed)
    • Requirement: Optional but recommended
    • Example: Impressions, Clicks, Spend, CTR
  6. Level:

    • Description: Define the granularity of the data. Meta's ad structure consists of Campaigns -> Ad Sets -> Ads. Decide at which hierarchy level you want to pull the data.
    • Input Type: Dropdown
    • Options: Campaign, Ad Set, Ad
    • Requirement: Mandatory
  7. Action Report Time:

    Description: This field determines the time window in which actions, either "Impressions" or "Conversions," are attributed to your ad after being viewed or clicked. It's crucial for understanding the effectiveness and latency of your ads.

    Options:

    1. Impressions:

      • Description: Choosing this option means that your report will attribute actions based on when a user viewed your ad.
      • Use Case: This is beneficial for campaigns that aim to raise awareness. Even if a user doesnโ€™t immediately interact with the ad, seeing the ad might influence their behavior later.
    2. Conversions:

      • Description: Selecting this option attributes actions based on when a user clicked on your ad and then took a desired action, like making a purchase.
      • Use Case: This is especially pertinent for direct response campaigns where the aim is to drive immediate action, such as sign-ups, purchases, or downloads.

    Choosing the Right Option: The best choice between "Impressions" and "Conversions" largely depends on your custom report objectives. By Default this value is set to "Impressions", however if you are looking for specific conversion values such as action values, converted product value or purchase ROAS then "Conversions" would be advised.

๐Ÿ”ง Troubleshooting:

  1. Report Validation Failed: Ensure all mandatory fields have been filled.
  2. No Data in Report: Some combinations of breakdowns and fields might result in empty datasets. Try broadening your selections or changing the report "Level".
  3. Remember that certain combinations of breakdowns and fields may yield no data or may not be supported. Experiment with different configurations to find the most valuable insights.

๐Ÿ“Š SQL Templates

Get started with Facebook/Meta Ads SQL Templates

Get inspiration on how to model your data, with our collection of foundational SQL templates we have battle-tested at Weld. All the templates work out of the gate with the Weld data integrations for Meta Ads.


๐Ÿ“ˆ Marketing Core Metrics

You can integrate the following connectors with your Facebook/Meta Ads data to create a comprehensive marketing dashboard using Weld and our Marketing Core Metrics:

To use these prebuilt models, simply click on any of these connectors in the Data Sources section of your account, and select Marketing Metrics.


๐Œญ Staging Models

facebook_ads_ad_report
facebook_ads_converstion_insights facebook_ads_marketing_report


๐Ÿ”ง Setup Guide - Reverse ETL

Meta reverse ETL allows you to sync data on a schedule from your Weld App automatically into a custom audience user list in Meta.

Step 1 - Destination

  1. In the Reverse ETL section, , select + Add Reverse ETL Sync
  2. Select Facebook Ads on the list of connectors
  3. Give the connector a name
  4. Select the Authentication Method as:
  • OAuth: This is the recommended method for most users, as it allows Weld to access your Meta account securely.
  • ** System User**: Suitable for agencies or users managing multiple accounts, this method requires a system user token.
  1. Click Authorize if you selected OAuth, or enter your system user token if you selected the System User method and click Connect.
  2. When authorization is complete, you will be redirected back to the Weld connections overview. The configuration is complete.

Step 2 - Target Details

You will need to select where you would like to send your data. Select:

  • Ad Account: The Meta Ads account where you want to send the data.
  • Custom Audience: The specific custom audience within the ad account that you want to update with the synced data.

Step 3 - Map Data

  1. Select the source data model that you would like to sync to Facebook Ads. This can be a table or a view from your data warehouse.
  2. Select the destination object you would like to sync to. In Facebook Ads, this is typically user.
  3. You will be presented with several options to configure your sync, which we will go through in the next steps.

Sync Mode

Choose how you want to sync data from your source model to the destination object. Depending on the destination object, you might have only one or multiple of the following options available:

  • Upsert: Updates existing records and inserts new ones.

Field Mapping

Map the fields from your source model to the fields in Facebook Ads. You can map the fields manually or use the auto-mapping feature to match fields based on their names. Ensure that the fields you map correspond to the properties in Facebook Ads.

Step 4 - Schedule

After you finished the steps above, click on Next to proceed to the scheduling step. Here you can choose how often you would like the sync to run:

  • Independent: The sync will run on its own schedule, independent of other syncs.
  • Orchestration: The sync will be part of an orchestration workflow, allowing you to run it in conjunction with other tasks.

Step 5 - Finalise and Run

After you have configured the sync, click on Start Sync to finalize the setup. The sync will perform the initial run immediately.

Was this page helpful?