### General Install Postback Examples for Android and iOS

Source: https://support.appsflyer.com/hc/pt/articles/207273946

These examples illustrate the structure of general installation postbacks for both Android and iOS platforms. They include common parameters like site_id, advertising_id/idfa, android_id, and install_time. These are fundamental for tracking app installs.

```android
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)
```

```ios
http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)
```

--------------------------------

### General Installation Postback Examples

Source: https://support.appsflyer.com/hc/pt/articles/207273946-Available-Macros-on-AppsFlyer-s-Postbacks

Provides sample installation postback URLs for both Android and iOS platforms.

```APIDOC
## General Installation Postback Examples

### Description
Provides sample installation postback URLs for both Android and iOS platforms.

### Android Example

```
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)
```

### iOS Example

```
http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)
```
```

--------------------------------

### Sample Installation Postbacks

Source: https://support.appsflyer.com/hc/pt/articles/207273946-Macros-de-postback-para-ad-networks

Provides general examples of installation postbacks for both Android and iOS platforms.

```APIDOC
## Sample Installation Postbacks

### Description
General examples of installation postbacks for Android and iOS platforms.

### Android
```
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)
```

### iOS
```
http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)
```
```

--------------------------------

### General Install Postback - iOS

Source: https://support.appsflyer.com/hc/pt/articles/207273946-Available-Macros-on-AppsFlyer-s-Postbacks

Example of a general installation postback URL for iOS devices. It includes parameters such as publisher ID, device IP, IDFA, and install timestamp.

```url
http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)
```

--------------------------------

### General Install Postback - Android

Source: https://support.appsflyer.com/hc/pt/articles/207273946-Available-Macros-on-AppsFlyer-s-Postbacks

Example of a general installation postback URL for Android devices. It includes common parameters like publisher ID, advertising ID, Android ID, and install timestamp.

```url
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)
```

--------------------------------

### GET /api/adnets-data/v1/export/blocked_installs_report/app/{app_id}

Source: https://support.appsflyer.com/hc/pt/articles/115004745523-Protect360-for-integrated-partners

Retrieves a report of blocked installs for a given application ID. This report includes installations identified as fraudulent.

```APIDOC
## GET /api/adnets-data/v1/export/blocked_installs_report/app/{app_id}

### Description
Retrieves a report of blocked installs for a given application ID. This report includes installations identified as fraudulent.

### Method
GET

### Endpoint
`/api/adnets-data/v1/export/blocked_installs_report/app/{app_id}`

### Parameters
#### Path Parameters
- **app_id** (string) - Required - The unique identifier of the application.

#### Query Parameters
- **from** (string) - Required - The start date for the report (YYYY-MM-DD).
- **to** (string) - Required - The end date for the report (YYYY-MM-DD).
- **additional_fields** (string) - Optional - Comma-separated list of additional fields to include in the report (e.g., `keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type`).

### Request Example
```curl
curl --location --request GET 'https://hq1.appsflyer.com/api/adnets-data/v1/export/blocked_installs_report/app/{app_id}?from={2020-07-10}&to={2020-07-20}&additional_fields=keyword_id,store_reinstall,deeplink_url,oaid,blocked_reason,blocked_reason_value,blocked_reason_rule,blocked_sub_reason,match_type,device_category,gp_referrer,gp_click_time,gp_install_begin,amazon_aid,keyword_match_type' \
-H 'Authorization: Bearer {V2.0 api token placeholder. Note: The token has more than 700 characters.}'
```

### Response
#### Success Response (200)
- **data** (array) - Contains the report data.
- **app_id** (string) - The application ID.
- **date** (string) - The date of the record.
- **blocked_reason** (string) - The reason for the block.
- **blocked_sub_reason** (string) - The sub-reason for the block.
- **match_type** (string) - The type of match.
- **device_category** (string) - The category of the device.
- **gp_referrer** (string) - Google Play referrer information.
- **gp_click_time** (string) - Google Play click time.
- **gp_install_begin** (string) - Google Play install begin time.
- **amazon_aid** (string) - Amazon Advertising ID.
- **keyword_id** (string) - Keyword ID.
- **store_reinstall** (boolean) - Indicates if it's a store reinstall.
- **deeplink_url** (string) - Deeplink URL.
- **oaid** (string) - Open Advertising ID.
- **blocked_reason_value** (string) - The value associated with the blocked reason.
- **blocked_reason_rule** (string) - The rule that caused the block.

#### Response Example
```json
{
  "data": [
    {
      "app_id": "1234567890",
      "date": "2020-07-15",
      "blocked_reason": "Fraudulent Install",
      "blocked_sub_reason": "Bot Traffic",
      "match_type": "Exact",
      "device_category": "Mobile",
      "gp_referrer": "some_referrer",
      "gp_click_time": "2020-07-15T10:00:00Z",
      "gp_install_begin": "2020-07-15T10:05:00Z",
      "amazon_aid": null,
      "keyword_id": "kw123",
      "store_reinstall": false,
      "deeplink_url": null,
      "oaid": null,
      "blocked_reason_value": "High Click Volume",
      "blocked_reason_rule": "Rule 1"
    }
  ]
}
```
```

--------------------------------

### General Install Postback - iOS

Source: https://support.appsflyer.com/hc/pt/articles/207273946-Macros-de-postback-para-ad-networks

This is a sample URL for an iOS install postback. It includes parameters such as site_id, device_ip, idfa, and install_time, essential for tracking app installations on the iOS platform.

```url
http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install_unix_ts)


```

--------------------------------

### Protect360 - Fake Installs Details

Source: https://support.appsflyer.com/hc/pt/articles/213223166-Master-API-customized-aggregate-data-API

Get details on fake install blocking within Protect360, including blacklisted site IDs and counts of blocked bots and anomalies.

```APIDOC
## GET /websites/support_appsflyer_hc_pt_articles

### Description
Retrieves detailed metrics related to fake install blocking by Protect360. This includes data on blacklisted site IDs and counts of blocked bots and behavioral anomalies.

### Method
GET

### Endpoint
`/websites/support_appsflyer_hc_pt_articles?metric=[METRIC_NAME]`

### Parameters
#### Query Parameters
- **metric** (string) - Required - The specific fake install detail metric. Examples:
  - `blocked_installs_siteid_blacklist`
  - `post_attribution_installs_siteid_blacklist`
  - `blocked_installs_bots`
  - `post_attribution_installs_bots`
  - `blocked_installs_behavioral_anomalies`
  - `post_attribution_installs_behavioral_anomalies`
  - `blocked_installs_install_validation`

### Request Example
```
GET /websites/support_appsflyer_hc_pt_articles?metric=blocked_installs_bots
```

### Response
#### Success Response (200)
- **[METRIC_NAME]** (integer or array) - The value of the requested Protect360 fake install detail metric.

#### Response Example
```json
{
  "blocked_installs_bots": 150
}
```
```

--------------------------------

### Example afParameters Configuration for Media Source

Source: https://support.appsflyer.com/hc/pt/articles/4413588932241-OneLink-Smart-Script-V2-setup

Illustrates a sample configuration object for the 'media source' parameter within `afParameters`. It specifies input keys, a default value, and value overrides for custom attribution tracking.

```json
{
  "keys": ["incoming_mediasource", "utm_source"],
  "defaultValue": "any_source",
  "overrideValues": {
    "twitter": "twitter_int",
    "orig_src": "new_src"
  }
}
```

--------------------------------

### General Install Postback - Android

Source: https://support.appsflyer.com/hc/pt/articles/207273946-Macros-de-postback-para-ad-networks

This is a sample URL for an Android install postback. It includes common parameters like site_id, advertising_id, android_id, and install_time, which are used to track app installations originating from various sources.

```url
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)

```