REST Resource: accounts.conversionSources

Ressource: ConversionSource

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

JSON-Darstellung
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
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

enum (State)

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

expireTime

string (Timestamp format)

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

controller

enum (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:
merchantCenterDestination

object (MerchantCenterDestination)

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

AttributionSettings

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

JSON-Darstellung
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Felder
attributionLookbackWindowDays

integer

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

attributionModel

enum (AttributionModel)

Erforderlich. Attributionsmodell.

conversionType[]

object (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

JSON-Darstellung
{
  "name": string,
  "report": boolean
}
Felder
name

string

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

report

boolean

Nur Ausgabe. Option, die angibt, ob der Typ in Merchant Center-Berichte einbezogen werden soll.

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.

JSON-Darstellung
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
Felder
destination

string

Nur Ausgabe. Merchant Center-Ziel-ID

attributionSettings

object (AttributionSettings)

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

displayName

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.

currencyCode

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.

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.

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.

Methoden

create

Eine neue Conversion-Quelle wird erstellt.

delete

Eine vorhandene Conversion-Quelle wird archiviert.

get

Ruft eine Conversion-Quelle ab.

list

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

patch

Hiermit werden Informationen zu einer Conversion-Quelle aktualisiert.

undelete

Damit wird eine archivierte Conversion-Quelle wieder aktiviert.