Erstellt ein GTM-Tag. Probieren Sie es aus oder sehen Sie sich ein Beispiel an.
Anfragen
HTTP-Anfrage
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
accountId |
string |
Die Google Tag Manager-Konto-ID. |
containerId |
string |
Die GTM-Container-ID. |
Autorisierung
Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung
Umfang |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Anfragetext
Geben Sie im Anfragetext eine Tags-Ressource mit den folgenden Eigenschaften an:
Property-Name | Wert | Beschreibung | Hinweise |
---|---|---|---|
Erforderliche Eigenschaften | |||
name |
string |
Anzeigename des Tags. | Bearbeitbar |
parameter[].type |
string |
Der Parametertyp. Gültige Werte sind:
Zulässige Werte sind:
|
Bearbeitbar |
priority.type |
string |
Der Parametertyp. Gültige Werte sind:
Zulässige Werte sind:
|
Bearbeitbar |
type |
string |
GTM-Tag-Typ. | Bearbeitbar |
Optionale Attribute | |||
blockingRuleId[] |
list |
Blockierregel-IDs. Wenn eine der aufgeführten Regeln als „true“ ausgewertet wird, wird das Tag nicht ausgelöst. | Bearbeitbar |
blockingTriggerId[] |
list |
Trigger-IDs blockieren Wenn einer der aufgeführten Trigger „true“ ergibt, wird das Tag nicht ausgelöst. | Bearbeitbar |
firingRuleId[] |
list |
Auslösungsregel-IDs Ein Tag wird ausgelöst, wenn eine der aufgeführten Regeln erfüllt ist und alle zugehörigen blockingRuleIds -Werte (falls vorhanden) falsch sind. |
Bearbeitbar |
firingTriggerId[] |
list |
Auslösende Trigger-IDs. Ein Tag wird ausgelöst, wenn einer der aufgelisteten Trigger wahr ist und alle seine blockingTriggerIds (falls vorhanden) falsch sind. |
Bearbeitbar |
liveOnly |
boolean |
Ist die Richtlinie auf „true“ gesetzt, wird dieses Tag nur in der Live-Umgebung ausgelöst, nicht im Vorschau- oder Debug-Modus. | Bearbeitbar |
notes |
string |
Nutzerhinweise zur Anwendung dieses Tags auf den Container. | Bearbeitbar |
parameter[] |
list |
Die Parameter des Tags. | Bearbeitbar |
parameter[].key |
string |
Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert. | Bearbeitbar |
parameter[].list[] |
list |
Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). | Bearbeitbar |
parameter[].map[] |
list |
Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). | Bearbeitbar |
parameter[].value |
string |
Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. | Bearbeitbar |
paused |
boolean |
„True“, wenn das Tag pausiert ist. | Bearbeitbar |
priority |
nested object |
Benutzerdefinierte numerische Priorität des Tags. Tags werden asynchron in der Reihenfolge ihrer Priorität ausgelöst. Tags mit einem höheren numerischen Wert werden zuerst ausgelöst. Die Priorität eines Tags kann ein positiver oder negativer Wert sein. Der Standardwert ist 0. | Bearbeitbar |
priority.key |
string |
Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert. | Bearbeitbar |
priority.list[] |
list |
Die Parameter dieses Listenparameters (Schlüssel werden ignoriert). | Bearbeitbar |
priority.map[] |
list |
Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein). | Bearbeitbar |
priority.value |
string |
Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ. | Bearbeitbar |
scheduleEndMs |
long |
Der Endzeitstempel in Millisekunden für die Planung eines Tags. | Bearbeitbar |
scheduleStartMs |
long |
Der Startzeitstempel in Millisekunden für die Planung eines Tags. | Bearbeitbar |
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Tags-Ressource im Antworttext zurückgegeben.
Beispiele
Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.
Java
Verwendet die Java-Clientbibliothek.
/* * 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
Verwendet die Python-Clientbibliothek.
# 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')
Jetzt testen
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.