App-Installationsanzeigendatensatz – Massenvorgang
Definiert eine App-Installationsanzeige, die heruntergeladen und in eine Massendatei hochgeladen werden kann.
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 der Anzeigengruppentyp auf "SearchStandard" festgelegt ist. Wenn der Anzeigengruppentyp auf "SearchDynamic" festgelegt ist, unterstützt die Anzeigengruppe keine App-Installationsanzeigen.
Sie können alle App Install Ad-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von AppInstallAds in die Serviceanforderung DownloadCampaignsByAccountIds oder DownloadCampaignsByCampaignIds einschließen. Darüber hinaus muss die Downloadanforderung den EntityData-Bereich enthalten. Weitere Informationen zum Massendienst, einschließlich bewährter Methoden, finden Sie unter Massendownload und -upload.
Im folgenden Massen-CSV-Beispiel wird eine neue App-Installationsanzeige hinzugefügt, wenn ein gültiger Wert für die übergeordnete ID angegeben wird.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer
Wenn Sie die Bing Ads-SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager zum Hochladen und Herunterladen des BulkAppInstallAd-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = "AdGroupNameGoesHere",
// 'Campaign' column header in the Bulk file
CampaignName = "ParentCampaignNameGoesHere",
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// AppInstallAd object of the Campaign Management service.
AppInstallAd = new AppInstallAd
{
// 'App Platform' column header in the Bulk file
AppPlatform = "Android",
// 'App Id' column header in the Bulk file
AppStoreId = "AppStoreIdGoesHere",
// 'Device Preference' column header in the Bulk file
DevicePreference = 0,
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"FinalUrlGoesHere"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales!",
// 'Title' column header in the Bulk file
Title = "Contoso Quick Setup",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
},
};
uploadEntities.Add(bulkAppInstallAd);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Für einen App Install Ad-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar. Die Kombination aus den Feldern App-ID, App-Plattform, Text und Titel macht die App-Installationsanzeige eindeutig.
- Anzeigengruppe
- App-ID
- App-Plattform
- Kampagnen
- Client-ID
- Benutzerdefinierter Parameter
- Geräteeinstellung
- Redaktioneller Einspruchsstatus
- Redaktioneller Ort
- Redaktioneller Grundcode
- Redaktioneller Status
- Redaktionsbegriff
- Endgültige URL
- Endgültiges URL-Suffix
- Id
- Änderungszeit
- Übergeordnete ID
- Herausgeberländer
- Status
- Text
- Title
- Vorlage für die Nachverfolgung
Anzeigengruppe
Der Name der Anzeigengruppe, die die Anzeige enthält.
Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Hinweis
Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Anzeigengruppe angeben.
App-ID
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: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
App-Plattform
Die Anwendungsplattform.
Mögliche Werte sind iOS und Android.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Kampagne
Der Name der Kampagne, die die Anzeigengruppe und die Anzeige enthält.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Client-ID
Wird verwendet, um Datensätze in der Massenuploaddatei datensätzen in der Ergebnisdatei zuzuordnen. Der Wert dieses Felds wird vom Server nicht verwendet oder gespeichert. es wird einfach aus dem hochgeladenen Datensatz in den entsprechenden Ergebnisdatensatz kopiert. Es kann eine beliebige gültige Zeichenfolge sein, die eine Länge von bis zu 100 hat.
Hinzufügen: Optional
Aktualisieren: Optional
Löschen: Schreibgeschützt
Benutzerdefinierter Parameter
Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung.
In einer Massendatei ist die Liste der benutzerdefinierten Parameter wie folgt formatiert.
Formatieren Sie jedes benutzerdefinierte Parameterpaar als Key=Value, z. B. {_promoCode}=PROMO1.
Microsoft Advertising akzeptiert die ersten 8 benutzerdefinierten Schlüssel- und Wertpaare, die Sie einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jedes Schlüssel-Wert-Paar wird durch ein Semikolon und ein Leerzeichen ("; ") getrennt, z. B. {_promoCode}=PROMO1; {_season}=Sommer.
Ein Schlüssel darf kein Semikolon enthalten. Wenn ein Wert ein Semikolon enthält, muss er als "\;" mit Escapezeichen versehen werden. Wenn der Wert außerdem einen umgekehrten Schrägstrich enthält, muss er auch als "\" mit Escapezeichen versehen werden.
Der Schlüssel darf 16 UTF-8 Bytes nicht überschreiten, und der Wert darf 250 UTF-8 Bytes nicht überschreiten. Der Schlüssel ist erforderlich, und der Wert ist optional. Die maximale Größe des Schlüssels enthält keine geschweiften Klammern und Unterstriche, d. h. "{", "_" und "}".
Hinweis
Beim Massendienst muss der Schlüssel mit umgebenden geschweiften Klammern und einem führenden Unterstrich formatiert werden. Wenn der Schlüssel beispielsweise promoCode ist, muss er als {_promoCode} formatiert werden. Mit dem Kampagnenverwaltungsdienst können Sie die umgebenden Klammern und Unterstriche nicht angeben.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie dieses Feld auf delete_value fest. Die delete_value Schlüsselwort (keyword) entfernt die vorherige Einstellung. Um eine Teilmenge von benutzerdefinierten Parametern zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie beibehalten möchten, und lassen Sie alle parameter aus, die Sie nicht beibehalten möchten. Der neue Satz von benutzerdefinierten Parametern ersetzt alle vorherigen benutzerdefinierten Parametersätze.
Löschen: Schreibgeschützt
Geräteeinstellung
In diesem Feld wird bestimmt, ob Werbung für die App-Installation auf mobilen geräten oder nur auf mobilen Geräten angezeigt werden soll. (Anzeigen zur App-Installation werden auf Desktopcomputern derzeit nicht unterstützt.)
Mögliche Werte sind All (Mobile- und Tablet-Geräte) und Mobile (d. h. ohne Tablets), die sich von den werten unterscheiden, die im Kampagnenverwaltungsdienst verwendet werden.
SixMonths
In der Massendownload- und Upload-Ergebnisdatei ist dieses Feld nie leer. Wenn Sie keine Geräteeinstellung angegeben haben, wird der Standardwert Alle zurückgegeben.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt. Wenn Sie dieses Feld auf delete_value festlegen, setzen Sie effektiv auf den Standardwert Alle zurück.
Löschen: Schreibgeschützt
Redaktioneller Einspruchsstatus
Bestimmt, ob Sie die von der redaktionellen Rezension gefundenen Probleme anfechten können.
Mögliche Werte werden in der folgenden Tabelle beschrieben.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktioneller Ort
Die Komponente oder Eigenschaft der Anzeige, bei der die redaktionelle Überprüfung fehlgeschlagen ist.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktioneller Grundcode
Ein Code, der die Ursache für den Fehler identifiziert. Eine Liste der möglichen Ursachencodes finden Sie unter Redaktionelle Ursachencodes.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktioneller Status
Die redaktionelle status der Anzeige.
Mögliche Werte werden in der folgenden Tabelle beschrieben.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Redaktionsbegriff
Der Begriff, der bei der redaktionellen Überprüfung nicht erfolgreich war.
Dieses Feld wird nicht festgelegt, wenn eine Kombination von Begriffen den Fehler verursacht hat oder wenn der Fehler auf einem Richtlinienverstoß basiert.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Endgültige URL
Die URL, an die ein Suchbenutzer gelangt und auswählen kann, ob eine App installiert werden soll.
Die folgenden Überprüfungsregeln gelten für die endgültige URL für App-Installationsanzeigen.
- Die Länge der URL ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
- Sie können nur eine URL in diesem Feld angeben.
- Die Verwendung von '{' und '}' ist nur zum Abgrenzen von Tags zulässig, z. B. "{lpurl}".
- Jede URL muss eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Endgültiges URL-Suffix
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: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt
Id
Der vom System generierte Bezeichner der Anzeige.
Hinzufügen: Optional. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner für die Anzeige kann dann im Feld Übergeordnete ID abhängiger Datensatztypen wie App Install Ad Label verwiesen werden. Dies wird empfohlen, wenn Sie neue Anzeigen und neue abhängige Datensätze in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Änderungszeit
Das Datum und die Uhrzeit der letzten Aktualisierung der Entität. Der Wert wird in UTC (Coordinated Universal Time) angegeben.
Hinweis
Der Datums- und Uhrzeitwert gibt das Datum und die Uhrzeit auf dem Server und nicht auf dem Client an. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Übergeordnete ID
Der vom System generierte Bezeichner der Anzeigengruppe, die die Anzeige enthält.
Dieses Massenfeld wird dem Feld Id des Anzeigengruppendatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Anzeigengruppenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Anzeigengruppendatensatzes entspricht. Dies wird empfohlen, wenn Sie einer neuen Anzeigengruppe in derselben Massendatei neue Anzeigen hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Hinweis
Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Anzeigengruppe angeben.
Herausgeberländer
Die Liste der Herausgeberländer oder -regionen, deren redaktionelle Richtlinien den angegebenen Begriff nicht zulassen.
In einer Massendatei wird die Liste der Herausgeberländer oder -regionen durch ein Semikolon (;).
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Status
Die status der Anzeige.
Mögliche Werte sind Aktiv, Angehalten oder Gelöscht.
Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.
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: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Titel
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: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt
Vorlage für die Nachverfolgung
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, setzen diejenigen außer Kraft, 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 z. B. lautet
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}und weder {_season} noch {_promocode} in der Kampagne, der Anzeigengruppe, dem Kriterium, Schlüsselwort (keyword) oder der Anzeigenebene definiert sind, ist die URL der Landing Page identisch.
Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt