Freigeben über

AssetGroup-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine Ressourcengruppe in einer Werbekampagne.

Syntax

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AssetGroupSearchThemes" nillable="true" type="tns:ArrayOfAssetGroupSearchTheme">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="AssetGroupUrlTargets" nillable="true" type="tns:ArrayOfAssetGroupUrlTarget">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q116:ArrayOfstring" />
    <xs:element xmlns:q117="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q117:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
    <xs:element minOccurs="0" name="Videos" nillable="true" type="tns:ArrayOfAssetLink">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elemente

Das AssetGroup-Objekt verfügt über die folgenden Elemente: AssetGroupSearchThemes, AssetGroupUrlTargets, BusinessName, CallToAction, Descriptions, EditorialStatus, EndDate, FinalMobileUrls, FinalUrls, ForwardCompatibilityMap, Headlines, ID, Images, LongHeadlines, Name, Path1, Path2, StartDate, Status, Videos.

Element Beschreibung Datentyp
AssetGroupSearchThemes Eine Liste der Suchdesigns für Ressourcengruppen. AssetGroupSearchTheme-Array
AssetGroupUrlTargets Reserviert. AssetGroupUrlTarget-Array
BusinessName Der Name des Unternehmens.

Je nach Anzeigenplatzierung kann der Name Ihres Unternehmens in Ihrer Anzeige angezeigt werden.

Die Länge der Zeichenfolge ist auf 25 Zeichen beschränkt.

Hinzufügen: Erforderlich. Wenn nicht angegeben und die übergeordnete Kampagne einem Geschäft zugeordnet wird, wird der Name des Geschäfts als Geschäftsname verwendet.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolge
CallToAction Ein kurzer, schlagkräftiger Grund für Kunden, sofort auf Ihre Anzeige zu klicken.

Dies wird auf der Schaltfläche "Aktionsaufruf" angezeigt.

Hinzufügen: Erforderlich. Wenn nicht angegeben und die übergeordnete Kampagne einem Store zugeordnet wird, wird standardmäßig LearnMore verwendet.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 CallToAction
Beschreibungen Die Beschreibungen, die unter dem Pfad in Ihrer Anzeige angezeigt werden.

Sie müssen zwischen 2 und 5 Beschreibungen festlegen. Der Text jeder Beschreibung muss mindestens ein Wort enthalten. Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten.

Wenn die übergeordnete Kampagne einem Store zugeordnet ist und Sie Beschreibungen angeben, müssen Sie auch Überschriften, LongHeadlines und Bilder angeben.

Hinzufügen: Optional, wenn die übergeordnete Kampagne einem Store zugeordnet ist, erforderlich, wenn die übergeordnete Kampagne keinem Store zugeordnet ist.
Update: Optional. Um alle vorhandenen Ressourcenlinks beizubehalten, legen Sie dieses Element auf null fest oder belassen sie. Wenn Sie einen Wert für dieses Element festlegen, werden alle Beschreibungen ersetzt, die zuvor mit dieser Ressourcengruppe verknüpft waren. Wenn die übergeordnete Kampagne einem Speicher zugeordnet ist und Sie dieses Element auf eine leere Liste festlegen, wird die vorherige Einstellung gelöscht.		 AssetLink-Array
EditorialStatus Die redaktionelle Überprüfung status der Vermögensgruppe, die angibt, ob die Assetgruppe eine Überprüfung aussteht, genehmigt oder abgelehnt wurde.

Hinzufügen: Schreibgeschützt
Update: Schreibgeschützt		 AssetGroupEditorialStatus
EndDate Das Datum, an dem die Ressourcengruppe abläuft.

Wenn Sie kein Enddatum angeben, läuft die Ressourcengruppe nicht ab. Das Enddatum kann verlängert werden, um eine Ressourcengruppe auch nach Ablauf der Ressourcengruppe für die Lieferung zu qualifizieren.

Das Enddatum ist inklusive. Wenn Sie z. B. EndDate auf den 31.12.2020 festlegen, laufen die Anzeigen in der Anzeigengruppe am 31.12.2020 um 23:59 Uhr ab. Die Uhrzeit basiert auf der Zeitzone, die Sie auf Kampagnenebene angeben.

Hinzufügen: Optional. Um beim Hinzufügen einer Ressourcengruppe kein Enddatum festzulegen, legen Sie dieses Element auf NULL fest.
Update: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um die vorhandene Enddatumseinstellung zu löschen und beim Aktualisieren einer Ressourcengruppe effektiv kein Enddatum festzulegen, legen Sie das Enddatum auf den 2. Januar 2050 oder später fest. Wenn Sie die Ressourcengruppe das nächste Mal abrufen, ist dieses Element null, d. h. es wird nicht auf den 2. Januar 2050 festgelegt.		 Date
FinalMobileUrls Die URL der mobilen Landing Page.

Die folgenden Überprüfungsregeln gelten für endgültige URLs und endgültige mobile URLs.
– 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 bis zu 10 Elemente für FinalUrls und FinalMobileUrls spezifizieren; für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10, um potenzielle Vorwärtskompatibilität zu erzielen.
- Die Verwendung von "{" und "}" ist nur zum Abgrenzen von Tags zulässig, z. B. {lpurl}.
- Endgültige URLs müssen jeweils eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
– Wenn Sie FinalMobileUrls angeben, müssen Sie auch FinalUrls angeben.

Hinzufügen: Optional
Update: Optional		 Zeichenfolgenarray
FinalUrls Die URL der Landing Page.

Der Domänenteil der URL in Kombination mit den Zeichenfolgen für Pfad 1 und Pfad 2 darf 67 Zeichen nicht überschreiten.

Die folgenden Überprüfungsregeln gelten für endgültige URLs und endgültige mobile URLs.
– 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 bis zu 10 Elemente für FinalUrls und FinalMobileUrls angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10, um potenzielle Vorwärtskompatibilität zu erzielen.
- Die Verwendung von "{" und "}" ist nur zum Abgrenzen von Tags zulässig, z. B. {lpurl}.
- Endgültige URLs müssen jeweils eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
– Wenn Sie FinalMobileUrls angeben, müssen Sie auch FinalUrls angeben.

Bei Einzelhandelskampagnen muss die endgültige URL mit der Domäne aus dem Store übereinstimmen, der der Kampagne zugeordnet ist.

Hinzufügen: Erforderlich. Wenn nicht angegeben und die übergeordnete Kampagne einem Store zugeordnet wird, wird die Store-URL als endgültige URL verwendet.
Update: Optional		 Zeichenfolgenarray
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.

Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.		 KeyValuePairOfstring-Array
Schlagzeilen Überschriften sind der prominenteste Text, der in Ihrer Anzeige angezeigt wird, daher sollten Sie die verfügbaren Zeichen optimal nutzen. Wir benötigen mehrere Überschriften, damit die Anzeige flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden kann.

Aus Sicht des Datenmodells werden die Beschreibungen und Überschriften jeweils als Textressourcen gespeichert, d. h. ein TextAsset pro AssetLink. Dasselbe Medienobjekt kann von mehreren Anzeigen verwendet werden. Wenn "Nahtlose Integration" beispielsweise ein Textobjekt ist, weist es für alle Anzeigen im selben Microsoft Advertising-Konto denselben Medienobjektbezeichner auf.

Sie müssen zwischen 3 und 15 Überschriften festlegen. Der Text jeder Überschrift muss mindestens ein Wort enthalten.

Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten.

Wenn die übergeordnete Kampagne einem Store zugeordnet ist und Sie Überschriften angeben, müssen Sie auch LongHeadlines, Beschreibungen und Bilder angeben.

Hinzufügen: Optional, wenn die übergeordnete Kampagne einem Store zugeordnet ist, erforderlich, wenn die übergeordnete Kampagne keinem Store zugeordnet ist.
Update: Optional. Um alle vorhandenen Ressourcenlinks beizubehalten, legen Sie dieses Element auf null fest oder belassen sie. Wenn Sie einen Wert für dieses Element festlegen, werden alle Überschriften ersetzt, die zuvor mit dieser Ressourcengruppe verknüpft waren. Wenn die übergeordnete Kampagne einem Speicher zugeordnet ist und Sie dieses Element auf eine leere Liste festlegen, wird die vorherige Einstellung gelöscht.		 AssetLink-Array
Id Die vom System generierte Ressourcengruppen-ID.

Hinzufügen: Schreibgeschützt
Update: Schreibgeschützt		 lang
Bilder Bildressourcen mit unterschiedlichen Größen und Seitenverhältnissen, sodass sie flexibel über eine Vielzahl von Herausgebern und Platzierungen hinweg angezeigt werden können.

Schließen Sie mindestens ein AssetLink-Objekt ein, das jeweils ein ImageAsset mit SubType und Zuschneideeinstellungen enthält, die dem gewünschten Seitenverhältnis entsprechen.

ImageAsset enthält die Felder CropHeight, CropWidth, CropX, CropY und SubType.

Mögliche Untertypwerte sind LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 und ImageMedia4X1.

Sie müssen mindestens 1 LandscapeImageMedia und 1 SquareImageMedia bereitstellen. Insgesamt können bis zu 20 Bilder und insgesamt bis zu 5 Logos gespeichert werden.

Wenn die übergeordnete Kampagne einem Store zugeordnet ist und Sie Bilder angeben, müssen Sie auch Überschriften, LongHeadlines und Beschreibungen angeben.

Hinzufügen: Optional, wenn die übergeordnete Kampagne einem Store zugeordnet ist, erforderlich, wenn die übergeordnete Kampagne keinem Store zugeordnet ist.
Update: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie während des Updates Images einschließen, werden alle zuvor festgelegten Images ersetzt. Wenn die übergeordnete Kampagne einem Speicher zugeordnet ist und Sie dieses Element auf eine leere Liste festlegen, wird die vorherige Einstellung gelöscht.		 AssetLink-Array
LongHeadlines Sie müssen zwischen 1 und 5 lange Überschriften festlegen. Der Text jeder Überschrift muss mindestens ein Wort enthalten. Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten.

Wenn die übergeordnete Kampagne einem Store zugeordnet ist und Sie LongHeadlines angeben, müssen Sie auch Überschriften, Beschreibungen und Bilder angeben.

Hinzufügen: Optional, wenn die übergeordnete Kampagne einem Store zugeordnet ist, erforderlich, wenn die übergeordnete Kampagne keinem Store zugeordnet ist.
Update: Optional. Um alle vorhandenen Ressourcenlinks beizubehalten, legen Sie dieses Element auf null fest oder belassen sie. Wenn Sie einen Wert für dieses Element festlegen, werden alle Überschriften ersetzt, die zuvor mit dieser Ressourcengruppe verknüpft waren. Wenn die übergeordnete Kampagne einem Speicher zugeordnet ist und Sie dieses Element auf eine leere Liste festlegen, wird die vorherige Einstellung gelöscht.		 AssetLink-Array
Name Der Name der Ressourcengruppe. Namen sollten in einer Kampagne eindeutig sein und die Groß-/Kleinschreibung beachten. Die Länge darf 256 Zeichen nicht überschreiten.

Hinzufügen: Erforderlich
Update: Optional		 Zeichenfolge
Pfad 1 Der erste Teil des optionalen Pfads, der an den Domänenteil Ihrer Anzeige-URL angefügt wird. Der Domänenteil Ihrer Anzeige-URL wird z. B. https://www.contoso.com aus der Domäne Ihrer finalen URL (FinalUrls-Element) generiert. Wenn Sie dann einen Wert für Path1 angegeben haben, wird dieser an die Anzeige-URL angefügt. Wenn Sie auch einen Wert für Path2 angegeben haben, wird er auch an die Anzeige-URL nach Path1 angefügt. Wenn Ihre FinalUrls z. B. enthalten https://www.contoso.com, Path1 auf Unterverzeichnis1 und Path2 auf Unterverzeichnis2 festgelegt ist, lautet https://www.contoso.com/subdirectory1/subdirectory2die angezeigte URL .

Es können maximal 15 Zeichen eingegeben werden. Die Anzeige wird nicht angezeigt, wenn die Länge der endgültigen URL-Domäne und der Pfade zusammen 67 Zeichen überschreitet.

Für Sprachen mit Zeichen mit doppelter Breite können z. B. traditionelles Chinesisch nicht mehr als 7 letzte Zeichen eingegeben werden. Die Anzeige wird nicht angezeigt, wenn die Länge der endgültigen URL-Domäne und der pfade zusammen 33 Zeichen überschreitet. Die Zeichen mit doppelter Breite werden durch die Zeichen bestimmt, die Sie anstelle des Zeichensatzes der Spracheinstellungen der Kampagne verwenden. Zu den Zeichen mit doppelter Breite gehören koreanische, japanische und chinesische Zeichen sowie Emojis.

Der Pfad darf keinen Schrägstrich (/) oder Zeilenvorschubzeichen (\n) enthalten.

Wenn der Pfad ein Leerzeichen enthält, wird er durch einen Unterstrich (_) ersetzt, wenn die Anzeige angezeigt wird.

Hinzufügen: Optional
Update: Optional		 Zeichenfolge
Pfad 2 Der zweite Teil des optionalen Pfads, der an den Domänenteil Ihrer Anzeige-URL angefügt wird. Der Domänenteil Ihrer Anzeige-URL wird z. B. https://www.contoso.com aus der Domäne Ihrer finalen URL (FinalUrls-Element) generiert. Wenn Sie dann einen Wert für Path1 angegeben haben, wird dieser an die Anzeige-URL angefügt. Wenn Sie auch einen Wert für Path2 angegeben haben, wird er auch an die Anzeige-URL nach Path1 angefügt. Wenn Ihre FinalUrls z. B. enthalten https://www.contoso.com, Path1 auf Unterverzeichnis1 und Path2 auf Unterverzeichnis2 festgelegt ist, lautet https://www.contoso.com/subdirectory1/subdirectory2die angezeigte URL .

Sie können Path2 nur angeben, wenn Path1 ebenfalls festgelegt ist.

Es können maximal 15 Zeichen eingegeben werden. Die Anzeige wird nicht angezeigt, wenn die Länge der endgültigen URL-Domäne und der Pfade zusammen 67 Zeichen überschreitet.

Für Sprachen mit Zeichen mit doppelter Breite können z. B. traditionelles Chinesisch nicht mehr als 7 letzte Zeichen eingegeben werden. Die Anzeige wird nicht angezeigt, wenn die Länge der endgültigen URL-Domäne und der pfade zusammen 33 Zeichen überschreitet. Die Zeichen mit doppelter Breite werden durch die Zeichen bestimmt, die Sie anstelle des Zeichensatzes der Spracheinstellungen der Kampagne verwenden. Zu den Zeichen mit doppelter Breite gehören koreanische, japanische und chinesische Zeichen sowie Emojis.

Der Pfad darf keinen Schrägstrich (/) oder Zeilenvorschubzeichen (\n) enthalten.

Wenn der Pfad ein Leerzeichen enthält, wird er durch einen Unterstrich (_) ersetzt, wenn die Anzeige angezeigt wird.

Hinzufügen: Optional
Update: Optional		 Zeichenfolge
StartDate Das Datum, an dem die Ressourcengruppe mit der Bereitstellung beginnen kann; Andernfalls kann der Dienst mit der Bereitstellung von Anzeigen beginnen, wenn die Ressourcengruppe aktiv wird.

Das Startdatum ist inklusive. Wenn Sie beispielsweise das Startdatum auf den 5.05.2021 festlegen, beginnen die aus der Ressourcengruppe erstellten Anzeigen am 5.05.2021 um 12:00 Uhr. Die Uhrzeit basiert auf der Zeitzone, die Sie auf Kampagnenebene angeben.

Hinzufügen: Optional. Wenn Sie das Startdatum nicht festlegen, wird standardmäßig das heutige Datum verwendet, und der Dienst kann mit der Bereitstellung von Anzeigen beginnen, sobald die Ressourcengruppe status aktiv ist.
Update: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Das Startdatum kann nicht aktualisiert werden, nachdem die Ressourcengruppe übermittelt wurde, d. h. sobald der Starttermin eingetroffen ist.		 Date
Status Die status der Ressourcengruppe. Mögliche Werte sind Aktiv, Abgelaufen und Angehalten. Die abgelaufene status ist schreibgeschützt.

Hinzufügen: Optional. Der Standardwert ist Angehalten.
Update: Optional		 AssetGroupStatus
Videos Reserviert. AssetLink-Array

Anforderungen

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

Verwendet von

AddAssetGroups
CreateAssetGroupRecommendation
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
RefineAssetGroupRecommendation
UpdateAssetGroups