Adobe Marketing Cloud Bloodhound for Mac 3.0
Contents Adobe Bloodhound for Mac 3.x for OSX...3 Getting Started...4 Processing Rules Mapping...6 Enable SSL...7 View Hits...8 Save Hits into a Test...9 Compare Current Hits to a Test...11 Contact and Legal Information...12 Last updated 5/25/2017 Bloodhound for Mac 3.0
Adobe Bloodhound for Mac 3.x for OSX 3 Adobe Bloodhound for Mac 3.x for OSX During application development, Adobe Bloodhound lets you view server calls locally, and optionally forward the data to Adobe collection servers. Last Updated: May 10, 2017 Important: As of April 30, 2017, Adobe Bloodhound has been sunset. Starting on May 1, 2017, no additional enhancements and no additional Engineering or Adobe Expert Care support will be provided. Adobe Bloodhound provides the following features: View GET and POST hits (Version 4.2 and later of the ios and Android SDKs send all hits using POST) Parse hits in real time Run processing rules against your raw data to see what variables will be set on the server. Install a Bloodhound SSL certificate to test SSL hits Save hits to tests for future comparison Compare hits using JavaScript (including regular expressions) to verify data. Requirements An Intel-based Mac computer running Snow Leopard (10.6) or later. Network connectivity to your mobile devices or simulators. Download The Adobe Bloodhound download is available from the releases page of the Adobe Marketing Cloud/Mobile Services GitHub repository.
Getting Started 4 Getting Started The Adobe Bloodhound app measurement QA tool displays and parses real-time hit data on mobile and web Analytics implementations, helping to ensure proper implementation for app developers and marketing teams. The tool focuses on mobile app measurement for ios, Android, and Windows Universal SDKs, but can be used for other platforms including desktop or mobile web. One major benefit to Adobe Bloodhound for all testing scenarios is that it can emulate an Analytics data collection server, so you can inspect hits during development without sending them to a data collection server. Complete the following tasks to get started using Adobe Bloodhound: Task Description Download Install Launch The Adobe Bloodhound download is available from the releases page of the Adobe Marketing Cloud/Mobile Services GitHub repository. Open the dmg you downloaded and drag Bloodhound to the Applications folder. After you launch the tool, the server is started automatically. The hostname and port is displayed in the Adobe Bloodhound window. An icon is displayed after the server address indicating the current status. Green indicates that the server is running, yellow indicates an error has occurred, and red indicates that the server is stopped. Hover over the status icon for details about the current status. Configure See Configure Devices to Send Hits to Adobe Bloodhound. Configure Devices to Send Hits to Adobe Bloodhound You can change proxy settings on the device to send http/https requests to Adobe Bloodhound. Requests that are sent to Bloodhound can optionally be forwarded to Adobe Data Collection servers. If your device does not allow you to configure a proxy, you can send the hits directly to Adobe Bloodhound. ios Devices The ios Device must be on the same network as the computer hosting Adobe Bloodhound. 1. Navigate to Settings > Wi-Fi. 2. Click the blue "i" icon to the right of your currently selected Wi-Fi network. 3. Scroll to the HTTP Proxy settings. 4. Select Auto. 5. Enter the Proxy Auto Config (PAC) URL from the Bloodhound UI into the URL field. For example, http://10.39.47.181:50000/pac. 6. Click Home. Other Devices If the device supports proxy auto config, simply use the Proxy URL (From the Adobe Bloodhound UI) as the Proxy Auto Config (PAC) URL. Proxy support varies across Android versions, and there are some proxy configuration tools available for Android to simplify configuration.
Getting Started 5 Send Hits Directly For devices that do not support proxy (ios Simulator, older Android versions, and so on) it is possible to specify Adobe Bloodhound as your tracking server in order to capture the hits it generates. To do this set your tracking server to "<Bloodhound IP>:<Bloodhound Port>" in the ADBMobileConfig.json config file. For example: "server" : "localhost:50000" Troubleshooting If you are having trouble sending hits to your Adobe Bloodhound server, verify that your device and Bloodhound server are on the same network. The best way to do this is to go to the web browser on your device and type in the URL, including port number, of the Bloodhound server. For example, http://10.39.47.181:50000. If your device is able to communicate with Bloodhound, you will see a Bloodhound Info screen similar to the following illustration:
Processing Rules Mapping 6 Processing Rules Mapping Starting with Adobe Bloodhound version 3.1, you can enter in your Adobe Analytics credentials to enable processing rules mapping. With processing rules mapping enabled, the hits you send to your Adobe Bloodhound server will have processing rules applied in real time, showing you which variables and events will be set on the data collection server. Note: This functionality is currently in beta and might not show mappings with 100% accuracy. If your processing rules are complex, please verify on a test resport suite that your mappings are correct. Complete the following steps to use processing rules mapping for Adobe Bloodhound: 1. Launch Adobe Bloodhound. 2. Click the Setup tab. 3. Specify your Adobe Analytics credentials (Company, Username, and Password), then click Authenticate. After you are authenticated, notice that your Context Data and Additional Data tables have a new column: "Mapping." Hits that come in will now apply processing rules specified by the Report Suite ID (rsid) in the hit received. Note: If your hit is tagged with more than one rsid, a drop-down list appears above the Hit Details box. You can select which set of processing rules you'd like to apply from the list.
Enable SSL 7 Enable SSL In order to send hits via HTTPS from your device to Adobe Bloodhound, you must download and install a CA Certificate on your device. The CA Certificate is available from the Bloodhound Info page. 1. Browse to http://hostname:port, where the hostname and port are the server where Adobe Bloodhound is running. For example, http://10.39.47.181:50000. 2. Click Download CA Certificate. 3. Install the bh.cer certificate file you downloaded on your test mobile devices. 4. In Adobe Bloodhound, click the Setup tab, and enter your Analytics server into the Analytics SSL Server field. Your Analytics server can be found in your ADBMobileConfig.json configuration file 5. On your mobile device, set the proxy to the hostname and port where Adobe Bloodhound is running. See Configure Devices to Send Hits to Adobe Bloodhound. 6. Send hits from your mobile device. 7. A dialog appears on the system where Adobe Bloodhound is running, prompting you to accept the connection. After you accept the connection, SSL hits are captured in Adobe Bloodhound.
View Hits 8 View Hits After configuration, hits are captured and displayed automatically. Adobe Bloodhound can impersonate an Adobe data collection server so you can test hits without sending data to a report suite. If Forward Hits is enabled, hits are sent to the specified report suite. If the hits aren't showing up, turn on debug logging in your application and check the debug output for image requests.
Save Hits into a Test 9 Save Hits into a Test Saving hits lets you store a sequence of hits along with any associated data to compare with this same sequence at a later time. For example, after upgrading the measurement library or upgrading your app. 1. Define a sequence of steps to perform in the app. This is your test sequence. This could be a user login, content download, or other engagement. 2. Start Adobe Bloodhound and perform this sequence in the app, and verify that hits are being captured. 3. After you have successfully captured the hits for this sequence, drag-and-drop the hits to the Test menu: 4. The hits appear on the test tab in descending order (newest hit appears at the top).
Save Hits into a Test 10 5. Select a hit and then insert any verification JavaScript you'd like to perform into the Editor. For example, to test that a specific context data value is set on that hit you could add the following: assert (contextdata["myapp.key"] == "Value"); Make sure you click the Checkmark to save any changes. When you Compare Current Hits to a Test, if false is returned by any statement for a test, an error is logged to the Adobe Bloodhound output window and the hit appears as red. Tests are saved in a local file so they can be shared to other users.
Compare Current Hits to a Test 11 Compare Current Hits to a Test Saved hits can be compared to hits as they are received during a test. 1. Prepare your app by navigating to the state where your test sequence should begin. 2. On the Test tab, select your test and click the play icon. The first hit in the sequence is selected. 3. In your App, perform the same test sequence you performed when you saved the test. Hits are compared as they are received to the hits in the test, and any failed tests are logged to output.
Contact and Legal Information 12 Contact and Legal Information Information to help you contact Adobe and to understand the legal issues concerning your use of this product and documentation. Help & Technical Support The Adobe Experience Cloud Customer Care team is here to assist you and provides a number of mechanisms by which they can be engaged: Check the Marketing Cloud help pages for advice, tips, and FAQs Ask us a quick question on Twitter @AdobeExpCare Log an incident in our customer portal Contact the Customer Care team directly Check availability and status of Marketing Cloud Solutions Service, Capability & Billing Dependent on your solution configuration, some options described in this documentation might not be available to you. As each account is unique, please refer to your contract for pricing, due dates, terms, and conditions. If you would like to add to or otherwise change your service level, or if you have questions regarding your current service, please contact your Account Manager. Feedback We welcome any suggestions or feedback regarding this solution. Enhancement ideas and suggestions can be added to our Customer Idea Exchange. Legal 2017 Adobe Systems Incorporated. All Rights Reserved. Published by Adobe Systems Incorporated. Terms of Use Privacy Center Adobe and the Adobe logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. A trademark symbol (,, etc.) denotes an Adobe trademark. All third-party trademarks are the property of their respective owners. Updated Information/Additional Third Party Code Information available at http://www.adobe.com/go/thirdparty.