Package google.shopping.merchant.conversions.v1beta

Dizin

ConversionSourcesService

Satıcı hesabı için dönüşüm kaynaklarını yönetme hizmeti.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

Yeni bir dönüşüm kaynağı oluşturur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

Mevcut bir dönüşüm kaynağını arşivler. Dönüşüm kaynağı bir Merchant Center Hedefiyse 30 gün boyunca kurtarılabilir. Dönüşüm kaynağı bir Google Analytics bağlantısıysa hemen silinir ve yeni bir bağlantı oluşturularak geri yüklenebilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

Bir dönüşüm kaynağı getirir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

Arayanın erişebildiği dönüşüm kaynaklarının listesini alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

Arşivlenmiş bir dönüşüm kaynağını yeniden etkinleştirir. Yalnızca Merchant Center Hedefi dönüşüm kaynakları için kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Mevcut bir dönüşüm kaynağının bilgilerini günceller. Yalnızca Merchant Center Hedefi dönüşüm kaynakları için kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

AttributionSettings

İlişkilendirme öncesi verileri alan dönüşüm kaynaklarının ilişkilendirme ayarlarını temsil eder.

Alanlar
attribution_lookback_window_days

int32

Zorunlu. Bu kaynakta ilişkilendirme için kullanılan yeniden inceleme aralıkları (gün cinsinden). Desteklenen değerler: 7, 30, 40.
attribution_model

AttributionModel

Zorunlu. İlişkilendirme modeli.
conversion_type[]

ConversionType

Sabit. Sırasız liste. Bir dönüşüm etkinliğinin sınıflandırılabileceği farklı dönüşüm türlerinin listesi. Oluşturma sırasında bu liste boşsa standart bir "purchase" türü otomatik olarak oluşturulur.

AttributionModel

Bu kaynak için kullanılan ilişkilendirme modeli. Google Analytics 4 tarafından sunulan model grubunu, https://support.google.com/analytics/answer/10596866 adresinde açıklandığı şekilde destekliyoruz.

Sıralamalar
ATTRIBUTION_MODEL_UNSPECIFIED Belirtilmemiş model.
CROSS_CHANNEL_LAST_CLICK Kanallar arası Son Tıklama modeli.
ADS_PREFERRED_LAST_CLICK Ads tercihli Son Tıklama modeli.
CROSS_CHANNEL_DATA_DRIVEN Kanallar arası veriye dayalı model.
CROSS_CHANNEL_FIRST_CLICK Kanallar arası İlk Tıklama modeli.
CROSS_CHANNEL_LINEAR Kanallar arası doğrusal model.
CROSS_CHANNEL_POSITION_BASED Kanallar arası Konuma Dayalı model.
CROSS_CHANNEL_TIME_DECAY Kanallar arası Zamana Bağlı Azalma modeli.

ConversionType

Dönüşüm etkinliği türlerini temsil eden mesaj

Alanlar
name

string

Yalnızca çıkış. Müşteri tarafından raporlanacağı şekliyle dönüşüm etkinliğinin adı.
report

bool

Yalnızca çıkış. Türün Merchant Center raporlarına dahil edilip edilmeyeceğini belirten seçenek.

ConversionSource

Bir satıcı hesabına ait dönüşüm kaynağını temsil eder. Bir satıcı hesabında en fazla 200 dönüşüm kaynağı olabilir.

Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. Yeni bir ConversionSource oluşturulduktan sonra Content API tarafından oluşturulur. Biçim: [a-z]{4}:.+ İki nokta işaretinden önceki dört karakter, dönüşüm kaynağının türünü temsil eder. İki nokta işaretinden sonraki içerik, söz konusu türdeki dönüşüm kaynağının kimliğini temsil eder. İki farklı dönüşüm kaynağının kimliği, farklı türlerde aynı olabilir. Şu tür önekler desteklenir: - galk: GoogleAnalyticsLink kaynakları için. - mcdn: MerchantCenterDestination kaynakları için.
state

State

Yalnızca çıkış. Bu dönüşüm kaynağının mevcut durumu. API aracılığıyla düzenlenemez.
expire_time

Timestamp

Yalnızca çıkış. Arşivlenmiş bir dönüşüm kaynağının kalıcı olarak silindiği ve artık silme işlemi geri alınamayacağı zaman.
controller

Controller

Yalnızca çıkış. Dönüşüm kaynağının denetleyicisidir.
Birleştirme alanı source_data. Zorunlu. Farklı her bir kaynak türüne özgü dönüşüm kaynağı verileri. source_data şunlardan yalnızca biri olabilir:
merchant_center_destination

MerchantCenterDestination

"Merchant Center Etiket Hedefi" türündeki Dönüşüm Kaynağı.

Denetleyici

Dönüşüm kaynağını kontrol eden varlık.

Sıralamalar
CONTROLLER_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
MERCHANT Dönüşüm Kaynağının sahibi olan Satıcı tarafından kontrol edilir.
YOUTUBE_AFFILIATES YT Satış Ortakları programı tarafından kontrol edilmektedir.

Eyalet

Dönüşüm kaynağının durumunu gösterir.

Sıralamalar
STATE_UNSPECIFIED Dönüşüm kaynağının durumu belirtilmemiş.
ACTIVE Dönüşüm kaynağı tamamen işlevseldir.
ARCHIVED Dönüşüm kaynağı son 30 gün içinde arşivlenmiş ve şu anda çalışmıyor. Silme işlemini geri alma yöntemiyle geri yüklenebilir.
PENDING Dönüşüm kaynağı oluşturma işlemi başladı, ancak henüz tam olarak tamamlanmadı.

CreateConversionSourceRequest

CreateConversionSource yöntemi için istek mesajı.

Alanlar
parent

string

Zorunlu. Yeni dönüşüm kaynağının sahibi olacak satıcı hesabı. Biçim: accounts/{account}
conversion_source

ConversionSource

Zorunlu. Dönüşüm kaynağı açıklaması. Oluşturulduktan sonra otomatik olarak yeni bir kimlik atanır.

DeleteConversionSourceRequest

DeleteConversionSource yöntemi için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek dönüşüm kaynağının adı. Biçim: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

GetConversionSource yöntemi için mesaj isteyin.

Alanlar
name

string

Zorunlu. Getirilecek dönüşüm kaynağının adı. Biçim: accounts/{account}/conversionsources/{conversion_source}

ListConversionSourcesRequest

ListConversionSources yöntemi için mesaj isteyin.

Alanlar
parent

string

Zorunlu. Dönüşüm kaynakları koleksiyonunun sahibi olan satıcı hesabı. Biçim: accounts/{account}
page_size

int32

İsteğe bağlı. Bir sayfada döndürülecek maksimum dönüşüm kaynağı sayısı. page_size belirtilmezse varsayılan değer olarak 100 kullanılır. Maksimum değer 200 olmalıdır. 200 değerinin üzerindeki değerler 200 olmaya zorlanır. Sayfalara ayırmadan bağımsız olarak, toplamda en fazla 200 dönüşüm kaynağı döndürülür.
page_token

string

İsteğe bağlı. Sayfa jetonu.
show_deleted

bool

İsteğe bağlı. Silinen (arşivlenen) seçeneğini göster.

ListConversionSourcesResponse

ListConversionSources yöntemi için yanıt mesajı.

Alanlar
conversion_sources[]

ConversionSource

Dönüşüm kaynaklarının listesi.
next_page_token

string

Sonraki sonuç sayfasını getirmek için kullanılacak jeton.

MerchantCenterDestination

"Merchant Center Hedefi" kaynakları, Google etiketi kullanan bir online mağazadan dönüşüm etkinliklerini doğrudan kaynağın oluşturulduğu Merchant Center hesabına göndermek için kullanılabilir.

Alanlar
destination

string

Yalnızca çıkış. Merchant Center Hedef Kimliği.
attribution_settings

AttributionSettings

Zorunlu. Merchant Center Hedefi için kullanılan ilişkilendirme ayarları.
display_name

string

Zorunlu. Hedef için satıcı tarafından belirtilen görünen ad. Merchant Center kullanıcı arayüzünde dönüşüm kaynağını tanımlayan addır. 64 karakterle sınırlıdır.
currency_code

string

Zorunlu. Üç harfli para birimi kodu (ISO 4217). Para birimi kodu, bu hedefe gönderilen dönüşümlerin Merchant Center'da hangi para biriminde raporlanacağını tanımlar.

UndeleteConversionSourceRequest

UndeleteConversionSource yöntemi için mesaj isteyin.

Alanlar
name

string

Zorunlu. Silme işlemi geri alınacak dönüşüm kaynağının adı. Biçim: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

UpdateConversionSource yöntemi için istek mesajı.

Alanlar
conversion_source

ConversionSource

Zorunlu. Dönüşüm kaynağı verilerinin yeni sürümü. Biçim: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

Zorunlu. Güncellenen alanların listesi.