Package google.shopping.merchant.conversions.v1beta

इंडेक्स

ConversionSourcesService

व्यापारी/कंपनी/कारोबारी के खाते के लिए, कन्वर्ज़न सोर्स मैनेज करने की सेवा.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

नया कन्वर्ज़न सोर्स बनाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

किसी मौजूदा कन्वर्ज़न सोर्स को संग्रहित करता है. अगर कन्वर्ज़न का सोर्स Merchant Center डेस्टिनेशन है, तो उसे 30 दिनों के अंदर वापस लाया जा सकता है. अगर कन्वर्ज़न का सोर्स Google Analytics लिंक है, तो उसे तुरंत मिटा दिया जाएगा. हालांकि, नया लिंक बनाकर उसे वापस लाया जा सकता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

कन्वर्ज़न का सोर्स फ़ेच करता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

कन्वर्ज़न के उन सोर्स की सूची दिखाता है जिनका ऐक्सेस कॉल करने वाले के पास है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

संग्रहित किए गए कन्वर्ज़न सोर्स को फिर से चालू करता है. यह सिर्फ़ Merchant Center के डेस्टिनेशन कन्वर्ज़न सोर्स के लिए उपलब्ध है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

किसी मौजूदा कन्वर्ज़न सोर्स की जानकारी अपडेट करता है. यह सिर्फ़ Merchant Center के डेस्टिनेशन कन्वर्ज़न सोर्स के लिए उपलब्ध है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

AttributionSettings

यह, उन कन्वर्ज़न सोर्स के लिए एट्रिब्यूशन सेटिंग दिखाता है जिन्हें एट्रिब्यूशन से पहले का डेटा मिल रहा है.

फ़ील्ड
attribution_lookback_window_days

int32

ज़रूरी है. इस सोर्स में एट्रिब्यूशन के लिए इस्तेमाल की गई लुकबैक विंडो (दिनों में). इन वैल्यू का इस्तेमाल किया जा सकता है: 7, 30, 40.
attribution_model

AttributionModel

ज़रूरी है. एट्रिब्यूशन मॉडल.
conversion_type[]

ConversionType

इम्यूटेबल. बिना क्रम वाली सूची. कन्वर्ज़न इवेंट को अलग-अलग कन्वर्ज़न टाइप में बांटा जा सकता है. इस सूची में उन सभी टाइप के बारे में बताया गया है. अगर कैंपेन बनाते समय यह सूची खाली है, तो स्टैंडर्ड "परचेज़" टाइप अपने-आप बन जाएगा.

AttributionModel

इस सोर्स के लिए इस्तेमाल किया गया एट्रिब्यूशन मॉडल. हम Google Analytics 4 के मॉडल के उसी सेट का इस्तेमाल करते हैं जिसके बारे में यहां बताया गया है: https://support.google.com/analytics/answer/10596866.

Enums
ATTRIBUTION_MODEL_UNSPECIFIED मॉडल की जानकारी नहीं दी गई है.
CROSS_CHANNEL_LAST_CLICK क्रॉस-चैनल लास्ट क्लिक मॉडल.
ADS_PREFERRED_LAST_CLICK Google Ads की प्राथमिकता वाला लास्ट क्लिक मॉडल.
CROSS_CHANNEL_DATA_DRIVEN क्रॉस-चैनल डेटा-ड्रिवन मॉडल.
CROSS_CHANNEL_FIRST_CLICK क्रॉस-चैनल फ़र्स्ट क्लिक मॉडल.
CROSS_CHANNEL_LINEAR क्रॉस-चैनल लीनियर मॉडल.
CROSS_CHANNEL_POSITION_BASED क्रॉस-चैनल की रैंक पर आधारित मॉडल.
CROSS_CHANNEL_TIME_DECAY क्रॉस-चैनल टाइम डेक मॉडल.

ConversionType

कन्वर्ज़न इवेंट के टाइप दिखाने वाला मैसेज

फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. कन्वर्ज़न इवेंट का नाम, जैसा कि क्लाइंट रिपोर्ट करेगा.
report

bool

सिर्फ़ आउटपुट के लिए. यह विकल्प बताता है कि इस टाइप को Merchant Center की रिपोर्टिंग में शामिल किया जाना चाहिए या नहीं.

ConversionSource

किसी व्यापारी/कंपनी/कारोबारी के खाते के मालिकाना हक वाले कन्वर्ज़न सोर्स को दिखाता है. किसी व्यापारी/कंपनी/कारोबारी के खाते में ज़्यादा से ज़्यादा 200 कन्वर्ज़न सोर्स हो सकते हैं.

फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. नया ConversionSource बनाने पर, Content API से जनरेट होता है. फ़ॉर्मैट: [a-z]{4}:.+ कोलन से पहले के चार वर्ण, कन्वर्ज़न सोर्स के टाइप को दिखाते हैं. कोलन के बाद मौजूद कॉन्टेंट, उस टाइप के कन्वर्ज़न सोर्स का आईडी दिखाता है. अलग-अलग तरह के दो कन्वर्ज़न सोर्स का आईडी एक जैसा हो सकता है. इन प्रीफ़िक्स का इस्तेमाल किया जा सकता है: - galk: GoogleAnalyticsLink सोर्स के लिए. - mcdn: MerchantCenterDestination सोर्स के लिए.
state

State

सिर्फ़ आउटपुट के लिए. इस कन्वर्ज़न सोर्स की मौजूदा स्थिति. एपीआई की मदद से इसमें बदलाव नहीं किया जा सकता.
expire_time

Timestamp

सिर्फ़ आउटपुट के लिए. वह समय जब संग्रहित किया गया कन्वर्ज़न सोर्स हमेशा के लिए मिट जाता है और उसे वापस नहीं लाया जा सकता.
controller

Controller

सिर्फ़ आउटपुट के लिए. कन्वर्ज़न के सोर्स को कंट्रोल करने वाला.
यूनियन फ़ील्ड source_data. ज़रूरी है. हर तरह के सोर्स के लिए कन्वर्ज़न सोर्स का डेटा. source_data इनमें से कोई एक हो सकता है:
merchant_center_destination

MerchantCenterDestination

"Merchant Center टैग डेस्टिनेशन" टाइप का कन्वर्ज़न सोर्स.

गेम कंट्रोलर

कन्वर्ज़न के सोर्स को कंट्रोल करने वाली इकाई.

Enums
CONTROLLER_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया जाता.
MERCHANT कन्वर्ज़न सोर्स का मालिकाना हक रखने वाले व्यापारी/कंपनी/कारोबारी के कंट्रोल में होता है.
YOUTUBE_AFFILIATES इसे YT Affiliates प्रोग्राम कंट्रोल करता है.

स्थिति

कन्वर्ज़न सोर्स की स्थिति दिखाता है.

Enums
STATE_UNSPECIFIED कन्वर्ज़न सोर्स की स्थिति की जानकारी नहीं दी गई है.
ACTIVE कन्वर्ज़न का सोर्स पूरी तरह से काम कर रहा हो.
ARCHIVED कन्वर्ज़न सोर्स को पिछले 30 दिनों में संग्रहित किया गया है और फ़िलहाल यह काम नहीं कर रहा है. मिटाए गए ईमेल को वापस लाने के तरीके का इस्तेमाल करके, उसे वापस लाया जा सकता है.
PENDING कन्वर्ज़न सोर्स बनाने की प्रोसेस शुरू हो गई है, लेकिन यह पूरी नहीं हुई है.

CreateConversionSourceRequest

CreateConversionSource तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. वह व्यापारी खाता जिसके पास नए कन्वर्ज़न सोर्स का मालिकाना हक होगा. फ़ॉर्मैट: accounts/{account}
conversion_source

ConversionSource

ज़रूरी है. कन्वर्ज़न के सोर्स की जानकारी. खाता बनाने के बाद, उसे अपने-आप एक नया आईडी असाइन हो जाएगा.

DeleteConversionSourceRequest

DeleteConversionSource तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
name

string

ज़रूरी है. कन्वर्ज़न के उस सोर्स का नाम जिसे मिटाना है. फ़ॉर्मैट: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

GetConversionSource तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
name

string

ज़रूरी है. फ़ेच किए जाने वाले कन्वर्ज़न सोर्स का नाम. फ़ॉर्मैट: accounts/{account}/conversionSources/{conversion_source}

ListConversionSourcesRequest

ListConversionSources तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
parent

string

ज़रूरी है. वह व्यापारी/कंपनी जिसका कन्वर्ज़न सोर्स का कलेक्शन है. फ़ॉर्मैट: accounts/{account}
page_size

int32

ज़रूरी नहीं. किसी पेज में दिखाए जाने वाले कन्वर्ज़न सोर्स की ज़्यादा से ज़्यादा संख्या. अगर कोई page_size नहीं दिया गया है, तो डिफ़ॉल्ट वैल्यू के तौर पर 100 का इस्तेमाल किया जाता है. ज़्यादा से ज़्यादा 200 हो सकती है. 200 से ज़्यादा की वैल्यू को 200 पर सेट कर दिया जाएगा. पेजेशन के बावजूद, कुल 200 कन्वर्ज़न सोर्स दिखाए जाते हैं.
page_token

string

ज़रूरी नहीं. पेज टोकन.
show_deleted

bool

ज़रूरी नहीं. मिटाए गए (संग्रहित) विकल्प दिखाएं.

ListConversionSourcesResponse

ListConversionSources तरीके के लिए रिस्पॉन्स मैसेज.

फ़ील्ड
conversion_sources[]

ConversionSource

कन्वर्ज़न के सोर्स की सूची.
next_page_token

string

नतीजों के अगले पेज को फ़ेच करने के लिए इस्तेमाल किया जाने वाला टोकन.

MerchantCenterDestination

"Merchant Center डेस्टिनेशन" सोर्स का इस्तेमाल, Google टैग का इस्तेमाल करके किसी ऑनलाइन स्टोर से कन्वर्ज़न इवेंट भेजने के लिए किया जा सकता है. इवेंट को सीधे उस Merchant Center खाते में भेजा जाता है जहां सोर्स बनाया गया है.

फ़ील्ड
destination

string

सिर्फ़ आउटपुट के लिए. Merchant Center का डेस्टिनेशन आईडी.
attribution_settings

AttributionSettings

ज़रूरी है. Merchant Center डेस्टिनेशन के लिए इस्तेमाल की जा रही एट्रिब्यूशन सेटिंग.
display_name

string

ज़रूरी है. डेस्टिनेशन के लिए, व्यापारी/कंपनी/कारोबारी का तय किया गया डिसप्ले नेम. इस नाम से, Merchant Center के यूज़र इंटरफ़ेस (यूआई) में कन्वर्ज़न के सोर्स की पहचान की जाती है. इसमें 64 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते.
currency_code

string

ज़रूरी है. तीन अक्षर वाला मुद्रा कोड (ISO 4217). मुद्रा कोड से यह तय होता है कि इस डेस्टिनेशन पर भेजे गए कन्वर्ज़न, Merchant Center में किस मुद्रा में रिपोर्ट किए जाएंगे.

UndeleteConversionSourceRequest

UndeleteConversionSource तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
name

string

ज़रूरी है. उस कन्वर्ज़न सोर्स का नाम जिसे मिटाया नहीं जाना है. फ़ॉर्मैट: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

UpdateConversionSource तरीके के लिए अनुरोध मैसेज.

फ़ील्ड
conversion_source

ConversionSource

ज़रूरी है. कन्वर्ज़न सोर्स डेटा का नया वर्शन. फ़ॉर्मैट: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

ज़रूरी नहीं. अपडेट किए जा रहे फ़ील्ड की सूची.