"Send Custom Event" node

You can use the Send Custom Event node to transmit any event to Facebook. As a result, you’ll be able to create an analysis in Facebook or create a new Custom Audience based on those events.

Prerequisites


Node configuration


  1. Click the node.
  2. Click Select connection.
  3. From the dropdown list, select the connection.
    If you haven’t established a connection yet, see Create a connection.

Create a connection

After you generate a system access token in Facebook, use it a node to establish a connection.

  1. At the bottom of the Select connection dropdown list, click Add connection.
  2. In the Access token field, enter the app access token from Facebook.
    Note: You can read more about access tokens in Facebook documentation.
  3. Click Next.
  4. In the Connection name field, enter the name for the access token you generated.
  5. Click Apply.
    Result: A connection is created and selected.

Define the integration settings

A blank configuration form in Send Custom Event (Facebook)
A blank configuration form in Send Custom Event (Facebook)
Note: Fields marked with the Snippet icon icon accept snippets or inserts. This integration allows usage of profile-related inserts.
  1. In the Graph API version field, enter the currently used Facebook API version.
    You can find information about the currently used API version in the Facebook documentation.
  2. In the Meta Pixel field, enter the identifier of the Pixel you use in Facebook.
    You can find information about how to find the ID of the Pixel in the Facebook documentation.
  3. In the Event data field, enter your event body. Different types of events may require different data in the request body. Refer to Facebook developer documentation.
    Note: Read the article about the Automation inserts.
  4. Confirm by clicking Apply.
Note: You can find response from integration requests in facebook.sendCustomEvent event.

Test integration


You can run a test request. If the request body contains a dynamic reference to a profile attribute and/or an event data from preceding nodes, then you can define the context using test profile data.

Note: Complete description of the feature is available in Testing outgoing integrations.
  1. In the Test integration section, click Send test request.
    Result: A test request builder opens. If:
    • a request body contains dynamic references, the request preview appears after you select the context of test profiles and events.
    • a request body contains static data, the preview of the body request appears immediately.
    An empty test request builder
    An empty test request builder
  2. If your request contains dynamic references (otherwise, the options aren’t available):
    • From the Test profile dropdown, select a test profile in the context of whom the test request will be performed.
    • From the Event context dropdown list, you can select a particular occurrence of an event whose values/information will be used for the test request.
      1. Select a test profile.
        Result: A history of test profile events appears.
        A stream of events of a test profile
        A stream of events of a test profile
      2. From the list of events, select one whose data you want use as a context. If there is no event you can use, in the upper-right corner of the pop-up, click Define own event and provide the body of the event.
      3. Confirm by clicking Apply.
  3. Verify the request body. If there is someting you want to change, come back to the node settings from previous steps.
  4. If the request body is ready to test, in the upper-right corner, click Send request.
    Result: The response section appears and the Update response event button becomes active.
  5. Optionally, you can update response event with new parameters by clicking Update response event in the upper-right corner.

Example of use


For an example of use refer to our use case.

😕

We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

😉

Awesome!

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

Close modal icon Placeholder alt for modal to satisfy link checker