DurationGoal Data Object – Kampagnenverwaltung

Artikel
12/21/2023

Definiert ein Dauerkonvertierungsziel. Verwenden Sie diese Art von Ziel, um jedes Mal zu zählen, wenn jemand länger als eine bestimmte Zeit auf einer Website als Konvertierung bleibt. Sie können beispielsweise eine Konvertierung zählen, wenn jemand 10 Minuten oder länger für einen Blog oder ein Spiel auf der Webseite verbracht hat.

Tipp

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

Wichtig

Jedes Mal, wenn Sie ein neues DurationGoal-, EventGoal-, OfflineConversionGoal-, PagesViewedPerVisitGoal - oder UrlGoal-Objekt über die Microsoft Advertising-Webanwendung oder die Kampagnenverwaltungs-API hinzufügen oder aktualisieren, wird der MSCLKIDAutoTaggingEnabled-Wert der entsprechenden AccountProperty automatisch auf True festgelegt. Wenn der Bereich des Ziels auf Kundenebene festgelegt ist, wird die AccountProperty für alle Konten unter dem Kunden festgelegt.

Syntax

<xs:complexType name="DurationGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="MinimumDurationInSeconds" nillable="true" type="xs:int" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das DurationGoal-Objekt weist die folgenden Elemente auf: MinimumDurationInSeconds.

Element	Beschreibung	Datentyp
MinimumDurationInSeconds	Die minimale Zeit in Sekunden, die der Benutzer auf Ihrer Website verbringen muss, um als Konvertierung nachzuverfolgen. Wenn Sie keinen Wert angeben, ist der Standardwert 0, und der mögliche Bereich ist 0 bis 86.399 (1 Sekunde weniger als ein vollständiger 24-Stunden-Tag). Hinzufügen: Optional Aktualisieren: Optional	int

Das DurationGoal-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von ConversionGoal

Das DurationGoal-Objekt wird vom ConversionGoal-Objekt abgeleitet und erbt die folgenden Elemente: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes. Die folgenden Beschreibungen sind spezifisch für DurationGoal und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom ConversionGoal-Objekt erben.

Element	Beschreibung	Datentyp
AttributionModelType	Bestimmt, welches Zuordnungsmodell , LastTouch oder LastClick, mit einem Konvertierungsziel verwendet wird.	AttributionModelType
KonvertierungWindowInMinutes	Das Konvertierungsfenster ist die Zeitspanne in Minuten nach einem Klick, die Sie Konvertierungen nachverfolgen möchten. Wenn Sie diesen Wert auf 43200 Minuten (30 Tage) festlegen, werden Konvertierungen, die innerhalb von 30 Tagen nach einem Klick erfolgen, nachverfolgt. Frühere Konvertierungen sind nicht betroffen. Der unterstützte Mindestwert beträgt 1 Minute. Beachten Sie jedoch, dass ein kürzeres Konvertierungsfenster die Anzahl der Konvertierungen für Ihre Kontodatensätze reduziert. Der maximal unterstützte Wert beträgt 129600 Minuten (90 Tage). Hinzufügen: Optional Aktualisieren: Optional	int
CountType	Dies bestimmt, wie Ihre Konvertierungen im ausgewählten Konvertierungsfenster aufgezeichnet werden. Es gibt zwei Optionen, und wenn Sie keinen Wert festlegen, ist der Standardwert Alle: - Alle: Alle Konvertierungen, die nach einem Anzeigenklick erfolgen, werden gezählt. Dies ist eine gängige Wahl für Den Vertrieb. - Eindeutig: Nur eine Konvertierung, die nach einem Anzeigenklick erfolgt, wird gezählt. Dies ist eine gängige Wahl für Leads. Beispiel: Sie verfolgen zwei Konvertierungen nach: Leads und Sales. Sie wählen Eindeutig für Leads und Alle für Vertrieb aus. Wenn aus einem Anzeigenklick zwei Leads und zwei Verkäufe werden, werden drei Konvertierungen gezählt: eine für den eindeutigen Lead und zwei für alle Verkäufe. Hinzufügen: Optional Aktualisieren: Optional	ConversionGoalCountType
ExcludeFromBidding	Bestimmt, ob Daten, die anderweitig im Zusammenhang mit diesem Konvertierungsziel stehen, von einer Teilmenge der Leistungsberichtsspalten ausgeschlossen werden sollen. Dieses Element ist nur für Kunden verfügbar, die für das Feature In Konvertierungen einschließen aktiviert sind (GetCustomerPilotFeatures gibt 574 zurück). Wenn dieses Element auf TRUE festgelegt ist, werden Daten, die sich andernfalls auf dieses Konvertierungsziel beziehen, aus den `Conversions`Berichtsspalten , `ConversionRateCostPerConversion`, , `ReturnOnAdSpendRevenuePerConversion`und `Revenue` ausgeschlossen. Wenn Sie eine automatisierte Gebotsstrategie verwenden, führt das Festlegen dieser Eigenschaft true dazu, dass die Konvertierungen des Ziels nicht mehr in automatisierte Gebotsberechnungen einbezogen werden. Das Festlegen dieser Eigenschaft auf "true" entspricht praktisch dem Deaktivieren von "In Konvertierungen einschließen" in der Microsoft Advertising-Webanwendung. Unabhängig von diesem Elementwert enthalten die `AllConversions`Berichtsspalten , `AllConversionRate`, `AllCostPerConversion`, `AllReturnOnAdSpend`, `AllRevenuePerConversion`und `AllRevenue` Daten für alle Konvertierungsziele. Standardmäßig ist dieses Element false, und Daten im Zusammenhang mit diesem Konvertierungsziel sind in allen Berichtsspalten enthalten. Weitere Informationen finden Sie unter Berichtsattribute und Leistungsstatistiken und im Hilfeartikel Konvertierungsziele: "Konvertierungen" im Vergleich zu "Alle Konvertierungen". Hinzufügen: Optional Aktualisieren: Optional	boolean
GoalCategory	Die Kategorie, die zum Segmentieren des Konvertierungsziels verwendet wird. Kategorisieren Sie Ihre Konvertierungsziele jedoch für Ihr Unternehmen. Zielkategorien wirken sich nicht auf die Leistung aus– sie helfen Ihnen, Ihre Ziele und ihre Leistungsmetriken zu segmentieren. Die unterstützten Kategoriewerte variieren je nach Konvertierungszieltyp. Dauerziele unterstützen nur die Kategorie Andere . Hinzufügen: Optional. Wenn Sie dieses Element null oder leer lassen, wird die Standardkategorie auf Other festgelegt. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.	ConversionGoalCategory
Id	Der eindeutige Microsoft Advertising-Bezeichner für das Konvertierungsziel. Hinzufügen: Schreibgeschützt Aktualisieren: Erforderlich und Read-Only	Lange
IsEnhancedConversionsEnabled	Bestimmt, ob erweiterte Konvertierungen für ein Konvertierungsziel aktiviert sind. Hinweis: Um ein erweitertes Konvertierungsziel zu erstellen und festzulegen `isEnhancedConversionsEnabled=true`, müssen Sie über die Microsoft Advertising-Benutzeroberfläche ein Konvertierungsziel für das Konto erstellen, wobei die Einstellung für die erweiterte Konvertierung ausgewählt und das zugehörige Kontrollkästchen aktiviert ist.	boolean
Name	Der Name des Konvertierungsziels. Die maximale Länge des Namens beträgt 100, und der Name muss unter allen Konvertierungszielen desselben Kunden eindeutig sein. Hinzufügen: Erforderlich Aktualisieren: Optional	Zeichenfolge
Einnahmen	Bestimmt, wie viel jede Konvertierung für Ihr Unternehmen wert ist. Wenn Sie beim Hinzufügen eines Konvertierungsziels keine Umsatznachverfolgungseinstellungen angeben, wird jedes ConversionGoalRevenue auf seine jeweiligen Standardwerte festgelegt. Wenn das Revenue-Element beim Aktualisieren eines Konvertierungsziels null oder leer ist, wird keine der geschachtelten Eigenschaften aktualisiert. Wenn dieses Element jedoch nicht null oder leer ist, ersetzen Sie effektiv alle vorhandenen Umsatzeigenschaften. Die VariableValue-Option ist für Dauerkonvertierungsziele nicht verfügbar. Hinzufügen: Optional Aktualisieren: Optional	ConversionGoalRevenue
Bereich	Bestimmt, ob das Ziel für alle Konten gilt oder nur für das Konto, das im erforderlichen CustomerAccountId-Headerelement angegeben ist. Wenn Sie über mehrere Microsoft Advertising-Konten verfügen, können Sie Konvertierungen für alle diese Konten nachverfolgen. Wenn Sie einem Konto ein Ziel zuordnen, werden Konvertierungen nur für dieses Konto nachverfolgt. Mögliche Werte sind Account und Customer. Wenn nicht angegeben, wird der Bereich standardmäßig auf Kunde festgelegt. Nachdem Sie den Bereich festgelegt haben, können Sie ihn nicht mehr ändern. Wenn Sie den Bereich ändern möchten, müssen Sie ein neues Konvertierungsziel erstellen und das alte anhalten. Hinzufügen: Optional Aktualisieren: Optional	EntityScope
Status	Definiert die möglichen benutzerdefinierten status Werte eines Konvertierungsziels. Dies sind die status Werte, die ein Benutzer festlegen kann. Beispielsweise kann ein Ziel auf Angehalten festgelegt werden, wenn Sie keine Konvertierungen für dieses Ziel mehr nachverfolgen möchten. Informationen status Werte, die vom System festgelegt werden können, z. B. ob das UET-Tag überprüft wird oder nicht, finden Sie im TrackingStatus-Element. Hinzufügen: Optional Aktualisieren: Optional	ConversionGoalStatus
TagId	Die eindeutige Microsoft Advertising-ID des UET-Tags, das Sie Ihrer Website hinzugefügt haben, damit Microsoft Advertising Aktionen sammeln kann, die Personen auf Ihrer Website ausführen. Bevor Sie eine Abhängigkeit von der Tag-ID erstellen, beachten Sie, dass das UET-Tag für oder von einem anderen Kunden freigegeben werden kann. 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: Erforderlich Aktualisieren: Optional	Lange
TrackingStatus	Definiert die möglichen systembestimmten status Werte eines Konvertierungsziels. Dies sind die status Werte, die vom System festgelegt werden können, z. B. legt das System die status auf TagUnverified fest, wenn das UET-Tag noch nicht überprüft wurde. Informationen status Werte, die ein Benutzer festlegen kann, z. B. das Festlegen des status auf Angehalten, wenn Sie Keine Konvertierungen für dieses Ziel mehr nachverfolgen möchten, finden Sie im Status-Element. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	ConversionGoalTrackingStatus
Typ	Der Typ des Konvertierungsziels. Dieser Wert ist Dauer , wenn Sie ein Dauerziel abrufen. Weitere Informationen zu Konvertierungszieltypen finden Sie in den Hinweisen zu ConversionGoal-Datenobjekten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	ConversionGoalType
ViewThroughConversionWindowInMinutes	Das Fenster für die Durchsichtskonvertierung gibt die Zeitspanne in Minuten nach einem Klick an, die Sie Durchsichtskonvertierungen nachverfolgen möchten. Wenn Sie diesen Wert auf 43200 Minuten (30 Tage) festlegen, werden View-Through-Konvertierungen, die innerhalb von 30 Tagen nach einem Klick erfolgen, nachverfolgt. Frühere Konvertierungen sind nicht betroffen. Der unterstützte Mindestwert beträgt 1 Minute. Beachten Sie jedoch, dass ein kürzeres Konvertierungsfenster die Anzahl der Konvertierungen für Ihre Kontodatensätze reduziert. Der maximal unterstützte Wert beträgt 43200 Minuten (30 Tage). Die IncludeViewThroughConversions-Kontoeigenschaft muss ebenfalls auf TRUE festgelegt werden, damit View-Through-Konvertierungen nachverfolgt werden können. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den ViewThroughConversionWindowInMinutes-Wert in das ReturnAdditionalFields-Element ein, wenn Sie die GetConversionGoalsByIds - und GetConversionGoalsByTagIds-Dienstvorgänge aufrufen. Hinzufügen: Optional Aktualisieren: Optional	int

Anforderungen

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

Freigeben über