AppInstallGoal-Datenobjekt – Kampagnenverwaltung

Artikel
12/21/2023

Definiert ein Konvertierungsziel für die App-Installation. Verwenden Sie diese Art von Ziel, um jedes Mal nachzuverfolgen, wenn jemand Ihre App als Konvertierung installiert.

Für andere Konvertierungszieltypen erstellen Sie ein UET-Tag (Universal Event Tracking), fügen es Ihrer Website hinzu und erstellen dann ein Konvertierungsziel. Für Konvertierungsziele für die App-Installation müssen Sie jedoch nur die appspezifische URL verwenden, die vom microsoft Advertising-zertifizierten Partner bereitgestellt wird. Weitere Informationen finden Sie unter Nachverfolgen von Installationen mobiler Apps als Konvertierungen.

Tipp

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

Syntax

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

Elemente

Das AppInstallGoal-Objekt weist die folgenden Elemente auf: AppPlatform, AppStoreId.

Element	Beschreibung	Datentyp
AppPlatform	Die Anwendungsplattform. Mögliche Werte sind Android, iOS, Windows und WindowsPhone. Hinzufügen: Erforderlich Aktualisieren: Optional	Zeichenfolge
AppStoreId	Der vom App Store bereitgestellte Anwendungsbezeichner. Hinzufügen: Erforderlich Aktualisieren: Optional	Zeichenfolge

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

Geerbte Elemente

Geerbte Elemente von ConversionGoal

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

Element	Beschreibung	Datentyp
AttributionModelType	Gilt nicht für App-Installationsziele.	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	Gilt nicht für App-Installationsziele.	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. App-Installationsziele unterstützen nur die Kategorie Herunterladen . Hinzufügen: Optional. Wenn Sie dieses Element null oder leer lassen, wird die Standardkategorie auf Herunterladen 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 Option VariableValue ist für Konvertierungsziele für die App-Installation 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. Für App-Installationsziele wird der Bereich auf Kontoebene nicht unterstützt. Sie können dieses Element auf Customer festlegen oder null lassen. Wenn nicht angegeben, wird der Bereich standardmäßig auf Kunde festgelegt. 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, finden Sie im TrackingStatus-Element. Hinzufügen: Optional Aktualisieren: Optional	ConversionGoalStatus
TagId	Gilt nicht für App-Installationsziele.	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. das System legt die status auf RecordingConversions fest, wenn wir Konvertierungen innerhalb der letzten 7 Tage aufgezeichnet haben. Nur die Status NoRecentConversions und RecordingConversions gelten für Konvertierungsziele für die App-Installation. 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 AppInstall , wenn Sie ein App-Installationsziel 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 App-Installationsziele.	int

Anforderungen

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

Freigeben über