Package google.shopping.merchant.conversions.v1beta

Index

ConversionSourcesService

Dienst zur Verwaltung von Conversion-Quellen für ein Händlerkonto

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Eine neue Conversion-Quelle wird erstellt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

Eine vorhandene Conversion-Quelle wird archiviert. Wenn die Conversion-Quelle ein Merchant Center-Ziel ist, kann sie innerhalb von 30 Tagen wiederhergestellt werden. Wenn die Conversion-Quelle eine Google Analytics-Verknüpfung ist, wird sie sofort gelöscht und kann durch Erstellen einer neuen Verknüpfung wiederhergestellt werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

Ruft eine Conversion-Quelle ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
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 in der Übersicht über OAuth 2.0.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Hiermit werden Informationen zu einer Conversion-Quelle aktualisiert. Nur für Ziel-Conversion-Quellen im Merchant Center verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

AttributionSettings

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

Felder
attribution_lookback_window_days

int32

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

AttributionModel

Erforderlich. Attributionsmodell.
conversion_type[]

ConversionType

Nicht veränderbar. Unsortierte Liste. Eine Liste der verschiedenen Conversion-Typen, die ein Conversion-Ereignis klassifizieren kann. Wenn diese Liste zum Zeitpunkt der Erstellung leer ist, wird automatisch ein Standardkauftyp erstellt.

AttributionModel

Das für diese Quelle verwendete Attributionsmodell. Es werden dieselben Modelle unterstützt 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 Channelübergreifendes datengetriebenes Modell.
CROSS_CHANNEL_FIRST_CLICK Modell „Erster Klick“ (channelübergreifend)
CROSS_CHANNEL_LINEAR Modell „Linear (channelübergreifend)“.
CROSS_CHANNEL_POSITION_BASED Positionsbasiertes Modell (channelübergreifend)
CROSS_CHANNEL_TIME_DECAY Kanalübergreifendes Zeitverlaufsmodell

ConversionType

Nachricht für verschiedene Conversion-Ereignistypen

Felder
name

string

Nur Ausgabe. Name des Conversion-Ereignisses, wie er vom Kunden erfasst wird
report

bool

Nur Ausgabe. Option, die angibt, ob der Typ in Merchant Center-Berichte einbezogen werden 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 die Art der Konversationsquelle an. Der Inhalt nach dem Doppelpunkt steht für die ID der Conversion-Quelle innerhalb dieses Typs. Die ID von zwei verschiedenen Conversion-Quellen kann für verschiedene Typen identisch sein. Die folgenden Typpräfixe werden unterstützt: „- galk“: Für GoogleAnalyticsLink-Quellen. – mcdn: Für MerchantCenterDestination-Quellen.
state

State

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

Timestamp

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

Controller

Nur Ausgabe. Controller der Conversion-Quelle.
Union-Feld source_data. Erforderlich. Spezifische Conversion-Quellendaten für die einzelnen Arten von Quellen. 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 kontrolliert, dem die Conversion-Quelle gehört.
YOUTUBE_AFFILIATES Sie werden vom YT Affiliates-Programm verwaltet.

Status

Stellt den Status der Conversion-Quelle dar.

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 funktioniert derzeit nicht. Kann mit der Undelete-Methode wiederhergestellt werden.
PENDING Das Erstellen der Conversion-Quelle hat begonnen, ist aber noch nicht vollständig abgeschlossen.

CreateConversionSourceRequest

Anfragenachricht für die Methode CreateConversionSource.

Felder
parent

string

Erforderlich. Das Händlerkonto, zu dem die neue Conversion-Quelle gehört. Format: accounts/{account}
conversion_source

ConversionSource

Erforderlich. Die Beschreibung der Conversion-Quelle. Der neuen ID wird bei der Erstellung automatisch eine neue ID zugewiesen.

DeleteConversionSourceRequest

Anfragenachricht für die Methode DeleteConversionSource.

Felder
name

string

Erforderlich. Der Name der Conversion-Quelle, die gelöscht werden soll. Format: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

Anfragenachricht für die GetConversionSource-Methode.

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, dem die Sammlung von Conversion-Quellen gehört. 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 Höchstwert ist 200. Für Werte über 200 wird 200 erzwungen. Unabhängig von der Paginierung werden insgesamt maximal 200 Conversion-Quellen zurückgegeben.
page_token

string

Optional. Seitentoken
show_deleted

bool

Optional. Option für 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, das zum Abrufen der nächsten Ergebnisseite verwendet wird.

MerchantCenterDestination

„Merchant Center-Zielquellen“ können verwendet werden, um Conversion-Ereignisse von einem Onlineshop mithilfe eines Google-Tags direkt an ein Merchant Center-Konto zu senden, in dem die Quelle erstellt wurde.

Felder
destination

string

Nur Ausgabe. Merchant Center-Ziel-ID
attribution_settings

AttributionSettings

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

string

Erforderlich. Vom Händler angegebener Anzeigename für das Ziel. Dies ist der Name, über den die Conversion-Quelle in der Merchant Center-Benutzeroberfläche identifiziert wird. Er ist auf maximal 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, die wiederhergestellt 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-Quelldaten. Format: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

Erforderlich. Liste der Felder, die aktualisiert werden.