UetTag-Datenobjekt – Kampagnenverwaltung

Definiert ein UET-Tag (Universal Event Tracking), das Sie Ihrer Website hinzufügen können, damit Microsoft Advertising Aktionen sammeln kann, die Personen auf Ihrer Website ausführen.

Nachdem Sie ein UET-Tag (z. B. über AddUetTags) erstellt haben, besteht der nächste Schritt darin, den UET-Tag-Trackingcode zu Ihrer Website hinzuzufügen. Es wird empfohlen, dass Sie oder Ihr Websiteadministrator es ihrer gesamten Website entweder im Kopf- oder Textabschnitt hinzufügen. Wenn Ihre Website über eine websiteweite Layoutseite verfügt, ist dies der beste Ort, um sie hinzuzufügen, da Sie sie einmal hinzufügen und auf allen Seiten enthalten sind. Weitere Informationen finden Sie unter Gewusst wie Hinzufügen des UET-Tags zu meiner Website?.

Sie können ein UET-Tag für alle Ihre Konvertierungsziele und -zielgruppen verwenden. Bevor Sie mehrere UET-Tags erstellen, lesen Sie Gründe für die Erstellung mehrerer UET-Tags.

Tipp

Eine Übersicht über die Implementierung finden Sie im technischen Leitfaden zur universellen Ereignisnachverfolgung .

XML

<xs:complexType name="UetTag" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CustomerShare" nillable="true" type="tns:CustomerShare" />
    <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingNoScript" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingScript" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:UetTagTrackingStatus" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "Id": "LongValueHere",
  "Name": "ValueHere",
  "TrackingNoScript": "ValueHere",
  "TrackingScript": "ValueHere",
  "TrackingStatus": "ValueHere"
}

Elemente

Das UetTag-Objekt verfügt über die folgenden Elemente: CustomerShare, Description, ID, Name, TrackingNoScript, TrackingScript, TrackingStatus.

Element	Beschreibung	Datentyp
CustomerShare	Bestimmt die Liste der Kunden, die das UET-Tag verwenden. Zu den Details gehören UET-Tag zur Anzahl der Benutzergruppenzuordnungen. Freigegebene UET-Tags und Zielgruppen sind nur für Pilotkunden verfügbar. Eine Übersicht über die Freigabe von Zielgruppen und UET-Tags in einer Kundenhierarchie finden Sie im technischen Leitfaden Freigeben von Zielgruppen und UET-Tags . Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie dieses Element auf NULL oder leer fest, um vorhandene Kundenkontofreigaben beizubehalten. Um alle Kundenkontofreigaben zu entfernen, legen Sie das CustomerAccountShares-Element des CustomerShare-Objekts auf NULL oder leer fest. Um eine Teilmenge von Kundenkontofreigaben zu entfernen, geben Sie die Kundenkontofreigaben, die Sie behalten möchten, im CustomerAccountShares-Element des CustomerShare-Objekts an.	CustomerShare
Beschreibung	Text, der Ihnen hilft, das UET-Tag zu identifizieren. Es wird empfohlen, dies auf den Namen oder die URL der entsprechenden Websiteseite festzulegen. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei	Zeichenfolge
Id	Der eindeutige Microsoft Advertising-Bezeichner des UET-Tags. Hinzufügen: Schreibgeschützt Aktualisieren: Erforderlich und schreibgeschützt	lang
Name	Der Name des UET-Tags. Die maximale Länge des Namens beträgt 100, und der Name muss unter allen UET-Tags eindeutig sein, die zum selben Kunden gehören. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei	Zeichenfolge
TrackingNoScript	Wenn Ihre Website JavaScript nicht unterstützt, können Sie diese Nicht-JavaScript-Darstellung des UET-Tags verwenden. Wenn Sie Nicht-JavaScript verwenden, können Sie keine benutzerdefinierten Ereignisse oder variablen Umsätze nachverfolgen. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolge
TrackingScript	Das Nachverfolgungsskript, das Sie Ihrer Website hinzufügen können, damit Microsoft Advertising Aktionen sammeln kann, die Personen auf Ihrer Website ausführen. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	Zeichenfolge
TrackingStatus	Die systembestimmte status Werte eines UET-Tags, z. B. legt das System die status auf Nicht überprüft fest, wenn das UET-Tag noch nicht überprüft wurde. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	UetTagTrackingStatus

Anforderungen

Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Verwendet von

AddUetTags
GetUetTagsByIds
UpdateUetTags