REST Resource: accounts.conversionSources

Risorsa: ConversionSource

Rappresenta un'origine conversione di proprietà di un account commerciante. Un account commerciante può avere fino a 200 origini conversione.

Rappresentazione JSON
{
  "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.
}
Campi
name

string

Solo output. Identificatore. Generato dall'API Content al momento della creazione di un nuovo ConversionSource. Formato: [a-z]{4}:.+ I quattro caratteri prima dei due punti rappresentano il tipo di sorgente di conversione. I contenuti dopo i due punti rappresentano l'ID dell'origine conversione all'interno del tipo. L'ID di due origini conversione diverse potrebbe essere lo stesso per tipi diversi. Sono supportati i seguenti prefissi di tipo: - galk: per le origini GoogleAnalyticsLink. - mcdn: per le origini MerchantCenterDestination.

state

enum (State)

Solo output. Stato attuale di questa origine conversione. Non può essere modificato tramite l'API.

expireTime

string (Timestamp format)

Solo output. La data e l'ora in cui un'origine conversione archiviata viene eliminata definitivamente e non è più possibile annullare l'eliminazione.

controller

enum (Controller)

Solo output. Titolare dell'origine conversione.

Campo unione source_data. Obbligatorio. Dati sulle sorgenti di conversione specifici per ogni tipo di origine. source_data può essere solo uno dei seguenti:
merchantCenterDestination

object (MerchantCenterDestination)

Origine conversione di tipo "Destinazione tag Merchant Center".

AttributionSettings

Rappresenta le impostazioni di attribuzione per le sorgenti di conversione che ricevono dati pre-attribuzione.

Rappresentazione JSON
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Campi
attributionLookbackWindowDays

integer

Obbligatorio. Le finestre temporali (in giorni) utilizzate per l'attribuzione in questa origine. I valori supportati sono 7, 30, 40.

attributionModel

enum (AttributionModel)

Obbligatorio. Modello di attribuzione.

conversionType[]

object (ConversionType)

Immutabile. Elenco non ordinato. Elenco dei diversi tipi di conversione in cui può essere classificato un evento di conversione. Se questo elenco è vuoto al momento della creazione, verrà creato automaticamente un tipo "acquisto" standard.

AttributionModel

Il modello di attribuzione utilizzato per questa origine. Supportiamo lo stesso insieme di modelli offerti da Google Analytics 4, come descritto in https://support.google.com/analytics/answer/10596866.

Enum
ATTRIBUTION_MODEL_UNSPECIFIED Modello non specificato.
CROSS_CHANNEL_LAST_CLICK Modello Ultimo clic cross-channel.
ADS_PREFERRED_LAST_CLICK Modello Ultimo clic Google Ads preferito.
CROSS_CHANNEL_DATA_DRIVEN Modello basato sui dati in più canali.
CROSS_CHANNEL_FIRST_CLICK Modello primo clic cross-channel.
CROSS_CHANNEL_LINEAR Modello lineare cross-channel.
CROSS_CHANNEL_POSITION_BASED Modello In base alla posizione in più canali.
CROSS_CHANNEL_TIME_DECAY Modello di decadimento temporale in più canali.

ConversionType

Messaggio che rappresenta un tipo di eventi di conversione

Rappresentazione JSON
{
  "name": string,
  "report": boolean
}
Campi
name

string

Solo output. Il nome dell'evento di conversione, come verrà registrato dal client.

report

boolean

Solo output. Opzione che indica se il tipo deve essere incluso nei report di Merchant Center.

MerchantCenterDestination

Le origini "Destinazione Merchant Center" possono essere utilizzate per inviare gli eventi di conversione da un negozio online utilizzando un tag Google direttamente a un account Merchant Center in cui è stata creata l'origine.

Rappresentazione JSON
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
Campi
destination

string

Solo output. ID destinazione Merchant Center.

attributionSettings

object (AttributionSettings)

Obbligatorio. Impostazioni di attribuzione utilizzate per la destinazione Merchant Center.

displayName

string

Obbligatorio. Nome visualizzato specificato dal commerciante per la destinazione. Si tratta del nome che identifica l'origine conversione nell'interfaccia utente di Merchant Center. Sono consentiti massimo 64 caratteri.

currencyCode

string

Obbligatorio. Codice valuta di tre lettere (ISO 4217). Il codice valuta definisce la valuta in cui verranno registrate in Merchant Center le conversioni inviate a questa destinazione.

Stato

Rappresenta lo stato dell'origine conversione.

Enum
STATE_UNSPECIFIED L'origine conversione ha uno stato non specificato.
ACTIVE L'origine conversione è completamente funzionale.
ARCHIVED L'origine conversione è stata archiviata negli ultimi 30 giorni e non è attualmente funzionale. Può essere ripristinato utilizzando il metodo di annullamento dell'eliminazione.
PENDING La creazione dell'origine conversione è iniziata, ma non è ancora stata completata.

Controller

Entità che controlla l'origine conversione.

Enum
CONTROLLER_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
MERCHANT Controllato dal commerciante proprietario dell'origine conversione.
YOUTUBE_AFFILIATES Controllata dal programma di affiliazione di YT.

Metodi

create

Crea una nuova sorgente di conversione.

delete

Archivia un'origine conversione esistente.

get

Recupera un'origine conversione.

list

Recupera l'elenco delle origini conversione a cui ha accesso l'utente che chiama.

patch

Aggiorna le informazioni di un'origine conversione esistente.

undelete

Riattiva un'origine conversione archiviata.