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

enum (State)

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

string (Timestamp format)

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

enum (Controller)

Nur Ausgabe. Der Datenverantwortliche der Conversion-Quelle.
Union-Feld source_data. Erforderlich. Conversion-Quellendaten, die für jeden einzelnen Quellentyp spezifisch sind. Für source_data ist nur einer der folgenden Werte zulässig:
merchantCenterDestination

object (MerchantCenterDestination)

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

AttributionSettings

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

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

integer

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

enum (AttributionModel)

Erforderlich. Attributionsmodell.
conversionType[]

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

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

string

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

boolean

Nur Ausgabe. Gibt an, ob der Typ in Merchant Center-Berichte aufgenommen werden soll.

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.

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, die für das Merchant Center-Ziel verwendet werden.
displayName

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.
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

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.

Controller

Das Rechtssubjekt, das die Conversion-Quelle verwaltet.

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.

Methoden

create

 Erstellt eine neue Conversion-Quelle.

delete

 Eine vorhandene Conversion-Quelle wird archiviert.

get

 Eine Conversion-Quelle wird abgerufen.

list

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

patch

 Aktualisiert Informationen zu einer vorhandenen Conversion-Quelle.

undelete

 Eine archivierte Conversion-Quelle wird wieder aktiviert.