Ampush is a Facebook Marketing Partner.

Module partners can use additional and extended data from adjust, and have been integrated with a custom module in adjust's backend. This guide describes how to activate the Ampush module, as well as additional set up that may be required or beneficial.

To integrate Ampush with adjust, follow these steps:

  1. Activate the module by adding one or more tokens in the Ampush panel in your dashboard.
  2. Toggle the Session Forwarding switch to ON to start sending session callbacks to Ampush.
  3. Optionally, add event labels to your in-app events in your Ampush panel to send in-app events to Ampush.
  4. Make sure that any campaigns you wish to manage with Ampush include the required keyword, ampush.
  5. All set - adjust will transmit the requisite data to Ampush.

1Activating the Ampush module

All settings related to Ampush can be found in your dashboard. Simply open your app settings and follow through to Partner Setup > Add Partners > Ampush.

To activate the integration, enter your Advertiser Name within this panel. You can find the required values in your Ampush dashboard.

Once activated, adjust will automatically start sending install, reattribution and (when activated) event and session callbacks to Ampush.

1.1Forwarding events & revenue to Ampush

You can also choose to transmit in-app events to Ampush. Each in-app event can be activated separately, so as to give you complete control of the data that you're sharing with your partners.

  1. Open the Ampush panel in your app settings.
  2. Select Event Linking and enter a name for each event you want to transmit to Ampush. This is the name that will be shown in their interface. You can use the same names as you do in adjust, if you wish.
    If you want to transmit all events to Ampush with the same names as you have set up in adjust, you can hit the "Fill all with event names" button.
    You also have the option use the same name for multiple events. If you do decide on doing this, it will result in those events displaying as a single event type in the Ampush interface.
  3. If you also want to send associated revenues to Ampush, you can activate Revenue Forwarding by flicking the corresponding switch above to "ON". To forward revenues, you have to activate event forwarding for at least one of your revenue events.
  4. As soon as you save these updated settings, adjust will start transmitting the in-app events that you have configured.

1.2List of parameters transmitted to Ampush

Ampush require certain parameters to be passed to them via their module. When you activate their module, the following parameters will be automatically transmitted.

  • Facebook campaign IDs and names
  • Timestamps (rounded to the nearest hour)
  • Impression Based flag
  • Random number
  • Revenue data (if you activate it)

2Filtering Facebook traffic to Ampush

Ampush only receives data on filtered Facebook traffic. This is designed so that you can manage your Ampush Facebook traffic separately from other Facebook campaigns that you might be running.

Only Facebook campaigns that are named to include the keyword ampush will be transmitted to Ampush. That is, you must include the keyword in the campaign name of each campaign that you want to manage with Ampush. Campaigns that do not include the keyword will not be transmitted to Ampush.