OfflineConversionGoal Data Object – Kampagnenverwaltung

Artikel
12/21/2023

Definiert ein Offlinekonvertierungsziel. Verwenden Sie diese Art von Ziel, wenn Sie die Leadgenerierung als Ziel verwenden. Leadgenerierung ist, wenn potenzielle Kunden ein Formular oder angebot von Interesse ausfüllen und dann der Verkauf offline oder telefonisch abgeschlossen wird (z. B. Autokäufe, Versicherungsangebote, Hypotheken usw.).

Erstellen Sie zum Einrichten der Offlinekonvertierungsnachverfolgung ein OfflineConversionGoal-Objekt, warten Sie zwei Stunden, und senden Sie dann Microsoft Advertising die OfflineConversion-Daten über den ApplyOfflineConversions-Vorgang .

Wichtig

Sie müssen OfflineConversionGoal über die Kampagnenverwaltungs-API erstellen, um die IsExternallyAttributed-Eigenschaft festzulegen.

Tipp

Weitere Informationen finden Sie unter Nachverfolgen von Offlinekonvertierungen.

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="OfflineConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="IsExternallyAttributed" 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:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das OfflineConversionGoal-Objekt weist die folgenden Elemente auf: IsExternallyAttributed.

Element	Beschreibung	Datentyp
IsExternallyAttributed	Dadurch wird ermittelt, ob Ihr Offlinekonvertierungsziel Ihr eigenes Zuordnungsmodell verwendet und ihnen ermöglicht, Bruchteile von Gutschriften für jede MSCLKID zu importieren. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den IsExternallyAttributed-Wert in das ReturnAdditionalFields-Element ein, wenn Sie die GetConversionGoalsByIds - und GetConversionGoalsByTagIds-Dienstvorgänge aufrufen. Hinweis: Sie können IsExternallyAttributed nur über die Kampagnenverwaltungs-API festlegen. Hinzufügen: Optional Aktualisieren: Optional	boolean

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

Geerbte Elemente

Geerbte Elemente von ConversionGoal

Das OfflineConversionGoal-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 OfflineConversionGoal und gelten möglicherweise nicht für andere Objekte, die die gleichen Elemente vom ConversionGoal-Objekt erben.

Element	Beschreibung	Datentyp
AttributionModelType	Gilt nicht für Offlinekonvertierungsziele.	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 Standardwert ist 43200. 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 mit unterschiedlichen Offlinekonvertierungszeiten, die nach einem Anzeigenklick erfolgen, werden gezählt. Dies ist eine gängige Wahl für Den Vertrieb. - Eindeutig: Nur die erste 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. Doppelte Offlinekonvertierungen mit derselben MicrosoftClickId und ConversionTime werden ignoriert. Anders ausgedrückt: Nur die erste Offlinekonvertierung für eine bestimmte MicrosoftClickId und ConversionTime wird gezählt. 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. Offlinekonvertierungsziele unterstützen die Kategorien AddToCart, BeginCheckout, BookAppointment, Contact, GetDirections, Other, OutboundClick, PageView, Purchase, RequestQuote, Signup, SubmitLeadForm und Subscribe . Hinzufügen: Erforderlich ab Juni 2021. Wenn Sie dieses Element zuvor null oder leer gelassen haben, wurde die Standardkategorie auf Keine festgelegt. Aktualisieren: Optional, wenn für das Konvertierungsziel bereits eine andere Kategorie als Keine festgelegt ist. 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. Wenn der Umsatztyp FixedValue oder VariableValue ist, haben die Elemente ConversionCurrencyCode und ConversionValue der angewendeten OfflineConversion-Daten Vorrang vor dem ConversionGoalRevenue-Währungscode und -wert. 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. 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. Wenn nicht angegeben, wird der Bereich standardmäßig auf Konto festgelegt. Aktualisieren: Schreibgeschützt. Sie können den Offlinekonvertierungszielbereich nicht aktualisieren.	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, finden Sie im TrackingStatus-Element. Hinzufügen: Optional Aktualisieren: Optional	ConversionGoalStatus
TagId	Gilt nicht für Offlinekonvertierungsziele.	Lange
TrackingStatus	Gilt nicht für Offlinekonvertierungsziele.	ConversionGoalTrackingStatus
Typ	Der Typ des Konvertierungsziels. Dieser Wert ist OfflineConversion , wenn Sie ein Offlinekonvertierungsziel abrufen. Weitere Informationen zu Konvertierungszieltypen finden Sie in den Hinweisen zu ConversionGoal-Datenobjekten. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	ConversionGoalType
ViewThroughConversionWindowInMinutes	Gilt nicht für Offlinekonvertierungsziele.	int

Anforderungen

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

Freigeben über