### Install Postback - iOS and Android (Awin Live Example) Source: https://help.awin.com/developers/docs/singular A live example of an install postback for Awin, demonstrating actual values for merchant ID, reference, and other parameters. ```url /sread.php?tt=ns&tv=2&type=ai&merchant=17634&amount=1&ref=fdb7f765dde1ac0ae23023f9389053e45cc178d0&parts=iOS_INSTALL:1&cks=17634_1712341671_caa46a9dd8fcc9c30e25b82809a3689d&p30=singular&ch=aw&re-engagement=0 ``` -------------------------------- ### Dynamic Setup: Install Postback URL Source: https://help.awin.com/developers/docs/adjust Use this URL for dynamic install postbacks. Replace `1001` with your Awin progid and ensure Awin module is disabled in Adjust. ```url install_callback=https%3A%2F%2Fwww.awin1.com%2Fsread.php%3Ftt%3Dss%26tv%3D2%26type%3Dai%26merchant%3D1001%26amount%3D1%26ref%3D%7Badid%7D%26parts%3DAPPINST%3A1%26testmode%3D0%26cks%3D!!!awc!!!%26p1%3D%7Bcountry%7D%26p2%3D%7Bpartner_parameters%7D%26p3%3D!!!awc!!!%26p4%3DINSTALL%26p5%3D%7Bos_name%7D%26p6%3D%7Bgps_adid_md5%7D%26p7%3D%7Bidfa_md5%7D%26p8%3D%7Badid%7D%26p9%3D%7Bdevice_type%7D%26p30%3Dadjust ``` -------------------------------- ### Install Postback Configuration Source: https://help.awin.com/developers/docs/adjust Configure this URL as an install postback in Adjust to send install data to Awin. Ensure all placeholders are correctly mapped. ```url https://www.awin1.com/sread.php?tt=ss&tv=2&type=ai&merchant={{awin_program_code}}&amount=1&ref={adid}&parts={installCID}:1&testmode=0&cks={{awin_click_id}}&p1={adid}&p2={os_name}&p30=adjust ``` -------------------------------- ### Example Dynamic Tracking Link Source: https://help.awin.com/developers/docs/adjust An example of a combined Adjust tracking URL with dynamic Awin postbacks for both installs and events. Ensure placeholders like `1001` are replaced with your specific Awin progid. ```url https://app.adjust.com/abc123_xyz456?campaign=Affiliates&adgroup=!!!dateDAY!!!&creative=!!!affid!!!&install_callback=https%3A%2F%2Fwww.awin1.com%2Fsread.php%3Ftt%3Dss%26tv%3D2%26type%3Dai%26merchant%3D1001%26amount%3D1%26ref%3D%7Badid%7D%26parts%3DAPPINST%3A1%26testmode%3D0%26cks%3D!!!awc!!!%26p1%3D%7Bcountry%7D%26p2%3D%7Bpartner_parameters%7D%26p3%3D!!!awc!!!%26p4%3DINSTALL%26p5%3D%7Bos_name%7D%26p6%3D%7Bgps_adid_md5%7D%26p7%3D%7Bidfa_md5%7D%26p8%3D%7Badid%7D%26p9%3D%7Bdevice_type%7D%26p30%3Dadjust&event_callback_me4jf0=https%3A%2F%2Fwww.awin1.com%2Fsread.php%3Ftt%3Dss%26tv%3D2%26type%3Dap%26merchant%3D1001%26amount%3D1%26ref%3D%7Badid%7D_Leadout_%7Bengagement_time%7D%26parts%3DLEADOUT%3A1%26testmode%3D0%26cks%3D!!!awc!!!%26p1%3D%7Bcountry%7D%26p2%3D%7Bpartner_parameters%7D%26p3%3D!!!awc!!!%26p4%3DLEADOUT%26p5%3D%7Bos_name%7D%26p6%3D%7Bgps_adid_md5%7D%26p7%3D%7Bidfa_md5%7D%26p8%3D%7Badid%7D%26p9%3D%7Bdevice_type%7D%26p30%3Dadjust&fallback=!!!redirectURL!!! ``` -------------------------------- ### Product Detailed Size Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the standardized size of the product. ```json {"product_detailed":{"size":"L"}} ``` -------------------------------- ### Product Detailed Weight Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the weight of the product, including the unit of measurement. ```json {"product_detailed":{"product_weight":"173 g"}} ``` -------------------------------- ### Product Detailed Pattern Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the pattern or graphic print on the product. ```json {"product_detailed":{"pattern":"Striped"}} ``` -------------------------------- ### Product Price Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of the required product price, including currency. ```json "price":"15.00 GBP" ``` -------------------------------- ### Example Products Response Source: https://help.awin.com/developers/docs/transaction-notifications This is an example of the response format for the !!!products!!! placeholder, which provides product breakdown details. ```plaintext plt_products[0][productName]: Octopus plt_products[0][unitPrice]: 1.00 plt_products[0][skuType]: plt_products[0][skuCode]: 101 plt_products[0][quantity]: 1 plt_products[0][category]: Food plt_products[0][cgId]: plt_products[1][productName]: Fish, best of plt_products[1][unitPrice]: 9.00 plt_products[1][skuType]: plt_products[1][skuCode]: 200 plt_products[1][quantity]: 1 plt_products[1][category]: Tonträger plt_products[1][cgId]: ``` -------------------------------- ### Product Detailed Size System Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the country's sizing system the product uses. ```json {"product_detailed":{"size_system":"UK"}} ``` -------------------------------- ### Product Subscription Cost Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of optional subscription cost details. ```json "subscription_cost":{ "period":"month", "period_length":12, "amount":"35.00 EUR" } ``` -------------------------------- ### Product Detailed Width Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the width of the product, including the unit of measurement. ```json {"product_detailed":{"product_width":"14 cm"}} ``` -------------------------------- ### Product Installment Plan Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of optional installment payment plan details. ```json "installment":{ "months":6, "amount":"50 BRL" } ``` -------------------------------- ### Product Availability Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of the required product availability status. ```json "availability":"in_stock" ``` -------------------------------- ### Product Detailed Color Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the primary and secondary colors for a product. ```json {"product_detailed":{"color":"yellow"}} ``` -------------------------------- ### Basic Product Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of a required direct product link for basic product data. ```json {"link":"https://www.example.com/writing/pens"} ``` -------------------------------- ### Product Type Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of a product type string. ASCII characters are recommended for compatibility. ```json "product_type":"Home > Women > Dresses > Maxi Dresses" ``` -------------------------------- ### Mobile Product Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of an optional mobile-optimized product link. ```json "mobile_link":"https://www.m.example.com/writing/pens"} ``` -------------------------------- ### Google Product Category Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of the recommended Google-defined product category. ```json "google_product_category":"Apparel & Accessories > Clothing > Dresses" ``` -------------------------------- ### Product Sale Price Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of the recommended product sale price, including currency. ```json "sale_price":"5.00 GBP"} ``` -------------------------------- ### Basic Product Image Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of a required direct product image link for basic product data. ```json {"image_link":"http://www.example.com/image1.jpg"} ``` -------------------------------- ### Product Detailed Height Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the height of the product, including the unit of measurement. ```json {"product_detailed":{"product_height":"14 cm"}} ``` -------------------------------- ### Product Detailed Highlight Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to list key product highlights using a JSON array of strings. Each highlight has a character limit. ```json {"product_detailed":{“product_highlight":[ "Supports thousands of apps, including Netflix, YouTube, HBO Now, Spotify, Showtime, Pandora, Google Play Movies", "Supports thousands of apps, including Netflix, YouTube, HBO Now, Spotify, Showtime, Pandora, Google Play Movies", "Supports thousands of apps, including Netflix, YouTube, HBO Now, Spotify, Showtime, Pandora, Google Play Movies"]}} ``` -------------------------------- ### Trackable Deep Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a trackable direct product link. Must be 1-2,000 characters. ```json {"product_basic":{"aw_deep_link":" https://www.awin1.com/cread.php?awinmid=12345&awinaffid=6789&ued=https://www.example.com/product/17290"}} ``` -------------------------------- ### Product Detailed Length Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the length of the product, including the unit of measurement. ```json {"product_detailed":{"product_length":"14 cm"}} ``` -------------------------------- ### Basic Product ID Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of a required product ID for basic product data. ```json {"id":"16817108"} ``` -------------------------------- ### Basic Product Description Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of a required product description for basic product data. ```json {"description":"Made from 100% organic cotton, this classic red men's polo..."} ``` -------------------------------- ### In-app Postback (Awin Live Example) Source: https://help.awin.com/developers/docs/singular A live example of an in-app postback for Awin, showing how transaction amount, currency, and other parameters are populated. ```url /sread.php?tt=ns&tv=2&type=ap&merchant=17634&amount=89.89&ref=54489364&parts=INAPP-SALE:89.89&cks=17634_1715712831_47e7a6cb689241c2660d93199bf22d3a&p1=3040f5a806d7948e657c8d8561c90a22&ch=aw&cr=BRL&p30=singular ``` -------------------------------- ### Example Click-Through URL Parameters Source: https://help.awin.com/developers/docs/offline-tracking-1 These are example parameters that are added to the query string on click-through to the advertiser's site. They should be captured and stored. ```text _awaid=12345 &awgid=123456&awbid=234567&awpid=123456789&awcr=abcd1234&awc=10001_1581419106_2aeff1ef22119c6dbc699bcc174ec544_ ``` -------------------------------- ### Trackable Mobile Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a trackable mobile-optimized product link. Must be 1-2,000 characters. ```json {"product_basic":{"aw_mobile_link": "https://www.awin1.com/cread.php?awinmid=12345&awinaffid=6789&ued=https://www.m.example.com/writing/pens"}} ``` -------------------------------- ### Product Availability Date Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of the conditional availability date, required for 'preorder' or 'backorder'. ```json "availability_date":"2023-12-25T13:00-0800" ``` -------------------------------- ### Product Detailed Material Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the primary and secondary materials of a product. Maximum of three materials separated by slashes. ```json {"product_detailed":{"material":"Cotton/polyester/elastane"}} ``` -------------------------------- ### Basic Product Description Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a product description for basic product data. Must be 1-5,000 Unicode characters. ```json {"product_basic":{"description":"Made from 100% organic cotton, this classic red men''s polo has a slim fit and signature logo embroidered on the left chest. Machine wash cold; imported."}} ``` -------------------------------- ### Additional Product Image Links Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of optional additional product image links. Supports up to 10 images. ```json "additional_image_link":[ "http://www.example.com/image1.jpg", "http://www.example.com/image2.jpg" ] ``` -------------------------------- ### Virtual Model Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a link to promote 3D or AR models of products. Must be 1-2,000 characters. ```json {"product_basic":{"avirtual_model_link: "https://www.awin1.com/cread.php?awinmid=12345&awinaffid=6789&ued=https://www.m.example.com/writing/pens"}} ``` -------------------------------- ### Product Detailed Size Type Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to specify the product's size type or cut. Multiple values can be submitted. ```json {"product_detailed":{"size_type":[ "regular", "plus"]}} ``` -------------------------------- ### Install Postback - iOS and Android Source: https://help.awin.com/developers/docs/singular Template for an install postback to be sent to Awin. Replace placeholders with actual values. 're-engagement=1' indicates a re-engagement attribution. ```url /sread.php?tt=ns&tv=2&type=ai&merchant={Merchant_ID}&amount=1&ref={TIMESTAMP}3&parts={DEVICE_INSTALL}:1&cks={coalesce,(awc),(cks)}&ch=aw&p=singular&re-engagement=1 ``` -------------------------------- ### Product Sale Price Effective Date Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of the recommended date range for the product sale price. ```json "sale_price_effective_date":"2022-02-24T13:00-0800/2022-03-29T15:30-0800" ``` -------------------------------- ### Basic Product Title Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a product title for basic product data. Must be 1-150 Unicode characters. ```json {"product_basic":{"title":"Organic Cotton Men''s T-Shirt - Blue - M"}} ``` -------------------------------- ### Product Detailed Details Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of how to provide technical specifications or additional details for a product using a structured JSON array. ```json {"product_detailed":{"product_detail":[ { "section_name":"General", "attribute_name":"Product Type", "attribute_value":"Digital player" }, { "attribute_name":"Product Type", "attribute_value":"Digital Video" }]}} ``` -------------------------------- ### Mobile Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a mobile-optimized product link for basic product data. Must be a non-trackable ASCII URL, 1-2,000 characters. ```json {"product_basic":{"mobile_link":"https://www.m.example.com/writing/pens"}} ``` -------------------------------- ### Example Tracking Link Source: https://help.awin.com/developers/docs/singular This is an example of a tracking link generated by Singular, used for post-click attribution. Ensure all parameters are correctly mapped. ```url https://posthaus.sng.link/Adch7/t46t?_dl=posthaus%3A%2F%2Fposthaus.com.br%2F&_smtype=3&pcid=!!!id!!!&cl=!!!awc!!!&psn=!!!companyname!!!&psid=!!!affid!!!&pcrid=!!!linkid!!! ``` -------------------------------- ### Basic Product ID Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a product ID for basic product data. Must be 1-50 alphanumeric characters, underscores, or dashes. ```json {"product_basic":{"id":"16817108"}} ``` -------------------------------- ### Example Tracking Requests Source: https://help.awin.com/developers/docs/conversion-tag These are examples of tracking requests that are generated by the MasterTag after the Conversion Tag is processed. The exact requests may vary based on your program's setup. ```http https://www.awin1.com/sread.php?a=1001&b=8.33&cr=GBP&c=AA000001&d=DEFAULT:8.33&vc=&t=0&ch=aw&cks=1001_1403695822_a430d81e22c9e8687f423efcf024fbaa&l=https%3A//advertiser-domain.com/confirmation.php&tv=2&tt=ia ``` ```http https://www.awin1.com/sread.js?a=1001&b=8.33&cr=GBP&c=AA000001&d=DEFAULT:8.33&vc=&t=0&ch=aw&cks=1001_1403695822_a430d81e22c9e8687f423efcf024fbaa&l=https%3A//advertiser-domain.com/confirmation.php&tv=2&tt=js ``` ```http https://www.awin1.com/sread.php?a=1001&b=8.33&cr=GBP&c=AA000001&d=DEFAULT%3A8.33&vc=&t=0&cks=1001_1403695822_a430d81e22c9e8687f423efcf024fbaa&atp=&tv=2&tt=et&l=https%3A%2F%2Fwww.advertiser-domain.com%2Fconfirmation.php&ch=aw ``` ```http https://www.awin1.com/alt.php?mid=1001&gv=1&a=1001&b=8.33&cr=EUR&c=AA000001&d=DEFAULT:8.33&vc=&t=0&ch=aw&l=https%3A//www.advertiser-domain.com%2Fconfirmation.php ``` ```http https://www.awin1.com/m/1001.gif ``` -------------------------------- ### Full Implementation Example with customerAcquisition Source: https://help.awin.com/developers/docs/customer-acquisition This example demonstrates how to integrate the `customerAcquisition` parameter into both an image tag and a JavaScript tracking snippet for comprehensive customer acquisition reporting. ```html ``` -------------------------------- ### Basic Product Image Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a direct product image link for basic product data. Must be an ASCII URL, 1-2,000 characters. ```json {"product_basic":{"image_link":"http://www.example.com/image1.jpg"}} ``` -------------------------------- ### Product Expiration Date Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of an optional product expiration date. ```json "expiration_date":"2023-12-26T13:00-0800"} ``` -------------------------------- ### Multi-Platform Link Example Source: https://help.awin.com/developers/docs/adjust Construct a multi-platform Adjust tracking link by merging individual platform links. Ensure to replace the example program ID with your specific Awin progid. ```url https://app.adjust.com/abc123_xyz456?campaign=Affiliates&adgroup=!!!dateDAY!!!&creative=!!!affid!!!&awin_click_id=!!!awc!!!&awin_program_code=1001&deep_link=exampleshop-com%3A%2F%2Fhome&redirect=!!!redirectURL!!!&fallback=!!!redirectURL!!! ``` -------------------------------- ### Complete HTML Form Example with Product Data Source: https://help.awin.com/developers/docs/product-level-tracking-2 An example demonstrating the complete HTML form structure with sample product data. Each product row must be terminated by a line break. ```html
``` -------------------------------- ### Meta Data Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of meta data structure for advertiser ID and name. ```json {"meta":{"advertiser_id":1001,"advertiser_name":"Example Merchant"}} ``` -------------------------------- ### Product Loyalty Points Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of optional loyalty points awarded for a purchase. ```json "loyalty_points":"Program A:100:0.5" ``` -------------------------------- ### Basic Product Link Example Source: https://help.awin.com/developers/docs/enhanced-feeds-publisher-faq Example of a direct product link for basic product data. Must be a non-trackable URL, 1-2,000 ASCII characters. ```json {"product_basic":{"link":"https://www.example.com/writing/pens"}} ``` -------------------------------- ### Awin Install Postback Template for Kochava Source: https://help.awin.com/developers/docs/kochava Use this URL template for Awin's install postbacks when integrating with Kochava. Ensure all parameters are correctly populated. ```URL https://www.awin1.com/sread.php?tt=ss&tv=2&merchant={awin.merchant_id}&amount=1&ch=aw&ref={kochava_device_id}&parts=INSTALL_{platform}:1&cks={click_id}&testmode=0&type=ai&p1={platform}&p2={os_version}&p3={device_type}&p4={country}&p30=kochava ``` -------------------------------- ### Basic Product Title Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of a required product title for basic product data. ```json {"title":"Organic Cotton Men's T-Shirt - Blue - M"} ``` -------------------------------- ### Dynamic Setup: Event Postback URL Source: https://help.awin.com/developers/docs/adjust This URL is for dynamic event postbacks. Replace `me4jf0` with your Adjust event token and `1001` with your Awin progid. Ensure Awin module is disabled in Adjust. ```url event_callback_me4jf0=https%3A%2F%2Fwww.awin1.com%2Fsread.php%3Ftt%3Dss%26tv%3D2%26type%3Dap%26merchant%3D1001%26amount%3D1%26ref%3D%7Badid%7D_Leadout_%7Bengagement_time%7D%26parts%3DLEADOUT%3A1%26testmode%3D0%26cks%3D!!!awc!!!%26p1%3D%7Bcountry%7D%26p2%3D%7Bpartner_parameters%7D%26p3%3D!!!awc!!!%26p4%3DLEADOUT%26p5%3D%7Bos_name%7D%26p6%3D%7Bgps_adid_md5%7D%26p7%3D%7Bidfa_md5%7D%26p8%3D%7Badid%7D%26p9%3D%7Bdevice_type%7D%26p30%3Dadjust ``` -------------------------------- ### Product Unit Pricing Base Measure Example Source: https://help.awin.com/developers/docs/enhanced-feeds-prod-spec Example of the optional base measure for product pricing. ```json "unit_pricing_base_measure":"100 ml" ``` -------------------------------- ### Multiple Custom Parameters Implementation Example Source: https://help.awin.com/developers/docs/custom-parameters This example shows how to implement multiple custom parameters in the conversion tag and pixel. Ensure your advertiser ID is correctly set. ```html ``` -------------------------------- ### Example Commission Groups Response Source: https://help.awin.com/developers/docs/transaction-notifications This is an example of the response format for the !!!commissiongroups!!! placeholder, detailing commission group information. ```plaintext commissiongroups[0][id]: 194218 commissiongroups[0][name]: Default commissiongroups[0][code]: DEFAULT commissiongroups[0][description]: Default commissiongroups[0][commissionAmount]: 0.06 commissiongroups[0][amount]: 1.00 commissiongroups[1][id]: 276235 commissiongroups[1][name]: DVD commissiongroups[1][code]: DVD commissiongroups[1][description]: DVD commissiongroups[1][commissionAmount]: 0.90 commissiongroups[1][amount]: 9.00 ``` -------------------------------- ### Get Cookie Value Source: https://help.awin.com/developers/docs/channel-parameter Retrieves the value of a specified cookie. This function is used to get the channel parameter from cookies. ```javascript var _getCookie = function(sCookieName) { sCookieName += "="; var aCookies = document.cookie.split(";"); for (var i = 0; i < aCookies.length; i++) { while (aCookies[i].charAt(0) == " ") aCookies[i] = aCookies[i].substring(1); if (aCookies[i].indexOf(sCookieName) != -1) { return aCookies[i].substring(sCookieName.length, aCookies[i].length); } } }; ```