Sending custom object records to a program

Push your linked custom object records to a listener step in either a contact or custom object program. Using custom object record services, you can trigger your custom object to send new linked records when as they are created, or send existing records when there are changes to the record field values.

Note: You must create a program and activate it before you can send custom object records to it.

Before you begin:

  • Create the custom object program on the program canvas and add a listener step to the program. The listener step will listen for new or modified custom object records pushed by the custom object's record services. Be sure to give the listener step a descriptive name to make it easier to identify.

To send linked custom object records to a program:

  1. Navigate to Audience An image of the Audience icon. then select Custom Objects.
  2. Open the custom object you want to work with.
  3. Click Custom Object, then select Custom Object Record Services.

    The Manage Services page opens.

    An image of the Manage Services window.

    To trigger a push, you can add a processing step to one of two record services:

    • New Data: Checks the custom object for any new records that are registered.
    • Modified Data: Checks for any changes to the field values of existing records.
  4. Click either New Data or Modified Data drop-down arrow, then select Edit Service Actions.
  5. Click Add Processing Steps.
  6. Select Add to Step in Program from the Step drop-down list and add a description.

    An image of the Add Processing Step window highlighting the A single processing step selection

  7. Click Add.

    The processing step then opens in a new Edit Processing Step configuration window.

  8. Select Constant as the Source Type and select Custom Object as the Value.
  9. In the Conditional Parameters section, select Constant as the Source Type. Select the program listener step as the Value.

    An image of the Edit Program Listener page highlighting the settings for a custom object program

  10. Select one of four options to determine if, when, and how This Processing Step Gets Executed:
    • Always: This step always executes.
    • Only if the following Condition is met: This step executes when your conditions are met. You'll need to select the field and configure the desired values.
    • When the following Data Lookup criteria Is / Is Not met: This step executes when specific data lookup condition is met. You'll need to add and edit lookup criteria.
    • Never: This step never executes. Select this option to disable the step without deleting it.
  11. Save your changes and return to the Manage Service page.
  12. Click the drop-down next to New Data or Modified Data (whichever of the two that you configured in previous steps), and select Enable Custom Object Record Services.

    An image of the Manage Service page highlighting the Enable Custom Object Record Service option

After you enable the custom object record services, Open the listener step in your program, and click View Sources to verify the custom object as a source. The name of the custom object will be listed under the Active tab.

An image of the Active tab

Learn more

Data sources for listeners

Custom objects

Managing custom object record services