Skip to content

Commit b63b7f0

Browse files
karlwaldmanclaude
andcommitted
Add UTM tracking parameters to all signup and pricing links
Enable attribution tracking for Google Sheets add-on channel by adding utm_source=google_sheets&utm_medium=addin&utm_campaign=readme to signup links and utm_campaign=pricing to pricing links across README.md, Sidebar.html, and docs/index.html. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 1e6f2be commit b63b7f0

3 files changed

Lines changed: 815 additions & 674 deletions

File tree

README.md

Lines changed: 27 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
## 🎯 Overview
66

77
This Google Sheets add-on brings live commodity prices to your spreadsheets:
8+
89
- **Custom Functions**: `=OILPRICE("BRENT_CRUDE_USD")`
910
- **Sidebar UI**: Fetch and manage prices easily
1011
- **Auto-Convert**: Standardize all prices to $/MMBtu
@@ -13,13 +14,15 @@ This Google Sheets add-on brings live commodity prices to your spreadsheets:
1314
## 📦 Features
1415

1516
### Custom Functions
17+
1618
```javascript
1719
=OILPRICE("BRENT_CRUDE_USD") // Returns latest Brent Crude price
1820
=OILPRICE_HISTORY("WTI_USD", 30) // Returns 30 days of WTI data
1921
=OILPRICE_CONVERT("NATURAL_GAS_GBP") // Returns price in $/MMBtu
2022
```
2123

2224
### Sidebar Features
25+
2326
- API key management
2427
- Commodity selection (20+ commodities)
2528
- Fetch latest prices
@@ -28,19 +31,22 @@ This Google Sheets add-on brings live commodity prices to your spreadsheets:
2831
- Usage tracking
2932

3033
### Tier Detection
34+
3135
- Free: 100 requests (lifetime)
3236
- Exploration: 10,000 requests/month + historical data
3337
- Production+: Higher limits + webhooks
3438

3539
## 🚀 Installation
3640

3741
### From Google Workspace Marketplace (Coming Soon)
42+
3843
1. Open any Google Sheet
3944
2. Extensions → Add-ons → Get add-ons
4045
3. Search "OilPriceAPI Energy Prices"
4146
4. Click Install
4247

4348
### For Development
49+
4450
1. Open Google Sheets
4551
2. Extensions → Apps Script
4652
3. Copy code from `Code.gs` and `Sidebar.html`
@@ -49,20 +55,25 @@ This Google Sheets add-on brings live commodity prices to your spreadsheets:
4955
## 📖 Quick Start
5056

5157
### Step 1: Get API Key
52-
Visit https://oilpriceapi.com/auth/signup to get your free API key.
58+
59+
Visit https://www.oilpriceapi.com/signup?utm_source=google_sheets&utm_medium=addin&utm_campaign=readme to get your free API key.
5360

5461
### Step 2: Open Add-on
62+
5563
1. Extensions → OilPriceAPI → Configure
5664
2. Enter your API key
5765
3. Click Save
5866

5967
### Step 3: Use Custom Functions
68+
6069
In any cell, type:
70+
6171
```
6272
=OILPRICE("BRENT_CRUDE_USD")
6373
```
6474

6575
### Step 4: Fetch Multiple Prices
76+
6677
1. Extensions → OilPriceAPI → Fetch Prices
6778
2. Select commodities
6879
3. Click Fetch
@@ -71,6 +82,7 @@ In any cell, type:
7182
## 🎨 Example Dashboards
7283

7384
### Energy Price Comparison
85+
7486
```
7587
| Commodity | Latest Price | $/MMBtu | 30-Day Change |
7688
|-----------------|--------------|----------|---------------|
@@ -81,6 +93,7 @@ In any cell, type:
8193
```
8294

8395
### Historical Price Chart
96+
8497
1. Fetch past year data
8598
2. Insert → Chart
8699
3. Select date and price columns
@@ -89,28 +102,32 @@ In any cell, type:
89102
## 💰 Pricing
90103

91104
**Free Tier:**
105+
92106
- 100 requests (lifetime)
93107
- Real-time prices
94108
- 20+ commodities
95109
- Custom functions
96110

97111
**Exploration ($15/mo):**
112+
98113
- 10,000 requests/month
99114
- Historical data access
100115
- Pandas integration (Python SDK)
101116
- Email support
102117

103118
**Production ($45/mo):**
119+
104120
- 50,000 requests/month
105121
- Webhooks
106122
- Priority support
107123
- 99.9% uptime SLA
108124

109-
[View Full Pricing](https://oilpriceapi.com/pricing)
125+
[View Full Pricing](https://www.oilpriceapi.com/pricing?utm_source=google_sheets&utm_medium=addin&utm_campaign=pricing)
110126

111127
## 🛠️ Development
112128

113129
### Project Structure
130+
114131
```
115132
google-sheets-energy-addin/
116133
├── Code.gs # Main Apps Script code
@@ -122,12 +139,14 @@ google-sheets-energy-addin/
122139
```
123140

124141
### Testing Locally
142+
125143
1. Open Google Apps Script editor
126144
2. Make changes to Code.gs or Sidebar.html
127145
3. Click Run → test function
128146
4. Debug in Apps Script console
129147

130148
### Deployment
149+
131150
1. Click Deploy → New deployment
132151
2. Type: Add-on
133152
3. Description: Version X.X.X
@@ -155,13 +174,15 @@ google-sheets-energy-addin/
155174
## 📞 Support
156175

157176
**Having issues?**
177+
158178
- Email: support@oilpriceapi.com
159179
- GitHub Issues: https://github.com/OilpriceAPI/google-sheets-addin/issues
160180
- Documentation: https://www.oilpriceapi.com/tools/sheets-support
161181

162182
## 🎓 Examples
163183

164184
### Example 1: Build a Price Dashboard
185+
165186
1. Create new sheet named "Dashboard"
166187
2. Add formulas:
167188
```
@@ -173,12 +194,14 @@ google-sheets-energy-addin/
173194
4. Add conditional formatting for price changes
174195

175196
### Example 2: Historical Analysis
197+
176198
1. Extensions → OilPriceAPI → Fetch Historical
177199
2. Select "Brent Crude" and "Past Year"
178200
3. Data appears in "Historical" sheet
179201
4. Create line chart to visualize trends
180202

181203
### Example 3: Energy Cost Calculator
204+
182205
```
183206
A1: Commodity | B1: =OILPRICE("NATURAL_GAS_USD")
184207
A2: Volume (MMBtu) | B2: 1000
@@ -200,6 +223,7 @@ MIT License - See LICENSE file for details
200223
## 🚀 Contributing
201224

202225
Contributions welcome! Please:
226+
203227
1. Fork the repository
204228
2. Create feature branch
205229
3. Submit pull request
@@ -214,4 +238,4 @@ Contributions welcome! Please:
214238

215239
**Built with ❤️ by OilPriceAPI**
216240

217-
[Website](https://oilpriceapi.com)[Pricing](https://oilpriceapi.com/pricing)[Docs](https://docs.oilpriceapi.com)[Support](mailto:support@oilpriceapi.com)
241+
[Website](https://www.oilpriceapi.com)[Pricing](https://www.oilpriceapi.com/pricing?utm_source=google_sheets&utm_medium=addin&utm_campaign=pricing)[Docs](https://docs.oilpriceapi.com)[Support](mailto:support@oilpriceapi.com)

0 commit comments

Comments
 (0)