Meta Dataset - noti.vn icon

Meta Dataset - noti.vn

Send events to Facebook Conversions API

Send Event

AI-generated

Summary

Send a conversion event to a specified Facebook Dataset via the Facebook Conversions API using provided dataset ID and access token, including detailed user, custom, and attribution data.

Inputs

  • Dataset ID (required) — Facebook Dataset ID from your Events Manager to which the event will be sent.
  • Access Token (required) — Facebook API Access Token with ads_management permissions for authorizing the request.
  • Event Name (required) — Type of Facebook event to send (e.g., Purchase, AddToCart, or a custom event).
  • Custom Event Name — Name of the event when 'Custom Event' is selected as the Event Name.
  • Action Source (required) — Origin of the event such as website, email, app, business messaging, etc.
  • Messaging Channel — Messaging channel used if Action Source is 'business_messaging' (Facebook Messenger, Instagram Direct, WhatsApp).
  • Event Time (required) — Unix timestamp for when the event occurred, defaults to current time.
  • User Data — Collection of user identifiers and attributes (email, phone, name, location, and Facebook-specific IDs) automatically hashed as needed.
  • Custom Data — Additional event details such as value, currency, content IDs, order ID, search string, or event status.
  • Attribution Data — Advertising attribution information including campaign, ad set, and ad IDs plus attribution share.
  • Advanced Options — Extra options including test event code, event source URL, and opt-out flag for tracking.

Output shape

a list with a single item containing JSON with success status, event details sent, response info, and any error messages

The response includes details about the number of events accepted by Facebook, any messages returned, and a Facebook trace ID. On failure, error messages and trace IDs are included. If 'continueOnFail' is enabled, errors accumulate in output instead of throwing exceptions.

Discussion