Yetkilendirme gerektiriyor
GTM etiketi oluşturur. Şimdi deneyin veya bir örneğe göz atın.
İstek
HTTP isteği
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags
Parametreler
Parametre adı | Değer | Açıklama |
---|---|---|
Yol parametreleri | ||
accountId |
string |
GTM Hesap Kimliği. |
containerId |
string |
GTM Kapsayıcı Kimliği. |
Yetkilendirme
Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).
Kapsam |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
İstek içeriği
İstek gövdesinde, aşağıdaki özelliklere sahip bir Etiket kaynağı sağlayın:
Mülk adı | Değer | Açıklama | Notlar |
---|---|---|---|
Zorunlu Özellikler | |||
name |
string |
Etiketin görünen adı. | yazılabilir |
parameter[].type |
string |
Parametre türü. Geçerli değerler aşağıda belirtilmiştir:
Kabul edilebilir değerler şunlardır:
|
yazılabilir |
priority.type |
string |
Parametre türü. Geçerli değerler aşağıda belirtilmiştir:
Kabul edilebilir değerler şunlardır:
|
yazılabilir |
type |
string |
GTM Etiket Türü. | yazılabilir |
İsteğe Bağlı Özellikler | |||
blockingRuleId[] |
list |
Engelleme kuralı kimlikleri. Listelenen kurallardan herhangi biri doğru olarak değerlendirilirse etiket etkinleşmez. | yazılabilir |
blockingTriggerId[] |
list |
Tetikleyici kimlikleri engelleniyor. Listelenen tetikleyicilerden herhangi biri doğru olarak değerlendirilirse etiket etkinleşmez. | yazılabilir |
firingRuleId[] |
list |
Tetikleme kuralı kimlikleri. Bir etiket, listelenen kurallardan herhangi biri doğru ve tüm blockingRuleIds (belirtilmişse) yanlış olduğunda tetiklenir. |
yazılabilir |
firingTriggerId[] |
list |
Etkinleştirme tetikleyicisi kimlikleri. Bir etiket, listelenen tetikleyicilerden herhangi biri doğru ve tüm blockingTriggerIds tetikleyicileri (belirtilmişse) yanlış olduğunda tetiklenir. |
yazılabilir |
liveOnly |
boolean |
Politika, Doğru değerine ayarlanırsa bu etiket yalnızca canlı ortamda tetiklenir (ör. önizleme veya hata ayıklama modunda etkinleşmez). | yazılabilir |
notes |
string |
Kullanıcı, bu etiketin kapsayıcıya nasıl uygulanacağına ilişkin notları alır. | yazılabilir |
parameter[] |
list |
Etiketin parametreleri. | yazılabilir |
parameter[].key |
string |
Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır. | yazılabilir |
parameter[].list[] |
list |
Bu liste parametresinin parametreleri (anahtarlar yoksayılır). | yazılabilir |
parameter[].map[] |
list |
Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır). | yazılabilir |
parameter[].value |
string |
Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir). | yazılabilir |
paused |
boolean |
Etiket duraklatılmışsa doğru değerini döndürür. | yazılabilir |
priority |
nested object |
Etiketin kullanıcı tarafından tanımlanan sayısal önceliği. Etiketler, öncelik sırasına göre eşzamansız olarak tetiklenir. Sayısal değeri daha yüksek olan etiketler önce tetiklenir. Bir etiketin önceliği, pozitif veya negatif bir değer olabilir. Varsayılan değer 0'dır. | yazılabilir |
priority.key |
string |
Bir parametreyi benzersiz şekilde tanımlayan adlandırılmış anahtar. Üst düzey parametreler ve eşleme değerleri için gereklidir. Liste değerleri için yoksayılır. | yazılabilir |
priority.list[] |
list |
Bu liste parametresinin parametreleri (anahtarlar yoksayılır). | yazılabilir |
priority.map[] |
list |
Bu eşleme parametresinin parametreleri (anahtarlar içermelidir; anahtarlar benzersiz olmalıdır). | yazılabilir |
priority.value |
string |
Belirtilen türe uygun bir parametrenin değeri ("" gibi değişken başvuruları içerebilir). | yazılabilir |
scheduleEndMs |
long |
Etiketin programlanması için milisaniye cinsinden bitiş zaman damgası. | yazılabilir |
scheduleStartMs |
long |
Bir etiketi programlamak için milisaniye cinsinden başlangıç zaman damgası. | yazılabilir |
Yanıt
Başarılı olursa bu yöntem yanıt gövdesinde bir Etiketler kaynağı döndürür.
Örnekler
Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).
Java
Java istemci kitaplığını kullanır.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new tag. */ // Construct the parameters. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("trackingId"); arg0.setValue("UA-123456-1"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("type"); arg1.setValue("TRACK_TRANSACTION"); // Construct the tag object. Tag tag = new Tag(); tag.setName("Sample Universal Analytics Tag"); tag.setType("ua"); tag.setLiveOnly(false); tag.setParameter(Arrays.asList(arg0, arg1)); try { Tag response = tagmanager.accounts().containers(). tags().create("123456", "54321", tag).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the create method are stored in response object. * The following code shows how to access the created id and fingerprint. */ System.out.println("Tag id = " + response.getTagId()); System.out.println("Tag Fingerprint = " + response.getFingerprint());
Python
Python istemci kitaplığını kullanır.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new container tag. try: response = tagmanager.accounts().containers().tags().create( accountId='123456', containerId='54321', body={ 'name': 'Universal Analytics Tag', 'type': 'ua', 'liveOnly': False, 'parameter': [ { 'type': 'template', 'key': 'trackingId', 'value': 'UA-123456-1' }, { 'type': 'template', 'key': 'type', 'value': 'TRACK_TRANSACTION' } ] } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason)) # The results of the create method are stored in the response object. # The following code shows how to access the created id and fingerprint. print response.get('tagId') print response.get('fingerprint')
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.