Package google.shopping.merchant.conversions.v1beta

Indeks

• ConversionSourcesService (antar muka)
• AttributionSettings (pesan)
• AttributionSettings.AttributionModel (enum)
• AttributionSettings.ConversionType (pesan)
• ConversionSource (pesan)
• ConversionSource.Controller (enum)
• ConversionSource.State (enum)
• CreateConversionSourceRequest (pesan)
• DeleteConversionSourceRequest (pesan)
• GetConversionSourceRequest (pesan)
• GoogleAnalyticsLink (pesan)
• ListConversionSourcesRequest (pesan)
• ListConversionSourcesResponse (pesan)
• MerchantCenterDestination (pesan)
• UndeleteConversionSourceRequest (pesan)
• UpdateConversionSourceRequest (pesan)

ConversionSourcesService

Layanan untuk mengelola sumber konversi untuk akun penjual.

CreateConversionSource
rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource) Membuat sumber konversi baru. Cakupan otorisasi Memerlukan cakupan OAuth berikut ini: https://www.googleapis.com/auth/content Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty) Mengarsipkan sumber konversi yang ada. Jika sumber konversi adalah Tujuan Merchant Center, sumber konversi tersebut dapat dipulihkan selama 30 hari. Jika sumber konversi adalah Link Google Analytics, sumber konversi tersebut akan segera dihapus dan dapat dipulihkan dengan membuat penautan baru. Cakupan otorisasi Memerlukan cakupan OAuth berikut ini: https://www.googleapis.com/auth/content Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

GetConversionSource
rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource) Mengambil sumber konversi. Cakupan otorisasi Memerlukan cakupan OAuth berikut ini: https://www.googleapis.com/auth/content Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ListConversionSources
rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse) Mengambil daftar sumber konversi yang dapat diakses pemanggil. Cakupan otorisasi Memerlukan cakupan OAuth berikut ini: https://www.googleapis.com/auth/content Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UndeleteConversionSource
rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource) Mengaktifkan kembali sumber konversi yang diarsipkan. Hanya Tersedia untuk sumber konversi Tujuan Merchant Center. Cakupan otorisasi Memerlukan cakupan OAuth berikut ini: https://www.googleapis.com/auth/content Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UpdateConversionSource
rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource) Memperbarui informasi sumber konversi yang ada. Hanya tersedia untuk sumber konversi Tujuan Merchant Center. Cakupan otorisasi Memerlukan cakupan OAuth berikut ini: https://www.googleapis.com/auth/content Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AttributionSettings

Mewakili setelan atribusi untuk sumber konversi yang menerima data pra-atribusi.

Kolom
attribution_lookback_window_days	int32 Wajib. Periode lihat balik (dalam hari) yang digunakan untuk atribusi di sumber ini. Nilai yang didukung adalah 7, 30, 40.
attribution_model	AttributionModel Wajib. Model atribusi.
conversion_type[]	ConversionType Tidak dapat diubah. Daftar yang tidak diurutkan. Daftar berbagai jenis konversi yang dapat diklasifikasikan sebagai peristiwa konversi. Jenis "pembelian" standar akan otomatis dibuat jika daftar ini kosong pada saat pembuatan.

AttributionModel

Model atribusi yang digunakan untuk sumber ini. Kami mendukung kumpulan model yang sama yang ditawarkan oleh Google Analytics 4, seperti yang dijelaskan di: https://support.google.com/analytics/answer/10596866.

Enum
ATTRIBUTION_MODEL_UNSPECIFIED	Model belum ditetapkan.
CROSS_CHANNEL_LAST_CLICK	Model Klik Terakhir Lintas-saluran.
ADS_PREFERRED_LAST_CLICK	Model Klik Terakhir ke Ads.
CROSS_CHANNEL_DATA_DRIVEN	Model Berbasis Data Lintas Saluran.
CROSS_CHANNEL_FIRST_CLICK	Model Klik Pertama Lintas-saluran.
CROSS_CHANNEL_LINEAR	Model Linear Lintas-saluran.
CROSS_CHANNEL_POSITION_BASED	Model Berbasis Posisi Lintas Saluran.
CROSS_CHANNEL_TIME_DECAY	Model Peluruhan Waktu Lintas Saluran.

ConversionType

Pesan yang merepresentasikan jenis peristiwa konversi

Kolom
name	string Hanya output. Nama peristiwa konversi, karena akan dilaporkan oleh klien.
report	bool Hanya output. Opsi yang menunjukkan apakah jenisnya harus disertakan dalam pelaporan Merchant Center.

ConversionSource

Mewakili sumber konversi yang dimiliki oleh akun Penjual. Akun penjual dapat memiliki hingga 200 sumber konversi.

Kolom
name	string Hanya output. Pengenal. Dibuat oleh Content API saat pembuatan ConversionSource baru. Format: [a-z]{4}:.+ Empat karakter sebelum tanda titik dua mewakili jenis sumber konversio. Konten setelah titik dua menunjukkan ID sumber konversi dalam jenis tersebut. ID dari dua sumber konversi yang berbeda mungkin sama di berbagai jenis. Jenis awalan berikut didukung: - galk: Untuk sumber GoogleAnalyticsLink. - mcdn: Untuk sumber MerchantCenterDestination.
state	State Hanya output. Status sumber konversi ini saat ini. Tidak dapat diedit melalui API.
expire_time	Timestamp Hanya output. Waktu saat sumber konversi yang diarsipkan dihapus secara permanen dan tidak lagi tersedia untuk dibatalkan penghapusannya.
controller	Controller Hanya output. Pengontrol sumber konversi.
Kolom union source_data. Wajib. Data sumber konversi khusus untuk setiap jenis sumber yang berbeda. source_data hanya ada berupa salah satu diantara berikut:
google_analytics_link	GoogleAnalyticsLink Tidak dapat diubah. Sumber Konversi jenis "Tautkan ke Properti Google Analytics".
merchant_center_destination	MerchantCenterDestination Sumber Konversi jenis "Tujuan Tag Merchant Center".

Pengontrol

Entitas yang mengontrol sumber konversi.

Enum
CONTROLLER_UNSPECIFIED	Nilai default. Nilai ini tidak digunakan.
MERCHANT	Dikontrol oleh Penjual yang memiliki Sumber Konversi.
YOUTUBE_AFFILIATES	Dikontrol oleh program Afiliasi YT.

Negara Bagian

Mewakili status sumber konversi.

Enum
STATE_UNSPECIFIED	Sumber konversi memiliki status yang belum ditentukan.
ACTIVE	Sumber konversi berfungsi sepenuhnya.
ARCHIVED	Sumber konversi telah diarsipkan dalam 30 hari terakhir dan saat ini tidak berfungsi. Dapat dipulihkan menggunakan metode pembatalan penghapusan.
PENDING	Pembuatan sumber konversi telah dimulai, tetapi belum selesai sepenuhnya.

CreateConversionSourceRequest

Pesan permintaan untuk metode CreateConversionSource.

Kolom
parent	string Wajib. Akun penjual yang akan memiliki sumber konversi baru. Format: accounts/{account}
conversion_source	ConversionSource Wajib. Deskripsi sumber konversi. ID baru akan ditetapkan secara otomatis ke ID tersebut saat pembuatan.

DeleteConversionSourceRequest

Pesan permintaan untuk metode DeleteConversionSource.

Kolom
name	string Wajib. Nama sumber konversi yang akan dihapus. Format: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

Pesan permintaan untuk metode GetConversionSource.

Kolom
name	string Wajib. Nama sumber konversi yang akan diambil. Format: accounts/{account}/conversionsources/{conversion_source}

GoogleAnalyticsLink

Sumber "Link Google Analytics" dapat digunakan untuk mendapatkan data konversi dari properti Google Analytics yang ada ke akun Merchant Center tertaut.

Kolom
property_id	int64 Wajib. Tidak dapat diubah. ID properti Google Analytics yang ditautkan oleh penjual.
attribution_settings	AttributionSettings Hanya output. Setelan atribusi untuk properti Google Analytics tertaut.
property	string Hanya output. Nama properti Google Analytics yang ditautkan oleh penjual.

ListConversionSourcesRequest

Pesan permintaan untuk metode ListConversionSources.

Kolom
parent	string Wajib. Akun penjual yang memiliki kumpulan sumber konversi. Format: accounts/{account}
page_size	int32 Opsional. Jumlah maksimum sumber konversi yang akan ditampilkan di halaman. Jika page_size tidak ditentukan, 100 akan digunakan sebagai nilai default. Nilai maksimum adalah 200. Nilai di atas 200 akan dikonversi menjadi 200. Terlepas dari penomoran halaman, maksimal 200 sumber konversi ditampilkan secara total.
page_token	string Opsional. Token halaman.
show_deleted	bool Opsional. Tampilkan opsi yang dihapus (diarsipkan).

ListConversionSourcesResponse

Pesan respons untuk metode ListConversionSources.

Kolom
conversion_sources[]	ConversionSource Daftar sumber konversi.
next_page_token	string Token yang akan digunakan untuk mengambil halaman hasil berikutnya.

MerchantCenterDestination

Sumber "Tujuan Merchant Center" dapat digunakan untuk mengirim peristiwa konversi dari toko online menggunakan tag Google langsung ke akun Merchant Center tempat sumber dibuat.

Kolom
destination	string Hanya output. ID Tujuan Merchant Center.
attribution_settings	AttributionSettings Wajib. Setelan atribusi yang digunakan untuk Tujuan Merchant Center.
display_name	string Wajib. Nama tampilan yang ditentukan penjual untuk tujuan. Nama ini adalah nama yang mengidentifikasi sumber konversi dalam UI Merchant Center. Dibatasi hingga 64 karakter.
currency_code	string Wajib. Kode mata uang tiga huruf (ISO 4217). Kode mata uang menentukan mata uang yang digunakan untuk melaporkan konversi yang dikirim ke tujuan ini di Merchant Center.

UndeleteConversionSourceRequest

Pesan permintaan untuk metode UndeleteConversionSource.

Kolom
name	string Wajib. Nama sumber konversi yang akan dibatalkan penghapusannya. Format: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

Pesan permintaan untuk metode UpdateConversionSource.

Kolom
conversion_source	ConversionSource Wajib. Versi baru data sumber konversi. Format: accounts/{account}/conversionSources/{conversion_source}
update_mask	FieldMask Wajib. Daftar kolom yang sedang diperbarui.