रूपांतरण अपलोड करें

इस गाइड में, Campaign Manager 360 API Conversions सेवा का इस्तेमाल करके, ऑफ़लाइन कन्वर्ज़न अपलोड करने के बारे में पूरी जानकारी दी गई है. आगे बढ़ने से पहले, हमारा सुझाव है कि आप ऑफ़लाइन कन्वर्ज़न के बारे में जानने के लिए, खास जानकारी देखें. साथ ही, इस गाइड में बताए गए कॉन्सेप्ट के बारे में जानें.

ध्यान दें: API, Campaign Manager 360 और Display & Video 360 के लिए ऑफ़लाइन कन्वर्ज़न का समर्थन करता है. हालांकि, कार्ट डेटा इन दोनों प्रॉडक्ट के लिए उपलब्ध नहीं है. कार्ट डेटा के बारे में ज़्यादा जानें.

कन्वर्ज़न रिसॉर्स कॉन्फ़िगर करना

कन्वर्ज़न अपलोड करने की प्रोसेस में पहला चरण, एक या उससे ज़्यादा Conversion संसाधन ऑब्जेक्ट बनाना है. इनमें से हर ऑब्जेक्ट, एक कन्वर्ज़न इवेंट को दिखाता है. साथ ही, इसमें कुछ ज़रूरी फ़ील्ड होते हैं:

फ़ील्ड	ब्यौरा
floodlightActivityId	वह Floodlight गतिविधि जिससे यह कन्वर्ज़न जुड़ा होगा.
floodlightConfigurationId	यह उस Floodlight कॉन्फ़िगरेशन को दिखाता है जिसका इस्तेमाल चुनी गई गतिविधि करती है.
ordinal	इस वैल्यू का इस्तेमाल यह कंट्रोल करने के लिए किया जाता है कि एक ही दिन में, एक ही डिवाइस या उपयोगकर्ता से मिले डुप्लीकेट कन्वर्ज़न को कैसे हटाया जाए. ज़्यादा जानकारी के लिए, अक्सर पूछे जाने वाले सवाल देखें.
timestampMicros	कन्वर्ज़न का टाइमस्टैंप. यह टाइमस्टैंप, Unix epoch के बाद से माइक्रोसेकंड में होता है.

इसके अलावा, हर ऑब्जेक्ट में यहां दिए गए फ़ील्ड में से एक फ़ील्ड होना चाहिए:

फ़ील्ड	ब्यौरा
encryptedUserId	%m मैच मैक्रो या डेटा ट्रांसफ़र से मिला एन्क्रिप्ट (सुरक्षित) किया गया एक यूज़र आईडी.
encryptedUserIdCandidates[]	%m मैच मैक्रो या Data Transfer से मिले एन्क्रिप्ट (सुरक्षित) किए गए उपयोगकर्ता आईडी की सूची. इनमें से उस आईडी का इस्तेमाल किया जाएगा जिसे timestampMicros से पहले रिकॉर्ड किया गया था. अगर कोई भी आईडी, पहले से मौजूद किसी एक्सपोज़र से मेल नहीं खाता है, तो गड़बड़ी का मैसेज दिखेगा.
dclid	Campaign Manager 360 या Display & Video 360 से जनरेट किया गया डिसप्ले क्लिक आइडेंटिफ़ायर.
gclid	Google Ads या Search Ads 360 से जनरेट किया गया Google क्लिक आइडेंटिफ़ायर.
matchId	विज्ञापन देने वाले व्यक्ति या कंपनी की तरफ़ से बनाया गया यूनीक आइडेंटिफ़ायर, जिसे Floodlight टैग के ज़रिए Campaign Manager 360 को भेजा गया है.
mobileDeviceId	आईडीएफ़ए या विज्ञापन आईडी फ़ॉर्मैट में अनएन्क्रिप्ट मोबाइल आईडी या विज्ञापन के लिए कनेक्टेड टीवी आइडेंटिफ़ायर (आईएफ़ए). ये आइडेंटिफ़ायर, सीटीवी डिवाइस प्लैटफ़ॉर्म (Roku, Fire TV, Android TV, Apple TV, Xbox, Samsung, Vizio) से मिलने चाहिए. ध्यान दें कि Google, YouTube कनेक्टेड टीवी आईएफ़ए उपलब्ध नहीं कराता.

आखिर में, हर कन्वर्ज़न की दो मेट्रिक होती हैं:

फ़ील्ड	ब्यौरा
quantity	ज़रूरी है. कन्वर्ज़न से जुड़े आइटम की संख्या. कन्वर्ज़न को कुछ मेट्रिक (जैसे, कुल कन्वर्ज़न) में शामिल करने के लिए, इसकी वैल्यू कम से कम 1 होनी चाहिए.
value	कन्वर्ज़न से जुड़ी डॉलर में रकम. विज्ञापन देने वाले व्यक्ति या कंपनी के Floodlight कॉन्फ़िगरेशन के मुद्रा कोड के हिसाब से तय की जाती है.

जो फ़ील्ड ज़रूरी नहीं हैं उनके बारे में रेफ़रंस दस्तावेज़ में बताया गया है.

नीचे दिए गए उदाहरण में, सामान्य कन्वर्ज़न रिसोर्स ऑब्जेक्ट बनाने का तरीका बताया गया है:

C#

// Generate a timestamp in milliseconds since Unix epoch.
TimeSpan timeSpan = DateTime.UtcNow - new DateTime(1970, 1, 1);
long currentTimeInMilliseconds = (long) timeSpan.TotalMilliseconds;

// Find the Floodlight configuration ID based on the provided activity ID.
FloodlightActivity floodlightActivity =
    service.FloodlightActivities.Get(profileId, floodlightActivityId).Execute();
long floodlightConfigurationId = (long) floodlightActivity.FloodlightConfigurationId;

// Create the conversion.
Conversion conversion = new Conversion();
conversion.EncryptedUserId = conversionUserId;
conversion.FloodlightActivityId = floodlightActivityId;
conversion.FloodlightConfigurationId = floodlightConfigurationId;
conversion.Ordinal = currentTimeInMilliseconds.ToString();
conversion.TimestampMicros = currentTimeInMilliseconds * 1000;

Java

long currentTimeInMilliseconds = System.currentTimeMillis();

// Find Floodlight configuration ID based on the provided activity ID.
FloodlightActivity floodlightActivity = reporting.floodlightActivities()
    .get(profileId, floodlightActivityId).execute();
long floodlightConfigurationId = floodlightActivity.getFloodlightConfigurationId();

Conversion conversion = new Conversion();
conversion.setEncryptedUserId(encryptedUserId);
conversion.setFloodlightActivityId(floodlightActivityId);
conversion.setFloodlightConfigurationId(floodlightConfigurationId);
conversion.setOrdinal(String.valueOf(currentTimeInMilliseconds));
conversion.setTimestampMicros(currentTimeInMilliseconds * 1000);

PHP

$currentTimeInMicros = time() * 1000 * 1000;

// 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();

$conversion = new Google_Service_Dfareporting_Conversion();
$conversion->setEncryptedUserId($values['encrypted_user_id']);
$conversion->setFloodlightActivityId($values['floodlight_activity_id']);
$conversion->setFloodlightConfigurationId($floodlightConfigId);
$conversion->setOrdinal($currentTimeInMicros);
$conversion->setTimestampMicros($currentTimeInMicros);

Python

# Look up the Floodlight configuration ID based on activity ID.
floodlight_activity = (
    service.floodlightActivities()
    .get(profileId=str(profile_id), id=str(floodlight_activity_id))
    .execute()
)
floodlight_config_id = floodlight_activity['floodlightConfigurationId']

current_time_in_micros = int(time.time() * 1000000)

# Construct the conversion.
conversion = {
    'encryptedUserId': encrypted_user_id,
    'floodlightActivityId': floodlight_activity_id,
    'floodlightConfigurationId': floodlight_config_id,
    'ordinal': current_time_in_micros,
    'timestampMicros': current_time_in_micros
}

Ruby

# Look up the Floodlight configuration ID based on activity ID.
floodlight_activity = service.get_floodlight_activity(profile_id,
  floodlight_activity_id)
floodlight_config_id = floodlight_activity.floodlight_configuration_id

current_time_in_micros = DateTime.now.strftime('%Q').to_i * 1000

# Construct the conversion.
conversion = DfareportingUtils::API_NAMESPACE::Conversion.new(
  encrypted_user_id: encrypted_user_id,
  floodlight_activity_id: floodlight_activity_id,
  floodlight_configuration_id: floodlight_config_id,
  ordinal: current_time_in_micros,
  timestamp_micros: current_time_in_micros
)

एन्क्रिप्ट (सुरक्षित) करने के तरीके की जानकारी देना

ध्यान दें: यह सेक्शन सिर्फ़ उन कन्वर्ज़न को अपलोड करने पर लागू होता है जिनमें encryptedUserId या encryptedUserIdCandidates[] शामिल है.

अगर आपको ऑफ़लाइन कन्वर्ज़न को एन्क्रिप्ट (सुरक्षित) किए गए यूज़र आईडी एट्रिब्यूट करने हैं, जैसा कि पिछले उदाहरण में बताया गया है, तो आपको यह जानकारी देनी होगी कि उन्हें एन्क्रिप्ट (सुरक्षित) कैसे किया गया है. यह जानकारी, आपको डेटा डालने के अनुरोध के हिस्से के तौर पर देनी होगी. खास तौर पर, आपको इनके बारे में जानकारी होनी चाहिए:

1. एन्क्रिप्शन सोर्स, जिससे यह पता चलता है कि एन्क्रिप्ट (सुरक्षित) किए गए आईडी का बैच कहां से आया है. स्वीकार की जाने वाली वैल्यू ये हैं: %m match मैक्रो से सोर्स किए गए आईडी के लिए AD_SERVING या डेटा ट्रांसफ़र फ़ाइलों से सोर्स किए गए आईडी के लिए DATA_TRANSFER.

2. encryption entity, जो वैल्यू का एक यूनीक सेट होता है. इसका इस्तेमाल, उपयोगकर्ता आईडी को एन्क्रिप्ट (सुरक्षित) करने के लिए किया जाता है. आम तौर पर, ये वैल्यू Campaign Manager 360 खाते से जुड़ी होती हैं. ऐसा तब होता है, जब सोर्स डेटा ट्रांसफ़र होता है. इसके अलावा, ये वैल्यू Campaign Manager 360 में विज्ञापन देने वाले व्यक्ति या कंपनी से जुड़ी होती हैं. ऐसा तब होता है, जब सोर्स %m मैक्रो होता है. हालांकि, ऐसा हमेशा नहीं होता. अगर आपको पक्का नहीं है, तो ज़्यादा जानकारी के लिए, अपने Campaign Manager 360 खाते के प्रतिनिधि या Campaign Manager 360 की सहायता टीम से संपर्क करें.

ज़रूरत पड़ने पर, इन वैल्यू के बारे में बताने वाला 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);

PHP

$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]
)

ध्यान दें कि हर इंसर्ट अनुरोध में सिर्फ़ एक EncryptionInfo ऑब्जेक्ट हो सकता है. इसका मतलब है कि किसी अनुरोध में शामिल सभी कन्वर्ज़न, एक ही सोर्स से होने चाहिए. साथ ही, उनमें एन्क्रिप्शन के लिए एक ही इकाई का इस्तेमाल होना चाहिए.

शामिल करने का अनुरोध जनरेट करना

इस प्रोसेस का आखिरी चरण, batchinsert को कॉल करके कन्वर्ज़न अपलोड करना है. यह तरीका, ConversionsBatchInsertRequest ऑब्जेक्ट को स्वीकार करता है. यह ऑब्जेक्ट, अपलोड किए जाने वाले कन्वर्ज़न के सेट को उनसे जुड़ी एन्क्रिप्शन की जानकारी के साथ जोड़ता है. हालांकि, ऐसा सिर्फ़ तब किया जाता है, जब इसकी ज़रूरत हो:

C#

// Insert the conversion.
ConversionsBatchInsertRequest request = new ConversionsBatchInsertRequest();
request.Conversions = new List<Conversion>() { conversion };
request.EncryptionInfo = encryptionInfo;

ConversionsBatchInsertResponse response =
    service.Conversions.Batchinsert(request, profileId).Execute();

Java

ConversionsBatchInsertRequest request = new ConversionsBatchInsertRequest();
request.setConversions(ImmutableList.of(conversion));
request.setEncryptionInfo(encryptionInfo);

ConversionsBatchInsertResponse response = reporting.conversions()
    .batchinsert(profileId, request).execute();

PHP

$batch = new Google_Service_Dfareporting_ConversionsBatchInsertRequest();
$batch->setConversions([$conversion]);
$batch->setEncryptionInfo($encryptionInfo);

$result = $this->service->conversions->batchinsert(
    $values['user_profile_id'],
    $batch
);

Python

# Insert the conversion.
request_body = {
    'conversions': [conversion],
    'encryptionInfo': encryption_info
}
request = service.conversions().batchinsert(
    profileId=str(profile_id), body=request_body
)
response = request.execute()

Ruby

# Construct the batch insert request.
batch_insert_request =
  DfareportingUtils::API_NAMESPACE::ConversionsBatchInsertRequest.new(
    conversions: [conversion],
    encryption_info: encryption_info
  )

# Insert the conversion.
result = service.batchinsert_conversion(profile_id, batch_insert_request)

ध्यान दें कि Campaign Manager 360, आपके अनुरोध में मौजूद हर कन्वर्ज़न को सबसे सही तरीके से डालने की कोशिश करता है. यह पूरे बैच को एक ऐसे लेन-देन के तौर पर नहीं डालता जिसमें सभी कन्वर्ज़न शामिल हों या कोई भी कन्वर्ज़न शामिल न हो. अगर बैच में मौजूद कुछ कन्वर्ज़न नहीं जुड़ते हैं, तो हो सकता है कि बाकी कन्वर्ज़न जुड़ जाएं. इसलिए, हमारा सुझाव है कि आप ConversionsBatchInsertResponse की जांच करें, ताकि हर कन्वर्ज़न की स्थिति का पता लगाया जा सके:

C#

// Handle the batchinsert response.
if (!response.HasFailures.Value) {
  Console.WriteLine("Successfully inserted conversion for encrypted user ID {0}.",
      conversionUserId);
} else {
  Console.WriteLine("Error(s) inserting 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 inserted conversion for encrypted user ID %s.%n",
      encryptedUserId);
} else {
  System.out.printf("Error(s) inserting 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());
  }
}

PHP

if (!$result->getHasFailures()) {
    printf(
        'Successfully inserted conversion for encrypted user ID %s.',
        $values['encrypted_user_id']
    );
} else {
    printf(
        'Error(s) inserting 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 inserted conversion for encrypted user ID %s.'
      % encrypted_user_id
  )
else:
  print(
      'Error(s) inserting 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) inserting conversion for encrypted user ID %s.',
    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 inserted conversion for encrypted user ID %s.',
    encrypted_user_id)
end

ऊपर दिए गए जवाब के status फ़ील्ड में, ConversionStatus ऑब्जेक्ट शामिल होगा. यह ऑब्जेक्ट, ओरिजनल अनुरोध में शामिल हर कन्वर्ज़न के लिए होगा. अगर आपको सिर्फ़ उन कन्वर्ज़न में दिलचस्पी है जिन्हें डाला नहीं जा सका, तो hasFailures फ़ील्ड का इस्तेमाल करके यह तुरंत पता लगाया जा सकता है कि दिए गए बैच में कोई कन्वर्ज़न डाला नहीं जा सका.

पुष्टि करना कि कन्वर्ज़न प्रोसेस हो गए हैं

आम तौर पर, अपलोड किए गए कन्वर्ज़न को प्रोसेस होने और रिपोर्ट में दिखने में 24 घंटे लगते हैं. यह पुष्टि करने के लिए कि अपलोड किए गए कन्वर्ज़न प्रोसेस किए गए हैं या नहीं, हमारा सुझाव है कि आप Floodlight इंप्रेशन रिपोर्ट जनरेट करें. अन्य एट्रिब्यूशन रिपोर्ट के उलट, ये रिपोर्ट डिफ़ॉल्ट रूप से एट्रिब्यूट किए गए (विज्ञापन से जुड़े) और एट्रिब्यूट नहीं किए गए, दोनों तरह के कन्वर्ज़न दिखाती हैं. इससे यह तुरंत पता चल जाता है कि भेजे गए कन्वर्ज़न, Campaign Manager 360 में पहुंच गए हैं या नहीं.

ध्यान दें: पुष्टि करने के लिए, हाल ही के कन्वर्ज़न का इस्तेमाल किया जाना चाहिए. फ़्लडलाइट इंप्रेशन रिपोर्ट में, ऐसे कन्वर्ज़न नहीं दिखेंगे जिन्हें टाइमस्टैंप के 28 दिनों के बाद सबमिट किया गया है.