Tag Manager API – הפניית מילון משתנה

במסמך הזה מתוארים המאפיינים שאפשר להגדיר ל-Google Tag משתני מנהל.

מבוא

כל משתנה של Google Tag Manager מכיל קוד type לזיהוי המשתנה. בנוסף, רוב המשתנים כוללים פרמטרים (key, type שאפשר להגדיר כחלק מ'אובייקט פרמטר' כשיוצרים או מעדכנים משתנה. כדי לקבל מידע נוסף על הגדרת הפרמטרים האלה באמצעות את האובייקט של הפרמטר. הפניה לפרמטרים.

בהמשך המסמך מפורטים הפרטים של כל המשתנים הנתמכים.

קובץ Cookie של צד ראשון

הקלדת קוד

k

פרמטרים

מפתח סוג הערות
name template שם קובץ Cookie.

דוגמה

 {
   "name": "Sample First Party Cookie Variable",
   "type": "k",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "myCookieName"
    }
   ]
 }

משתנה אוטומטי של אירוע

הקלדת קוד

aev

פרמטרים

מפתח סוג הערות
varType template אחד מ- ELEMENT,CLASSES, ID, TARGET, TEXT, URL, HISTORY_NEW_URL_FRAGMENT, HISTORY_OLD_URL_FRAGMENT, HISTORY_NEW_STATE, HISTORY_OLD_STATE, HISTORY_CHANGE_SOURCE.
defaultValue template זה שינוי אופציונלי.

דוגמה

  {
   "name": "Sample AutoEvent Variable",
   "type": "aev",
   "parameter": [
    {
     "type": "template",
     "key": "varType",
     "value": "CLASSES"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefault"
    }
   ]
  }

מחרוזת קבועה

הקלדת קוד

c

פרמטרים

מפתח סוג
value template

דוגמה

  {
   "name": "Sample Constant String",
   "type": "c",
   "parameter": [
    {
     "type": "template",
     "key": "value",
     "value": "MyString"
    }
   ]
  }

מספר גרסה של מאגר תגים

הקלדת קוד

ctv

פרמטרים

לא רלוונטי

דוגמה

  {
   "name": "Sample Container Version Number",
   "type": "ctv"
  }

אירוע בהתאמה אישית

הקלדת קוד

פרמטרים

לא רלוונטי

דוגמה

  {
   "name": "Custom Event Name",
   "type": "e"
  }

JavaScript בהתאמה אישית

הקלדת קוד

jsm

פרמטרים

מפתח סוג
javascript template

דוגמה

  {
   "name": "Sample Custom Javascript",
   "type": "jsm",
   "parameter": [
    {
     "type": "template",
     "key": "javascript",
     "value": "function() {\n return \"Hello World\";\n}"
    }
   ]
  }

משתנה של שכבת נתונים

הקלדת קוד

v

פרמטרים

מפתח סוג הערות
name template שם המשתנה של שכבת הנתונים.
defaultValue template
dataLayerVersion integer 1 או 2.

דוגמה

  {
   "name": "Sample Data Layer Variable",
   "type": "v",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "DL Variable Name"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "DEFAULT"
    },
    {
     "type": "integer",
     "key": "dataLayerVersion",
     "value": "2"
    }
   ]
  }

מצב ניפוי באגים

הקלדת קוד

dbg

פרמטרים

לא רלוונטי

דוגמה

  {
   "name": "Sample Debug Mode Variable",
   "type": "dbg"
  }

רכיב DOM

הקלדת קוד

d

פרמטרים

מפתח סוג הערות
elementId template
attributeName template זה שינוי אופציונלי.

דוגמה

  {
   "name": "Sample DOM Element Variable",
   "type": "d",
   "parameter": [
    {
     "type": "template",
     "key": "elementId",
     "value": "MyElementId"
    },
    {
     "type": "template",
     "key": "attributeName",
     "value": "MyAttributeName"
    }
   ]
  }

מקור ההפניה של HTTP

הקלדת קוד

f

פרמטרים

מפתח סוג הערות
component template אחת מהאפשרויות: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
stripWww boolean לרכיב = HOST
queryKey template לרכיב = QUERY

דוגמה

  {
   "name": "Sample HTTP Referrer Variable",
   "type": "f",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    }
   ]
  }

משתנה JavaScript

הקלדת קוד

j

פרמטרים

מפתח סוג הערות
name template שם של משתנה גלובלי.

דוגמה

  {
   "name": "Sample Javascript Variable",
   "type": "j",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "MyGlobalVarName"
    }
   ]
  }

טבלת חיפוש

הקלדת קוד

smm

פרמטרים

מפתח סוג הערות
input template הערך המשמש לחיפוש צריך להיות הפניה למשתנה.
map list רשימה של מפות, שלכל אחת מהן יש צמד [key, value].
map[].key template
map[].value template
defaultValue template זה שינוי אופציונלי.

דוגמה

  {
   "name": "Sample Lookup Table Variable",
   "type": "smm",
   "parameter": [
    {
     "type": "template",
     "key": "input",
     "value": "{{event}}"
    },
    {
     "type": "list",
     "key": "map",
     "list": [
      {
       "type": "map",
       "map": [
        {
         "type": "template",
         "key": "key",
         "value": "EventEqualsThis"
        },
        {
         "type": "template",
         "key": "value",
         "value": "ThenSetToThis"
        }
       ]
      }
     ]
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefaultValue"
    }
   ]
  }

מספר אקראי

הקלדת קוד

r

פרמטרים

לא רלוונטי

דוגמה

  {
   "name": "Sample Random Number Variable",
   "type": "r"
  }

כתובת URL

הקלדת קוד

u

פרמטרים

מפתח סוג הערות
component template אחת מהאפשרויות: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
customUrlSource template זה שינוי אופציונלי.
stripWww boolean לרכיב = HOST.
queryKey template לרכיב = QUERY.

דוגמה

  {
   "name": "Sample URL Variable",
   "type": "u",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    },
    {
     "type": "template",
     "key": "customUrlSource",
     "value": "{{element}}"
    }
   ]
  }