Get a demoLog inAcademyDevelopers
More docs

Meta ads

Overview

The Meta Ads connector allows you to integrate Meta’s advertising capabilities into Bird. With this connector, you can create and manage audiences, fetch ad campaigns, and send ad events directly from Bird.

Key Features

  • Manage Audiences: Retrieve, create, update, and sync custom audiences.

  • Fetch Campaign Data: Access ad campaigns, adsets, and ads.

  • Lead Management: Retrieve leads generated from ads.

  • Ad Event Notifications: Send messaging-related events to Meta using the Conversions API.

Installation

To install the Meta Ads connector, follow these steps:

  1. Navigate to Integrations: Go to the "Integrations" section within Bird.

  2. Select Meta Ads: Locate and select "Meta Ads" from the available connectors.

  3. Click Install: Begin the installation process.

  4. Log in to Facebook: Authenticate your Facebook account. Ensure you have admin permissions for your Facebook Marketing account.

  5. Grant Permissions: Approve the required permissions for Bird to access your Meta Ads account.

  6. Complete Setup: After authorising, the Meta Ads connector will be available for use in Bird workflows.

Supported Actions

Audience Management

  • Check Audience: Retrieve information about a specific audience.

  • Get Audience: Retrieve all audiences linked to the account.

  • List Custom Audiences: Retrieve a list of custom audiences.

  • Create Custom Audience: Create a new custom audience.

  • Add to Custom Audience: Add users to a custom audience.

  • Remove from Custom Audience: Remove users from a custom audience.

  • Sync Custom Audience: Sync a custom audience with the connected Facebook page.

Ad Campaign Data

  • Fetch Me: Retrieve information about the authenticated user.

  • Fetch Campaigns: Retrieve a list of ad campaigns.

  • Fetch Adsets: Retrieve adsets for a campaign.

  • Fetch Ads: Retrieve ads under an adset.

  • Fetch Leads: Retrieve leads generated by an ad.

  • Populate Info: Populate information about an ad campaign.

Event Notifications

  • Send Ad Events: Notify Meta of specific messaging-related events via the Conversions API.

Sending Ad Events

Overview

The "Send Ad Event" action allows you to notify Meta of messaging-related conversion events, such as leads or sales generated via WhatsApp, Messenger or Instagram. These events are sent using the Conversions API and can be configured within a Bird flow.

Supported Event Types

The Conversions API for business messaging events supports the following events:

  • Purchase

  • LeadSubmitted

  • InitiateCheckout

  • AddToCart

  • ViewContent

  • OrderCreated

  • OrderShipped

Refer to Meta’s Conversions API Business Messaging Documentation for detailed event parameter requirements.

Using the Send Ad event action

  1. Add the "Send Ad Event" Action

    • Drag and drop the "Send Ad Event" step into your Bird flow.

  2. Enter the Dataset ID

    • Input the dataset ID provided by Meta to identify the data source for the events.

  3. Select the Event Name

    • Choose the appropriate event name from the dropdown (e.g., Lead, Message Sent, etc.).

  4. Set the Channel Slug

    • Specify the channel where the event occurred (e.g., WhatsApp, Messenger, Instagram).

  5. Add User Data

    • Include the necessary user data fields as an object.

      • For Messenger add:

        • page_id: ID of the page where the event occurred.

        • page_scoped_user_id: User ID scoped to the page.

      • For WhatsApp add:

        • whatsapp_business_account_id: ID of the WhatsApp Business Account.

        • ctwa_clid: Click-to-WhatsApp tracking ID.

      • For Instagram add:

        • instagram_business_account_id: ID of the Instagram Business Account.

        • ig_sid: Instagram session ID.

  6. Add Custom Data (Optional)

    • Provide additional event-specific data as key-value pairs, such as:

      • currency: Currency used for the transaction.

      • value: Transaction value.

  7. Save and Test

    • Save the configuration and run a test to ensure the event is correctly sent to Meta.

Example Configuration

Here’s an example of how to configure the "Send Ad Event" action:

  • Dataset ID: 12333

  • Event Name: Purchase

  • Channel Slug: WhatsApp

  • User Data:

    • whatsapp_business_account_id: <WHATSAPP_BUSINESS_ACCOUNT_ID>

    • ctwa_clid: ARAkLka8rmFleiCkTEJQ-QTWrRiyYHAFDLMNDBH0CD3apjd0HR4irJ6LEkR7JwFF4XvnO2E4

  • Custom Data:

    • currency: USD

    • value: 123

When executed, this data is securely sent to Meta, allowing for efficient tracking of messaging-related conversions.

For more information, visit Meta’s Conversions API Documentation.

Last updated