Package google.shopping.merchant.conversions.v1beta

Indeks

ConversionSourcesService

Layanan untuk mengelola sumber konversi bagi akun penjual.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Membuat sumber konversi baru.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • 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 Penautan Google Analytics, penautan tersebut akan segera dihapus dan dapat dipulihkan dengan membuat penautan baru.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

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

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

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Memperbarui informasi tentang sumber konversi yang ada. Hanya tersedia untuk sumber konversi Tujuan Merchant Center.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

AttributionSettings

Merepresentasikan 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 dalam 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 waktu 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 tidak ditentukan.
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 mewakili jenis peristiwa konversi

Kolom
name

string

Hanya output. Nama peristiwa konversi, seperti yang akan dilaporkan oleh klien.

report

bool

Hanya output. Opsi yang menunjukkan apakah jenis harus disertakan dalam pelaporan Merchant Center.

ConversionSource

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

Kolom
name

string

Hanya output. ID. Dibuat oleh Content API setelah pembuatan ConversionSource baru. Format: [a-z]{4}:.+ Empat karakter sebelum titik dua mewakili jenis sumber konversio. Konten setelah titik dua mewakili ID sumber konversi dalam jenis tersebut. ID dari dua sumber konversi yang berbeda mungkin sama di berbagai jenis. Awalan jenis 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 menjadi 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 yang spesifik untuk setiap jenis sumber yang berbeda. source_data hanya dapat berupa salah satu dari berikut:
merchant_center_destination

MerchantCenterDestination

Sumber Konversi dari 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

Menunjukkan status sumber konversi.

Enum
STATE_UNSPECIFIED Sumber konversi memiliki status yang tidak 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 otomatis ditetapkan saat dibuat.

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}

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 tidak ada page_size yang ditentukan, 100 akan digunakan sebagai nilai default. Nilai maksimumnya 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. Menampilkan 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. 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 akan 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 diperbarui.