Skip to main content
All CollectionsAffise MMP x Affise PerformanceAPI
Sending events to Affise MMP (S2S)
Sending events to Affise MMP (S2S)
Natalya Yefimenko avatar
Written by Natalya Yefimenko
Updated over 7 months ago

It's a common case that you use a third-party system to store data about the event (registration, purchase, deposit, etc.) happening within the application. These events are not automatically tracked by the MMP, since it tracks the channel from where the users come. All the events users do are tracked in your system.

To send the events to Affise MMP and to the services the MMP integrated with (Facebook, for example, to optimize ad campaigns), use the guide below.


Events sending logic

The events should be sent with the event ID to Affise MMP to further register it in the system.

Events sending method

You need an API key from the API access section to send the request below:

curl --request POST \

--header 'Authorization: Bearer <API-KEY>' \

--header 'Content-Type: application/json' \

--data '{

"affise_device_id": "3d973489-e784-4f5d-8e51-9bee0ac16b00",

"random_user_id": "7ea344d0-643d-4670-8e57-e3b9ecb53a00",

"event": {

"affise_event_id": "780df130-2302-4037-a628-ae087bcb2923",

"affise_event_name": "CustomId03",

"affise_event_timestamp": 1688046085325,

"affise_event_first_for_user": true,

"affise_event_user_data": "any_string",

"affise_event_data": {

"affise_event_custom_id_03": "any_name",

"affise_event_custom_id_{03}_timestamp": 1688046085325

}

}

}'


where:

  • affise_device_id & random_user_id - device identifiers.

  • affise_event_id - uuid new for each event.

  • affise_event_name - see valid values in other documentation, for example AddToCart Purchase.

  • affise_event_timestamp - timestamp send event (millisec or sec).

  • affise_event_first_for_user - default false.

  • affise_event_user_data - any user data as string.

  • affise_event_data - optional and depends on affise_event_name.

minimal works:

curl --request POST \

--header 'Authorization: Bearer <API-KEY>' \

--data '{

"affise_device_id": "3d973489-e784-4f5d-8e51-9bee0ac16b00",

"event": {

"affise_event_name": "CustomId03"

}

}'

curl --request GET \

--header 'Authorization: Bearer <API-KEY>'

🔎 If a user opts out of sharing GAID based on Google's policy, or you can't pass affse_device_id or affise_random_id, you can pass gaid_adid or adid as unique user identifiers.

For example:

curl --request POST \

--header 'Authorization: Bearer <API-KEY>' \

--header 'Content-Type: application/json' \

--data '{

"gaid_adid": "39ae1572-055b-41c9-ba50-87d9e45f47d9",

"event": {

"affise_event_id": "780df130-2302-4037-a628-ae087bcb2923",

"affise_event_name": "CustomId07",

"affise_event_timestamp": 1688046085325,

"affise_event_first_for_user": true,

"affise_event_user_data": "any_string",

"affise_event_data": {

"affise_event_custom_id_07": "any_name"

}

}

}'

or

curl --request POST \

--header 'Authorization: Bearer <API-KEY>' \

--header 'Content-Type: application/json' \

--data '{

"adid": "D8CA4CF9-B475-4FA1-ADEB-8921D2431756",

"event": {

"affise_event_id": "780df130-2302-4037-a628-ae087bcb2923",

"affise_event_name": "StartTrial",

"affise_event_timestamp": 1688046085325,

"affise_event_first_for_user": true

}

}'

Events examples


Purchase event

🔎 adid and gaid_adid are to be defined earlier in the install to deliver events correctly to Facebook (Meta), Google Ads (UAC), TikTok

Max event

curl --request POST \

--header 'Authorization: Bearer <api-key>' \

--header 'Content-Type: application/json' \

--data '{

"affise_device_id": "eb4cfa97-5266-4dea-b807-6a345c3ab900",

"random_user_id": "bd1f6259-3521-45dc-ac48-651b649c1598",

"gaid_adid": "GAID",

"adid": "IDFA",

"event": {

"affise_event_name": "Purchase",

"affise_event_timestamp": 1688046085325,

"affise_parameters": {

"affise_p_content_ids": [123, 789],

"affise_p_content_id": "name",

"affise_p_content_type": "type",

"affise_p_content_list": [{"key": "name"}, {"value": "value"}],

"affise_p_currency": "USD",

"affise_p_quantity": 6,

"affise_p_price": 0.05,

"affise_p_revenue": 0.3

}

}

}'

Min event

curl --request POST \

--header 'Authorization: Bearer <api-key>' \

--header 'Content-Type: application/json' \

--data '{

"affise_device_id": "eb4cfa97-5266-4dea-b807-6a345c3ab900",

"event": {

"affise_event_name": "Purchase",

"affise_parameters": {

"affise_p_currency": "USD",

"affise_p_quantity": 6,

"affise_p_price": 0.05,

"affise_p_revenue": 0.3

}

}

}'


Event with conversion ID

curl --request POST \

--header ‘Authorization: Bearer <api-key>’ \

--header ‘Content-Type: application/json’ \

--data ‘{

“affise_device_id”: “eb4cfa97-5266-4dea-b807-6a345c3ab900",

“event”: {

“affise_event_name”: “Loan”,

“affise_parameters”: {

“affise_p_conversion_id”: “123",

“affise_p_customer_type”: ———,

“affise_p_customer_user_id”: ———

}

}

}’​

🔎 Use the correspondent macros in partner postback:

  • {p_conversion_id}

  • {p_customer_type}

  • {p_customer_user_id}


Please contact the Affise Customer Support team regarding all raised questions via the e-mail: [email protected].

Did this answer your question?