AffiliateTraction Extension Suite. Supporting Documentation for Tracking Pixel and Feed Manager v1.1

Transcription

1 AffiliateTraction Extension Suite Supporting Documentation for Tracking Pixel and Feed Manager v1.1

2 Revision History v1.1 Updated Demac branding Updated location to find compatibility information v1.0 Initial document for external distribution v0.5 Small update to wording of install section v0.4 Grammar, and wording changes made Might need to expand a bit in the installation section of the document v0.3 Updates to default values that used in the feed v0.2 Initial document support@demacmedia.com Page 2 of 16

3 Table of Contents Revision History... 2 Overview... 4 Features... 5 Installation... 6 AffiliateTraction - Pixel... 7 Pixel Location in the Magento Administrative Backend... 7 The Pixel... 7 Configuration... 8 AffiliateTraction Feed Manager... 9 Feed Manager Location in the Magento Administrative Backend... 9 Setup and Configuration of a Product Feed Dashboard of the Feed Manager Configuration Feed Information Configuration FTP Information Configuration Attribute Mapping Configuration Product Selection Configuration Category Mapping support@demacmedia.com Page 3 of 16

4 Overview Take Affiliate Marketing to the Next Level with the Demac Media & AffililateTraction Extension Suite! Affiliate marketing offers a strategic way to gain more product exposure and brand recognition by creating a new channel to generate traffic and sales. As a result, merchants enjoy increased revenue, branding, and better search engine rankings. Though the affiliate marketing channel comes with many benefits, retailers often encounter obstacles and challenges due to a multitude of tedious, manual processes or complex technical integrations. Furthermore, e-commerce affiliate modules are often fragmented or don't contain the features needed to integrate across multiple networks and channels. With this in mind, Demac Media, a Magento gold partner, and AffiliateTraction, the largest affiliate agency in the world, have teamed up to build an extension that aims to ease the transition into the world of affiliate marketing, making it as comprehensive, seamless and hassle-free as possible. Introducing the Demac Media & AffiliateTraction Extension Suite! This extension suite provides merchants with the software to simplify integration between their Magento installation and global affiliate channels, unifying efforts across multiple networks and verticals while creating efficiencies that reduce strains on technical and marketing departments through automation of both setup and ongoing tasks. Because this suite was developed in partnership with AffiliateTraction, you gain access to the leading global affiliate marketing agency and their comprehensive suite of affiliate channel and brand compliance services. You also gain access to top networks in the US, EU, UK, CA, and AU such as Commission Junction, Rakuten LinkShare, ebay ecommerce, AffiliateWindow, Trade Doubler, DGM, Zanox and many others. Currently this module supports global, cross-network platform product feeds, and the triple redundant AffiliateTraction tracking container pixel all in a single instance of Magento. Future releases will include sales reconciliation, consumer offers and promotion codes. Download it once and you will be notified about these future enhancements as they are released. support@demacmedia.com Page 4 of 16

5 Features Implement the AffiliateTraction pixel without the need to directly modify code in the checkout Configure the pixel in multiple currencies and multiple accounts Upload multiple product feeds from Magento to AffiliateTraction Map attributes from Magento to AffiliateTraction Manage product selection from the Magento catalog Category mapping to AffiliateTraction standard categories Page 5 of 16

6 Installation The Demac Media AffiliateTraction Extension Suite is available now on Magento Connect as well as the Demac Media Product Page. For the latest version compatibility, please see the Magento Connect listing. All individual modules will be bundled into the main install with the option to enable or disable as required. The install of this extension (via FTP) is the same as the majority of modules that are available on Magento Connect. For the particular package Demac_AffTrac_Suite zip you will need to: 1. Extract the files inside the 0.2.1/ directory in your Magento root. This can be done with an FTP program such as FileZilla. 2. Flush your Magento cache under System > Cache Management > Flush Cache Magento Cache. 3. Re-login to the Magento administrative backend. If you have any further questions, please contact and a member of our support team will assist you. support@demacmedia.com Page 6 of 16

7 AffiliateTraction - Pixel Pixel Location in the Magento Administrative Backend Please navigate to: System > Configuration > DEMAC > AffiliateTraction Pixel The following screenshot is what you will see: The Pixel The following is an example of the information that you will receive from AffiliateTraction once your account has been set up: <!--START AffiliateTraction CODE--> <iframe src=" nx8iq&sale=[sale]&orderid=[order]&promo=[promo]&currency=[currency]" height="1" width="1" frameborder=no border=0 scrolling=no></iframe> <!-- END AffiliateTraction CODE -->"; The piece of information that you will require from the above is yourid Once the pixel is implemented, the following is an example of what will be fired upon a successful checkout: <!--START AffiliateTraction CODE--> <iframe src=" 4kF3nX8iQ&sale=13&orderId=test &currency=USD" height="1" width="1" frameborder="no" border="0" scrolling="no"></iframe> support@demacmedia.com Page 7 of 16

8 <!-- END AffiliateTraction CODE -->"; Configuration The configuration of the pixel can either be completed at the DEFAULT, WEBSITE or STORE VIEW scope. The configuration parameters and a description of each are as follows: Enabled o Yes/No o Default or Website or Store View o You are able to enable/disable the pixel at the specific scope you want it to apply to ID o Supplied by AffiliateTraction o If varies by website, then you need to do a specific entry for each site o yourid on affiliatetechnology.com. E.g yourid.affiliatetechnology.com Currency o The currency parameter should populate with whatever currency is used by the customer at the time of the purchase Development Mode o Yes/No o If set to Yes, the order ID will be prefixed with test- to ensure that duplicate order IDs are not sent from a staging vs production environment o orderid=test Note: After configuring the pixel, please inform your AffiliateTraction representative that you are set up and ready for testing. support@demacmedia.com Page 8 of 16

9 AffiliateTraction Feed Manager Feed Manager Location in the Magento Administrative Backend For overall module configuration and enabling please navigate to: System > Configuration > DEMAC > AffiliateTraction Feed The following screenshot is what you will see: The configuration parameters and a description of each are as follows: Enabled o Yes/No o Default or Website or Store View o You are able to enable/disable the feed at the specific scope you want it to apply to List Simple Products o Yes/No o Option to either break out the simple products (as part of a configurable) or just have the configurable listed in the feed ID o Supplied by AffiliateTraction o If varies by website, then you need to do a specific entry for each site o yourid on affiliatetechnology.com. E.g yourid.affiliatetechnology.com support@demacmedia.com Page 9 of 16

10 To then initiate the configuration of the feed, please navigate to: Catalog > Demac Feed Manager Setup and Configuration of a Product Feed Dashboard of the Feed Manager Begin by Adding a Product Feed click Add a Product Feed in the top right corner: Note: If there is an error when uploading the feed, the status will display a red error signal. If the upload is complete, it will display a green uploaded signal. The status is determined once the following steps have been completed. Configuration Feed Information The Feed Information section is where you enter details about the Product Feed and assign it to a specific WEBSITE scope. Note that there is the ability to have multiple feeds per WEBSITE. Name the Feed o Identifier of the feed support@demacmedia.com Page 10 of 16

11 Description (Optional) o Textual descriptor of the purpose of the feed Status o Active or Inactive option to disable the feed o Note that all feeds that are Active will run on a nightly cron for upload Websites o For instances of Magento with multiple sites, choose which WEBSITE the feed will pull products and gather information from Configuration FTP Information support@demacmedia.com Page 11 of 16

12 Your AffiliateTraction account representative will provide the required inputs for the FTP Information during the account setup phase. The feed is uploaded through this information from Magento to AffiliateTraction for processing and will be uploaded on a nightly basis via a cron or if the feed is explicitly run from the administrative section of Magento (Save and Generate Feed). All fields are required: FTP Host FTP User FTP Pass FTP Path o / is recommended to be used as this will upload to the root FTP Filename o This will be prefixed with dmm_ on upload to the FTP site o If there are multiple feeds to run, make sure the names are unique to each Configuration Attribute Mapping The Attribute Mapping rule menu correlates the attributes you set in Magento to AffiliateTraction s attributes (following the Google base product feed). Start by clicking Add a New Attribute and selecting the corresponding attributes in the dropdown menu. Left Attributes corresponds to the specific Magento attribute Right Content Attribute corresponds to the attribute header that will be sent in the feed support@demacmedia.com Page 12 of 16

13 Note: There are some attributes that are always required in the feed and will be populated with a default value if a specific Magento attribute is not mapped to it The list is as follows with their default values: o gender unisex o agegroup = adult In addition the following will try to auto-map on attribute name if there is the same name found in Magento (this can be overwritten by explicitly setting the mapping): o color o size o material o pattern support@demacmedia.com Page 13 of 16

14 Configuration Product Selection The Product Selection in the Product Feed Configuration is where you will define which products you are including on the feed to AffiliateTraction. Products are selected based on rules in which you will define here in this section; these rules follow standard Magento rule inputs (such as with promotions). Examples of rules used to define products for selection can include: Category Attribute Set Specific Attribute Rules o Brands o Price = > $x.xx o SKU range or specific support@demacmedia.com Page 14 of 16

15 Configuration Category Mapping The Category Mapping configuration will help to define the mapping from the specific Magento categories (or even attribute rules) to the standard categories that are available that will best represent the products you are pushing in the product feed. This category listing is based off of the Google Product Category Taxonomy. PLEASE NOTE: If a products falls into a category that does not have a mapping, it will not be categorized and therefore not accepted on the feed. Some examples of this mapping can include: If your category contains baby car seats Or (Your Category): Car Seats = Baby & Toddler > Baby Transport > Baby & Toddler Car Seats. If your category contains car seats for vehicles (Your Category): Car Seats = Vehicles & Parts > Vehicle Parts & Accessories > Motor Vehicle Interior > Car Seats support@demacmedia.com Page 15 of 16

16 Page 16 of 16