커뮤니티 템플릿 갤러리에 템플릿 제출

Google 태그 관리자의 커뮤니티 템플릿 갤러리를 사용하면 조직은 Google 태그 관리자와 기본적으로 통합되는 태그 및 변수 템플릿을 만들고 관리할 수 있습니다. 또한 템플릿을 빌드하고 GitHub에 템플릿 저장소를 게시한 다음, 커뮤니티 템플릿 갤러리에 템플릿을 제출하여 전 세계 사용자에게 제공할 수 있습니다. 조직이 얻을 수 있는 이점은 다음과 같습니다.

  • 고객이 조직의 템플릿을 손쉽게 추가하고 사용할 수 있습니다.
  • 태그 관리자 사용자가 조직의 브랜드에 노출됩니다.
  • 고객이 몇 개월이 아닌 몇 분 이내에 태그를 배포할 수 있습니다.
  • 조직은 템플릿에 업데이트를 게시하고 고객에게 자동 업데이트를 제공할 수 있습니다.

커뮤니티 템플릿 갤러리에 새 템플릿을 제출하는 프로세스의 주요 단계는 다음과 같습니다.

  1. 템플릿 제작
  2. 프로젝트 파일 준비
  3. GitHub에 파일 업로드
  4. 템플릿 제출

템플릿 제작

시작하려면 Google 태그 관리자에서 템플릿을 맞춤 템플릿으로 만듭니다. 템플릿이 철저한 테스트를 거쳤고, 템플릿의 콘텐츠가 스타일 가이드를 준수하고, 향후에 필요한 경우를 대비해 템플릿을 관리 및 업데이트할 방법을 계획하거나 준비하고 있는지 확인합니다.

서비스 약관

템플릿을 새로 제출할 때마다 Google 태그 관리자 커뮤니티 템플릿 갤러리의 서비스 약관에 동의해야 합니다. 템플릿의 서비스 약관에 동의하려면 다음 안내를 따르세요.

  1. Google 태그 관리자 커뮤니티 템플릿 갤러리 서비스 약관을 읽습니다.
  2. 템플릿 편집기에서 템플릿을 열고 정보 탭에서 '커뮤니티 템플릿 갤러리 서비스 약관 동의' 체크박스를 선택합니다.

템플릿 내보내기

템플릿이 완료되면 템플릿 파일을 로컬 머신으로 내보내고 파일 이름을 template.tpl로 바꿉니다.

프로젝트 파일 준비

다음 단계에서는 GitHub에 게시하기 위한 저장소를 준비합니다. 각 저장소에는 다음 파일이 포함되어야 합니다.

  1. 내보낼 템플릿 파일(이름: template.tpl). categories 항목을 추가하려면 이 파일을 업데이트해야 합니다.
  2. metadata.yaml 파일
  3. LICENSE 파일. 파일 이름은 모두 대문자여야 하고, 라이선스 파일의 콘텐츠는 Apache 2.0이어야 합니다.
  4. README.md 파일을 추가합니다(선택사항이지만 권장됨).

template.tpl에 카테고리 추가

categories 항목이 포함된 template.tpl 파일을 INFO 섹션으로 업데이트하고, 아래 표에서 선택한 관련성 높은 카테고리 값을 하나 이상 제공합니다. 둘 이상의 카테고리가 적절한 경우, 가장 관련성이 높은 것에서 가장 낮은 순으로 최대 3개의 카테고리 값을 제공할 수 있습니다.

예:

___INFO___

{
  "displayName": "Example Template",
  "categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
  // additional template properties, etc...
}

지원되는 카테고리 값 표:

카테고리 설명
ADVERTISING 광고
AFFILIATE_MARKETING 제휴 마케팅
ANALYTICS 애널리틱스
ATTRIBUTION 기여 분석
CHAT 채팅
전환수 전환 측정
DATA_WAREHOUSING 데이터 웨어하우징
EMAIL_MARKETING 이메일 마케팅
EXPERIMENTATION A/B 실험 및 콘텐츠 최적화
HEAT_MAP 히트맵
LEAD_GENERATION 리드 생성
MARKETING 마케팅
PERSONALIZATION 맞춤설정
REMARKETING 리마케팅
SALES 영업 및 CRM
SESSION_RECORDING 세션 녹음
SOCIAL 소셜
SURVEY 설문조사
TAG_MANAGEMENT 태그 관리 시스템
UTILITY Google 태그 관리자 유틸리티

metadata.yaml

metadata.yaml 파일에는 조직의 홈페이지로 연결되는 링크, 템플릿 문서, 버전 정보 등 템플릿에 대한 정보가 포함되어 있습니다. 각 버전은 SHA 번호라고도 알려진 변경 번호로 표시되며, 이러한 번호는 Git 커밋과 연결된 변경 번호입니다. changeNotes 필드는 선택사항이지만, 버전에 포함된 변경사항을 사용자에게 알리는 것이 좋습니다.

metadata.yaml 파일을 설정하려면 다음 안내를 따르세요.

  1. homepage 항목을 추가합니다. 이는 조직의 홈페이지를 가리키는 URL이어야 합니다.
  2. documentation에 대한 항목을 추가합니다. 이는 템플릿의 문서를 가리키는 URL이어야 합니다.
  3. GitHub에서, 템플릿의 초기 버전을 푸시하고자 하는 변경사항이 포함된 커밋을 찾아 SHA 번호를 복사합니다. commit view(커밋 뷰)로 이동하여 클립보드 아이콘(클립보드 아이콘)을 클릭하면 GitHub에서 SHA 번호를 손쉽게 얻을 수 있습니다. 이렇게 하면 SHA 번호 전체가 클립보드에 복사됩니다. 아래와 같이 이러한 숫자를 sha 항목의 값으로 versions 노드의 하위 요소로 붙여넣습니다.
  4. changeNotes 항목을 versions 노드에 추가하여 이 새 버전에 포함된 변경사항을 간략하게 설명합니다.
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

GitHub에 업로드

다음 단계에서는 파일을 GitHub에 업로드합니다. 위에서 설명한 대로 적절한 파일 및 구조로 GitHub 저장소를 만듭니다.

템플릿 저장소에는 Git 저장소의 루트 수준에서 확인되는 template.tpl, metadata.yaml, LICENSE 파일이 있어야 합니다. 각 Git 저장소에는 template.tpl 파일이 하나만 있어야 합니다. 모든 리소스는 GitHub 저장소의 기본 분기에 있어야 합니다. 이 구조와 일치하지 않는 템플릿 저장소는 갤러리에서 삭제됩니다.

커뮤니티 템플릿 갤러리에 있는 각 항목은 사용자가 버그를 발견하면 조직에 알릴 수 있도록 템플릿 GitHub 저장소의 Issues(문제) 섹션으로 연결됩니다. 발생하는 모든 문제를 검토하고 해결할 수 있도록 템플릿의 GitHub 저장소에서 Issues(문제) 기능이 사용 중지되지는 않았는지 확인합니다.

템플릿 제출

템플릿 저장소가 GitHub에서 호스팅되면 커뮤니티 템플릿 갤러리에 템플릿을 제출할 수 있습니다. 템플릿을 제출하려면 다음 단계를 따르세요.

  1. 갤러리에 추가할 템플릿 저장소에 대한 액세스 권한이 있는 계정으로 GitHub에 로그인했는지 확인합니다.
  2. 커뮤니티 템플릿 갤러리(tagmanager.google.com/gallery)로 이동합니다.
  3. 아이콘을 클릭하고 템플릿 제출을 선택합니다.
  4. 표시되는 필드에 저장소 URL을 입력하고 제출을 클릭합니다.

템플릿 업데이트

템플릿을 게시한 후에는 경우에 따라 템플릿에 업데이트를 제공할 수 있습니다. 템플릿에 대한 업데이트 사항이 있는 경우, 템플릿 사용자에게 알림이 전송되며 템플릿을 최신 버전으로 업데이트할 수 있는 옵션이 제공됩니다.

metadata.yaml 파일은 갤러리에서 사용할 템플릿의 버전을 결정하는 데 사용됩니다. 새 버전을 게시하려면 metadata.yaml 파일의 versions 섹션에 변경 번호(SHA 번호)를 추가해야 합니다.

  1. 푸시하고자 하는 변경사항이 포함된 커밋을 찾아 SHA 번호를 복사합니다. GitHub에서 commit view(커밋 뷰)로 이동하고 클립보드 아이콘(클립보드 아이콘)을 클릭하면 해당 번호를 손쉽게 복사할 수 있습니다. 이렇게 하면 SHA 번호 전체가 클립보드에 복사됩니다.
  2. metadata.yamlversions 목록 상단에 새 sha 항목을 추가합니다. (아래 예시를 참고하세요.)
  3. changeNotes를 추가하여 이 새 버전에 포함된 변경사항을 간략하게 설명합니다. 원하는 경우 여러 줄로 설명할 수 있습니다. (아래 예시를 참고하세요.)
  4. 변경사항을 metadata.yaml에 커밋하면 일반적으로 2~3일 이내에 업데이트가 갤러리에 표시됩니다.

이 예시에서는 SHA 번호와 변경 메모를 비롯해 새 버전 정보를 추가하는 방법을 보여줍니다.

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  # Latest version
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874c
    changeNotes: |2
      Fix bug with the whatsamajig.
      Improve menu options.
      Update API calls.
  # Older versions
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874b
    changeNotes: Adds eject button.
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.