Genel bakış
Google Etiket Yöneticisi'nin (GTM) mobil uygulaması olan bir sınıf.
Örnek kullanım:
TAGContainer *container =
[[TAGManager instance] openContainerById:myContainerId];
NSString *value = [container stringForKey:@"myKey"];TAGDataLayer *dataLayer = [[TAGManager instance] dataLayer]; [dataLayer push:@{@"event": @"openScreen", @"screenName": @"Main Page"}];
Kapsayıcı; makrolar, kurallar ve etiketlerden oluşan bir koleksiyondur. GTM uygulaması (http://www.google.com/tagmanager) içinde oluşturulur ve bu tanımlayıcıya bir kapsayıcı kimliği atanır. Bu kapsayıcı kimliği, bu API'de kullanılan kimliktir.
TAGContainer sınıfı, makro adına göre makro değerlerini alma yöntemleri sağlar. booleForKey: (TAGContainer), doubleForKey: (TAGContainer), int64ForKey: (TAGContainer), stringForKey: (TAGContainer) rutinleri, kapsayıcıdaki ilgili makroyla ilişkili kurallara bağlı olarak değer koleksiyonu makro adı için geçerli değeri döndürür.
Örneğin, kapsayıcınızda değeri 32 olan "speed" anahtarına sahip bir değer toplama makrosu varsa ve etkinleştirme kuralı Language "en" ise; değeri 45 olan ve etkinleştirme kuralı Dil "en" olmayan bir anahtar "speed" anahtarına sahip başka bir değer toplama makrosu varsa şu çağrı yapılır:
[container longForKey:@"speed"]
cihazın geçerli dili İngilizceyse 32, değilse 45 değerini döndürür.
Veri katmanı, uygulama hakkında genel bilgileri içeren bir haritadır. TAGDataLayer sınıfı, veri katmanından veri aktarmak ve almak için yöntemler sunar. Veri katmanına bir event anahtarı aktarmak, bu etkinlikle eşleşen etiketlerin tetiklenmesine neden olur.
Kapsayıcının ilk sürümü, uygulamayla birlikte gelir. containerId adlı pakete bir kaynak olarak yerleştirilmelidir. Burada containerId, bu API'de kullanacağınız kapsayıcı kimliğidir. openContainerById:callback: (TAGManager) yöntemini çağırdığınızda kapsayıcı, paketlenmiş kurallar/etiketler/makrolarla birlikte döndürülür. Kullanıcı arayüzünde kapsayıcıyı oluşturur ve İndir düğmesini kullanarak indirin.
Kullanıcı arayüzünde kapsayıcıyı değiştirebilir ve yeni bir sürüm yayınlayabilirsiniz. Bu durumda, mobil uygulama kapsayıcıyı ağdan tekrar yenilediğinde (şu anda 12 saatte bir) bu yeni sürümü alır. "get..." rutinlerinden birini çağırdığınızda değer, en son kurallar kullanılarak hesaplanır.
İndirilen kapsayıcı yerel olarak kaydedilir. openContainerById:callback: (TAGManager) yöntemini çağırdığınızda, önce varsayılan kapsayıcı yüklenir. Daha sonra, kaydedilmiş herhangi bir kapsayıcı, eşzamansız olarak yüklenir. Hiçbir şey bulunmazsa veya 12 saatten daha eskiyse ağdan daha yeni bir sürüm almaya çalışır. Bu eşzamansız yüklemelerin durumunu, openContainerById:callback: (TAGManager) aracına bir TAGContainerCallback ileterek öğrenebilirsiniz.
Bazen, varsayılan olmayan bir kapsayıcı ya da yeni bir kapsayıcı kullanılabilir olana kadar engelleme işlemi yapmak isteyebilirsiniz. Bunu, openContainerById:callback: (TAGManager) içindeki geri çağırmaları veya TAGContainerOpener işlevini kullanarak yapabilirsiniz.
Bir kapsayıcıyla işiniz bittiğinde close (TAGContainer) işlevini çağırın.
Herkese Açık Üye İşlevleri | |
| (TAGContainer *) | - openContainerById:callback: |
| Bir kapsayıcı döndürür. | |
| (TAGContainer *) | - getContainerById: |
Belirtilen containerId ile ilişkili kapsayıcıyı döndürür; kapsayıcı zaten açık değilse nil değerini döndürür. | |
| (BOOL) | - previewWithUrl: |
| Uygulamayı giriş URL'si ile önizler. | |
| (void) | - dispatch |
| Etiketler (isteğe bağlı pikseller, analiz işaretçileri vb.) tarafından oluşturulan beklemedeki tüm ağ trafiğini gönderir. | |
| (void) | - dispatchWithCompleteHandler: |
| İstek gönderildiğinde (kTAGDispatchGood döndürüldüğünde) veya bir hata oluştuğunda (kTAGDispatchError döndürüldüğünde) completeHandler'ı çağırarak sıradaki beklemedeki sonraki ağ trafiğini gönderir. | |
Statik Herkese Açık Üye İşlevleri | |
| (TAGManager *) | + örnek |
| Gerekirse TAGManager sınıfının tekli örneğini alır. | |
Mülkler | |
| id< TAGLogger > | logger |
| Google Etiket Yöneticisi SDK'sı için kullanılacak günlük kaydedici. | |
| TAGRefreshMode | refreshMode |
| Google Etiket Yöneticisi SDK'sı için kullanılan yenileme modu. | |
| TAGDataLayer * | dataLayer |
| Etkinlikleri ve diğer verileri aktarmak için push: (TAGDataKatman) yöntemini çağırın. | |
| NSTimeInterval | dispatchInterval |
| Bu değer pozitifse izleme bilgileri her {/6}referralInterval saniyede otomatik olarak gönderilir. | |
Üye İşlevi Belgeleri
| - (TAGContainer *) OpenContainerById: | (NSString *) | containerId | |
| geri arama: | (kimlik< TAGContainerCallback >) | callback | |
Bir kapsayıcı döndürür.
Döndürülen kapsayıcı genellikle boş olur, ancak yükleme eşzamansız olarak gerçekleşir. Bu nedenle döndürülen kapsayıcı, döndürülmeden önce veya döndürüldükten sonra yenilenebilir ya da örneğin, kapsayıcının kullanım süresi boyunca ağ bağlantısı yoksa hiçbir zaman yenilenmeyebilir.
Geri çağırma, kapsayıcıyla ilgili çeşitli işlemler sırasında çağrılır. En azından, openContainerById:callback: kapsayıcının kaydedilmiş bir sürümünü yüklemeye çalışır. Kayıtlı sürüm yoksa veya kayıtlı sürüm eskiyse ağdan yüklenmeye çalışılır.
openContainerById:callback: belirli bir containerId için ikinci kez çağrılırsa önceki açılmış kapsayıcı zaten kapanmadığı sürece nil döndürülür.
- Parametreler:
-
containerId Açılacak kapsayıcının kimliği. geri çağırma Yükleme işlemi sırasında çeşitli yöntemleri çağrılacak bir nesne. Yöntemlerin farklı iş parçacıklarından çağrılabileceğini unutmayın. Ayrıca, openContainerById:callback: döndürülmeden önce çağrılabilir.
- İade et:
- Açık kapsayıcı.
| - (TAGContainer *) getContainerById: | (NSString *) | containerId |
Belirtilen containerId ile ilişkili kapsayıcıyı döndürür; kapsayıcı zaten açık değilse nil değerini döndürür.
| - (BOOL) previewWithUrl: | (NSURL *) | url |
Uygulamayı giriş URL'si ile önizler.
Geçerli URL şununla başlamalıdır:
tagmanager.c.<app_name>://preview/p?id=
burada <uygulama_adı> uygulama adıdır.
- Parametreler:
-
url Önizleme URL'si.
- İade et:
- URL geçerli bir tagmanager önizleme URL'siyse EVET.
| + (TAGManager *) örnek |
Gerekirse TAGManager sınıfının tekli örneğini alır.
- İade et:
- TAGManager'ın tekillik örneği.
| - (geçersiz) gönderim |
Etiketler (isteğe bağlı pikseller, analiz işaretçileri vb.) tarafından oluşturulan beklemedeki tüm ağ trafiğini gönderir.
| - (geçersiz) dispatchWithCompleteHandler: | (TAGDispatchResult) | completionHandler |
İstek gönderildiğinde (kTAGDispatchGood döndürüldüğünde) veya bir hata oluştuğunda (kTAGDispatchError döndürüldüğünde) completeHandler'ı çağırarak sıradaki beklemedeki sonraki ağ trafiğini gönderir.
Ağ bağlantısı yoksa veya gönderilecek veri yoksa kTAGDispatchNoData döndürülür.
Bu yöntemin nilcompletionHandler ile çağrılması, görev dağıtıcının çağrılmasıyla aynıdır.
Bu yöntem, iOS 7.0 veya sonraki sürümlerde arka planda veri getirme işlemi için kullanılabilir.
Uygulamadan çıkarken, gönderilmemiş takip bilgilerini göndermeye başlamak için bu çağrıyı çağırmak mantıklı olacaktır.
Gayrimenkul Dokümanları
Google Etiket Yöneticisi SDK'sı için kullanılacak günlük kaydedici.
Varsayılan olarak, Google Etiket Yöneticisi hata/uyarı mesajlarını günlüğe kaydeder ve bilgi/hata ayıklama/ayrıntılı mesajları yoksayar. Bu özelliği ayarlayarak kendi özelleştirilmiş günlük kaydedicinizi kullanabilirsiniz.
- (TAGRefreshMode) refreshMode [read, write, assign] |
Google Etiket Yöneticisi SDK'sı için kullanılan yenileme modu.
Bunun kTAGRefreshModeDefaultContainer olarak ayarlanması, yenileme yönteminin geliştirme amacıyla yalnızca varsayılan kapsayıcıyı kullanmasına olanak tanır. Varsayılan değer kTAGRefreshModeStandard şeklindedir.
- (TAGDataLayer*) dataLayer [read, assign] |
Etkinlikleri ve diğer verileri aktarmak için push: (TAGDataKatman) yöntemini çağırın.
- (NSTimeInterval) dispatchInterval [read, write, assign] |
Bu değer pozitifse izleme bilgileri her {/6}referralInterval saniyede otomatik olarak gönderilir.
Aksi takdirde, izleme bilgileri görev dağıtıcı araması yapılarak manuel olarak gönderilmelidir.
Varsayılan olarak bu değer, izleme bilgilerinin 120 saniyede bir otomatik olarak gönderileceğini belirten "120" değerine ayarlıdır.