REST Resource: accounts.conversionSources

Ressource: ConversionSource

Stellt eine Conversion-Quelle dar, die 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 stehen für den Typ der Conversio-Quelle. Der Inhalt nach dem Doppelpunkt steht für die ID der Conversion-Quelle innerhalb dieses Typs. Die ID zweier verschiedener Conversion-Quellen kann bei verschiedenen Typen gleich 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. Sie können 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. Für die einzelnen Quellentypen spezifische Conversion-Quelldaten 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 Vor-Attributionsdaten 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: 7, 30 und 40.

attributionModel

enum (AttributionModel)

Erforderlich. Attributionsmodell.

conversionType[]

object (ConversionType)

Nicht veränderbar. Unsortierte Liste. Liste der verschiedenen Conversion-Typen, denen ein Conversion-Ereignis zugeordnet werden kann. Ein Standardkauf wird automatisch erstellt, wenn diese Liste zum Zeitpunkt der Erstellung leer ist.

AttributionModel

Das für diese Quelle verwendete Attributionsmodell. Wir unterstützen dieselben Modelle wie Google Analytics 4 (siehe https://support.google.com/analytics/answer/10596866).

Enums
ATTRIBUTION_MODEL_UNSPECIFIED Nicht angegebenes Modell.
CROSS_CHANNEL_LAST_CLICK „Letzter Klick (channelübergreifend)“.
ADS_PREFERRED_LAST_CLICK „Letzter Google Ads-Klick bevorzugt“ verwenden.
CROSS_CHANNEL_DATA_DRIVEN Channelübergreifendes datengetriebenes Modell.
CROSS_CHANNEL_FIRST_CLICK Modell „Erster Klick“ (channelübergreifend)
CROSS_CHANNEL_LINEAR „Linear (channelübergreifend)“.
CROSS_CHANNEL_POSITION_BASED Modell „Positionsbasiert“ (channelübergreifend)
CROSS_CHANNEL_TIME_DECAY Modell „Zeitverlauf (channelübergreifend)“.

ConversionType

Nachricht, die verschiedene Conversion-Ereignisse darstellt

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

string

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

report

boolean

Nur Ausgabe. Option, die angibt, ob der Typ in Merchant Center-Berichten enthalten sein soll.

MerchantCenterDestination

„Merchant Center-Ziel“ Quellen können verwendet werden, um Conversion-Ereignisse von einem Onlineshop über ein Google-Tag direkt an ein Merchant Center-Konto zu senden, 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. Der vom Händler angegebene Anzeigename für die Zielanwendung. Dies ist der Name, der die Conversion-Quelle in der Merchant Center-Benutzeroberfläche identifiziert. Beschränkt auf 64 Zeichen.

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

Der Status der Conversion-Quelle.

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 hat derzeit keine Funktion. Kann mithilfe der Wiederherstellungsmethode wiederhergestellt werden.
PENDING Die Erstellung der Conversion-Quelle hat begonnen, 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 verwaltet, dem die Conversion-Quelle gehört.
YOUTUBE_AFFILIATES Gesteuert durch das YouTube Affiliates-Programm.

Methoden

create

Erstellt eine neue Conversion-Quelle.

delete

Archiviert eine Conversion-Quelle.

get

Ruft eine Conversion-Quelle ab.

list

Ruft die Liste der Conversion-Quellen ab, auf die der Aufrufer zugreifen kann

patch

Aktualisiert die Informationen einer vorhandenen Conversion-Quelle.

undelete

Dadurch wird eine archivierte Conversion-Quelle wieder aktiviert.