![\"Osiem](\"https:\/\/www.lukaswojcik.com\/blog\/wp-content\/uploads\/diagrams\/containerversion-finden-pl.png\")
Co pokazuje lista wersji, a co ukrywa<\/h2>\n
Ka\u017cda publikacja tworzy wersj\u0119, a ta wersja jest pe\u0142n\u0105, niezmienn\u0105 kopi\u0105 kontenera z tamtej chwili. Lista tych wersji pokazuje cztery rzeczy: numer, nazw\u0119, kto opublikowa\u0142 i kiedy.<\/p>\n
Nie pokazuje zawarto\u015bci. Dwie wersje mog\u0105 r\u00f3\u017cni\u0107 si\u0119 jednym znakiem w jednej zmiennej, a lista i tak wygl\u0105da tak samo. Liczba zmian obok wersji pomaga troch\u0119, a myli wiele, bo liczy zmiany w obszarze roboczym, a nie r\u00f3\u017cnic\u0119 wobec wersji poprzedniej – obszar roboczy, w kt\u00f3rym co\u015b zmieniono i cofni\u0119to, podnosi t\u0119 liczb\u0119, niczego nie zmieniaj\u0105c.<\/p>\n
Jedynym polem, kt\u00f3re odpowiedzia\u0142oby na pytanie wprost, s\u0105 notatki wersji. To dowolny tekst, pisany przy publikacji, i w niemal ka\u017cdym istniej\u0105cym kontenerze pusty. Wype\u0142nianie go jest najta\u0144sz\u0105 mo\u017cliw\u0105 popraw\u0105 ca\u0142ego tego problemu – i pomaga dopiero od teraz.<\/p>\n
Pobranie wersji przez API<\/h2>\n
API Tag Managera zwraca te same wersje, kt\u00f3re pokazuje interfejs, oraz pe\u0142n\u0105 zawarto\u015b\u0107 ka\u017cdej z nich. Wystarczy dost\u0119p do odczytu.<\/p>\n
# Zakres: https:\/\/www.googleapis.com\/auth\/tagmanager.readonly\n\nBASIS=\"https:\/\/tagmanager.googleapis.com\/tagmanager\/v2\"\nPFAD=\"accounts\/6000000001\/containers\/7000000002\"\n\n# 1 lista wersji - krotka, bez zawartosci\ncurl -s -H \"Authorization: Bearer $TOKEN\" \\\n \"$BASIS\/$PFAD\/version_headers\" | jq -r \\\n '.containerVersionHeader[] | [.containerVersionId, .name] | @tsv'\n\n# 2 jedna pelna wersja\ncurl -s -H \"Authorization: Bearer $TOKEN\" \\\n \"$BASIS\/$PFAD\/versions\/41\" > version-41.json<\/code><\/pre>\nDwie rzeczy o pierwszym wywo\u0142aniu warto wiedzie\u0107. Zwraca nag\u0142\u00f3wki zamiast zawarto\u015bci, co czyni je tanim i jest w\u0142a\u015bciw\u0105 drog\u0105 do wyliczenia. I jest stronicowane: kontener z wieloma wersjami zwraca nextPageToken<\/code>, a skrypt go pomijaj\u0105cy po cichu pracuje wy\u0142\u0105cznie z najnowsz\u0105 stron\u0105.<\/p>\nDrugie wywo\u0142anie jest tym drogim, bo zwraca ca\u0142y kontener. To pow\u00f3d istnienia nast\u0119pnego rozdzia\u0142u: pobranie czterdziestu pe\u0142nych wersji, by por\u00f3wna\u0107 jeden tag, to du\u017co danych na jedno pytanie.<\/p>\n
Suma kontrolna wskazuj\u0105ca zmian\u0119<\/h2>\n
Ka\u017cdy element kontenera niesie pole fingerprint<\/code>, a zmienia si\u0119 ono, gdy tylko element zostanie zmodyfikowany. Por\u00f3wnanie sumy kontrolnej jednego tagu w kolejnych wersjach odpowiada wi\u0119c na pytanie bez por\u00f3wnywania czegokolwiek innego.<\/p>\nimport json, glob\n\nGESUCHT = \"25\" # tagId: GA4 - Event - purchase\n\nvorher = None\nfor datei in sorted(glob.glob(\"version-*.json\"),\n key=lambda d: int(d.split(\"-\")[1].split(\".\")[0])):\n daten = json.load(open(datei))\n tags = {t[\"tagId\"]: t for t in daten.get(\"tag\", [])}\n tag = tags.get(GESUCHT)\n\n if tag is None:\n print(f\"{datei:16s} nie istnieje\")\n else:\n marke = tag[\"fingerprint\"]\n hinweis = \"ZMIENIONY\" if vorher and marke != vorher else \"\"\n print(f\"{datei:16s} {marke} {hinweis}\")\n vorher = marke<\/code><\/pre>\nWynikiem jest jedna linia na wersj\u0119, a te ciekawe zg\u0142aszaj\u0105 si\u0119 same. Tag nietkni\u0119ty przez trzydzie\u015bci wersji, a potem raz zmieniony, daje dok\u0142adnie jeden oznaczony wiersz – i ten wiersz jest odpowiedzi\u0105.<\/p>\n
Dwie w\u0142a\u015bciwo\u015bci sumy kontrolnej zas\u0142uguj\u0105 na uwag\u0119. Jest nieprzejrzysta – m\u00f3wi, \u017ce co\u015b si\u0119 zmieni\u0142o, a nie co – i do tego kroku to wystarcza. I zmienia si\u0119 przy ka\u017cdej edycji, \u0142\u0105cznie ze zmian\u0105 nazwy: przemianowany tag pojawia si\u0119 jako zmieniony, cho\u0107 zachowuje si\u0119 tak samo. Zestawianie po tagId<\/code> zamiast po nazwie tego nie zmienia, ale prze\u017cywa t\u0119 zmian\u0119 nazwy, kt\u00f3ra w og\u00f3le utrudni\u0142a odnalezienie elementu.<\/p>\nZnale\u017a\u0107 wersj\u0119, potem por\u00f3wna\u0107 dwie<\/h2>\n
Gdy wersja jest znana, por\u00f3wnanie odbywa si\u0119 mi\u0119dzy dwoma plikami, a nie czterdziestoma – i op\u0142aca si\u0119 na kopii ujednoliconej, a nie na surowym eksporcie.<\/p>\n
# tylko szukany tag z obu wersji, posortowany\nfor v in 43 44; do\n jq -S --arg n \"GA4 - Event - purchase\" \\\n '.tag[] | select(.name == $n)' version-$v.json > tag-$v.json\ndone\n\ndiff -u tag-43.json tag-44.json<\/code><\/pre>\nTo -S<\/code> czyni wynik czytelnym. Bez niego klucze JSON wracaj\u0105 w kolejno\u015bci wytworzonej przez API, a por\u00f3wnanie dw\u00f3ch obiekt\u00f3w o tym samym znaczeniu potrafi mie\u0107 kilkadziesi\u0105t linii. Posortowanie kluczy usuwa to ca\u0142kowicie, a zostaje w\u0142a\u015bciwa zmiana.<\/p>\nTrzy pola warto w por\u00f3wnaniu pomin\u0105\u0107, bo zmieniaj\u0105 si\u0119 same z siebie: fingerprint<\/code>, s\u0142u\u017c\u0105cy tutaj do znalezienia wersji, a nie do jej opisu, oraz ka\u017cde pole znacznika czasu albo \u015bcie\u017cki nios\u0105ce numer wersji. Wszystko inne, co si\u0119 r\u00f3\u017cni, jest r\u00f3\u017cnic\u0105 prawdziw\u0105.<\/p>\nPrzydzia\u0142 zapyta\u0144 i kopia lokalna<\/h2>\n
API Tag Managera ma ograniczenia na minut\u0119 i na dob\u0119, a p\u0119tla po czterdziestu pe\u0142nych wersjach szybko na nie wpada. Niepowodzeniem jest odpowied\u017a 429, a skrypt bez przerwy zamienia jedno badanie w API zablokowane do ko\u0144ca godziny.<\/p>\n
for v in $(cat versionen.txt); do\n [ -f \"version-$v.json\" ] && continue # juz jest\n curl -s -H \"Authorization: Bearer $TOKEN\" \\\n \"$BASIS\/$PFAD\/versions\/$v\" > \"version-$v.json\"\n sleep 2\ndone<\/code><\/pre>\nPomini\u0119cie istniej\u0105cego pliku to wa\u017cna linia. Wersje s\u0105 niezmienne, wi\u0119c raz pobranej wersji nigdy nie trzeba pobiera\u0107 ponownie – a katalog z nimi staje si\u0119 archiwum odpowiadaj\u0105cym na nast\u0119pne pytanie bez dotykania API w og\u00f3le.<\/p>\n
To archiwum warto zak\u0142ada\u0107 celowo, a nie ubocznie. Cotygodniowe zadanie pobieraj\u0105ce najnowsze wersje nic nie kosztuje – a dzi\u0119ki temu historia jest dost\u0119pna tak\u017ce dla kontenera, do kt\u00f3rego kto\u015b p\u00f3\u017aniej traci dost\u0119p.<\/p>\n
Pytanie, na kt\u00f3re API nie odpowiada<\/h2>\n
Trzy rzeczy pozostaj\u0105 poza zasi\u0119giem, a wiedza o tym, kt\u00f3re to, oszcz\u0119dza d\u0142ugiego szukania czego\u015b, czego nie ma.<\/p>\n
Pierwsz\u0105 jest to, kto zmieni\u0142 okre\u015blony element. Wersja zapisuje, kto j\u0105 opublikowa\u0142, a publikacja mo\u017ce zawiera\u0107 prac\u0119 kilku os\u00f3b z kilku tygodni. Autorstwa na poziomie elementu API nie ma, a interfejs r\u00f3wnie\u017c nie.<\/p>\n
Drug\u0105 jest wszystko, co nigdy nie sta\u0142o si\u0119 wersj\u0105. Zmiana wprowadzona w obszarze roboczym i cofni\u0119ta przed publikacj\u0105 nie zostawia \u015bladu, podobnie jak skasowany obszar roboczy. Historia jest histori\u0105 publikacji, a nie edycji.<\/p>\n
Trzeci\u0105 jest skutek. Dwie wersje mog\u0105 r\u00f3\u017cni\u0107 si\u0119 warunkiem wyzwalania spe\u0142niaj\u0105cym si\u0119 o dziesi\u0119\u0107 procent cz\u0119\u015bciej, a nic w kontenerze tego nie m\u00f3wi – r\u00f3\u017cnic\u0105 jest jedna linia konfiguracji, a jej nast\u0119pstwo stoi w danych. Dlatego ca\u0142a ta procedura jest pierwsz\u0105 po\u0142ow\u0105 badania: daje chwil\u0119 i zmian\u0119, a drug\u0105 po\u0142ow\u0105 jest sprawdzenie, czy liczby r\u00f3wnie\u017c poruszy\u0142y si\u0119 w tej chwili.<\/p>\n
\nPytania i odpowiedzi<\/h2>\nCzy por\u00f3wnanie sumy kontrolnej wykrywa tak\u017ce zmian\u0119 triggera albo zmiennej, z kt\u00f3rych korzysta tag?<\/h3>\n
Nie, i to jest najwa\u017cniejsza luka tej procedury. Pole fingerprint tagu zmienia si\u0119 tylko wtedy, gdy edytowany jest sam tag. Tag odwo\u0142uje si\u0119 do swoich trigger\u00f3w przez ich identyfikatory, a do zmiennych przez ich nazwy w podw\u00f3jnych nawiasach klamrowych. Je\u015bli kto\u015b zmieni warunek wyzwalania triggera albo warto\u015b\u0107 zmiennej, tag pozostaje identyczny znak po znaku, a wraz z nim jego suma kontrolna, cho\u0107 zachowuje si\u0119 ju\u017c inaczej.<\/p>\n
P\u0119tl\u0119 z artyku\u0142u da si\u0119 wi\u0119c rozszerzy\u0107 na zale\u017cno\u015bci: z tagu odczytuje si\u0119 identyfikatory w firingTriggerId i blockingTriggerId oraz zbiera nazwy wszystkich odwo\u0142a\u0144 {{\u2026}}, a nast\u0119pnie por\u00f3wnuje sumy kontrolne tych trigger\u00f3w w daten[\"trigger\"]<\/code> i tych zmiennych w daten[\"variable\"]<\/code> w kolejnych wersjach tak samo jak sum\u0119 tagu.<\/p>\nNawet to nie wystarcza w pe\u0142ni, bo zmienne mog\u0105 odwo\u0142ywa\u0107 si\u0119 do innych zmiennych. Dok\u0142adn\u0105 drog\u0105 jest \u015bledzenie odwo\u0142a\u0144, dop\u00f3ki nie przestan\u0105 pojawia\u0107 si\u0119 nowe; prostsz\u0105 jest por\u00f3wnanie od razu sum kontrolnych wszystkich element\u00f3w kontenera przy szukaniu wersji.<\/p>\n
Co si\u0119 dzieje, gdy pobranie w p\u0119tli ko\u0144czy si\u0119 odpowiedzi\u0105 429?<\/h3>\n
Plik i tak powstaje. Bez dodatkowych opcji curl -s zapisuje do wyj\u015bcia tak\u017ce odpowied\u017a z b\u0142\u0119dem, wi\u0119c version-44.json zawiera wtedy komunikat b\u0142\u0119du API w formacie JSON zamiast kontenera. Przy nast\u0119pnym przebiegu plik uchodzi za istniej\u0105cy i zostaje pomini\u0119ty, a wi\u0119c w\u0142a\u015bnie linia, kt\u00f3ra czyni archiwum warto\u015bciowym, utrwala b\u0142\u0105d.<\/p>\n
Skrypt analizuj\u0105cy tego nie zg\u0142asza, lecz wprowadza w b\u0142\u0105d: daten.get(\"tag\", [])<\/code> zwraca dla komunikatu b\u0142\u0119du pust\u0105 list\u0119, a wersja pojawia si\u0119 jako \u201enie istnieje\u201d, jakby tag zosta\u0142 w niej usuni\u0119ty.<\/p>\nSamo dodanie -f nie wystarczy, bo przekierowanie > tworzy plik, zanim curl odpowie; zosta\u0142by wtedy pusty plik, pomini\u0119ty tak samo. Pewn\u0105 drog\u0105 jest plik tymczasowy, kt\u00f3remu nadaje si\u0119 docelow\u0105 nazw\u0119 dopiero wtedy, gdy curl zako\u0144czy\u0142 si\u0119 powodzeniem, a jq -e .containerVersionId<\/code> znajduje warto\u015b\u0107.<\/p>\nCzy wersja, w kt\u00f3rej zmieni\u0142 si\u0119 tag, jest te\u017c t\u0105, kt\u00f3ra dzia\u0142a\u0142a w danym dniu?<\/h3>\n
Niekoniecznie. Ka\u017cda publikacja tworzy wersj\u0119, ale nie ka\u017cda wersja zostaje opublikowana: wersj\u0119 da si\u0119 utworzy\u0107 bez uruchamiania jej na stronie, a starsz\u0105 wersj\u0119 da si\u0119 p\u00f3\u017aniej opublikowa\u0107 ponownie, na przyk\u0142ad \u017ceby cofn\u0105\u0107 zmian\u0119. Numer wersji oddaje wi\u0119c kolejno\u015b\u0107 powstania, a nie kolejno\u015b\u0107 publikacji.<\/p>\n
Przy zestawieniu z raportem liczy si\u0119 to, kiedy kt\u00f3ra wersja zacz\u0119\u0142a dzia\u0142a\u0107. Je\u015bli por\u00f3wnanie znajduje zmian\u0119 w wersji 44, trzeba ustali\u0107, czy i kiedy wersja 44 zosta\u0142a opublikowana i czy potem nie obowi\u0105zywa\u0142a zn\u00f3w starsza wersja.<\/p>\n
Jakich uprawnie\u0144 potrzebuje cotygodniowe zadanie archiwizuj\u0105ce?<\/h3>\n
Wystarczy dost\u0119p do odczytu, jak podaje artyku\u0142, z zakresem tagmanager.readonly. Je\u015bli zadanie dzia\u0142a na koncie us\u0142ugi, jego adres e-mail musi zosta\u0107 dodany w Tag Managerze jako u\u017cytkownik z uprawnieniem do odczytu konta albo kontenera; sam zakres nie daje dost\u0119pu. Z samym prawem odczytu zadanie nie mo\u017ce niczego opublikowa\u0107, a utracony klucz ujawnia wtedy zawarto\u015b\u0107 kontenera, ale nie pozwala jej zmieni\u0107.<\/p>\n<\/div>\n