Postbacks
Returns postback data for a specific date range.
Request format
GET https://api.appmetrica.yandex.ru/logs/v1/export/postbacks.{csv | json}
? application_id=<int>
& date_since=<string>
& date_until=<string>
& fields=<string>
& [limit=<int>]
& [use_utf8_bom=<bool>]
& [<any field name>=<string>]
|
Filtering by the app's numeric ID in AppMetrica |
|
Start of the date range in |
|
End of the date range in |
|
A comma-separated list of fields for the sample. A list that contains all available fields (for quick copy):
|
|
Limit on the number of items in the list. Takes the maximum value by default. There is no guarantee that results will match from request to request (there may be differences in results sorting). |
|
Parameter that enables the use of byte order mark. The default value is |
|
Filtering by the value of one of the available fields. Only the equality check operation is supported. |
Response format
If all available fields are requested:
{
"data": [
{
"application_id": "integer",
"attributed_touch_type": "string",
"click_datetime": "string",
"click_id": "string",
"click_ipv6": "string",
"click_timestamp": "integer",
"click_url_parameters": "string",
"click_user_agent": "string",
"publisher_id": "integer",
"publisher_name": "string",
"tracker_name": "string",
"tracking_id": "integer",
"install_datetime": "string",
"install_ipv6": "string",
"install_timestamp": "integer",
"match_type": "string",
"appmetrica_device_id": "integer",
"device_locale": "string",
"device_manufacturer": "string",
"device_model": "string",
"device_type": "string",
"google_aid": "string",
"oaid": "string",
"ios_ifa": "string",
"ios_ifv": "string",
"os_name": "string",
"os_version": "string",
"windows_aid": "string",
"app_package_name": "string",
"app_version_name": "string",
"conversion_datetime": "string",
"conversion_timestamp": "integer",
"event_name": "string",
"attempt_datetime": "string",
"attempt_timestamp": "integer",
"cost_model": "string",
"notifying_status": "string",
"postback_url": "string",
"postback_url_parameters": "string",
"response_body": "string",
"response_code": "integer"
},
...
]
}
application_id,ios_ifa,os_name,...
1111,024AE7EB-4128-4237-9803-D24950323D4D,ios,...
1111,3A86D5E8-1985-4A23-B147-5A1C0CF8781E,ios,...
1111,,android
...
|
Unique numeric identifier for the application in AppMetrica. |
|
Ad interaction type: |
|
Date and time of the click/impression in |
|
ID of the click/impression or |
|
IP address at the time of the click/impression in IPv6 format. For example: 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147. |
|
Time of the click/impression in Unix time format, in seconds. |
|
Parameters as they are shown in the URL. Special characters must be escaped (for example, |
|
User-agent of the click/impression. |
|
ID of the AppMetrica publisher. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0. |
|
Name of the AppMetrica partner. If unattributed postbacks are enabled for the tracker, the field value will be empty. |
|
Name of the tracker being added to the AppMetrica interface If unattributed postbacks are enabled for the tracker, the field value will be empty. |
|
ID of the AppMetrica tracker. You may use it to identify the publisher in AppMetrica reports. If unattributed postbacks are enabled for the tracker, the field value will be 0. |
|
Date and time of the installation in |
|
The IP address at the time of the installation in IPv6 format (for example, 2a02:6b8::40c:6676:baff:fea6:53d8, ::ffff:5.255.232.147). |
|
Time of the installation in Unix time format, in seconds. |
|
Attribution method: |
|
A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV. |
|
The language on the device. |
|
The device manufacturer detected by the AppMetrica service (for example, Apple or Samsung). |
|
The device model detected by the AppMetrica service (for example, Galaxy S6). |
|
The device type detected by the AppMetrica service. Possible values: |
|
The device's Google AID in the format received from the device. |
|
The device's Huawei OAID in the format received from the device. |
|
The device's IFA in the format received from the device. |
|
IFV for the app in the format received from the device. |
|
Operating system on the user's device: |
|
The version of the operating system on the user's device. |
|
The device's Windows AID in the format received from the device. |
|
The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro). |
|
The app version in the format specified by the developer. |
|
Date and time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in |
|
Time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in Unix time format. |
|
Name of the event (as passed to the SDK). |
|
Date and time of sending in yyyy-mm-dd hh:mm:ss` format. |
|
Time of sending in Unix time format. |
|
Postback type. Possible values: |
|
The status of the postback sending ( |
|
Full Postback URL. |
|
Postback URL parameters as shown in the URL. For example, |
|
Data received from the server. |
|
HTTP code for sending the postback. |
Example
Request:
curl -X GET \
'https://api.appmetrica.yandex.ru/logs/v1/export/postbacks.json?application_id=1111&date_since=2018-10-10&date_until=2018-10-11&fields=application_id,attributed_touch_type,click_datetime,click_id,click_ipv6,click_timestamp,click_url_parameters,click_user_agent,publisher_id,publisher_name,tracker_name,tracking_id,install_datetime,install_ipv6,install_timestamp,match_type,appmetrica_device_id,device_locale,device_manufacturer,device_model,device_type,google_aid,oaid,ios_ifa,ios_ifv,os_name,os_version,windows_aid,app_package_name,app_version_name,conversion_datetime,conversion_timestamp,event_name,attempt_datetime,attempt_timestamp,cost_model,notifying_status,postback_url,postback_url_parameters,response_body,response_code' \
-H 'Authorization: OAuth oauth_token'
Response:
{
"data": [
{
"application_id": "1111",
"attributed_touch_type": "click",
"click_datetime": "yyyy-mm-dd hh:mm:ss",
"click_id": "f2ae4254de8844dda58b29cac2cf0e87",
"click_ipv6": "::ffff:5.255.232.147",
"click_timestamp": "1556258660",
"click_url_parameters": "click_id=f2ae4254de8844dda58b29cac2cf0e87&c=1234&google_aid=&google_aid_sha1=&google_aid_md5=&ios_ifa=&ios_ifa_sha1=&ios_ifa_md5&click_timestamp=1554824136&afpub_id=&site_id=&creative_id=&goal_id1=&goal_id2 ",
"click_user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1 Mobile/15E148 Safari/604.1",
"publisher_id": "39",
"publisher_name": "AdColony",
"tracker_name": "Advertising iOS campaign",
"tracking_id": "12345678901234567890",
"install_datetime": "yyyy-mm-dd hh:mm:ss",
"install_ipv6": "::ffff:5.255.232.147",
"install_timestamp": "1556258660",
"match_type": "fingerprint",
"appmetrica_device_id": "123456789012345678",
"device_locale": "ru_RU",
"device_manufacturer": "Apple",
"device_model": "iPhone X",
"device_type": "phone",
"google_aid": "",
"oaid": "",
"ios_ifa": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ios_ifv": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"os_name": "ios",
"os_version": "12.2",
"windows_aid": "",
"app_package_name": "ru.yandex.metro",
"app_version_name": "1.0",
"conversion_datetime": "yyyy-mm-dd hh:mm:ss",
"conversion_timestamp": "1556258660",
"event_name": "New person",
"attempt_datetime": "yyyy-mm-dd hh:mm:ss",
"attempt_timestamp": "1556258660",
"cost_model": "cpi",
"notifying_status": "sent",
"postback_url": "https://adcolony.servecvr.com/?transaction_id=f2ae4254de8844dda58b29cac2cf0e87",
"postback_url_parameters": "transaction_id=f2ae4254de8844dda58b29cac2cf0e87",
"response_body": "SUCCESS",
"response_code": "200"
}
]
}
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.