Skip to main content

Recent Searches

No recent searches

    Popular Articles

      Articles

      View all

        Topics

        View all

          Tickets

          View all
            no results

            Sorry! nothing found for

            Bidease callback specifications

            Modified on Wed, 4 Nov at 6:15 AM

            bideaseINTEGRATION SPEC
            Callback Specifications
            How to send install and in-app event callbacks to Bidease: the URL structure, required and optional parameters, and ready-to-use examples.
            ↺
            Pass back x
            Return the x value Bidease passes through the click or impression — it links the conversion to the ad.
            ◉
            One URL, all events
            Installs and in-app events use the same endpoint; leave goal_id empty for an install.
            $
            Revenue in USD
            Send the purchase amount in purchase_usd; leave it empty when there is no purchase.
            SPECIFICATION
            Callback Parameters
            1
            Default callback structure
            CALLBACK URL
            https://track-us.bidease.com/conv?
x=[BID_ID]
&goal_id=[GOAL_ID]
&attr_type=[ATTR_TYPE]
&is_attributed=[IS_ATTRIBUTED]
&tracker=[TRACKER]
&bundle=[BUNDLE]
&purchase_usd=[REVENUE]
&ip=[IP]
&make=[MAKE]
&model=[MODEL]
&os=[OS]
&os_ver=[OS_VER]
&user_agent=[USER_AGENT]
&lang=[LANGUAGE]
&country=[COUNTRY]
&region=[REGION]
&city=[CITY]
&carrier=[CARRIER]
            2
            Required parameters

            These parameters are mandatory. If any of them is missing, the data will be corrupted or may not be recognized at all.

            ParameterDescription
            xUnique session ID (or click ID) that Bidease passes through the click or impression.
            goal_idName of the event the user performed, e.g. registration, purchase. For an install, leave this parameter empty.
            attr_typeType of attribution: send 0 if the conversion came from a click (post-click) and 1 if it came from an impression (post-view).
            is_attributedSend 1 if the user was attributed to a Bidease click/impression and 0 if the user came from another partner. If you can't split them this way, send 1 for all conversions.
            bundleBundle of your application. If you send callbacks from a website, you can use your website address instead, e.g. &bundle=bidease.com.
            trackerName of the tracker/platform you use to send callbacks, e.g. SampleManager for the SampleManager platform.
            3
            Optional parameters
            ParameterDescription
            purchase_usdPurchase amount in USD. For an event or install without a purchase amount, leave it empty.
            ipIP address of the user when the event occurred
            makeDevice maker
            modelDevice model
            osDevice operating system: android / ios
            os_verDevice operating system version
            user_agentBrowser user agent string
            langBrowser language, 2-letter ISO 639-1 code
            countryCountry code, ISO-3166-1-alpha-3
            regionRegion code, ISO-3166-2; 2-letter state code for the USA (outside the US, the English name is preferred)
            cityUnited Nations Code for Trade & Transport Locations preferred (outside the US, the English name is preferred)
            carrierCarrier or ISP
            4
            Examples
            INSTALL CALLBACK
            https://track-us.bidease.com/conv?x=gyaG7wMJC6ItL9F3&goal_id=&attr_type=0&is_attributed=1&tracker=SampleManager&bundle=com.example.app&purchase_usd=
            EVENT CALLBACK
            https://track-us.bidease.com/conv?x=gyaG7wMJC6ItL9F3&goal_id=purchase&attr_type=0&is_attributed=1&tracker=SampleManager&bundle=com.example.app&purchase_usd=15.45
            bidease
            Grow Your App with Ease
            Questions? Contact your Bidease account manager
            support@bidease.com

            Was this article helpful?

            That’s Great!

            Thank you for your feedback

            Sorry! We couldn't be helpful

            Thank you for your feedback

            Let us know how can we improve this article!

            Select at least one of the reasons
            CAPTCHA verification is required.

            Feedback sent

            We appreciate your effort and will try to fix the article

            Preview
            0 of 0