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}}"
    }
   ]
  }