Freigeben über

Ressourcengruppeneintrag – Massendatensatz

  • Artikel

Definiert eine Ressourcengruppenauflistungsgruppe, die in eine Massendatei hochgeladen und heruntergeladen werden kann.

Sie können Datensätze von Ressourcengruppenauflistungsgruppen für mehrere Anzeigengruppen in derselben Massendatei hochladen, solange die Validierungsregeln wie unten beschrieben erfüllt sind.

  • Sie müssen mindestens den Stammknoten für die Struktur der Produktpartitionsgruppe angeben. Für den Stammknoten der Produktpartitionsgruppe muss das Feld Product Condition 1 auf "All" und product value 1 null oder empty festgelegt sein. Wenn Sie für alle Produkte im Katalog gleichermaßen bieten, legen Sie das Feld Untertyp auf Einheit fest. Wenn Sie die Gebote basierend auf spezifischeren Produktbedingungen partitionieren, legen Sie das Feld Untertyp auf Unterteilung, die Übergeordnete Kriteriums-ID auf NULL oder leer und die ID auf einen negativen Wert fest. Sie verwenden den negativen Wert als übergeordnete Kriterien-ID für alle untergeordneten Knoten.

  • Der Stammknoten wird als Ebene 0 betrachtet, und eine Struktur kann verzweigt bis zu 7 Ebenen tief sein.

  • Pro Uploadanforderung können Sie maximal 20.000 Produktpartitionsstrukturknoten pro Anzeigengruppe einschließen. Die Anzahl der Gesamten Knoten der Produktpartitionsstruktur für eine Anzeigengruppe darf 20.000 nicht überschreiten.

  • Die Knoten der Produktpartitionsstruktur für dieselbe Struktur (dieselbe Anzeigengruppe) müssen in der Datei gruppiert werden.

  • Die Reihenfolge der Produktpartitionsknoten ist während des Downloads nicht garantiert, und übergeordnete Knoten werden möglicherweise nach untergeordneten Knoten bereitgestellt. Alle Knoten für dieselbe Anzeigengruppe werden jedoch in der Datei gruppiert.

  • Wenn Sie die Struktur erstellen oder ändern, müssen die Knoten der übergeordneten Produktpartitionsstruktur vor den untergeordneten Produktpartitionsstrukturknoten angeordnet werden. bei nicht strukturellen Änderungen wie der Aktualisierung des Gebots spielt der Auftrag jedoch keine Rolle. Wenn Sie beispielsweise die Gebote aktualisieren möchten, ohne die Struktur hinzuzufügen, zu löschen oder zu aktualisieren, müssen Sie nur die Felder Id und Übergeordnete ID hochladen.

  • Um die Felder Product Condition 1, Product Value 1 oder Is Excluded zu aktualisieren, müssen Sie den vorhandenen Knoten der Produktpartitionsstruktur löschen und einen neuen Knoten der Produktpartitionsstruktur hochladen, der einen neuen Bezeichner erhält.

  • Wenn eine Aktion fehlschlägt, schlagen auch alle verbleibenden Aktionen fehl, die andernfalls erfolgreich waren.

  • Alle Aktionen zum Hinzufügen und Löschen von Produktpartitionsknoten müssen zu einer vollständigen Struktur führen.

  • Jeder Pfad vom Stammknoten bis zum Ende einer Verzweigung muss mit einem Blattknoten (Sub Type=Unit) enden. Jede Einheit muss über ein Gebot verfügen, es sei denn, das Feld Ist ausgeschlossen ist true, was bedeutet, dass der Knoten ein negatives Anzeigengruppenkriterium ist.

  • Jede Unterteilung muss über mindestens einen Blattknoten verfügen, der auf den Rest der Bedingungen der Unterteilung gebote, d. h. denselben Operanden wie die gleichgeordneten Einheiten verwenden und den Produktwert 1 null oder leer festlegen.

  • Wenn Sie Partitionen mit mehreren Ebenen hinzufügen, auf denen weder das übergeordnete noch das untergeordnete Element vorhanden ist, verwenden Sie einen negativen int-Wert als Verweis, um das übergeordnete Element zu identifizieren. Legen Sie beispielsweise sowohl die ID des übergeordneten Elements als auch das Feld Parent Criterion ID des untergeordneten Elements auf denselben negativen Wert fest. Die negativen IDs sind nur für die Dauer des Aufrufs gültig. Eindeutige Systembezeichner für jedes erfolgreich hinzugefügte Anzeigengruppenkriterium werden in der Upload-Ergebnisdatei zurückgegeben.

  • Um eine Produktpartition anzuhalten, müssen Sie die gesamte Anzeigengruppe anhalten, indem Sie das Feld Status der Anzeigengruppe auf Angehalten aktualisieren. Sie können die gesamte Kampagne anhalten, indem Sie das Feld Status der Kampagne auf Angehalten aktualisieren.

  • Für eine Deleted-Aktion müssen Sie nur die ID und die übergeordnete ID angeben.

  • Wenn Sie eine übergeordnete Produktpartition löschen, werden auch alle untergeordneten Elemente und Nachfolger gelöscht.

  • Sie dürfen keine doppelten Produktbedingungen in einer Verzweigung angeben.

Sie können alle Einträge von Ressourcengruppenauflistungsgruppen im Konto herunterladen, indem Sie den DownloadEntity-Wert von AssetGroupListingGroups 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.

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 BulkAssetGroupListingGroup-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.

Für einen Ressourcengruppeneintragsgruppendatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

Asset Group

Der Name der Ressourcengruppe, zu der die Ressourcengruppe gehört.

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder die übergeordnete ID oder das Feld Ressourcengruppe und Kampagne angeben.

Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Kampagne

Der Name der Kampagne, die die Ressourcengruppe und die Auflistungsgruppe enthält.

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder die übergeordnete ID oder das Feld Ressourcengruppe und Kampagne angeben.

Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

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: Wahlfrei
Aktualisieren: Wahlfrei
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner der Ressourcengruppenauflistungsgruppe.

Hinzufügen: Wahlfrei. Sie müssen dieses Feld entweder leer lassen oder einen negativen Bezeichner angeben. Auf einen negativen Bezeichner, der für die Ressourcengruppenauflistungsgruppe festgelegt ist, kann dann im Feld Übergeordnete ID abhängiger Datensatztypen wie Anzeigen, Schlüsselwörter oder Kriterium verwiesen werden. Dies wird empfohlen, wenn Sie neue Ressourcengruppen 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

Ist ausgeschlossen

Bestimmt, ob Produkte, die zur Listengruppe gehören, bei der Bereitstellung ausgeschlossen werden sollen.

Wenn dieser Wert auf TRUE festgelegt ist, handelt es sich um ein negatives Kriterium, andernfalls handelt es sich bei false um ein positives Kriterium.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Ä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

Die ID der Ressourcengruppe, die die Auflistungsgruppe enthält.

Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder die übergeordnete ID oder die Ressourcengruppe und das Feld Kampagne angeben.

Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Gruppen-ID der übergeordneten Auflistung

Sie müssen mindestens den Stammknoten für die Struktur angeben.

Für den Stammknoten der Auflistungsgruppe muss das Feld Produktbedingung 1 auf Alle und Produktwert 1 null oder leer festgelegt sein.

Wenn Sie für alle Produkte im Katalog gleichermaßen bieten, legen Sie das Feld Untertyp auf Einheit fest.

Wenn Sie die Produkte basierend auf spezifischeren Produktbedingungen partitionieren, legen Sie das Feld Untertyp auf Unterteilung, die Id der übergeordneten Auflistungsgruppe auf NULL oder leer und die ID auf einen negativen Wert fest. Sie verwenden den negativen Wert als Gruppen-ID der übergeordneten Auflistung für alle untergeordneten Knoten.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Produktbedingung 1

Der Operand der Bedingung. Die Operanden enthalten implizit den Gleichheitsoperator. Beispielsweise können Sie Brand als Brand= lesen.

Verwenden Sie die Produktbedingung 1 als Operanden für den Produktwert 1.

Für jede Microsoft Performance Max-Ressourcengruppe können mehrere Produktbedingungen angegeben werden. Jede Bedingung ist erfüllt, wenn der Attributwert des Produkts dem Attributwert des Operanden entspricht. Wenn der Operand beispielsweise auf Brand und das Attribut auf Contoso festgelegt ist, ist die Bedingung erfüllt, wenn der Wert des Brand-Attributs des Produktkatalogs contoso entspricht.

In Performance Max-Kampagnen können die Produktbedingungen nur auf Ressourcengruppenebene festgelegt werden. In der folgenden Tabelle werden die Geschäftsregeln Product Condition (Operand) und Product Value (Attribut) für AssetGroupListingGroup-Objekte beschrieben.

Produktbedingung (Operand) Beschreibung des Produktwerts (Attributs) Ressourcengruppen-Produktpartitionsregeln
Alle Muss NULL sein. Für die Produktpartitionen einer Ressourcengruppe muss der Operand für den Stammknoten auf Alle und das Attribut auf NULL oder leer festgelegt sein.
Marke Hersteller, Marke oder Herausgeber des Produkts.

Maximal 1.000 Zeichen.		 Für die Produktpartitionen einer Ressourcengruppe muss der Operand für den Stammknoten auf Alle und das Attribut auf NULL oder leer festgelegt sein.
KategorieL1-5

Fünf Kategorieoperandwerte sind verfügbar, d. h. CategoryL1, CategoryL2, CategoryL3, CategoryL4 und CategoryL5.		 Eine Produktkategorie, die vom Microsoft Merchant Center-Store definiert wird. Gültige Kategoriewerte und Taxonomie finden Sie unter Bing-Kategorietaxonomie .

CategoryL0 ist die Kategorie der höchsten Ebene, und CategoryL4 ist die niedrigste oder präziseste Kategorie.

Maximal 100 Zeichen.		 Jeder der CategoryL-Operanden kann in mehreren Branches verwendet werden.

Jeder der CategoryL-Operanden kann in mehreren Verzweigungen verwendet werden, kann aber nur einmal pro Branch angegeben werden. Beispielsweise kann ein Branch CategoryL1 und CategoryL2 enthalten, aber keinen weiteren Knoten mit dem CategoryL2-Operanden .

Wenn Sie den Operanden auf eine Produktkategorie von 1 bis 5 festlegen, müssen diese in aufsteigender Reihenfolge angegeben werden. Beispielsweise kann der Operand mit dem Attribut Pet Supplies auf CategoryL2 festgelegt werden, wenn eine Übergeordnete Produktpartition den Operanden CategoryL1 mit dem Attribut Animals & Pet Supplies aufweist.

Der Produktkategorieoperand der vorherigen Ebene muss nicht in der unmittelbar übergeordneten Partition angegeben werden. Beispielsweise könnte eine CategoryL2-Bedingung für eine Produktpartition angegeben werden, wenn das übergeordnete Element des übergeordneten Elements eine CategoryL1-Bedingung angibt.
Kanal Der LIA-Kanal (Local Inventory Ads).

Mögliche Werte sind "Local Stores" und "Online".

Wenn sich die Kampagne nicht für Lokale Bestandsanzeigen entschieden hat, sind alle Angebote standardmäßig nur Online (Channel=Online) und Einzelner Kanal (ChannelExclusivity=Single-Channel). Weitere Informationen finden Sie auf der Hilfeseite Für Lokale Bestandsanzeigen .		 Der Kanaloperand kann in mehreren Verzweigungen verwendet werden, kann aber nur einmal pro Branch angegeben werden.
ChannelExclusivity Exklusivität des LIA-Kanals (Local Inventory Ads).

Mögliche Werte sind "Single-channel" und "Multi-channel".

Wenn sich die Kampagne nicht für Lokale Bestandsanzeigen entschieden hat, sind alle Angebote standardmäßig nur Online (Channel=Online) und Einzelner Kanal (ChannelExclusivity=Single-Channel). Weitere Informationen finden Sie auf der Hilfeseite Für Lokale Bestandsanzeigen .		 Der ChannelExclusivity-Operand kann in mehreren Verzweigungen verwendet werden, kann aber nur einmal pro Verzweigung angegeben werden.
Bedingung Der Zustand des Produkts.

Wenn der Operand auf Bedingung festgelegt ist, sind die unterstützten Attributwerte, die Sie angeben können, Neu, Verwendet und Generalisiert.		 Der Condition-Operand kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden.
CustomLabel0-4

Fünf benutzerdefinierte Bezeichnungsoperndenwerte sind verfügbar, d. h. CustomLabel0, CustomLabel1, CustomLabel2, CustomLabel3 und CustomLabel4.		 Eine benutzerdefinierte Bezeichnung, die vom Händler definiert wird.

Benutzerdefinierte Bezeichnungen, z. B. CustomLabel0 und CustomLabel4, werden nicht basierend auf einer Hierarchie überprüft.

Maximal 100 Zeichen.		 Jeder der CustomLabel-Operanden kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden. Beispielsweise kann ein Branch CustomLabel0 und CustomLabel1 enthalten, aber keinen weiteren Knoten mit dem CustomLabel1-Operanden .
Id Der vom Händler definierte Produktbezeichner.

Maximal 1.000 Zeichen.		 Der Id-Operand kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden.
ProductType1-5

Fünf Produkttyp-Operandenwerte sind verfügbar, d. h. ProductType1, ProductType2, ProductType3, ProductType4 und ProductType5.		 Ein vom Händler definierter Produkttyp oder eine Kategorie.

ProductType1 ist der Produkttyp der höchsten Ebene, und ProductType5 ist der produkttyp mit der niedrigsten oder granularsten Ebene.

Maximal 100 Zeichen.		 Jeder der ProductType-Operanden kann in mehreren Branches verwendet werden, kann aber nur einmal pro Branch angegeben werden. Beispielsweise kann ein Branch ProductType1 und ProductType2 enthalten, aber keinen weiteren Knoten mit dem ProductType2-Operanden .

Wenn Sie den Operanden auf einen Produkttyp von 1 bis 5 festlegen, müssen diese in aufsteigender Reihenfolge angegeben werden. Beispielsweise kann der Operand mit dem Attribut Pet Supplies auf ProductType2 festgelegt werden, wenn eine übergeordnete Produktpartition den Operanden ProductType1 mit dem Attribut Animals & Pet Supplies aufweist.

Der Produkttypopernd der vorherigen Ebene muss nicht in der unmittelbar übergeordneten Partition angegeben werden. Beispielsweise kann eine ProductType2-Bedingung für eine Produktpartition angegeben werden, wenn das übergeordnete Element des übergeordneten Elements eine ProductType1-Bedingung angegeben hat.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt. Sie können die Bedingungs- oder Wertfelder nicht aktualisieren. Um die Bedingungen zu aktualisieren, müssen Sie die Produktpartition löschen und eine neue hinzufügen.
Löschen: Schreibgeschützt

Produktwert 1

Der Attributwert der Bedingung.

Der Wert eines Attributs muss genau mit dem in der Microsoft Merchant Center-Katalogdatei des Kunden angegebenen Wert übereinstimmen.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt. Sie können die Bedingungs- oder Wertfelder nicht aktualisieren. Um die Bedingungen zu aktualisieren, müssen Sie die Produktpartition löschen und eine neue hinzufügen.
Löschen: Schreibgeschützt

Status

Der Status der Auflistungsgruppe der Ressourcengruppe.

Mögliche Werte sind Aktiv, Gelöscht.

Hinzufügen: Wahlfrei.
Aktualisieren: Wahlfrei. 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.

Untertyp

Der Typ der Ressourcengruppenauflistungsgruppe.

Mögliche Werte sind Unterteilung und Einheit.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt