इस गाइड में, Campaign Manager 360 API Conversions
सेवा का इस्तेमाल करके कन्वर्ज़न में बदलाव करने के बारे में पूरी जानकारी दी गई है. जारी रखने से पहले, हमारा सुझाव है कि आप ऑफ़लाइन कन्वर्ज़न के बारे में जानकारी के लिए खास जानकारी की समीक्षा करें. साथ ही, इस गाइड में बताए गए कॉन्सेप्ट के बारे में जानें.
शुरू करने से पहले
इस एडिट वर्कफ़्लो की मदद से, मौजूदा ऑनलाइन और ऑफ़लाइन कन्वर्ज़न के quantity
और value
में बदलाव किया जा सकता है. ऐसा करने के लिए, आपको ऐसे मान देने होंगे जो खास तौर पर उन कन्वर्ज़न की पहचान करें जिनमें बदलाव करना है. बदलाव किए जा रहे कन्वर्ज़न के टाइप के आधार पर, आपको ये वैल्यू अलग-अलग तरीकों से मिलेंगी:
ऑनलाइन कन्वर्ज़न की पहचान करने के लिए, ज़रूरी वैल्यू डेटा ट्रांसफ़र से ली जा सकती हैं.
ऑफ़लाइन कन्वर्ज़न की पहचान करने के लिए ज़रूरी वैल्यू,
batchinsert
केConversionsBatchInsertResponse
अनुरोधों में मिलती हैं.
किसी भी तरह के कन्वर्ज़न में बदलाव करने के बाद, ConversionsBatchUpdateResponse
में बाद के बदलाव करने के लिए ज़रूरी वैल्यू शामिल होंगी.
कन्वर्ज़न के रिसॉर्स कॉन्फ़िगर करें
एडिट वर्कफ़्लो के पहले चरण में, एक या एक से ज़्यादा Conversion
रिसॉर्स ऑब्जेक्ट बनाए जाते हैं.
नीचे दिए गए फ़ील्ड का इस्तेमाल, कन्वर्ज़न की पहचान करने के लिए किया जाता है. ये फ़ील्ड ज़रूरी हैं और किसी मौजूदा कन्वर्ज़न से पूरी तरह मेल खाने चाहिए.
फ़ील्ड | जानकारी |
---|---|
|
एन्क्रिप्ट किया गया यूज़र आईडी, Google क्लिक आईडी, डिसप्ले क्लिक आईडी, मैच आईडी या मोबाइल डिवाइस आईडी, जिससे कन्वर्ज़न जनरेट हुआ. |
floodlightActivityId |
वह फ़्लडलाइट गतिविधि जिसमें कन्वर्ज़न को एट्रिब्यूट किया गया है. |
floodlightConfigurationId |
किसी गतिविधि में इस्तेमाल किया गया Floodlight कॉन्फ़िगरेशन. |
ordinal |
कन्वर्ज़न से जुड़ा डिडुप्लीकेटर आइडेंटिफ़ायर. |
timestampMicros |
Unix epoch के बाद से कन्वर्ज़न का टाइमस्टैंप, माइक्रोसेकंड में. |
बदलाव किए जा सकने वाले फ़ील्ड नीचे दिए गए हैं. ये फ़ील्ड ज़रूरी हैं और आपकी दी गई वैल्यू, बदले जा रहे कन्वर्ज़न की पहले से मौजूद वैल्यू को बदल देंगी.
फ़ील्ड | जानकारी |
---|---|
quantity |
कन्वर्ज़न से जुड़े आइटम की संख्या. |
value |
कन्वर्ज़न से जनरेट हुई आय. |
रेफ़रंस दस्तावेज़ में बताए गए अन्य सभी फ़ील्ड काम नहीं करते और उनमें बदलाव नहीं किया जा सकता. बदलाव करने के आपके अनुरोध में इस्तेमाल न किए जा सकने वाले फ़ील्ड शामिल करने से गड़बड़ी हो सकती है. बदलाव किए जा रहे कन्वर्ज़न में, इस्तेमाल न किए जा सकने वाले किसी भी फ़ील्ड के लिए पहले से मौजूद वैल्यू शामिल हैं. वे वैल्यू अपने-आप सेव हो जाएंगी.
नीचे दिए गए उदाहरण में, बदलाव करने के लिए एक आसान कन्वर्ज़न संसाधन बनाने का तरीका बताया गया है:
C#
// Find the Floodlight configuration ID based on the provided activity ID. FloodlightActivity floodlightActivity = service.FloodlightActivities.Get(profileId, floodlightActivityId).Execute(); long floodlightConfigurationId = (long) floodlightActivity.FloodlightConfigurationId; // Construct the conversion object with values that identify the conversion to update. Conversion conversion = new Conversion(); conversion.EncryptedUserId = conversionUserId; conversion.FloodlightActivityId = floodlightActivityId; conversion.FloodlightConfigurationId = floodlightConfigurationId; conversion.Ordinal = conversionOrdinal; conversion.TimestampMicros = conversionTimestamp; // Set the fields to be updated. These fields are required; to preserve a value from the // existing conversion, it must be copied over manually. conversion.Quantity = newQuantity; conversion.Value = newValue;
Java
// Create a conversion object populated with values that identify the conversion to update. Conversion conversion = new Conversion(); conversion.setEncryptedUserId(encryptedUserId); conversion.setFloodlightActivityId(floodlightActivityId); conversion.setFloodlightConfigurationId(floodlightConfigurationId); conversion.setOrdinal(ordinal); conversion.setTimestampMicros(timestampMicros); // Set the fields to be updated. These fields are required; to preserve a value from the // existing conversion, it must be copied over manually. conversion.setQuantity(newQuantity); conversion.setValue(newValue);
129
// Find Floodlight configuration ID based on provided activity ID. $activity = $this->service->floodlightActivities->get( $values['user_profile_id'], $values['floodlight_activity_id'] ); $floodlightConfigId = $activity->getFloodlightConfigurationId(); // Create a conversion object with values that identify the conversion to // update. $conversion = new Google_Service_Dfareporting_Conversion(); $conversion->setEncryptedUserId($values['encrypted_user_id']); $conversion->setFloodlightActivityId($values['floodlight_activity_id']); $conversion->setFloodlightConfigurationId($floodlightConfigId); $conversion->setOrdinal($values['ordinal']); $conversion->setTimestampMicros($values['timestamp']); // Set the fields to be updated. These fields are required; to preserve a // value from the existing conversion, it must be copied over manually. $conversion->setQuantity($values['new_quantity']); $conversion->setValue($values['new_value']);
Python
# Construct the conversion object with values that identify the conversion # to update. conversion = { 'encryptedUserId': encrypted_user_id, 'floodlightActivityId': floodlight_activity_id, 'floodlightConfigurationId': floodlight_config_id, 'ordinal': ordinal, 'timestampMicros': timestamp } # Set the fields to be updated. These fields are required; to preserve a # value from the existing conversion, it must be copied over manually. conversion['quantity'] = new_quantity conversion['value'] = new_value
Ruby
# Look up the Floodlight configuration ID based on activity ID. floodlight_activity = service.get_floodlight_activity(profile_id, existing_conversion[:floodlight_activity_id]) floodlight_config_id = floodlight_activity.floodlight_configuration_id # Construct the conversion with values that identify the conversion to # update. conversion = DfareportingUtils::API_NAMESPACE::Conversion.new( encrypted_user_id: existing_conversion[:encrypted_user_id], floodlight_activity_id: existing_conversion[:floodlight_activity_id], floodlight_configuration_id: floodlight_config_id, ordinal: existing_conversion[:ordinal], timestamp_micros: existing_conversion[:timestamp] ) # Set the fields to be updated. These fields are required; to preserve a # value from the existing conversion, it must be copied over manually. conversion.quantity = new_quantity conversion.value = new_value
एन्क्रिप्ट (सुरक्षित) करने की जानकारी दें
अगर ऐसे कन्वर्ज़न में बदलाव किए जा रहे हैं जिन्हें एन्क्रिप्ट (सुरक्षित) किए गए यूज़र आईडी से जोड़ा गया है, तो आपको बदलाव के अनुरोध के तहत इस बारे में जानकारी देनी होगी कि उन्हें कैसे एन्क्रिप्ट किया गया है. ज़्यादा जानकारी के लिए, कन्वर्ज़न अपलोड करना गाइड पढ़ें.
ज़रूरत पड़ने पर, इन वर्कफ़्लो के बारे में बताने वाला EncryptionInfo
ऑब्जेक्ट बनाना, वर्कफ़्लो में बदलाव करने का दूसरा चरण है:
C#
// Create the encryption info. EncryptionInfo encryptionInfo = new EncryptionInfo(); encryptionInfo.EncryptionEntityId = encryptionEntityId; encryptionInfo.EncryptionEntityType = encryptionEntityType; encryptionInfo.EncryptionSource = encryptionSource;
Java
// Create the encryption info. EncryptionInfo encryptionInfo = new EncryptionInfo(); encryptionInfo.setEncryptionEntityId(encryptionEntityId); encryptionInfo.setEncryptionEntityType(encryptionEntityType); encryptionInfo.setEncryptionSource(encryptionSource);
129
$encryptionInfo = new Google_Service_Dfareporting_EncryptionInfo(); $encryptionInfo->setEncryptionEntityId($values['encryption_entity_id']); $encryptionInfo->setEncryptionEntityType($values['encryption_entity_type']); $encryptionInfo->setEncryptionSource($values['encryption_source']);
Python
# Construct the encryption info. encryption_info = { 'encryptionEntityId': encryption_entity_id, 'encryptionEntityType': encryption_entity_type, 'encryptionSource': encryption_source }
Ruby
# Construct the encryption info. encryption_info = DfareportingUtils::API_NAMESPACE::EncryptionInfo.new( encryption_entity_id: encryption[:entity_id], encryption_entity_type: encryption[:entity_type], encryption_source: encryption[:source] )
अपडेट का अनुरोध जनरेट करना
इस प्रक्रिया का आखिरी कदम, batchupdate
को कॉल करके कन्वर्ज़न में बदलाव करना है. यह तरीका ConversionsBatchUpdateRequest
ऑब्जेक्ट को स्वीकार करता है, जिसमें कन्वर्ज़न के सेट को उनसे जुड़े एन्क्रिप्शन की जानकारी में बदलाव करने की ज़रूरत होती है (जब ज़रूरी हो):
C#
// Insert the conversion. ConversionsBatchUpdateRequest request = new ConversionsBatchUpdateRequest(); request.Conversions = new List<Conversion>() { conversion }; request.EncryptionInfo = encryptionInfo; ConversionsBatchUpdateResponse response = service.Conversions.Batchupdate(request, profileId).Execute();
Java
ConversionsBatchUpdateRequest request = new ConversionsBatchUpdateRequest(); request.setConversions(ImmutableList.of(conversion)); request.setEncryptionInfo(encryptionInfo); ConversionsBatchUpdateResponse response = reporting.conversions() .batchupdate(profileId, request).execute();
129
$batch = new Google_Service_Dfareporting_ConversionsBatchUpdateRequest(); $batch->setConversions([$conversion]); $batch->setEncryptionInfo($encryptionInfo); $result = $this->service->conversions->batchupdate( $values['user_profile_id'], $batch );
Python
# Update the conversion. request_body = { 'conversions': [conversion], 'encryptionInfo': encryption_info } request = service.conversions().batchupdate( profileId=profile_id, body=request_body) response = request.execute()
Ruby
# Construct the batch update request. batch_update_request = DfareportingUtils::API_NAMESPACE::ConversionsBatchUpdateRequest.new( conversions: [conversion], encryption_info: encryption_info ) # Update the conversion. result = service.batchupdate_conversion(profile_id, batch_update_request)
ध्यान रखें कि Campaign Manager 360, आपके अनुरोध में मौजूद हर कन्वर्ज़न में बदलाव करने की पूरी कोशिश करता है. इसके लिए, पूरे बैच को ऑल-इन-वन लेन-देन के तौर पर अपडेट नहीं किया जाता. अगर बैच में कुछ कन्वर्ज़न अपडेट नहीं हो पाते हैं, तो हो सकता है कि दूसरे कन्वर्ज़न अब भी अपडेट हो जाएं. इसलिए, हर कन्वर्ज़न की स्थिति जानने के लिए, लौटाए गए ConversionsBatchUpdateResponse
की जांच करने का सुझाव दिया जाता है:
C#
// Handle the batchinsert response. if (!response.HasFailures.Value) { Console.WriteLine("Successfully updated conversion for encrypted user ID {0}.", conversionUserId); } else { Console.WriteLine("Error(s) updating conversion for encrypted user ID {0}:", conversionUserId); ConversionStatus status = response.Status[0]; foreach(ConversionError error in status.Errors) { Console.WriteLine("\t[{0}]: {1}", error.Code, error.Message); } }
Java
if (!response.getHasFailures()) { System.out.printf("Successfully updated conversion for encrypted user ID %s.%n", encryptedUserId); } else { System.out.printf("Error(s) updating conversion for encrypted user ID %s:%n", encryptedUserId); // Retrieve the conversion status and report any errors found. If multiple conversions // were included in the original request, the response would contain a status for each. ConversionStatus status = response.getStatus().get(0); for (ConversionError error : status.getErrors()) { System.out.printf("\t[%s]: %s.%n", error.getCode(), error.getMessage()); } }
129
if (!$result->getHasFailures()) { printf( 'Successfully updated conversion for encrypted user ID %s.', $values['encrypted_user_id'] ); } else { printf( 'Error(s) updating conversion for encrypted user ID %s:<br><br>', $values['encrypted_user_id'] ); $status = $result->getStatus()[0]; foreach ($status->getErrors() as $error) { printf('[%s] %s<br>', $error->getCode(), $error->getMessage()); } }
Python
if not response['hasFailures']: print('Successfully updated conversion for encrypted user ID %s.' % encrypted_user_id) else: print('Error(s) updating conversion for encrypted user ID %s.' % encrypted_user_id) status = response['status'][0] for error in status['errors']: print '\t[%s]: %s' % (error['code'], error['message'])
Ruby
if result.has_failures puts format('Error(s) updating conversion for encrypted user ID %s.', existing_conversion[:encrypted_user_id]) status = result.status[0] status.errors.each do |error| puts format("\t[%s]: %s", error.code, error.message) end else puts format('Successfully updated conversion for encrypted user ID %s.', existing_conversion[:encrypted_user_id]) end
जैसा कि ऊपर दिखाया गया है, जवाब के status
फ़ील्ड में मूल कन्वर्ज़न में शामिल हर कन्वर्ज़न के लिए एक ConversionStatus
ऑब्जेक्ट होगा. अगर आपकी दिलचस्पी सिर्फ़ ऐसे कन्वर्ज़न में है जो अपडेट नहीं हो सके, तो hasFailures
फ़ील्ड का इस्तेमाल करके यह तय किया जा सकता है कि दिए गए बैच में कोई कन्वर्ज़न पूरा हुआ है या नहीं.