ConversionGoal Data Object – Kampagnenverwaltung

Artikel
12/21/2023

Definiert das Basisobjekt eines Konvertierungsziels.

Versuchen Sie nicht, ein ConversionGoal zu instanziieren. Sie können eines oder mehrere der folgenden Objekte erstellen, die daraus abgeleitet werden.

Syntax

<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ConversionWindowInMinutes" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
    <xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
    <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
    <xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elemente

Das ConversionGoal-Objekt verfügt über die folgenden Elemente: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes.

Element	Beschreibung	Datentyp
AttributionModelType	Bestimmt, welches Zuordnungsmodell , LastTouch oder LastClick, mit einem Konvertierungsziel verwendet wird. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den AttributionModelType-Wert in das ReturnAdditionalFields-Element ein, wenn Sie die GetConversionGoalsByIds - und GetConversionGoalsByTagIds-Dienstvorgänge aufrufen. Dieses Element gilt nicht für AppInstallGoal, InStoreTransactionGoal und OfflineConversionGoal.	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).	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. Dieses Element gilt nicht für AppInstallGoal.	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".	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 Typ des Konvertierungsziels. Ausführliche Anforderungen finden Sie auf der entsprechenden Referenzseite.	ConversionGoalCategory
Id	Der eindeutige Microsoft Advertising-Bezeichner für das Konvertierungsziel.	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.	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 Option VariableValue ist für AppInstallGoal, DurationGoal oder PagesViewedPerVisitGoal nicht verfügbar.	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. 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. Nur der Kundenbereich wird für AppInstallGoal unterstützt.	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.	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 . Dieses Element gilt nicht für AppInstallGoal, InStoreTransactionGoal und OfflineConversionGoal.	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. Nur die Status NoRecentConversions und RecordingConversions gelten für AppInstallGoal und OfflineConversionGoal.	ConversionGoalTrackingStatus
Typ	Der Typ des Konvertierungsziels. Weitere Informationen zu Konvertierungszieltypen finden Sie in den Hinweisen.	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. Dieses Element gilt nicht für AppInstallGoal, InStoreTransactionGoal und OfflineConversionGoal.	int

Hinweise

Legen Sie für Java und die .NET-Sprachen nicht das Type-Element fest, da der Wert durch den Typ des Konvertierungsziels bestimmt wird, das Sie instanziieren.

Wenn Sie den SOAP manuell generieren, verwenden Sie das type-Attribut des <ConversionGoal> Knotens wie im folgenden Beispiel gezeigt, um den Typ des Konvertierungsziels anzugeben.

<ConversionGoals i:nil="false">
  <ConversionGoal i:type="UrlGoal">
    <ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
    <CountType i:nil="false">Unique</CountType>
    <Id i:nil="true" />
    <Name i:nil="false">My Url Conversion Goal</Name>
    <Revenue i:nil="false">
      <CurrencyCode i:nil="false">USDollar</CurrencyCode>
      <Type i:nil="false">FixedValue</Type>
      <Value i:nil="false">10.00</Value>
    </Revenue>
    <Scope i:nil="false">Customer</Scope>
    <Status i:nil="true" />
    <TagId i:nil="false"></TagId>
    <TrackingStatus i:nil="true" />
    <UrlExpression i:nil="false">contoso</UrlExpression>
    <UrlOperator i:nil="false">Contains</UrlOperator>
  </ConversionGoal>
</ConversionGoals>

Anforderungen

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

Verwendet von

AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals

Freigeben über