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>]

application_id*

Filtering by the app's numeric ID in AppMetrica

date_since*

Start of the date range in yyyy-mm-dd hh:mm:ss format.

date_until*

End of the date range in yyyy-mm-dd hh:mm:ss format.

fields*

A comma-separated list of fields for the sample.

A list that contains all available fields (for quick copy):

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,os_name,os_version,windows_aid,app_package_name,app_version_name,conversion_datetime,conversion_timestamp,event_name,attempt_datetime,attempt_timestamp,cost_model (postback_type),notifying_status,postback_url,postback_url_parameters,response_body,response_code

limit

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).

use_utf8_bom

Parameter that enables the use of byte order mark. The default value is false.

<any field name>

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
...

application_id

Unique numeric identifier for the application in AppMetrica.

attributed_touch_type

Ad interaction type: click | impression | unknown.

click_datetime

Date and time of the click/impression in yyyy-mm-dd hh:mm:ss format.

click_id

ID of the click/impression or '' (an empty string if the ID is not available).

click_ipv6

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.

click_timestamp

Time of the click/impression in Unix time format, in seconds.

click_url_parameters

Parameters as they are shown in the URL. Special characters must be escaped (for example, ?param1=1&param2=2... will look like ?param1%3D1%26param2%3D2... in the request).

click_user_agent

User-agent of the click/impression.

publisher_id

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.

publisher_name

Name of the AppMetrica partner. If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracker_name

Name of the tracker being added to the AppMetrica interface If unattributed postbacks are enabled for the tracker, the field value will be empty.

tracking_id

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.

install_datetime

Date and time of the installation in yyyy-mm-dd hh:mm:ss.

install_ipv6

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).

install_timestamp

Time of the installation in Unix time format, in seconds.

match_type

Attribution method: fingerprint | referrer | identifier | '' (empty string).

appmetrica_device_id

A unique device identifier detected by the AppMetrica service. In Android from AppSetId, in iOS from IFV.

device_locale

The language on the device.

device_manufacturer

The device manufacturer detected by the AppMetrica service (for example, Apple or Samsung).

device_model

The device model detected by the AppMetrica service (for example, Galaxy S6).

device_type

The device type detected by the AppMetrica service. Possible values: phone | tablet | unknown.

google_aid

The device's Google AID in the format received from the device.

oaid

The device's Huawei OAID in the format received from the device.

ios_ifa

The device's IFA in the format received from the device.

ios_ifv

IFV for the app in the format received from the device.

os_name

Operating system on the user's device: ios | android | windows.

os_version

The version of the operating system on the user's device.

windows_aid

The device's Windows AID in the format received from the device.

app_package_name

The package name for Android, or the Bundle ID for iOS (for example, ru.yandex.metro).

app_version_name

The app version in the format specified by the developer.

conversion_datetime

Date and time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in yyyy-mm-dd hh:mm:ss format.

conversion_timestamp

Time of the event (for CPA postback), installation (for CPI postback), or re-engagement (for CPR postback) in Unix time format.

event_name

Name of the event (as passed to the SDK).

attempt_datetime

Date and time of sending in yyyy-mm-dd hh:mm:ss` format.

attempt_timestamp

Time of sending in Unix time format.

cost_model

Postback type. Possible values: cpi (installation) | cpa (event) | cpr (re-engagement).

notifying_status

The status of the postback sending (failed | sent). The same postback may appear multiple times in the response if sending failed.

postback_url

Full Postback URL.

postback_url_parameters

Postback URL parameters as shown in the URL. For example, param1=1&param2=2....

response_body

Data received from the server.

response_code

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.

Contact support