How to integrate conversion tracking through Server to Server connection

1. Go to Aidem Ads.

2. In the left-hand side menu section select “Integrations”.

   

3. In the newly opened window in the top right corner click “New Integration”.

   

4. Afterwards you should see the new integration dialog where you should enter the following setup options:

   1. Integration name – unique name to help your team identify the integration.

      

   2. Advertiser selection – advertiser under which this integration should be implemented.

      

   3. Integration - please select Conversion API.

      

5. After all the data is entered please click “Next” button.

   

6. In the next step you should be able to see the Aidem Conversion API Authorization token, either copy the token from the textarea or click “Copy to Clipboard” button.

   

7. Use the above mentioned token as Authorization Bearer Token header when sending requests to Aidem.

8. Create JSON payload with all the information which you would like to pass. Here is a list of required fields:
   a) timestamp - utc timestamp.
   b) event_type - specific event type (supported event types can be found below).
   c) payload.email - customer email address.

   Copy{
       "timestamp": UTC_TIMESTAMP_GOES_HERE,
       "event_type": "EVENT_TYPE_GOES_HERE",
       "payload": {
         "email": "EMAIL_GOES_HERE",
         "first_name": "FIRST_NAME_GOES_HERE",
         "last_name": "LAST_NAME_GOES_HERE",
         "phone_number": "PHONE_NUMBER_GOES_HERE",
         "address": {
           "address_line_1": "ADDRESS_LINE_1_GOES_HERE",
           "address_line_2": "ADDRESS_LINE_2_GOES_HERE",
           "city": "CITY_GOES_HERE",
           "state": "STATE_GOES_HERE",
           "zip": "ZIP_GOES_HERE",
           "country": "COUNTRY_GOES_HERE"
         },
         "order_id": "ORDER_ID_GOES_HERE",
         "currency": "CURRENCY_GOES_HERE",
         "price": PRICE_GOES_HERE,
         "units": UNITS_GOES_HERE
       }
   }
   

9. It is very important to notice that the majority of payload fields are optional, however passing as many of them as possible greatly increases the conversion match rate, so we highly recommend to pass as much information.

10. After the JSON is created and all the fields are filled in with the necessary information it can be sent to our server using POST HTTP method to the following endpoint: https://webhook.aidemsrv.com/conversion/api.

Example

Copycurl --header "Content-Type: application/json" \
  --header "Authorization: Bearer YOUR_TOKEN_CREATED_IN_STEP_6_GOES_HERE" \
  --request POST \
  --data '{"timestamp":1752667603,"event_type":"Purchase","payload":{"email":"test@aidem.com","first_name":"Aidem","last_name":"Ads","phone_number":"+1 (415) 555-0198","address":{"address_line_1":"1234 Elm Street","address_line_2":"","city":"San Francisco","state":"CA","zip":"94107","country":"USA"},"order_id":"123456","currency":"USD","price":100,"units":2}}' \
  https://webhook.aidemsrv.com/conversion/api

Supported Event Types