Help Center

| Submit or View Help Requests | Developer Docs |
| |

Enable Action Inquiry Event Notification Postbacks as a Partner

If you want to receive real-time notifications whenever action inquiries are created or resolved, you can set up an Action Inquiry Event Notification.

Set up action inquiry postbacks

Now that you know all about our postback system, let's get your postbacks set up. This section will cover creating action inquiry postbacks for your entire account.

  1. From the left navigation bar, select [Menu]→ Settings.

  2. Under Technical, select Event Notifications.

  3. Next the Action Inquiry Events, select [Edit].

  4. Enter your server's URL. This is the URL to which impact.com will send postbacks.

  5. Select your preferred HTTP method.

    • If you select POST, you will then enter the body of the request. Below is an example of how you might want to map each data point for a JSON format. The keys in each key-value pair should be sourced from your own system’s setup, and the values will be your chosen coinciding data point that impact.com provides and should be entered in brackets { }.

    • View some of impact.com's available body parameters.

    • Don't see a value you need? Reach out to your Publisher Account Manager (or contact support).

  6. Select the Body Format that matches your setup in Step 5a.

  7. Select Action Inquiry Events . These settings are optional.

    • Enter a Minimum Delay between when an event happens and when the postback is generated and sent to your system.

    • Enter a rate limit for the Maximum Requests impact.com can make to your system per second.

    • Enter what you want the Success Response to a postback to be.

    • Enter what you want the Error Response to a postback to be.

  8. Select Save.

Now that you have action inquiry postbacks set up, your system should begin receiving postbacks whenever an inquiry is created by your account or resolved by a partnered brand. To learn how to test your new postback setup, view the Test an action inquiry postback section below.

Test an action inquiry postback

Once you set up action inquiry postbacks, you should test your setup. Make sure you notify your partnered brand that you'll be testing your postback setup.

  1. From the top navigation menu, select Content → Assets.

  2. Find an asset, then, under Actions, select Get Ad code. A new window will appear.

  3. Next to Sub ID and Shared ID, select Edit.

  4. Ensure there is at least one word in each field, then select Save.

    • You can skip steps 3 and 4 if you already have values in these fields.

  5. At the bottom of the new window, select Tracking Link → Copy Code.

  6. Paste the link into a fresh browser window.

  7. Complete the action.

    • This action will ultimately be reversed.

  8. After about 15 minutes, find the action on the Pending Actions screen. You'll need some pieces of information to generate an action inquiry in-app:

    • The brand associated with your test action.

    • The action's Order ID.

    • The action's Sale Amount.

    • The action's Transaction Date.

  9. Create a new action inquiry in impact.com. In the Notes section, mention this is a test inquiry.

    • Learn how to create an inquiry via the UI.

    • After doing so, you should receive a postback letting you know an action inquiry was created. If you see the new inquiry on the Inquiries screen but have not received a postback yet, double-check your postback setup.

  10. Provide your partnered brand with the Order ID associated with the inquiry and ask them to Decline the inquiry.

    • When the brand declines the inquiry, you should receive another postback informing you of the inquiry's resolution. If you see the inquiry update on the Inquiries screen but have not received a postback yet, double-check your postback setup.

Warning

If you cannot find any issues with your postback setup but are still not receiving them, contact support. We can check if postbacks are being generated, what the response code for them is, as well as the body for each postback. This information might help you successfully debug your setup.

FAQs

For more information on what event notifications are and how action inquiry postback work, and more, view our Action Inquiry Event Notification Postbacks FAQ for Partners article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.