ProductAd-Datenobjekt – Kampagnenverwaltung

2024-12-18

Definiert eine Produktanzeige. Eine Produktanzeige wird nicht direkt für gelieferte Anzeigenkopien verwendet. Stattdessen generiert die Liefer-Engine Produktanzeigen aus den Produktdetails, die sie im Microsoft Merchant Center-Store des Kunden findet.

<xs:complexType name="ProductAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="PromotionalText" 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": "Product",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "PromotionalText": "ValueHere"
}

Elemente

Das ProductAd-Objekt weist die folgenden Elemente auf: PromotionalText.

Element	Beschreibung	Datentyp
PromotionalText	Diese Eigenschaft ist für die interne Verwendung reserviert und wird aus einer zukünftigen Version der API entfernt. Sie können Händleraktionen verwenden, wenn Tags am Ende Ihrer Produktanzeige als "Sonderangebote"-Links angezeigt werden sollen, um die Kundenbindung zu erhöhen. Hinzufügen: Wahlfrei Aktualisieren: Wahlfrei	Zeichenfolge

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

Geerbte Elemente

Geerbte Elemente von Ad

Das ProductAd-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 ProductAd 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	Wird für diesen Anzeigentyp nicht unterstützt.	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 diesen Anzeigentyp nicht unterstützt.	AppUrl-Array
FinalMobileUrls	Wird für diesen Anzeigentyp nicht unterstützt.	Zeichenfolgenarray
FinalUrls	Wird für diesen Anzeigentyp nicht unterstützt.	Zeichenfolgenarray
FinalUrlSuffix	Wird für diesen Anzeigentyp nicht unterstützt.	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. Derzeit gibt es keine ForwardCompatibilityMap-Schlüssel- und Wertpaare, die für Produktanzeigen 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	Wird für diesen Anzeigentyp nicht unterstützt.	Zeichenfolge
Typ	Der Typ der Anzeige. Dieser Wert ist Product , wenn Sie eine Produktanzeige 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	Wird für diesen Anzeigentyp nicht unterstützt.	CustomParameters

Anforderungen

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