Package google.shopping.merchant.conversions.v1beta

Dizin

ConversionSourcesService

Satıcı hesabının dönüşüm kaynaklarını yönetmek için kullanılan hizmet.

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ı makaleyi inceleyin.
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şturarak 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ı makaleyi inceleyin.
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ı makaleyi inceleyin.
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ı makaleyi inceleyin.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

Arşivlenen bir dönüşüm kaynağını yeniden etkinleştirir. Yalnızca Merchant Center hedef 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ı makaleyi inceleyin.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

Mevcut bir dönüşüm kaynağının bilgilerini günceller. Yalnızca Merchant Center hedef 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ı makaleyi inceleyin.

AttributionSettings

İlişkilendirme öncesi veri alan dönüşüm kaynakları için 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'tır.
attribution_model

AttributionModel

Zorunlu. İlişkilendirme modeli.
conversion_type[]

ConversionType

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

AttributionModel

Bu kaynak için kullanılan ilişkilendirme modeli. https://support.google.com/analytics/answer/10596866 adresinde açıklandığı gibi, Google Analytics 4 tarafından sunulan modellerin aynısını 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ı ilk 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ış. İstemci tarafından bildirildiği ş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

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

Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. Yeni bir ConversionSource oluşturulduğunda Content API tarafından oluşturulur. Biçim: [a-z]{4}:.+ İki nokta üst üste 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. Aşağıdaki tür ön ekleri 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 üzerinden düzenlenemez.
expire_time

Timestamp

Yalnızca çıkış. Arşivlenen bir dönüşüm kaynağının kalıcı olarak silindiği ve artık silinmesi geri alınamayan zaman.
controller

Controller

Yalnızca çıkış. Dönüşüm kaynağının denetleyicisi.
Birlik alanı source_data. Zorunlu. Her farklı kaynak türüne özel dönüşüm kaynağı verileri. source_data yalnızca aşağıdakilerden biri olabilir:
merchant_center_destination

MerchantCenterDestination

"Merchant Center Etiketi Hedefi" türündeki dönüşüm kaynağı.

Denetleyici

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

Sıralamalar
CONTROLLER_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
MERCHANT Dönüşüm kaynağının sahibi olan satıcı tarafından kontrol edilir.
YOUTUBE_AFFILIATES YT Satış Ortağı Programı tarafından kontrol edilir.

Eyalet

Dönüşüm kaynağının durumunu temsil eder.

Sıralamalar
STATE_UNSPECIFIED Dönüşüm kaynağının durumu belirtilmemiş.
ACTIVE Dönüşüm kaynağı tamamen çalışır durumdadır.
ARCHIVED Dönüşüm kaynağı son 30 gün içinde arşivlendi ve şu anda kullanılamıyor. Silme işlemini geri alma yöntemi kullanılarak geri yüklenebilir.
PENDING Dönüşüm kaynağı oluşturma işlemi başladı ancak henüz 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 yeni bir kimlik otomatik olarak 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 istek mesajı.

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 istek mesajı.

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'tür. 200'ün üzerindeki değerler 200 olarak zorlanacaktır. Sayfalandı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österin.

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çlar sayfasını getirmek için kullanılacak jeton.

MerchantCenterDestination

"Merchant Center Hedefi" kaynakları, bir Google etiketi kullanılarak 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. Bu, 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 istek mesajı.

Alanlar
name

string

Zorunlu. Silme işleminin geri alınacağı 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

İsteğe bağlı. Güncellenen alanların listesi.