Freigeben über


AccountProperty-Datenobjekt – Kampagnenverwaltung

Ordnet einen Eigenschaftennamen auf Kontoebene einem Zeichenfolgenwert zu.

Syntax

<xs:complexType name="AccountProperty" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Name" type="tns:AccountPropertyName" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elemente

Das AccountProperty-Objekt weist die folgenden Elemente auf: Name, Wert.

Element Beschreibung Datentyp
Name Der Name der Kontoeigenschaft. AccountPropertyName
Wert Der Wert der benannten Kontoeigenschaft.

Der Wert variiert je nach Kontoeigenschaftsname. Weitere Informationen finden Sie unter Account Property Values (Kontoeigenschaftswerte ) im abschnitt unten.
Zeichenfolge

Hinweise

Account-Eigenschaftswerte

AdClickParallelTracking

Bestimmt, ob die parallele Nachverfolgung aktiviert ist.

Wenn Sie die URL-Nachverfolgung verwenden und Kunden auf Ihre Anzeige klicken, müssen sie in der Regel eine Reihe von Umleitungen durchlaufen, bevor sie Ihre Seite erreichen. Dies wird als sequenzielle Nachverfolgung bezeichnet.

Beim parallelen Tracking sehen Kunden, wenn sie auf Ihre Anzeige klicken, sofort Ihre Landing Page. Gleichzeitig führt Microsoft Advertising Ihre Nachverfolgungs-URLs im Hintergrund aus. So wird die Benutzererfahrung Ihrer Kunden verbessert, und Sie erhalten immer noch die gleiche großartige Messnachverfolgung.

Sie benötigen {lpurl} oder eine seiner Varianten in der Nachverfolgungsvorlage Ihrer URL, damit die parallele Nachverfolgung funktioniert. Weitere Informationen finden Sie unter Paralleles Tracking bringt Kunden schneller zu Ihrer Landing Page und Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?.

Wenn das Name-Element auf AdClickParallelTracking festgelegt ist, kann der zurückgegebene Wert entweder true oder false sein. Wenn der Wert true ist, ist die parallele Nachverfolgung aktiviert.

Wichtig

Die parallele Nachverfolgung ist für alle Konten erforderlich, die nach dem 31. Mai 2020 erstellt wurden. Bis Januar 2021 können Sie das Feature für Konten aktivieren und deaktivieren, die vor dem 1. Juni 2020 erstellt wurden, d. h. die Eigenschaft auf true oder false festlegen. Bis Mitte Januar 2021 werden alle Konten für die parallele Nachverfolgung aktiviert, und der Wert kann nur auf true festgelegt werden.

AllowImageAutoRetrieve

Bestimmt, ob Microsoft Advertising Bilder aus Ihrer Domäne verwenden darf, um Ihre Anzeigen im Microsoft Audience Network zu verbessern.

Wichtig

Durch die Anmeldung erklären Sie sich damit einverstanden, dass alle Bilder oder kreativen Inhalte, die von der Landing Page des Inserenten abgerufen werden, Inhalte sind, die vom Inserenten im Rahmen der Inhaltsnutzungslizenz in der Werbevereinbarung (Abschnitt 2) bereitgestellt werden, und dass der Inserent zustimmt, dass Microsoft diese Inhalte für die automatische Erstellung von Anzeigen und Erweiterungen für sie verwenden kann.

Hinweis

Dieses Feature hat noch nicht jeder. Wenn Sie dies nicht getan haben, machen Sie sich keine Sorgen – es ist bald verfügbar!

Wenn das Name-Element auf AllowImageAutoRetrieve festgelegt ist, kann der Wert entweder auf true oder false festgelegt werden. Wenn der Wert true ist, ist die Funktion zum automatischen Abrufen von Bildern aktiviert.

AutoApplyRecommendations

Bestimmt, ob Microsoft Advertising automatisch Anzeigenempfehlungen anwenden darf, die Ihnen helfen sollen, die Anzeigenleistung zu steigern.

Warnung

AutoApplyRecommendations in der Kampagnenverwaltungs-API ist ab dem 30. November 2022 veraltet. Es wird dringend empfohlen, die neue Verwaltungsschnittstelle für automatisches Anwenden in der Ad Insight-API zu verwenden.

Hinweis

Dieses Feature hat noch nicht jeder. Wenn Sie dies nicht getan haben, machen Sie sich keine Sorgen – es ist bald verfügbar!

Wir informieren Sie darüber, wann vorgeschlagene Anzeigen für Sie zur Überprüfung bereit sind. Anzeigenempfehlungen finden Sie auf der Seite Empfehlungen. Wenn Sie keine Maßnahmen ergreifen, wenden wir diese nach dem Überprüfungszeitraum automatisch an:

  • Multimedia-Anzeigen: 7 Tage
  • Alle anderen: 14 Tage

Sie können Ihre Optionen für die automatische Anwendung jederzeit ändern. Wenn Sie sich nicht für die automatische Anwendung von Anzeigenempfehlungen entscheiden, können Sie Empfehlungen weiterhin manuell anwenden.

Wenn das Name-Element auf AutoApplyRecommendations festgelegt ist, kann der Wert eine Liste von Empfehlungstypen enthalten.

Innerhalb des Value-Elements wird die Liste der Schlüssel- und Wertpaare durch ein Semikolon (;). In diesem Beispiel ist die automatische Anwendung von Anzeigenempfehlungen für Multimediaanzeigen aktiviert, jedoch nicht für reaktionsfähige Suchanzeigen oder erweiterte Textanzeigen.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>AutoApplyRecommendations</Name>
      <Value>MultimediaAdsAutoApply=true;ResponsiveSearchAdsAutoApply=false;ExpandedTextAdsAutoApply=false</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Die Standardschlüssel- und Wertpaare sind:

  • MultimediaAdsAutoApply=true;
  • ResponsiveSearchAdsAutoApply=false;
  • ExpandedTextAdsAutoApply=false;

Wenn der Wert eines Schlüssels auf true festgelegt ist, ist das Feature für die automatische Anwendung für den Empfehlungstyp aktiviert.

Sie können nur die Schlüssel-Wert-Paare festlegen, die Sie aktualisieren möchten. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.

BusinessAttributes

Ermöglicht es Ihnen, wichtige Geschäftswerte hervorzuheben, die Ihnen helfen sollen, die Anzeigenleistung zu steigern.

Geschäftsattribute sind optional, und Sie können ein oder mehrere Attribute auswählen, die für Ihr Unternehmen gelten.

Wenn das Name-Element auf BusinessAttributes festgelegt ist, kann der Wert eine Liste von Attributtypen enthalten.

Innerhalb des Value-Elements wird die Liste der Geschäftsattribute durch ein Semikolon (;). Mögliche Werte sind: AlcoholFree, AllergyFriendly, AsianOwned, BlackOwned, CarbonNegative, CarbonNeutral, CrueltyFree, DiabeticFriendly, EcoFriendly, FamilyFriendly, FamilyOwned, GlutenFree, Halal, HearingAssistance, Koher, LatinOwned, LocalBusiness, LGBTQIFriendly, LGBTQIFriendly, LGBTQIOwned, MinorityOwned, MobilityAssistance, NoContactDelivery, Nonprofit, PetFriendly, SmallBusiness, SupportACure, SupportDiseaseResearch, Sustainable, Vegan, Vegetarian, VisualAssistance, TouchlessPickup, Unisex, WebAccessibility, WheelchairAccessible und WomenOwned.

In diesem Beispiel sind Alkoholfrei, Familienbesitz und Vegan die ausgewählten Geschäftsattribute.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>BusinessAttributes</Name>
      <Value>AlcoholFree;FamilyOwned;Vegan</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Wenn das Attribut in der value-Eigenschaft angezeigt wird, wird es ausgewählt. Wenn das Attribut nicht in der value-Eigenschaft angezeigt wird, ist es nicht ausgewählt.

Um die Geschäftsattribute des Kontos zu löschen, legen Sie den Namen auf BusinessAttributes und den Wert auf "" (leere Zeichenfolge) fest.

Sie können nur die Geschäftsattribute festlegen, die Sie aktualisieren möchten. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.

FinalUrlSuffix

Wenn das Name-Element auf FinalUrlSuffix festgelegt ist, stellt der Wert das Endgültige URL-Suffix Ihres Kontos dar.

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.

Um das endgültige URL-Suffix des Kontos zu löschen, legen Sie den Namen auf FinalUrlSuffix und den Wert auf "" (leere Zeichenfolge) fest.

IncludeViewThroughConversions

Bestimmt, ob Sie View-Through-Konvertierungen für Kampagnen in das Konto einschließen möchten.

View-Through-Konvertierungen sind Konvertierungen, die Personen vornehmen, nachdem sie Ihre Anzeige gesehen haben, obwohl sie nicht auf die Anzeige geklickt haben.

Wenn das Name-Element auf IncludeViewThroughConversions festgelegt ist, kann der Wert entweder auf true oder false festgelegt werden. Wenn der Wert true ist, werden View-Through-Konvertierungen eingeschlossen. Wenn Sie sich im Featurepilot befinden (GetCustomerPilotFeatures gibt 616 zurück), ist diese Eigenschaft standardmäßig auf TRUE festgelegt, was bedeutet, dass die Werte in den Spalten "Alle" -Konvertierungen Ihrer Leistungsberichte View-Through-Konvertierungen enthalten. Sie können die Option deaktivieren, wenn Sie keine Konvertierungen für das Durchsehen einschließen möchten.

Hinweis

View-Through-Konvertierungen erfordern ein UETTag, sodass diese Eigenschaft nicht für AppInstallGoal, InStoreTransactionGoal und OfflineConversionGoal gilt.

MSCLKIDAutoTaggingEnabled

Bestimmt, ob das automatische Tagging des MSCLKID-Abfragezeichenfolgenparameters aktiviert ist. Die MSCLKID ist eine 32-stellige GUID, die für jeden Anzeigenklick eindeutig ist.

Wenn das Name-Element auf MSCLKIDAutoTaggingEnabled festgelegt ist, kann der Wert entweder auf true oder false festgelegt werden. Wenn der Wert true ist, ist die automatische Kennzeichnungsfunktion MSCLKID aktiviert. Möglicherweise möchten Sie das automatische Tagging von MSCLKID zum Nachverfolgen von Leads über Offlinekonvertierungsziele aktivieren. Wenn die automatische Kennzeichnung von MSCLKID aktiviert ist, wird die MSCLKID automatisch an die URL der Startseite angefügt, wenn ein Kunde auf Ihre Anzeige klickt. Beispiel : www.contoso.com/?msclkid={msclkid}. Die Klick-ID ist für jeden Anzeigenklick eindeutig, und mehrere Klicks auf dieselbe Anzeige desselben Benutzers führen zu Mehrfachklick-IDs.

Wichtig

Der MSCLKIDAutoTaggingEnabled-Wert wird standardmäßig auf true festgelegt, wenn ein neues Konto erstellt wird. Sie können diese Option manuell deaktivieren. 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 vorhandenen Konten unter dem Kunden festgelegt.

ProfileExpansionEnabled

Bestimmt, ob die LinkedIn-Profiladressierung für Ihr gesamtes Konto erweitert werden soll, um weitere Kunden zu erreichen, die denen ähneln, die Sie derzeit als Ziel verwenden.

Durch die Aktivierung der Profiladressierungserweiterung kann Microsoft Advertising Ihre Anzeigen für weitere Kunden anzeigen, die denen ähneln, auf die Sie derzeit abzielen. Wenn Sie z. B. ein bestimmtes LinkedIn-Zielgruppensegment als Ziel haben, richten wir uns auch an Bing-Benutzer, die kein bestätigtes LinkedIn-Konto haben, die aber die gleichen Merkmale wie LinkedIn-Benutzer in diesem Segment aufweisen.

Wenn das Name-Element auf ProfileExpansionEnabled festgelegt ist, kann der Wert entweder auf true oder false festgelegt werden. Wenn der Wert true ist, ist die LinkedIn-Profilerweiterung aktiviert.

TrackingUrlTemplate

Wenn das Name-Element auf TrackingUrlTemplate festgelegt ist , stellt value die Nachverfolgungsvorlage Ihres Kontos dar, die als Standard für alle URLs in Ihrem Konto verwendet werden soll. Der Wert des TrackingUrlTemplate-Schlüssels kann auf eine beliebige gültige Zeichenfolge festgelegt werden, wie unten beschrieben.

  • Nachverfolgungsvorlagen, die für Entitäten auf niedrigerer Ebene definiert sind, z. B. Schlüsselwort (keyword) ü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}.

  • Sie müssen mindestens einen der folgenden URL-Parameter für die Landing Page einschließen: {lpurl}, {lpurl+2}, {lpurl+3}, {unescapedlpurl}, {escapedlpurl}. Darüber hinaus können Sie jeden dynamischen Parameter verwenden, der von Microsoft Advertising unterstützt wird. Eine Liste der unterstützten Parameter finden Sie in den Abschnitten Verfügbare Parameter im Microsoft Advertising-Hilfeartikel Einrichten einer Nachverfolgungsvorlage.

  • 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 endgültige URL 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-, Schlüsselwort (keyword)- oder Anzeigenebene definiert sind, ist die endgültige URL identisch.

Um die Nachverfolgungsvorlage des Kontos zu löschen, legen Sie den Namen auf TrackingUrlTemplate und den Wert auf "" (leere Zeichenfolge) fest.

Anforderungen

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

Verwendet von

GetAccountProperties
SetAccountProperties