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. Generati 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 origine della conversazione. Il contenuto dopo i due punti rappresenta l'ID dell'origine conversione all'interno di quel 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 sorgenti GoogleAnalyticsLink. - mcdn: per le origini Merchant CenterDestination.

state

enum (State)

Solo output. Stato attuale di questa origine conversione. Non possono essere modificate tramite l'API.

expireTime

string (Timestamp format)

Solo output. Il momento in cui un'origine conversione archiviata viene eliminata definitivamente e non è più disponibile per l'annullamento dell'eliminazione.

controller

enum (Controller)

Solo output. Titolare dell'origine conversione.

Campo di unione source_data. Obbligatoria. Dati dell'origine conversione specifici per ogni tipo diverso 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 origini conversione che ricevono dati pre-attribuzione.

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

integer

Obbligatoria. Finestre temporali (in giorni) utilizzate per l'attribuzione in questa sorgente. I valori supportati sono 7, 30, 40.

attributionModel

enum (AttributionModel)

Obbligatoria. Modello di attribuzione.

conversionType[]

object (ConversionType)

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

AttributionModel

Il modello di attribuzione utilizzato per questa sorgente. Supportiamo lo stesso insieme di modelli offerti da Google Analytics 4, come descritto all'indirizzo: 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 multicanale.
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 cross-channel.
CROSS_CHANNEL_TIME_DECAY modello Decadimento temporale cross-channel.

ConversionType

Messaggio che rappresenta un tipo di eventi di conversione

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

string

Solo output. Nome dell'evento di conversione, come verrà riportato dal cliente.

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 eventi di conversione da un negozio online utilizzando un tag Google direttamente a un account Merchant Center in cui viene 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)

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

displayName

string

Obbligatoria. Nome visualizzato specificato dal commerciante per la destinazione. Si tratta del nome che identifica l'origine conversione nell'interfaccia utente di Merchant Center. La lunghezza massima è 64 caratteri.

currencyCode

string

Obbligatoria. Codice valuta a tre lettere (ISO 4217). Il codice valuta definisce la valuta in cui verranno riportate 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 funzionante.
ARCHIVED L'origine conversione è stata archiviata negli ultimi 30 giorni e al momento non funziona. 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 È controllata dal commerciante proprietario dell'origine conversione.
YOUTUBE_AFFILIATES Controllata dal programma YT Affiliates.

Metodi

create

Crea una nuova origine conversione.

delete

Archivia un'origine conversione esistente.

get

Recupera un'origine conversione.

list

Recupera l'elenco delle origini conversione a cui ha accesso il chiamante.

patch

Aggiorna le informazioni di un'origine conversione esistente.

undelete

Riattiva un'origine conversione archiviata.