AppInstallAd-Datenobjekt – Kampagnenverwaltung

Artikel
11/14/2024

Definiert eine App-Installationsanzeige.

App-Installationsanzeigen ähneln Textanzeigen, stellen jedoch direkte Links zu Ihren Apps mit einer Schaltfläche bereit, die Kunden direkt an den entsprechenden Store senden, um die Anwendung herunterzuladen. Dies ist eine ideale Lösung für Werbetreibende, die Downloads ihrer Apps verwalten und steuern möchten, anstatt den Website-Datenverkehr.

App-Installationsanzeigen erkennen automatisch das mobile Gerät und Betriebssystem des Kunden und senden sie an die entsprechenden Apple App Store oder Google Play. Sie können Konvertierungen auch mit denselben Konvertierungsnachverfolgungspartnern wie App-Erweiterungen nachverfolgen: AppsFlyer, Kochava, Tune, Singular, Adjust und Branch.

Hinweis

App-Installationsanzeigen sind nur in Australien, Brasilien, Kanada, Frankreich, Deutschland, Indien, Großbritannien und den USA unter iOS und Android verfügbar. Derzeit werden nur Apps unterstützt, die im USA im Apple App Store und im Google Play Store verfügbar sind. Windows wird nicht unterstützt.

Dieses Feature hat noch nicht jeder. Wenn Sie dies nicht getan haben, machen Sie sich keine Sorgen. Es ist in Kürze verfügbar.

Hinweis

App-Installationsanzeigen können nur in Suchkampagnen erstellt werden, bei denen adGroupType auf "SearchStandard" festgelegt ist. Wenn adGroupType auf "SearchDynamic" festgelegt ist, unterstützt die Anzeigengruppe keine App-Installationsanzeigen.

Die Kombination der Elemente AppPlatform, AppStoreId, Text und Title macht die App-Installationsanzeige eindeutig.

<xs:complexType name="AppInstallAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <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:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AdFormatPreference": "ValueHere",
  "DevicePreference": "LongValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "Type": "AppInstall",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "AppPlatform": "ValueHere",
  "AppStoreId": "ValueHere",
  "Text": "ValueHere",
  "Title": "ValueHere"
}

Elemente

Das AppInstallAd-Objekt verfügt über die folgenden Elemente: AppPlatform, AppStoreId, Text, Title.

Element	Beschreibung	Datentyp
AppPlatform	Die Anwendungsplattform. Mögliche Werte sind iOS und Android. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei	Zeichenfolge
AppStoreId	Der vom App Store bereitgestellte Anwendungsbezeichner. Wenn die Anwendung neu ist, warten Sie 4 bis 7 Tage, bevor die Anzeige für die Zustellung berechtigt ist. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei	Zeichenfolge
Text	Die Anzeigenkopie. Die Kopie muss mindestens ein Wort enthalten. Die Kopie und der Titel der Anzeige müssen zusammen mindestens drei Wörter enthalten. Die Anzeigenkopie darf keine dynamischen Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Die maximale Eingabelänge der Kopie beträgt 71 Zeichen. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, der Text auf 38 Zeichen beschränkt ist. Die Anzeigenkopie darf das Zeilenumbruchzeichen (\n) nicht enthalten. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei	Zeichenfolge
Title	Der Titel der Anzeige. Der Titel muss mindestens ein Wort enthalten. Die Kopie und der Titel der Anzeige müssen zusammen mindestens drei Wörter enthalten. Der Titel darf keine dynamischen Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Die maximale Eingabelänge des Titels beträgt 25 Zeichen. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, der Titel auf 15 Zeichen beschränkt ist. Der Titel darf das Zeilenumbruchzeichen (\n) nicht enthalten. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei	Zeichenfolge

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

Geerbte Elemente

Geerbte Elemente von Ad

Das AppInstallAd-Objekt wird vom Ad-Objekt abgeleitet und erbt die folgenden Elemente: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Die folgenden Beschreibungen gelten spezifisch für AppInstallAd und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom Ad-Objekt erben.

Element	Beschreibung	Datentyp
AdFormatPreference	Wird für diesen Anzeigentyp nicht unterstützt.	Zeichenfolge
DevicePreference	Dieses Element bestimmt, ob werbung für die App-Installation auf Mobilen und Tablets oder nur auf mobilen Geräten angezeigt werden soll. (Anzeigen zur App-Installation werden auf Desktopcomputern derzeit nicht unterstützt.) Legen Sie dieses Element auf 30001 fest, um eine Einstellung nur für mobile Geräte anzugeben (d. h. tablets ausschließen). Legen Sie dieses Element auf 0 (null) fest, oder lassen Sie das Element null, um eine Einstellung für Mobile- und Tablet-Geräte anzugeben. Standardmäßig ist dieses Element null. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei	lang
EditorialStatus	Die redaktionelle Überprüfung status der Anzeige, die angibt, ob die Anzeige überprüft, genehmigt oder abgelehnt wurde. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	AdEditorialStatus
FinalAppUrls	Wird für App-Installationsanzeigen nicht unterstützt.	AppUrl-Array
FinalMobileUrls	Wird für App-Installationsanzeigen nicht unterstützt.	Zeichenfolgenarray
FinalUrls	Die URL, an die ein Suchbenutzer gelangt und auswählen kann, ob eine App installiert werden soll. Hinzufügen: Erforderlich Aktualisieren: Wahlfrei	Zeichenfolgenarray
FinalUrlSuffix	Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.	Zeichenfolge
ForwardCompatibilityMap	Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden. Es gibt derzeit keine ForwardCompatibilityMap-Schlüssel- und Wertpaare, die für dieses Objekt gelten.	KeyValuePairOfstring-Array
Id	Der eindeutige Microsoft Advertising-Bezeichner für die Anzeige. Hinzufügen: Schreibgeschützt Aktualisieren: Erforderlich und schreibgeschützt	lang
Status	Die status der Anzeige. Sie können die Anzeige status auf Aktiv oder Angehalten festlegen. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei	AdStatus
TrackingUrlTemplate	Die Nachverfolgungsvorlage, die als Standard für die mit FinalUrls angegebene URL verwendet werden soll. Die folgenden Validierungsregeln gelten für Nachverfolgungsvorlagen. Weitere Informationen zu unterstützten Vorlagen und Parametern finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden? - Nachverfolgungsvorlagen, die für Entitäten auf niedrigerer Ebene definiert sind, z. B. Anzeigen, überschreiben diejenigen, die für Entitäten höherer Ebene festgelegt wurden, z. B. Kampagnen. Weitere Informationen finden Sie unter Entitätsgrenzwerte. – Die Länge der Nachverfolgungsvorlage ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet. – Die Nachverfolgungsvorlage muss eine wohlgeformte URL sein, die mit einer der folgenden Beginnt: http://, https://, {lpurl} oder {unescapedlpurl}. – Microsoft Advertising überprüft nicht, ob benutzerdefinierte Parameter vorhanden sind. Wenn Sie benutzerdefinierte Parameter in Ihrer Nachverfolgungsvorlage verwenden und diese nicht vorhanden sind, enthält die URL der Angebotsseite die Schlüssel- und Wertplatzhalter Ihrer benutzerdefinierten Parameter ohne Ersetzung. Wenn Ihre Nachverfolgungsvorlage beispielsweise lautet `https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}` und weder {_season} noch {_promocode} auf Kampagnen-, Anzeigengruppen-, Kriterium-, Schlüsselwort (keyword)- oder Anzeigenebene definiert sind, ist die URL der Landing Page identisch. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.	Zeichenfolge
Typ	Der Typ der Anzeige. Dieser Wert ist AppInstall , wenn Sie eine App-Installationsanzeige abrufen. Weitere Informationen zu Anzeigentypen finden Sie in den Hinweisen zu Ad Data Object.For more information about ad types, see the Ad Data Object Remarks. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt	AdType
UrlCustomParameters	Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung. Microsoft Advertising akzeptiert die ersten 8 CustomParameter-Objekte , die Sie in das CustomParameters-Objekt einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jeder CustomParameter enthält Key - und Value-Elemente . Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie das UrlCustomParameters-Element auf NULL oder leer fest, um alle vorhandenen benutzerdefinierten Parameter beizubehalten. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie das Parameters-Element des CustomParameters-Objekts auf NULL oder leer fest. Um eine Teilmenge benutzerdefinierter Parameter zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie im Parameters-Element des CustomParameters-Objekts beibehalten möchten.	CustomParameters

Anforderungen

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

Freigeben über