Package google.shopping.merchant.conversions.v1beta

Indice

ConversionSourcesService

Servizio per la gestione delle origini conversione per un account commerciante.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Crea una nuova origine conversione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

Archivia un'origine conversione esistente. Se l'origine conversione è una destinazione Merchant Center, sarà recuperabile per 30 giorni. Se l'origine conversione è un collegamento a Google Analytics, verrà eliminata immediatamente e potrà essere ripristinata creandone uno nuovo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

Recupera un'origine conversione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

Riattiva un'origine conversione archiviata. Disponibile solo per le origini conversione di destinazione Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Aggiorna le informazioni di un'origine conversione esistente. Disponibile solo per le origini conversione Destinazione di Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

AttributionSettings

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

Campi
attribution_lookback_window_days

int32

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

AttributionModel

Obbligatoria. Modello di attribuzione.
conversion_type[]

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

Campi
name

string

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

bool

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

ConversionSource

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

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

State

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

Timestamp

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

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

MerchantCenterDestination

Origine conversione di tipo "Destinazione tag Merchant Center".

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.

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.

CreateConversionSourceRequest

Messaggio di richiesta per il metodo CreateConversionSource.

Campi
parent

string

Obbligatoria. L'account commerciante proprietario della nuova origine conversione. Formato: accounts/{account}
conversion_source

ConversionSource

Obbligatoria. La descrizione dell'origine conversione. Le verrà assegnato automaticamente un nuovo ID al momento della creazione.

DeleteConversionSourceRequest

Messaggio di richiesta per il metodo DeleteConversionSource.

Campi
name

string

Obbligatoria. Il nome dell'origine conversione da eliminare. Formato: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

Messaggio di richiesta per il metodo GetConversionSource.

Campi
name

string

Obbligatoria. Il nome dell'origine conversione da recuperare. Formato: accounts/{account}/conversionsources/{conversion_source}

ListConversionSourcesRequest

Messaggio di richiesta per il metodo ListConversionSources.

Campi
parent

string

Obbligatoria. L'account commerciante proprietario della raccolta delle origini conversione. Formato: accounts/{account}
page_size

int32

Campo facoltativo. Il numero massimo di origini conversione da restituire in una pagina. Se page_size non viene specificato, viene utilizzato 100 come valore predefinito. Il valore massimo è 200. I valori superiori a 200 verranno forzati a 200. A prescindere dall'impaginazione, vengono restituite al massimo 200 origini conversione in totale.
page_token

string

Campo facoltativo. Token pagina.
show_deleted

bool

Campo facoltativo. Mostra opzione eliminata (archiviata).

ListConversionSourcesResponse

Messaggio di risposta per il metodo ListConversionSources.

Campi
conversion_sources[]

ConversionSource

Elenco delle origini conversione.
next_page_token

string

Token da utilizzare per recuperare la pagina dei risultati successiva.

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.

Campi
destination

string

Solo output. ID destinazione Merchant Center.
attribution_settings

AttributionSettings

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

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

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.

UndeleteConversionSourceRequest

Messaggio di richiesta per il metodo UndeleteConversionSource.

Campi
name

string

Obbligatoria. Il nome dell'origine conversione di cui annullare l'eliminazione. Formato: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

Messaggio di richiesta per il metodo UpdateConversionSource.

Campi
conversion_source

ConversionSource

Obbligatoria. La nuova versione dei dati dell'origine conversione. Formato: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

Obbligatoria. Elenco dei campi in fase di aggiornamento.