This document describes how to create a secure link between your GitHub account and your iQ Tag Management (TiQ) account using an access token. Once linked, the new JavaScript Code extension has access to use files from your GitHub repository. Your code remains safely stored in GitHub, but is available to publish in your TiQ profile.

In this article:

Table of Contents Placeholder

Prerequisites

  • A GitHub account with at least one public repository
  • A GitHub personal access token
  • Working knowledge of GitHub and experience working with GitHub repositories
  • Your TiQ account must have the Manage Account permission (Learn more)

How It Works

The GitHub integration allows you to create a seamless workflow between your code management process in GitHub and publishing in TiQ. You create a secure link between TiQ and GitHub with your GitHub username and personal access token. Once the account is linked, your TiQ account will be able to integrate with the code files in your respositories.

When your GitHub account is linked and your TiQ configuration has references to code files in your GitHub repository, you can easily sync those files to get the latest versions in your TiQ profile.

Supported Features

The following features support the GitHub integration:

Linking to GitHub

In this step, you will create a secure link to your GitHub account to allow code syncing from your GitHub repository.

To link to your GitHub account:

  1. In TiQ, click the username menu and select Manage GitHub Account.
  2. Enter your GitHub Username.
    This is the username or email address you use to sign in to GitHub.
  3. Enter your Access Token.
    This is the token used to authenticate your account with third-party applications.

    You can locate your Access Token in GitHub by going to User > Settings > Developer Settings > Personal Access Tokens. (Learn more)
    When generating your personal access token, ensure that you select the "repo" checkbox.

  4. Click Link Account.
    Manage GitHub Account New.jpg
  5. Click Save Changes.

Unlink a GitHub Account

In this step, you will remove the link to your GitHub account. Any files from your GitHub repository that are referenced in your TiQ configuration will remain, but they will no longer be synced.

To unlink to your GitHub account:

  1. In TiQ, click the username menu and select Manage GitHub Account.
  2. Click Unlink Account to remove the linked GitHub account.

FAQ

I am getting a message that says my authorization is invalid, what can I do?

This can be caused when automatic or manual syncing fails due to one of the following reasons:

  • GitHub is down.
  • The URL being used to retrieve the file no longer is valid. For example, the user renamed or deleted the file on GitHub.
  • There are too many snippets trying to be synced (more than 10).
  • The API token was revoked or the GitHub account was deleted.

How can I correct invalid authorization errors?

  • If GitHub is down, there is nothing you can do until the service is up again. You can keep using the extension as normal but will not be able to get the latest code from GitHub. If this is the case, a message with a timestamp will display that the system is unable to connect until GitHub is back up.
  • If the URL being used to retrieve the file is no longer valid, you can delete the snippet if it is no longer needed and replace it with a new snippet containing the new URL.
  • If  you have more than ten (10) GitHub snippets that were configured to automatically sync, delete the extra snippets if possible.
  • If the credentials are invalid, contact your GitHub account manager or contact GitHub support. In some cases, support may might need to unlink your account and relink it with a new access token.

What happens to my GitHub files in TiQ if I unlink my account?

  • If you unlink your GitHub account, the files are still there and can be used but are in "disconnected" mode. While unlinked, no syncing occurs.
  • Once the account is relinked, the files are again active and will sync as normal.

If I previously enabled the GitHub Integration feature using the Early Access program, do I need to switch to Experiments?

  • If you previously accessed the GitHub Integration for JavaScript Code Extension feature using the Early Access program, Tealium recommends that you disable the feature in Early Access and then enable the feature using Experiments.