Skip to content

Commit

Permalink
#20 fixed
Browse files Browse the repository at this point in the history
2nd, Aug 2021
1. add global attribute to decide GA version - _g_bUaPropertyLoaded, _g_bGa4DatastreamIdLoaded
2. integrate all related method to integrate Google Analytics v3 and v4
3. update LICENSE.md to integrate Google Analytics v3 and v4
4. update README.md to integrate Google Analytics v3 and v4
  • Loading branch information
singleview-co-kr committed Aug 8, 2021
1 parent 826e34e commit a7a5e88
Show file tree
Hide file tree
Showing 3 changed files with 867 additions and 392 deletions.
2 changes: 1 addition & 1 deletion LICENSE.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@ Redistributions of source code must retain the above copyright notice, this list

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

Neither the name of gatk nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
Neither the name of gatk / gaectk nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 changes: 24 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,53 @@
Enhanced Ecommerce Snippet Code for Google Analytics v3
Enhanced Ecommerce JS Snippet Code for Google Analytics v3 and v4
============

[![License](http://img.shields.io/badge/license-GNU%20LGPL-brightgreen.svg)](http://www.gnu.org/licenses/gpl.html)
[![Latest release](https://img.shields.io/github/v/release/singleview-co-kr/gaectk.svg)](https://github.com/singleview-co-kr/gaectk/releases)

Enhanced Ecommerce Snippet Code for Google Analytics v3(gatk)는 누구나 쉽고 편하게 Google Analytics v3에 전자상거래 관련 이벤트를 전송하는 snippet code를 표준화했습니다.
Enhanced Ecommerce JS Snippet Code for Google Analytics v3 and v4(gaectk)는 Google Analytics for web이 제공하는 복잡한 JS snippet code 규칙을 몰라도 쉽고 정확하게 사용할 수 있도록 Google Analytics v3 and v4 for web의 전자상거래 관련 이벤트를 전송하는 snippet code를 라이브러리화했습니다.
오픈소스 라이선스로 누구나 사용 또는 개작할 수 있으며, 개방형 프로젝트로서 누구나 개발에 참여할 수 있습니다.

프로젝트는 Google Analytics와 관련된 시장의 낙후된 구조를 개선하기 위해 시작합니다.
프로젝트의 목표는 Google Analytics for web과 관련된 시장의 낙후된 구조를 개선하는 것입니다.

노련한 개발과 온라인 마케팅 자원을 보유하지 못한 조직이 Google Analytics를 사용하여 정량적인 온라인 마케팅을 시작하려고 하면 가장 먼저 부딪히는 난관이 자사의 쇼핑몰 사이트에 Enhanced Ecommerce Snippet Code를 설치하는 것인데
노련한 개발과 온라인 마케팅 자원이 없는 조직이 Google Analytics for web을 사용하여 정량적 온라인 마케팅을 시작하면 처음 부딪히는 난관이 자사의 쇼핑몰 사이트에 Enhanced Ecommerce Snippet Code를 설치하는 것입니다.

Enhanced Ecommerce Snippet Code를 설치하기 위해 외부팀과 논의하면 과도한 비용과 기간을 요구하는 경우가 많기 때문입니다.
이를 위해 외부팀과 논의하면 과도한 비용과 기간을 요구하는 경우가 많지만, 외부팀의 전문성과 신뢰성을 의심하게 되는 상황이 많아서 결국 정량적 온라인 마케팅이 시작부터 난관에 부딪히는 경우가 많습니다.

본 프로젝트는 이러한 시장의 문제를 두 가지 관점에서 개선하려고 노력합니다.

### 안정성

Google Analytics 전문가라고 자신을 소개하는 외부 조직이 코드 설치와 안정화를 위해 1주 이상의 기간을 요구한다면, 역설적으로 그 조직은 전문성이 매우 떨어진다고 의심해야 합니다.
Google Analytics for web전문가라고 자신을 소개하는 외부 조직이 코드 설치와 안정화를 위해 2일 이상의 기간을 요구한다면, 역설적으로 그 조직의 전문성을 매우 신중하게 검토해야 합니다.

gatk는 2015년부터 개발을 시작하여 다수의 성공적인 프로젝트에서 실제로 사용하고 2017년부터 안정성을 확보했습니다.
Google Anaytics for web은 한국 시장에서 본격적으로 사용된지 최소한 6년이 지났습니다. 아직도 정형화된 적용 절차를 확립하지 못해서 2일 이상의 검증 시간을 요구한다면, 운영 경험이 전무하거나, 사실은 시간이 소요되지 않지만 비용을 부풀리기 위해 의뢰인을 기밍하는 것인지 의심해야 합니다.

gaectk는 2015년부터 개발을 시작하여 다수의 성공적인 프로젝트에서 실제로 사용하고 백억 단위의 누적 광고비를 집행하며 2017년부터 수집 데이터의 안정성을 확보했습니다.

2021년 7월부터 Google Analytics v4 for web용 Enhanced Ecommerce snippet code 태스트를 시작했습니다.

웹페이지에 코드를 적용하는 즉시 데이터 수집이 시작되며, 오차없이 작동하는지 검토할 필요가 없습니다.

### 단순성

Google Analytics 전문가라고 자신을 소개하는 외부 조직이 코드 설치와 안정화를 위해 비용을 요구한다면, 역설적으로 그 조직은 기술력이 매우 떨어진다고 의심해야 합니다.
Google Analytics for web 전문가라고 자신을 소개하는 외부 조직이 코드 설치와 안정화를 위해 2일 이상의 인건비를 요구한다면, 역설적으로 그 조직의 기술력과 직업 윤리 의식을 신중하게 점검해야 합니다.

gatk 라이브러리는 pure Java Script라서 웹사이트에 팝업창을 띄울 수 있다면 설치할 수 있습니다.
왜냐하면 정형화된 적용 절차를 확립했다면, 2일 이상이 필요하지 않기 때문입니다. 다만, 의뢰인의 웹페이지에 코드를 설치할 수 없는 복잡한 사정이 있다면, 빠르게 거절할 수는 있습니다.

gaectk JS 라이브러리는 pure Java Script라서 웹사이트에 팝업창을 띄우고 HTML 스킨 코드를 수정할 수 있다면 설치할 수 있습니다.

더하여, 전자상거래를 위한 웹페이지는 UI 관련 코드만으로도 충분히 복잡합니다.

Google Analytics용 Enhanced Ecommerce Snippet Code만 설치하면 댓가를 취득할 수 있는 외부 조직은 미숙하여 사이트의 다른 소스 코드 유지 보수를 고려하지 않은 채 산만하게 코드를 적용하여 사이트 운영자의 행복을 저해하거나
Google Analytics for web용 Enhanced Ecommerce JS Snippet Code만 설치하면 댓가를 취득할 수 있는 외부 조직은 사이트의 다른 소스 코드 유지 보수를 고려하지 않은 채 코드를 적용하여 사이트 운영자의 행복을 저해하거나

여러가지 이유로 내부 인력의 Google Analytics for web용 Enhanced Ecommerce Snippet Code 접근을 방해하는 경우가 많습니다.

이후의 추가 수익이나 권리를 주장하기 위해 내부 인력들이 관리할 수 있도록 공개해야 하는 코드를 의도적으로 은폐시킵니다.
Google Analytics v4 블로그에서는 당분간 v4용 snippet code를 적용하는 중에 v3용 snippet code를 망치지 말라고 공식적으로 권고하고 있기 때문에 단순성을 유지해야 하는 필요는 더욱 커집니다.

위와 같은 이유로 클래스화된 pure JS를 사용하여 Google Analytics v3를 위한 Enhanced Ecommerce Snippet Code의 라인수를 줄이려는 노력은 유지보수 환경을 개선합니다.
위와 같은 이유로 클래스화된 pure JS를 사용하여 Google Analytics v3 and v4 for web를 위한 Enhanced Ecommerce Snippet Code의 복잡도를 줄이려는 노력은 유지보수 환경을 개선합니다.

### 오픈 소스 소프트웨어! 열린 프로젝트! (코드 공헌 가이드)

gatk는 singleview.co.kr이 내부 프로젝트를 성공시키기 위한 목적으로만 사용한 gatk를 기반으로 하여 수집 데이터의 정확성과 안정성은 확보했지만 발전과 개선의 여지는 상당할 것입니다.
gaectk는 singleview.co.kr이 내부 프로젝트를 성공시키기 위한 목적으로만 사용한 gaectk를 기반으로 하여 수집 데이터의 정확성과 안정성은 확보했지만 개선의 여지는 많을 것입니다.

참여를 원하시는 분들은 버그 신고/제안 혹은 Pull Request 전에 [CONTRIBUTING.md](./CONTRIBUTING.md) 문서를 먼저 읽어주시기 바랍니다.
singleview.co.kr은 여러분들의 개발 참여를 기다립니다.
Expand All @@ -46,7 +56,7 @@ singleview.co.kr은 여러분들의 개발 참여를 기다립니다.
@singleview-co-kr

## Contributors
TBD
한국의 Google Analytics for web 활용 수준을 향상시키고 싶은 분들의 참여를 환영합니다.

## Support
* Official site (Korean) : http://singleview.co.kr/
Loading

0 comments on commit a7a5e88

Please sign in to comment.