Package google.shopping.merchant.conversions.v1beta

Index

ConversionSourcesService

Dienst zum Verwalten von Conversion-Quellen für ein Händlerkonto.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Erstellt eine neue Conversion-Quelle.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

Eine vorhandene Conversion-Quelle wird archiviert. Wenn es sich bei der Conversion-Quelle um eine Merchant Center-Zielvorhaben handelt, kann sie 30 Tage lang wiederhergestellt werden. Wenn es sich bei der Conversion-Quelle um eine Google Analytics-Verknüpfung handelt, wird sie sofort gelöscht und kann durch Erstellen einer neuen wiederhergestellt werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

Eine Conversion-Quelle wird abgerufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

Ruft die Liste der Conversion-Quellen ab, auf die der Aufrufer Zugriff hat.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

Eine archivierte Conversion-Quelle wird wieder aktiviert. Nur für Merchant Center-Ziel-Conversion-Quellen verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Aktualisiert Informationen zu einer vorhandenen Conversion-Quelle. Nur für Merchant Center-Ziel-Conversion-Quellen verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

AttributionSettings

Stellt Attributionseinstellungen für Conversion-Quellen dar, die Daten vor der Attribution erhalten.

Felder
attribution_lookback_window_days

int32

Erforderlich. Lookback-Window (in Tagen), das für die Attribution in dieser Quelle verwendet wird. Unterstützte Werte sind 7, 30 und 40.

attribution_model

AttributionModel

conversion_type[]

ConversionType

Nicht veränderbar. Unsortierte Liste. Liste der verschiedenen Conversion-Typen, als die ein Conversion-Ereignis klassifiziert werden kann. Wenn diese Liste beim Erstellen leer ist, wird automatisch der Standardtyp „purchase“ erstellt.

AttributionModel

Das für diese Quelle verwendete Attributionsmodell. Wir unterstützen dieselben Modelle wie in Google Analytics 4, wie unter https://support.google.com/analytics/answer/10596866 beschrieben.

Enums
ATTRIBUTION_MODEL_UNSPECIFIED Nicht angegebenes Modell.
CROSS_CHANNEL_LAST_CLICK Modell „Letzter Klick“ (channelübergreifend)
ADS_PREFERRED_LAST_CLICK Modell „Letzter Google Ads-Klick bevorzugt“
CROSS_CHANNEL_DATA_DRIVEN Datengetriebenes Modell (channelübergreifend)
CROSS_CHANNEL_FIRST_CLICK Modell „Erster Klick“ (channelübergreifend)
CROSS_CHANNEL_LINEAR Lineares Modell (channelübergreifend)
CROSS_CHANNEL_POSITION_BASED Positionsbasiertes Modell (channelübergreifend)
CROSS_CHANNEL_TIME_DECAY Modell „Zeitverlauf“ (channelübergreifend)

ConversionType

Nachricht, die einen Conversion-Ereignistyp darstellt

Felder
name

string

Nur Ausgabe. Der Name des Conversion-Ereignisses, wie er vom Kunden gemeldet wird.

report

bool

Nur Ausgabe. Hier können Sie angeben, ob der Typ in Merchant Center-Berichten enthalten sein soll.

ConversionSource

Stellt eine Conversion-Quelle dar, die zu einem Händlerkonto gehört. Ein Händlerkonto kann bis zu 200 Conversion-Quellen haben.

Felder
name

string

Nur Ausgabe. Kennung. Wird von der Content API beim Erstellen einer neuen ConversionSource generiert. Format: [a-z]{4}:.+ Die vier Zeichen vor dem Doppelpunkt geben den Conversion-Quelltyp an. Der Inhalt nach dem Doppelpunkt ist die ID der Conversion-Quelle dieses Typs. Die ID zweier verschiedener Conversion-Quellen kann für verschiedene Typen identisch sein. Die folgenden Präfixe für den Typ werden unterstützt: - galk: Für GoogleAnalyticsLink-Quellen. – mcdn: Für MerchantCenterDestination-Quellen.

state

State

Nur Ausgabe. Der aktuelle Status dieser Conversion-Quelle. Kann nicht über die API bearbeitet werden.

expire_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, an dem eine archivierte Conversion-Quelle endgültig gelöscht wird und nicht mehr wiederhergestellt werden kann.

controller

Controller

Nur Ausgabe. Der Datenverantwortliche der Conversion-Quelle.

Union-Feld source_data. Erforderlich. Conversion-Quellendaten, die für jeden Quelltyp spezifisch sind. Für source_data ist nur einer der folgenden Werte zulässig:
merchant_center_destination

MerchantCenterDestination

Conversion-Quelle vom Typ „Merchant Center-Tag-Ziel“

Controller

Entität, die die Conversion-Quelle steuert.

Enums
CONTROLLER_UNSPECIFIED Standardwert Dieser Wert wird nicht verwendet.
MERCHANT Wird vom Händler gesteuert, dem die Conversion-Quelle gehört.
YOUTUBE_AFFILIATES Wird vom YT-Affiliate-Programm verwaltet.

Status

Gibt den Status der Conversion-Quelle an.

Enums
STATE_UNSPECIFIED Der Status der Conversion-Quelle ist nicht angegeben.
ACTIVE Die Conversion-Quelle ist voll funktionsfähig.
ARCHIVED Die Conversion-Quelle wurde in den letzten 30 Tagen archiviert und ist derzeit nicht funktionsfähig. Kann mit der Undo-Methode wiederhergestellt werden.
PENDING Die Erstellung der Conversion-Quelle wurde gestartet, ist aber noch nicht abgeschlossen.

CreateConversionSourceRequest

Anfragenachricht für die Methode „CreateConversionSource“.

Felder
parent

string

Erforderlich. Das Händlerkonto, dem die neue Conversion-Quelle zugewiesen werden soll. Format: accounts/{account}

conversion_source

ConversionSource

Erforderlich. Die Beschreibung der Conversion-Quelle. Beim Erstellen wird ihm automatisch eine neue ID zugewiesen.

DeleteConversionSourceRequest

Anfragenachricht für die Methode „DeleteConversionSource“.

Felder
name

string

Erforderlich. Der Name der zu löschenden Conversion-Quelle. Format: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

Anfragenachricht für die Methode „GetConversionSource“.

Felder
name

string

Erforderlich. Der Name der abzurufenden Conversion-Quelle. Format: accounts/{account}/conversionSources/{conversion_source}

ListConversionSourcesRequest

Anfragenachricht für die Methode „ListConversionSources“

Felder
parent

string

Erforderlich. Das Händlerkonto, zu dem die Conversion-Quellen gehören. Format: accounts/{account}

page_size

int32

Optional. Die maximale Anzahl von Conversion-Quellen, die auf einer Seite zurückgegeben werden sollen. Wenn kein page_size angegeben ist, wird 100 als Standardwert verwendet. Der Maximalwert ist 200. Werte über 200 werden auf 200 festgelegt. Unabhängig von der Paginierung werden insgesamt maximal 200 Conversion-Quellen zurückgegeben.

page_token

string

Optional. Seitentoken

show_deleted

bool

Optional. Option „Gelöschte (archivierte) Elemente anzeigen“

ListConversionSourcesResponse

Antwortnachricht für die Methode „ListConversionSources“.

Felder
conversion_sources[]

ConversionSource

Liste der Conversion-Quellen.

next_page_token

string

Token, mit dem die nächste Ergebnisseite abgerufen wird.

MerchantCenterDestination

Mit Quellen vom Typ „Merchant Center-Ziel“ können Conversion-Ereignisse über ein Google-Tag direkt von einem Onlineshop an ein Merchant Center-Konto gesendet werden, in dem die Quelle erstellt wird.

Felder
destination

string

Nur Ausgabe. Merchant Center-Ziel-ID.

attribution_settings

AttributionSettings

Erforderlich. Attributionseinstellungen, die für das Merchant Center-Ziel verwendet werden.

display_name

string

Erforderlich. Vom Händler angegebener Anzeigename für das Ziel. Mit diesem Namen wird die Conversion-Quelle in der Merchant Center-Benutzeroberfläche identifiziert. Ist auf 64 Zeichen beschränkt.

currency_code

string

Erforderlich. Dreistelliger Währungscode (ISO 4217). Mit dem Währungscode wird festgelegt, in welcher Währung die an dieses Ziel gesendeten Conversions im Merchant Center erfasst werden.

UndeleteConversionSourceRequest

Anfragenachricht für die Methode „UndeleteConversionSource“.

Felder
name

string

Erforderlich. Der Name der Conversion-Quelle, deren Löschvorgang rückgängig gemacht werden soll. Format: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

Anfragenachricht für die Methode „UpdateConversionSource“.

Felder
conversion_source

ConversionSource

Erforderlich. Die neue Version der Conversion-Quellendaten. Format: accounts/{account}/conversionSources/{conversion_source}

update_mask

FieldMask

Optional. Liste der aktualisierten Felder.