Package google.shopping.merchant.conversions.v1beta

Indice

ConversionSourcesService

Servizio per la gestione delle sorgenti di conversione per un account commerciante.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Crea una nuova sorgente di conversione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la 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 una nuova.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la 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 Panoramica di OAuth 2.0.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

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

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la 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 di destinazione di Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

AttributionSettings

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

Campi
attribution_lookback_window_days

int32

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

AttributionModel

Obbligatorio. Modello di attribuzione.
conversion_type[]

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 di "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 cross-channel.
CROSS_CHANNEL_FIRST_CLICK Modello primo clic cross-channel.
CROSS_CHANNEL_LINEAR Modello lineare in più canali.
CROSS_CHANNEL_POSITION_BASED Modello cross-channel In base alla posizione.
CROSS_CHANNEL_TIME_DECAY Modello decadimento temporale in più canali.

ConversionType

Messaggio che rappresenta un tipo di eventi di conversione

Campi
name

string

Solo output. Nome dell'evento di conversione, così 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. 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 origine 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

State

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

Timestamp

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

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:
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 Controllato dal commerciante proprietario dell'origine conversione.
YOUTUBE_AFFILIATES Controllata dal programma YouTube Affiliates.

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.

CreateConversionSourceRequest

Messaggio di richiesta per il metodo CreateConversionSource.

Campi
parent

string

Obbligatorio. L'account commerciante che sarà proprietario della nuova sorgente di conversione. Formato: accounts/{account}
conversion_source

ConversionSource

Obbligatorio. La descrizione dell'origine conversione. Al momento della creazione, gli verrà assegnato automaticamente un nuovo ID.

DeleteConversionSourceRequest

Messaggio di richiesta per il metodo DeleteConversionSource.

Campi
name

string

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

GetConversionSourceRequest

Messaggio di richiesta per il metodo GetConversionSource.

Campi
name

string

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

ListConversionSourcesRequest

Messaggio di richiesta per il metodo ListConversionSources.

Campi
parent

string

Obbligatorio. L'account commerciante proprietario della raccolta delle sorgenti di conversione. Formato: accounts/{account}
page_size

int32

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

string

(Facoltativo) Token pagina.
show_deleted

bool

(Facoltativo) Mostra l'opzione Eliminate (archiviate).

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 gli eventi di conversione da un negozio online utilizzando un tag Google direttamente a un account Merchant Center in cui è stata creata l'origine.

Campi
destination

string

Solo output. ID destinazione Merchant Center.
attribution_settings

AttributionSettings

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

string

Obbligatorio. Nome visualizzato specificato dal commerciante per la destinazione. Questo è il nome che identifica l'origine conversione nella UI di Merchant Center. La lunghezza massima è 64 caratteri.
currency_code

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.

UndeleteConversionSourceRequest

Messaggio di richiesta per il metodo UndeleteConversionSource.

Campi
name

string

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

Obbligatorio. La nuova versione dei dati delle origini conversione. Formato: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

Obbligatorio. Elenco dei campi in fase di aggiornamento.