--- title: Custom measurement integration guide description: This guide explains how to structure your URLs correctly for installs and in-app events and details all the required and optional parameters for each event type. --- [Skip to content](https://helpcenter.mobileaction.co/en/custom-measurement-integration#main-content) [![MobileAction Logo](https://helpcenter.mobileaction.co/hs-fs/hubfs/logo_black_medium-1.png?width=145&height=48&name=logo_black_medium-1.png)](https://www.mobileaction.co/) - [Website](https://www.mobileaction.co/) - [Help Center](https://helpcenter.mobileaction.co/en) Open main navigation Close main navigation - [Website](https://www.mobileaction.co/) - [Help Center](https://helpcenter.mobileaction.co/en) Advice and answers from the MobileAction Team - There are no suggestions because the search field is empty. 1. [Help Center](https://helpcenter.mobileaction.co/en?hsLang=en) 2. [Integrations](https://helpcenter.mobileaction.co/en/integrations?hsLang=en) 3. [SearchAds.com Integrations](https://helpcenter.mobileaction.co/en/integrations?hsLang=en#searchads-com-integrations) # Custom measurement integration guide To set up a custom integration, you’ll first need to create and configure a postback URL that securely sends your event data directly to our platform. This guide explains how to structure your URLs correctly for installs and in-app events and details all the required and optional parameters for each event type, helping you smoothly integrate your custom measurement solution with our platform. ### Install postback URL parameters These are the parameters expected in the install-level postback: | Name | Parameter | Required? | Description | Example Value | Apple Ads Attribution API Equivalent | Apple Ads Attribution API v4 IDs | | --- | --- | --- | --- | --- | --- | --- | | Device Type | `deviceType` | ✅ If possible | The type of device that triggered the event | iPhone, iPad | - | - | | Organization ID | `orgId` | ✅ If possible | Your campaign group's unique ID | 5555555 | `orgId` | `iad-org-id` | | App ID | `trackId` | ✅ Yes | The ID of your app on the App Store | 123456789 | - | - | | Country Code | `countryCode` | ✅ If possible | Country based on user’s IP address | US, UK, etc. | - | - | | Country/Region | `countryRegion` | ✅ If possible | Country selected for the campaign | US, UK, etc. | `countryOrRegion` | `iad-country-region` | | Campaign ID | `campaignId` | ✅ Yes | Apple Ads Campaign ID | 448876249 | `campaignId` | `iad-campaign-id` | | Ad Group ID | `adgroupId` | ✅ Yes | Apple Ads Ad Group ID | 258876905 | `adgroupId` | `iad-adgroup-id` | | Ad ID | `adId` | ✅ If possible | Apple Ads Creative ID | 12345678 | `adId` | `iad-ad-id` | | Keyword | `keyword` | ✅ If possible | Keyword that triggered the ad | games | - | `iad-keyword` | | Keyword ID | `keywordId` | ✅ If possible | Apple Ads Keyword ID | 84567829 | `keywordId` | `iad-keyword-id` | | Match Type | `keywordMatchType` | ✅ If possible | Type of keyword match | Exact; Broad; Search Match | - | `iad-keyword-matchtype` | | Install Time | `installTimestamp` | ✅ Yes | Timestamp of the install in seconds | 1590161787 | - | - | | Reattribution | `reattribution` | Optional | Is reattributed data | 0 or 1 | - | - | | Conversion Type | `conversionType` | Optional | Type of install: download or redownload | download | `conversionType` | `iad-conversion-type` | | Claim Type | `claimType` | Optional | Method of attribution: click or impression | click | `claimType` | - | ### Install postback format Use the  HTTP method: **GET** and include the provided API key. **URL template:** ``` https://attrs.searchads.com/api/postbacks/custom/installs/{api_key}?deviceType={device_type}&orgId={org_id}&trackId={app_id}&countryCode={country_code}&countryRegion=country_or_region}&campaignId={campaign_id}&adgroupId={ad_group_id}&adId={ad_id}&keyword={keyword}&keywordId={keyword_id}&keywordMatchType={keyword_match_type}&installTimestamp={install_time_stamp}&reAttribution={re_attribution}&conversionType={conversion_type}&claimType={claim_type} ``` **Example URL:** ``` https://attrs.searchads.com/api/postbacks/custom/installs/abcEfg1b644d?deviceType=iPhone&orgId=116750&trackId=id1105855019&countryCode=US&countryRegion=ES&campaignId=372373519&adgroupId=371423499&adId=7412457&keyword=game&keywordId=12455643&keywordMatchType=Exact&installTimestamp=1589560389&reAttribution=0&claimType=Click ``` ### In-app event postback parameters After the install, you may want to track specific in-app actions like purchases or sign-ups. These are the required parameters for sending in-app event postback: | Name | Parameter | Required? | Description | Example Value | Apple Ads Attribution API Equivalent | Apple Ads Attribution API v4 IDs | | --- | --- | --- | --- | --- | --- | --- | | Device Type | `deviceType` | ✅ If possible | The type of device that triggered the event | iPhone, iPad | - | - | | Organization ID | `orgId` | ✅ Yes | Your campaign group's unique ID | 5555555 | `orgId` | `iad-org-id` | | App ID | `trackId` | ✅ Yes | The ID of your app on the App Store | 123456789 | - | - | | Country Code | `countryCode` | ✅ If possible | Country based on user’s IP address | US, UK, etc. | - | - | | Country/Region | `countryRegion` | ✅ If possible | Country selected for the campaign | US, UK, etc. | `countryOrRegion` | `iad-country-region` | | Campaign ID | `campaignId` | ✅ Yes | Apple Ads Campaign ID | 448876249 | `campaignId` | `iad-campaign-id` | | Ad Group ID | `adgroupId` | ✅ Yes | Apple Ads Ad Group ID | 258876905 | `adgroupId` | `iad-adgroup-id` | | Ad ID | `adId` | ✅ If possible | Apple Ads Creative ID | 12345678 | `adId` | `iad-ad-id` | | Keyword | `keyword` | ✅ If possible | Keyword that triggered the ad | games | - | `iad-keyword` | | Keyword ID | `keywordId` | ✅ If possible | Apple Ads Keyword ID | 84567829 | `keywordId` | `iad-keyword-id` | | Match Type | `keywordMatchType` | ✅ If possible | Type of match used | Exact; Broad; Search Match | - | `iad-keyword-matchtype` | | Install Time | `installTimestamp` | ✅ Yes | Timestamp of the install in seconds | 1590161787 | - | - | | Event Time | `eventTimestamp` | ✅ Yes | Timestamp of the event (e.g., purchase) in seconds | 1590161237 | - | - | | Event Name | `eventName` | ✅ Yes | Name of the event | Purchase, Subscription etc. | - | - | | USD Revenue | `usdRevenue` | ✅ If possible | Revenue in USD | 9.99 | - | - | | Original Revenue | `origRevenue` | ✅ If possible | Original revenue | 25.45 | | | | Currency | `currency` | ✅ If possible | Original ISO 4217 currency code | EUR | - | - | | Reattribution | `reattribution` | Optional | Is reattributed data | 0 or 1 | - | - | | Conversion Type | `conversionType` | Optional | Type of conversion: download or redownload | Download; Redownload | `conversionType` | `iad-conversion-type` | | Claim Type | `claimType` | Optional | Attribution method: click or impression | Click Impression | `claimType` | - | **Note:** You can choose to provide either the **USD revenue** or the **original revenue along with its currency code**. If you send the original currency, the team will handle the conversion on our end. This approach also allows you to view metrics in both **USD and the original currency** within your dashboard, supporting a more localized and flexible reporting experience. ### **In-app postback URL format** Use the  HTTP method: **GET** and include the provided API key. **URL template:** ``` https://attrs.searchads.com/api/postbacks/custom/events/{api_key}?deviceType={device_type}&orgId={org_id}&trackId={app_id}&countryCode={country_code}&countryRegion={country_or_region}&campaignId={campaign_id}&adgroupId={ad_group_id}&adId={ad_id}&keyword={keyword}&keywordId={keyword_id}&keywordMatchType={keyword_match_type}&installTimestamp={install_time_stamp}&eventTimestamp={event_time_stamp}&eventName={event_name}&usdRevenue={usd_revenue}&origRevenue={orig_revenue}¤cy={currency}&reAttribution={re_attribution}&conversionType={conversion_type}&claimType={claim_type} ``` **Example in-app postback:** ``` https://attrs.searchads.com/api/postbacks/custom/events/abcEfg1b644de32349?deviceType=iPhone&orgId=116750&trackId=id1105855019&countryCode=US&countryRegion=ES&campaignId=372373519&adgroupId=371423499&adId=7412457&keyword=game&keywordId=12455643&keywordMatchType=Exact&installTimestamp=1589560389&eventTimestamp=1589560889&eventName=purchase&usdRevenue=35.97&origRevenue=33.45¤cy=EUR&reAttribution=0&claimType=Click ``` If you need support while setting up your custom integration, feel free to contact your Customer Success Manager or reach out to us directly via live chat. We’re here to help! - [Quick Guide to MobileAction](https://helpcenter.mobileaction.co/en/quick-guide-to-mobileaction?hsLang=en) - [MobileAction CMP](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#main-content) - [Apple Ads Integration](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#apple-ads-integration) - [AI Assistant](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#ai-assistant) - [Overview](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#overview) - [Ads Manager](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#ads-manager) - [Automations](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#automations) - [CPP A/B Testing](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#cpp-a-b-testing) - [AI Keyword Planner](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#ai-keyword-planner) - [AI Smart Bidding](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#ai-smart-bidding) - [Budget Allocation](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#budget-allocation) - [Benchmarks](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#benchmarks) - [Market Finder](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#market-finder) - [MMP Integration](https://helpcenter.mobileaction.co/en/mobileaction-cmp?hsLang=en#mmp-integration) - [ASO Intelligence](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#main-content) - [Metadata Optimizer](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#metadata-optimizer) - [App Update Timeline](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#app-update-timeline) - [Creative Monitoring](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#creative-monitoring) - [Localization](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#localization) - [Keyword Tracking](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#keyword-tracking) - [Competitor Keywords](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#competitor-keywords) - [Keyword Inspector](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#keyword-inspector) - [Keyword Trends](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#keyword-trends) - [Keyword Translator](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#keyword-translator) - [Organic CPP Results](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#organic-cpp-results) - [ASO Report](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#aso-report) - [Visibility Report](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#visibility-report) - [Download Share](https://helpcenter.mobileaction.co/en/aso-intelligence?hsLang=en#download-share) - [Store Analytics](https://helpcenter.mobileaction.co/en/store-analytics?hsLang=en#main-content) - [Revenue Snapshot](https://helpcenter.mobileaction.co/en/store-analytics?hsLang=en#revenue-snapshot) - [Organic Acquisition Dashboard](https://helpcenter.mobileaction.co/en/store-analytics?hsLang=en#organic-acquisition-dashboard) - [Download Report](https://helpcenter.mobileaction.co/en/store-analytics?hsLang=en#download-report) - [Conversion Funnel View](https://helpcenter.mobileaction.co/en/store-analytics?hsLang=en#conversion-funnel-view) - [Analytics Overview](https://helpcenter.mobileaction.co/en/store-analytics?hsLang=en#analytics-overview) - [Search Ads Intelligence](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#main-content) - [Search Result/App](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#search-result-app) - [Search Result/Keyword](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#search-result-keyword) - [Search Result/Competitor](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#search-result-competitor) - [Today Tab](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#today-tab) - [Search Tab](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#search-tab) - [Product Pages](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#product-pages) - [Top Advertisers](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#top-advertisers) - [CPP by Keyword](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#cpp-by-keyword) - [CPP by App](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#cpp-by-app) - [CPP by Category](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#cpp-by-category) - [CPP on Ad Networks](https://helpcenter.mobileaction.co/en/search-ads-intelligence?hsLang=en#cpp-on-ad-networks) - [App Intelligence](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#main-content) - [Compass Explore](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#compass-explore) - [Compass Trace](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#compass-trace) - [Compass Impact](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#compass-impact) - [App Profile](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#app-profile) - [Publisher Profile](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#publisher-profile) - [Featured Apps](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#featured-apps) - [Category Rankings](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#category-rankings) - [Reviews](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#reviews) - [AI Review Reply](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#ai-review-reply) - [Ratings](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#ratings) - [Similar Apps](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#similar-apps) - [In-App Events](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#in-app-events) - [Promotional Content](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#promotional-content) - [Top Charts](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#top-charts) - [Biggest Movers](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#biggest-movers) - [Biggest Losers](https://helpcenter.mobileaction.co/en/app-intelligence?hsLang=en#biggest-losers) - [Ad Intelligence](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#main-content) - [Creative Analysis](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#creative-analysis) - [Advertiser Analysis](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#advertiser-analysis) - [Ad Publisher Analysis](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#ad-publisher-analysis) - [Developer Analysis](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#developer-analysis) - [Top Advertisers](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#top-advertisers) - [Top Ad Publishers](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#top-ad-publishers) - [Top Creatives](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#top-creatives) - [Top Developers](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#top-developers) - [App Collections](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#app-collections) - [Creative Collections](https://helpcenter.mobileaction.co/en/ad-intelligence?hsLang=en#creative-collections) - [Troubleshooting](https://helpcenter.mobileaction.co/en/troubleshooting?hsLang=en#main-content) - [MobileAction CMP Troubleshooting](https://helpcenter.mobileaction.co/en/troubleshooting?hsLang=en#mobileaction-cmp-troubleshooting) - [ASO Intelligence Troubleshooting](https://helpcenter.mobileaction.co/en/troubleshooting?hsLang=en#aso-intelligence-troubleshooting) - [Search Ads Intelligence Troubleshooting](https://helpcenter.mobileaction.co/en/troubleshooting?hsLang=en#search-ads-intelligence-troubleshooting) - [Integrations](https://helpcenter.mobileaction.co/en/integrations?hsLang=en#main-content) - [MobileAction Integrations](https://helpcenter.mobileaction.co/en/integrations?hsLang=en#mobileaction-integrations) - [SearchAds.com Integrations](https://helpcenter.mobileaction.co/en/integrations?hsLang=en#searchads-com-integrations) - [SSO Configuration](https://helpcenter.mobileaction.co/en/integrations?hsLang=en#sso-configuration) - [Settings](https://helpcenter.mobileaction.co/en/settings?hsLang=en#main-content) - [MobileAction Settings](https://helpcenter.mobileaction.co/en/settings?hsLang=en#mobileaction-settings) - [SearchAds.com Settings](https://helpcenter.mobileaction.co/en/settings?hsLang=en#searchads-com-settings) - [Single Sign-On Configuration Guides](https://helpcenter.mobileaction.co/en/settings?hsLang=en#single-sign-on-configuration-guides) [![Chill listening crop-3](https://helpcenter.mobileaction.co/hs-fs/hubfs/logo_black_medium-2.png?width=165&height=55&name=logo_black_medium-2.png "Chill listening crop-3")](https://www.mobileaction.co) Build app store marketing on AI, automation and expertise Copyright © 2025, MobileAction