|
| 1 | +--- |
| 2 | +title: "[]{#_txprw7e8ra85 .anchor}Segment Documentation--Ambee" |
| 3 | +--- |
| 4 | + |
| 5 | +## **Ambee Destination** |
| 6 | + |
| 7 | +title: Ambee Destination id: integration_id |
| 8 | + |
| 9 | +{% include content/plan-grid.md name=\"actions\" %} |
| 10 | + |
| 11 | +Ambee provides self-serve predictive analytics for businesses, |
| 12 | +leveraging machine learning to automate audience insights and |
| 13 | +recommendations based on climate and environmental datasets. Ambee |
| 14 | +offers actionable air quality and pollen data that can reinforce your |
| 15 | +climate strategy, simplify personalization, and enhance business |
| 16 | +outcomes. |
| 17 | + |
| 18 | +This destination is maintained by Ambee. For any issues with the |
| 19 | +destination, contact their [[Support |
| 20 | +Team]{.underline}](https://support.getambee.com/portal/en/home). |
| 21 | + |
| 22 | +{% include content/ajs-upgrade.md %} |
| 23 | + |
| 24 | +### **Getting started** |
| 25 | + |
| 26 | +From the **Segment** web app, click **Catalog**, then click |
| 27 | +**Destinations**. |
| 28 | + |
| 29 | +Find the **Destinations Actions** item in the left navigation, and click |
| 30 | +it. |
| 31 | + |
| 32 | +Click Configure **Ambee** |
| 33 | + |
| 34 | +Select an existing Source to connect to **Ambee** (Actions). |
| 35 | + |
| 36 | +{% include components/actions-fields.html %} |
| 37 | + |
| 38 | +## **Settings** |
| 39 | + |
| 40 | +### **Segment Write Key** |
| 41 | + |
| 42 | +The write key is a unique identifier for each Source. It lets Segment |
| 43 | +know which Source is sending the data and which destinations should |
| 44 | +receive that data. |
| 45 | + |
| 46 | +To find a write key, you first need to create a non-Cloud Source such as |
| 47 | +a website, server, or mobile source. |
| 48 | + |
| 49 | +Then, in the Source, go to **Settings,** and then go to **API Keys**. |
| 50 | + |
| 51 | +### |
| 52 | + |
| 53 | +### **API Key** |
| 54 | + |
| 55 | +To start working with Ambee as your destination, you will require |
| 56 | +Ambee's API Key. Sign up for Ambee by visiting [[this |
| 57 | +website]{.underline}](https://auth.ambeedata.com/users/register?redirectUrl=https://api-dashboard.getambee.com). |
| 58 | + |
| 59 | +Once you are signed in, you will get your limited-period API key on the |
| 60 | +dashboard\'s homepage. If your use case requires data in bulk, you will |
| 61 | +need to subscribe to Ambee's [[enterprise |
| 62 | +plan]{.underline}](https://www.getambee.com/pricing). During |
| 63 | +subscription, you will need to specify your choice of API--air quality |
| 64 | +and/or pollen. []{.mark} |
| 65 | + |
| 66 | +After subscription, you can use Ambee's air quality and/or pollen data |
| 67 | +by pasting your API key under **the API Key section** in **Mapping**. |
| 68 | + |
| 69 | +## **Ambee Destination Mapping** |
| 70 | + |
| 71 | +### **Ambee Air Quality Subscription** |
| 72 | + |
| 73 | +Ambee's air quality subscription helps you personalize and position your |
| 74 | +messaging via emails, sms, and push notifications to improve user |
| 75 | +engagement on your website based on air quality triggers for locations |
| 76 | +across the world. You can also retarget messaging based on your user's |
| 77 | +geo-location, for example- |
| 78 | + |
| 79 | +- Promote the sale of your EVs in highly polluted areas |
| 80 | + |
| 81 | +- Advertise anti-pollution products like masks, skincare, etc., during |
| 82 | + > highly polluted durations |
| 83 | +
|
| 84 | +- Showcase ads for smart air purifiers in highly polluted localities |
| 85 | + |
| 86 | +The table below shows the AQI risk levels, their associated value, and |
| 87 | +what each category means for the public. Ambee uses globally valid data |
| 88 | +that follows US EPA standards to provide relevant recommendations. If |
| 89 | +you are subscribed to **air quality,** you can select the risk levels |
| 90 | +for AQI from the drop-down box under **the air quality** section. |
| 91 | + |
| 92 | + ------------------------------------------------------------------------ |
| 93 | + AQI risk Index Values What it means |
| 94 | + levels |
| 95 | + ------------- --------------- ------------------------------------------ |
| 96 | + Good 0 - 50 Air quality is good and poses little or no |
| 97 | + risk. |
| 98 | + |
| 99 | + Moderate 51 - 100 Air quality is acceptable; however, there |
| 100 | + may be some health concerns for a small |
| 101 | + number of extremely sensitive people. |
| 102 | + |
| 103 | + Unhealthy For 101 - 150 When air quality is in this range, people |
| 104 | + Sensitive in sensitive groups may experience health |
| 105 | + Groups effects when engaging in outdoor |
| 106 | + activities. |
| 107 | + |
| 108 | + Unhealthy 151 - 200 When air quality is in this range, |
| 109 | + everyone who is active outdoors may |
| 110 | + experience effects. Members of sensitive |
| 111 | + groups are likely to experience more |
| 112 | + serious effects. |
| 113 | + |
| 114 | + Very 201 - 300 When air quality is in this range, it is |
| 115 | + Unhealthy expected that there will be widespread |
| 116 | + effects among the general population and |
| 117 | + more serious effects in members of |
| 118 | + sensitive groups. |
| 119 | + |
| 120 | + Hazardous 301 - 400 Air quality in this range triggers health |
| 121 | + warnings of emergency conditions. The |
| 122 | + entire population is more likely to be |
| 123 | + affected by serious health effects. |
| 124 | + |
| 125 | + 401 - 500 |
| 126 | + ------------------------------------------------------------------------ |
| 127 | + |
| 128 | +### **Ambee Pollen Subscription ** |
| 129 | + |
| 130 | +Ambee's pollen subscription helps you contextualize and hyper-target |
| 131 | +your marketing and advertising campaigns via emails, sms, and push |
| 132 | +notifications to improve user engagement with the help of pollen |
| 133 | +triggers for locations across the world. You can also personalize your |
| 134 | +ad content based on the user's geolocation, for example- |
| 135 | + |
| 136 | +- Advertise anti-allergy tissues based on high pollen condition |
| 137 | + |
| 138 | +- Promote OTC medicines to allergy sufferers |
| 139 | + |
| 140 | +The risk levels below are recommended by NAB to understand the risks |
| 141 | +they are exposed to, and it helps them take preventative measures to |
| 142 | +reduce their exposure to pollen. Ambee uses the NAB-compliant index to |
| 143 | +provide accurate insights. If you are subscribed to **pollen**, you can |
| 144 | +select the risk levels for pollen from the drop-down box under the |
| 145 | +**pollen** section. |
| 146 | + |
| 147 | + ------------------------------------------------------------------------ |
| 148 | + Risk Level Tree Grass Weed What it means |
| 149 | + ------------- ---------- ----------- ----------- ----------------------- |
| 150 | + Low 0-95 0-29 0-20 Individuals susceptible |
| 151 | + to pollen may |
| 152 | + experience mild |
| 153 | + allergic symptoms |
| 154 | + |
| 155 | + Moderate 96-207 30-60 21-77 Many individuals |
| 156 | + sensitive to pollen may |
| 157 | + experience allergic |
| 158 | + symptoms |
| 159 | + |
| 160 | + High 208-703 61-341 78-266 Most individuals with |
| 161 | + any sensitivity to |
| 162 | + pollen will experience |
| 163 | + allergic symptoms. |
| 164 | + Extremely sensitive |
| 165 | + groups could experience |
| 166 | + serious symptoms |
| 167 | + |
| 168 | + Very High 704+ 342+ 267+ Almost all individuals |
| 169 | + with any sensitivity to |
| 170 | + pollen will experience |
| 171 | + symptoms. |
| 172 | + ------------------------------------------------------------------------ |
| 173 | + |
| 174 | +### **IP Address** |
| 175 | + |
| 176 | +Ambee will fetch the user's IP address to trigger air quality and/or |
| 177 | +pollen notifications for device mode --- analytics.js or mobile |
| 178 | +(android/iOS). |
0 commit comments