Verwaltung von CSS-Labels

Preisvergleichsportale können im Namen von Händlern in Ländern, in denen das Programm für Preisvergleichsportale verfügbar ist, Shopping-Anzeigen auf Google platzieren. Mit der Content API können Preisvergleichsportal-Domains und Preisvergleichsportal-Gruppen ihre verknüpften Konten mithilfe von Labels organisieren. Mit Preisvergleichsportal-Domains können die mit der Domain verknüpften Merchant Center-Konten aufgelistet, mit Labels versehen und gefiltert werden. Preisvergleichsportal-Gruppen können die mit der Gruppe verbundenen Preisvergleichsportal-Domains mit einem Label versehen und auflisten. Diese Content API-Dienste bieten programmatische Funktionen, die einigen der im Comparison Shopping Service Center verfügbaren Funktionen entsprechen.

Weitere Informationen zu Preisvergleichsportalen finden Sie unter Preisvergleichsportale. Informationen zum Arbeiten mit Labels im CSS Center finden Sie unter Kontolabels im Comparison Shopping Service Center verwenden.

Kontotypen für Preisvergleichsportale

Preisvergleichsportale verwenden die folgenden drei Arten von Konten:

  • Preisvergleichsportal-Gruppen sind die Konten der obersten Ebene, die eine oder mehrere Preisvergleichsportal-Domains enthalten können.
  • Preisvergleichsportal-Domains sind die Konten für die Preisvergleichsportale selbst, die Shopping-Anzeigen im Namen der Händler platzieren. Jede Preisvergleichsportal-Domain kann nur einer Preisvergleichsportal-Gruppe angehören.
  • Merchant Center-Konten sind die Händler, für die Preisvergleichsportal-Domains Shopping-Anzeigen platziert werden. Preisvergleichsportale können mit verschiedenen Arten von Merchant Center-Konten verknüpft werden, einschließlich Mehrfachkundenkonten (MCAs) und einzelnen Händlerkonten. Jedes Merchant Center-Konto kann nur mit einer Preisvergleichsportal-Domain verknüpft werden. Weitere Informationen zu den verschiedenen Arten von Merchant Center-Konten finden Sie unter Kontotypen im Comparison Shopping Service Center.

CSS-Labeltypen

Preisvergleichsportale verwenden zwei Arten von Labels:

  • Manuelle Labels werden Merchant Center-Konten durch Preisvergleichsportal-Domains erstellt und den Preisvergleichsportal-Domains durch Preisvergleichsportal-Gruppen zugewiesen.
  • Automatische Labels werden vom CSS Center automatisch erstellt und den Merchant Center-Konten zugewiesen. Automatische Labels sind für verschiedene Arten von Kontomesswerten verfügbar und helfen Ihnen, wichtige Konten und erhebliche Kontoaktivitäten zu identifizieren.

Weitere Informationen zu Labeltypen, einschließlich der verfügbaren automatischen Labels, finden Sie unter Kontolabels im Comparison Shopping Service Center verwenden.

Content API-Funktionen und Endpunkte für Preisvergleichsportale

Die Content API bietet die folgenden Endpunkte für Preisvergleichsportale:

Beachten Sie die folgenden Anforderungen, wenn Sie accounts-Endpunkte als CSS-Domain aufrufen:

  • Preisvergleichsportal-Domains müssen ihre cssId anstelle von merchantId angeben.
  • Preisvergleichsportal-Domains müssen den Suchparameter view=CSS angeben.
  • Preisvergleichsportal-Domains müssen die zugehörige Merchant Center-Konto-ID als accountId angeben.

Beispiel: Label erstellen

Mit der Methode accounts.labels.create können Sie ein neues Label erstellen. Labels können auf Preisvergleichsportal-Domains und Merchant Center-Konten angewendet werden. Labels für die verschiedenen Kontotypen sind jedoch unabhängig und können nicht synonym verwendet werden. Wenn Sie ein Label auf Domainebene erstellen möchten, das auf Merchant Center-Konten angewendet werden kann, die mit der Domain verknüpft sind, verwenden Sie beim Erstellen des Labels die Preisvergleichsportal-Domain-ID als accountId. Wenn Sie ein Label auf Gruppenebene erstellen möchten, das auf mit der Gruppe verknüpfte Preisvergleichsportal-Domains angewendet werden kann, verwenden Sie beim Erstellen des Labels die Preisvergleichsportal-Gruppen-ID als accountId.

Das folgende Beispiel zeigt, wie Sie ein Schlüsselkontolabel auf Domainebene erstellen, das dann auf mit der Domain verknüpfte Merchant Center-Konten angewendet werden kann. Um das Label zu erstellen, senden Sie eine POST-Anfrage mit der folgenden URL und dem folgenden Anfragetext:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels
{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

Beispiel: Label auf ein Merchant Center-Konto anwenden

Mit der Methode accounts.updatelabels können Sie einem Merchant Center-Konto, das mit einer Preisvergleichsportal-Domain verknüpft ist, Labels zuweisen. Das folgende Beispiel zeigt, wie Sie das im vorherigen Beispiel erstellte Label key-accounts auf eines Ihrer wichtigsten Merchant Center-Konten anwenden.

Um das Label anzuwenden, senden Sie eine POST-Anfrage mit der folgenden URL und dem folgenden Anfragetext:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
 "labelIds": [‘123’] // ‘key-accounts’
}

Beispiel: Merchant Center-Konten mithilfe von Labels filtern

Nachdem Sie Labels für die Merchant Center-Konten erstellt und angewendet haben, die mit einer Preisvergleichsportal-Domain verknüpft sind, können Sie die Methode accounts.list verwenden und den Label-Suchparameter in Ihrer Anfrage übergeben, um nur die Konten mit diesem Label zurückzugeben. Im folgenden Beispiel wird gezeigt, wie die mit einer Preisvergleichsportal-Domain verknüpften Merchant Center-Konten gefiltert werden. Dazu wird id (123) des Labels key-accounts verwendet, das im Beispiel Label erstellen erstellt wurde. Um die Konten abzurufen, stellen Sie eine GET-Anfrage mit der folgenden URL:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

Es ist kein Anfragetext erforderlich.

Beispiel: Label auf eine Preisvergleichsportal-Domain anwenden

Sie können auch die Methode csses.updatelabels verwenden, um Labels einer Preisvergleichsportal-Domain zuzuweisen, die mit einer Preisvergleichsportal-Gruppe verknüpft ist. Im folgenden Beispiel wird gezeigt, wie Sie ein Label auf Gruppenebene key-domains, das mit der Methode accounts.labels.create erstellt wurde, auf eines Ihrer wichtigsten Preisvergleichsportal-Domainkonten anwenden. Beachten Sie, dass Labels für Preisvergleichsportal-Domains und Merchant Center-Konten separat sind. Labels auf Gruppenebene müssen mit einer Preisvergleichsportal-Gruppen-ID als accountId erstellt werden.

Um das Label anzuwenden, senden Sie eine POST-Anfrage mit der folgenden URL und dem folgenden Anfragetext:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
 "labelIds": [‘456’] // ‘key-domains’
}