আগে থেকে থাকা কনভার্সন পরিবর্তন করুন

এক বা একাধিক আগে থেকে থাকা কনভার্সনে নিম্নলিখিত ধরনের পরিবর্তন করতে Conversion.update() মেথড কল করুন:

Search Ads 360-তে নিম্নলিখিত বিষয়গুলি পরিবর্তন করা যায় না:

  • কনভার্সনের তারিখ।
  • কনভার্সনের ধরন।
  • কনভার্সনের জন্য অ্যাট্রিবিউট করা কীওয়ার্ড বা ভিজিট।
  • ফ্লাডলাইট অ্যাক্টিভিটি বা অ্যাক্টিভিটির নাম।

তবে, আপনি সবসময় আগে থেকে থাকা কোনও কনভার্সনকে সরিয়ে দেওয়া হয়েছে হিসেবে চিহ্নিত করতে এবং আপডেট করা তারিখ, ধরন, অ্যাট্রিবিউশন আইডি বা ফ্লাডলাইট অ্যাক্টিভিটি সহ নতুন কনভার্সন আপলোড করতে পারবেন (নতুন conversionId উল্লেখ করতে ভুলবেন না)।

আপনি Search Ads 360 API-এর মাধ্যমে আপলোড করা কনভার্সন (অফলাইন কনভার্সন) এবং Floodlight ট্যাগের মাধ্যমে Search Ads 360-এর রেকর্ড করা কনভার্সন (অনলাইন কনভার্সন), দুটিই এডিট করতে পারবেন, তবে নিম্নলিখিত সময়সীমা মেনে চলতে হবে:

  • আপনি যদি clickId-এর মাধ্যমে কনভার্সন শনাক্ত করেন, তাহলে ক্লিক আইডি অবশ্যই গত ৬০ দিনের মধ্যে জেনারেট হতে হবে (অন্যথায় ত্রুটি কোড 0x0000012F)।
  • Floodlight ট্যাগের মাধ্যমে রেকর্ড করা কনভার্সন শুধুমাত্র conversionTimestamp-এর ২৮ দিনের মধ্যে এডিট করা যাবে (অন্যথায় ত্রুটি কোড 0x00000125)।

Conversion.insert()-এর মতো, আপনার আপডেট করার অনুরোধে একাধিক কনভার্সন নির্দিষ্ট করা থাকলে, Search Ads 360 সব-বা-কিছুই-না ট্রানজ্যাকশন হিসেবে সম্পূর্ণ ব্যাচ আপডেট করার পরিবর্তে যথাসাধ্য চেষ্টা করে প্রতিটি কনভার্সন আপডেট করার চেষ্টা করে। একটি ব্যাচের কিছু আপডেট ব্যর্থ হলে, অন্যগুলি এখনও সফল হতে পারে। আপডেট সফল হয়েছে কিনা তা নিশ্চিত করতে, প্রতিটি আপডেট করা কনভার্সনের জন্য উত্তর পড়ুন।

dsConversionId-এর ডেপ্রিকেশন

dsConversionId ফিল্ডটি বাতিল করা হয়েছে এবং কনভার্সন শনাক্ত করার জন্য এটি আর ব্যবহার করা যাবে না। Search Ads 360 কনভার্সন API-তে কনভার্সন এডিট করতে আপনাকে অবশ্যই conversionId (বিজ্ঞাপনদাতার কনভার্সন আইডি) ব্যবহার করতে হবে। Conversion.update() 0x0000013C (Conversion editing using integer DS conversion ID is deprecated) ত্রুটি কোড সহ কনভার্সন বাতিল করে দেয়, যদি কনভার্সন:

  • dsConversionId ফিল্ড নির্দিষ্ট করে, অথবা
  • conversionId ফিল্ডে Search Ads 360 কনভার্সন আইডি (১৭ সংখ্যার আইডি যা Search Ads 360 প্রতিটি কনভার্সনের জন্য তৈরি করে) পাস করে।

গুরুত্বপূর্ণ পরিবর্তন:

  • dsConversionId বন্ধ করা: dsConversionID Search Ads 360 কনভার্সন API, Search Ads 360 রিপোর্টিং API (conversion.id হিসেবে উল্লেখ করা হয়েছে) বা রিপোর্টিং UI-তে ("কনভার্সন আইডি" হিসেবে উল্লেখ করা হয়েছে) আর কাজ করে না।
  • conversionId প্রয়োজনীয়তা: conversionId Search Ads 360 Conversion API-এর মাধ্যমে কনভার্সন এডিট করার জন্য এটি একটি বাধ্যতামূলক ফিল্ড।

conversionId কীভাবে পাবেন:

  • Search Ads 360 API-এর মাধ্যমে আপলোড করা কনভার্সন: কনভার্সন যোগ করার সময় আপনার উল্লেখ করা conversionId ব্যবহার করুন।
  • Floodlight ট্যাগের মাধ্যমে রেকর্ড করা কনভার্সন: Floodlight অর্ডার আইডি (ord ভ্যালু) ব্যবহার করুন যা Floodlight ট্যাগ কনভার্সনের জন্য রিপোর্ট করেছে, যেমন Floodlight বিক্রয় অ্যাক্টিভিটির অর্ডার বা ট্রানজ্যাকশন আইডি।
  • Search Ads 360 Reporting API: আপনি Search Ads 360 Reporting API ব্যবহার করে advertiser_conversion_id ফিরিয়ে আনতে পারবেন। এই ভ্যালু এডিট করার জন্য প্রয়োজনীয় conversionId-এর সাথে সম্পর্কিত।
  • Search Ads 360 UI: আপনি Search Ads 360 ইউজার ইন্টারফেসের মধ্যে কনভার্সন রিপোর্টিং পৃষ্ঠায় “বিজ্ঞাপনদাতার কনভার্সন আইডি” খুঁজে পেতে পারেন। SA360 রিপোর্টে কনভার্সন আইডি

আপডেট করার অনুরোধ পাঠান

আপনি যে কনভার্সন আপডেট করতে চান তা শনাক্ত করতে Conversion.update()-এ উল্লেখ করা বেশিরভাগ ফিল্ড ব্যবহার করা হয়। আগে থেকে থাকা কনভার্সন শনাক্ত করার জন্য আপনি নিম্নলিখিত পদ্ধতিগুলির মধ্যে যেকোনও একটি ব্যবহার করতে পারেন:

  • কনভার্সনের clickId উল্লেখ করুন
    • এডিট করা সব কনভার্সন অবশ্যই ক্লিক আইডি তৈরি হওয়ার ৬০ দিনের মধ্যে হতে হবে।
  • কনভার্সনের কীওয়ার্ড (customerId, campaignId, adGroupId এবং criterionId) উল্লেখ করুন

দুটি টেকনিকের ক্ষেত্রেই আপনাকে কনভার্সনের conversionId, conversionTimestamp এবং ট্রানজ্যাকশন type উল্লেখ করতে হবে। conversionTimestamp অবশ্যই আগে থেকে থাকা কনভার্সনের টাইমস্ট্যাম্প হতে হবে, Epoch মিলিসেকেন্ড UTC-তে। টাইমস্ট্যাম্প যদি আগে থেকে থাকা কনভার্সনের সাথে না মেলে (যেমন, এটি স্থানীয় টাইম জোন থেকে কনভার্ট করা হয়েছে বলে), Search Ads 360 কনভার্সন খুঁজে পায় না এবং 0x0000011B ত্রুটি কোড দেখায়।

Floodlight ট্যাগের মাধ্যমে Search Ads 360-এর রেকর্ড করা কনভার্সনের জন্য, আপনাকে কনভার্সনের Floodlight অ্যাক্টিভিটি (segmentationType এবং segmentationName অথবা segmentationId) উল্লেখ করতে হবে। অন্যথায়, অনুরোধটি 0x0000010C ত্রুটি কোড সহ ব্যর্থ হবে। আমরা সাজেস্ট করি যে আপনি প্রতিটি আপডেট অনুরোধে ফ্লাডলাইট অ্যাক্টিভিটি উল্লেখ করুন।

এছাড়াও, আসল কনভার্সনে revenueMicros এবং currencyCode বা quantityMillis উল্লেখ করা থাকলে, আপনি এটি পরিবর্তন না করলেও আপডেট করার অনুরোধে এই ডেটা উল্লেখ করতে হবে।

ক্লিক আইডি দিয়ে কনভার্সন শনাক্ত করা

কোনও কনভার্সন যদি প্রথমে ক্লিক আইডি নির্দিষ্ট করে, তাহলে আপনি এমন একটি Conversion.update() অনুরোধ পাঠাতে পারেন যা নিম্নলিখিত ফিল্ড নির্দিষ্ট করে:

  • clickId
  • conversionId
  • conversionTimestamp
  • type
  • segmentationType এবং segmentationName (বা segmentationId) (Floodlight ট্যাগের মাধ্যমে রেকর্ড করা কনভার্সনের জন্য প্রয়োজনীয়, সব কনভার্সনের জন্য সাজেস্ট করা হয়)
  • state (আপনি স্ট্যাটাস পরিবর্তন করে সরিয়ে দেওয়া হয়েছে বা অ্যাক্টিভ করতে চাইলে তবেই এটি প্রয়োজন)
  • quantityMillis (শুধুমাত্র আসল কনভার্সনে উল্লেখ করা থাকলে)
  • revenueMicros (শুধুমাত্র আসল কনভার্সনে উল্লেখ করা থাকলে)
  • currencyCode (শুধুমাত্র আসল কনভার্সনে উল্লেখ করা থাকলে)

উদাহরণ

এখানে আগে থেকে থাকা দুটি কনভার্সনের উদাহরণ দেওয়া হল:

{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA",
    "conversionId" : "test_20130906_10",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "100000000", // 100 million revenueMicros is equivalent to $100 of revenue
    "currencyCode": "USD"
  },
  {
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
   "conversionId": "test_1383337059137",
   "conversionTimestamp": "1378710000000",
   "segmentationType" : "FLOODLIGHT",
   "segmentationName" : "Test",
   "type": "ACTION",
   "quantityMillis": "1000"
  }]
}     

নিম্নলিখিত অনুরোধ আগের উদাহরণের একটি কনভার্সন আপডেট করে এবং অন্যটি সরিয়ে দেয়:

JSON

মনে রাখবেন যে Conversion.update() অনুরোধ PUT HTTP পদ্ধতি ব্যবহার করে।

PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with data from your site
   "conversionId": "test_20130906_10",
   "conversionTimestamp": "1378710000000",
   "segmentationType" : "FLOODLIGHT",
   "segmentationName" : "Test",
   "type": "TRANSACTION",
   "revenueMicros": "90000000", // 90 million revenueMicros is equivalent to $90 of revenue
   "currencyCode": "USD"
  },
  {
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with data from your site
   "conversionId": "test_1383337059137",
   "conversionTimestamp": "1378710000000",
   "segmentationType" : "FLOODLIGHT",
   "segmentationName" : "Test",
   "type": "ACTION",
   "quantityMillis": "1000",
   "state": "REMOVED"
  }
 ]
}        

Java

/**
 * Instantiate the Doubleclicksearch service, create a conversion that updates an existing conversion,
 * and upload the conversions.
 */
public static void main(String[] args) throws Exception {

  Doubleclicksearch service = getService(); // See Set Up Your Application.

  // Set up a List to keep track of each conversion you create.
  List<Conversion> conversions = new Vector<Conversion>();

  // Create a conversion and add it to the conversion list.
  // Just to get a little fancy, the updateConversionFromVisit() method can be used for all
  // visit conversions, including conversions that don't specify quantity, revenue, or currency.
  // If quantityMillis wasn't specified in the original conversion, specify -1L for the
  // quantityMillis parameter. Likewise, if revenueMicros wasn't specified originally,
  // specify -1L for the revenueMicros parameter and an empty string for currency.
  conversionList = updateConversionFromVisit(
      conversionList,
      "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site
      "test_20130906_10",           // conversionId
      1378710000000L,               // timeStamp
      "TRANSACTION",                // type
      "",                           // state
      -1L,                          // quantityMillis
      90000000L,                    // revenueMicros. Equivalent to $90 of revenue
      "USD");                       // currencyCode

   // Here's a conversion that needs to be removed. Just set the state parameter to "REMOVED".
   conversionList = updateConversionFromVisit(
      conversionList,
      "COiYmPDTv7kCFcP0KgodOzQAAA", // clickId. Replace with data from your site
      "test_1383337059137",         // conversionId
      1378710000000L,               // timeStamp
      "ACTION",                     // type
      "REMOVED",                    // state
      1000L,                        // quantityMillis
      -1L,                          // revenueMicros
      "");                          // currencyCode

    // Upload the List and handle the response.
    uploadConversions(conversions, service); // See an example in Add New Conversions. 
  }

/**
 * Create a conversion and add it to a List<Conversion>.
 */
  private static List<Conversion> updateConversionFromVisit(List<Conversion> conversions,
      String clickId,
      String conversionId,
      Long timeStamp,
      String type,
      String state,
      Long quantity,
      Long revenue,
      String currency) {

    // Identifies the existing conversion. This sample hard-codes the segmentation name.
    Conversion conversion = new Conversion()
        .setClickId(clickId)
        .setConversionId(conversionId)
        .setConversionTimestamp(BigInteger.valueOf(timeStamp))
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType(type);

    // Only add these fields if the value is not empty greater than -1.
    if(!state.isEmpty()) conversion.setState(state);
    if (quantity > -1L) {
      conversion.setQuantityMillis(quantity);
    }
    if (revenue > -1L) {
      conversion.setRevenueMicros(revenue);
      if (!currency.isEmpty()) {
        conversion.setCurrencyCode(currency);
      } else {
        System.err.println(String.format(
            "Can't add conversion %s. It specifies revenue but no currency.",
            conversion.getConversionId()));
        return conversions;
      }
    }

    conversions.add(conversion);
    return conversions;
  }         

Python

def update_conversion(service):
  """Change the revenue for one existing conversion and remove another.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().update(
      body=
      {
          'conversion' : [{
              'clickId' : 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site
              'conversionId' : 'test_20130906_13',
              'conversionTimestamp' : '1378710000000',
              'segmentationType' : 'FLOODLIGHT',
              'segmentationName' : 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '90000000', // 90 million revenueMicros is equivalent to $90 of revenue
              'currencyCode': 'USD'
            },
            {
             'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with data from your site
             'conversionId': 'test_1383337059137_01',
             'conversionTimestamp': '1378710000000',
             'segmentationType' : 'FLOODLIGHT',
             'segmentationName' : 'Test',
             'type': 'ACTION',
             'quantityMillis': '1000',
             'state': 'REMOVED'
            }]
      }
  )

  pprint.pprint(request.execute())

কীওয়ার্ড আইডি দিয়ে কনভার্সন শনাক্ত করুন

আপনার কাছে ক্লিক আইডির অ্যাক্সেস না থাকলে অথবা কোনও কনভার্সন মূলত কোনও কীওয়ার্ড বা কীওয়ার্ড/বিজ্ঞাপনের সাথে অ্যাট্রিবিউট করা থাকলে, আপনি Conversion.update() অনুরোধ পাঠাতে পারেন যা নিম্নলিখিত ফিল্ড নির্দিষ্ট করে:

  • customerId, campaignId, adGroupId এবং criterionId (নতুন সার্চ বিজ্ঞাপন ৩৬০ আইডি যা কীওয়ার্ড শনাক্ত করে)
  • conversionId
  • conversionTimestamp
  • type
  • state (আপনি স্ট্যাটাস পরিবর্তন করে সরিয়ে দেওয়া হয়েছে বা অ্যাক্টিভ করতে চাইলে তবেই এটি প্রয়োজন)
  • quantityMillis (শুধুমাত্র আসল কনভার্সনে উল্লেখ করা থাকলে)
  • revenueMicros (শুধুমাত্র আসল কনভার্সনে উল্লেখ করা থাকলে)
  • currencyCode (শুধুমাত্র আসল কনভার্সনে উল্লেখ করা থাকলে)

কীওয়ার্ড আইডি শুধুমাত্র একটি বিজ্ঞাপন গ্রুপের মধ্যে অনন্য, তাই আপনাকে চারটি আইডিই উল্লেখ করতে হবে। কোনও কনভার্সনে customerId, campaignId বা adGroupId ছাড়া criterionId উল্লেখ করা থাকলে, আপডেট করা যাবে না এবং 0x0000012E ত্রুটি কোড দেখানো হবে। আপনাকে অন্য আইডি নির্দিষ্ট করতে হবে না, যেমন কনভার্সনের বিজ্ঞাপন আইডি।

উদাহরণ

আগে থেকে থাকা কনভার্সনের একটি উদাহরণ এখানে দেওয়া হল:

{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
   "customerId": "123-456-7890",
   "campaignId": "14660344555",
   "adGroupId": "105138634255",
   "criterionId": "948710340465",
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "1000",
   "segmentationType": "FLOODLIGHT",
   "segmentationName": "Test"
  }]
}     

নিম্নলিখিত অনুরোধ কনভার্সনের পরিমাণ আপডেট করে:

JSON

মনে রাখবেন যে Conversion.update() অনুরোধ PUT HTTP পদ্ধতি ব্যবহার করে।

PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "customerId": "123-456-7890", // Replace with your ID
   "campaignId": "14660344555", // Replace with your ID
   "adGroupId": "105138634255", // Replace with your ID
   "criterionId": "948710340465", // Replace with your ID
   "conversionId": "test_1383157519886",
   "conversionTimestamp": "1378710000000",
   "type": "ACTION",
   "quantityMillis": "3000"
  }
 ]
}        

Java

    // Send conversion data to updateConversion, which creates a conversion and adds it
    // to the conversion list.
    conversionList =  updateConversionFromKeyword(conversionList,
        "123-456-7890",       // customerId. Replace with your ID
        14660344555L,         // campaignId. Replace with your ID
        105138634255L,        // adGroupId. Replace with your ID
        948710340465L,        // criterionId. Replace with your ID
        "test_1383157519886", // conversionId
        1378710000000L,       // timeStamp
        "ACTION",             // type
        "",                   // state
        3000L,                // quantityMillis
        -1L,                  // revenueMicros
        "");                  // currencyCode

  private static List<Conversion> updateConversionFromKeyword(List<Conversion> conversions,
       String customerId,
       Long campaignId,
       Long adGroupId,
       Long criterionId,
       String conversionId,
       Long timeStamp,
       String type,
       String state,
       Long quantity,
       Long revenue,
       String currency
    ) {

   Conversion conversion = new Conversion()
   .setCustomerId(customerId)
   .setCampaignId(campaignId)
   .setAdGroupId(adGroupId)
   .setCriterionId(criterionId)
   .setConversionId(conversionId)
   .setConversionTimestamp(BigInteger.valueOf(timeStamp))
   .setType(type);

   // Only add these fields if the value is not empty greater than -1.
   if(!state.isEmpty()) conversion.setState(state);
   if (quantity > -1L) {
     conversion.setQuantityMillis(quantity);
   }
   if (revenue > -1L) {
     conversion.setRevenueMicros(revenue);
     if (!currency.isEmpty()) {
       conversion.setCurrencyCode(currency);
     } else {
       System.err.println(String.format(
           "Can't add conversion %s. It specifies revenue but no currency.",
           conversion.getConversionId()));
       return conversions;
     }
   }

   conversions.add(conversion);
   return conversions;
   }                 

Python

def update_conversion(service):
  """Change the quantity of a conversion. Use the keyword's IDs (customerId,
  campaignId, adGroupId, and criterionId) to identify the conversion.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().update(
      body=
      {
          'conversion': [{
              'customerId': '123-456-7890', // Replace with your ID
              'campaignId': '14660344555', // Replace with your ID
              'adGroupId': '105138634255', // Replace with your ID
              'criterionId': '948710340465', // Replace with your ID
              'conversionId': 'test_1383157519886',
              'conversionTimestamp': '1378710000000',
              'type': 'ACTION',
              'quantityMillis': '3000'
            }]
      }
  )

  pprint.pprint(request.execute())

Search Ads 360-এর উত্তর ম্যানেজ করা

আপডেট সংক্রান্ত অনুরোধের উত্তর, ইনসার্ট সংক্রান্ত অনুরোধের উত্তরের মতোই: অনুরোধে থাকা সব কনভার্সন সফলভাবে আপডেট করা হলে তবেই Search Ads 360 সফলভাবে আপডেট করা হয়েছে বলে দেখায়।

অনুরোধ সফল হলে, উত্তরে প্রতিটি আপডেট করা কনভার্সনের জন্য সম্পূর্ণ Search Ads 360 ইন্টার্নাল রিপ্রেজেন্টেশন অন্তর্ভুক্ত থাকে, যেমন নতুন Search Ads 360 কাস্টমার আইডি, ক্যাম্পেন আইডি, বিজ্ঞাপন গ্রুপ আইডি এবং কীওয়ার্ড (মাপকাঠি) আইডি।

এক বা একাধিক আপডেট যাচাই বা আপলোড করা না গেলে, প্রতিটি ব্যর্থ আপডেটের জন্য উত্তরে ব্যর্থতার মেসেজ অন্তর্ভুক্ত থাকে। উত্তরে কনভার্সন সম্পর্কে কোনও মেসেজ নেই যা সফলভাবে আপডেট করা হয়েছে। এইসব ব্যর্থতার মেসেজ সম্পর্কে আরও তথ্য পেতে, যোগ করার অনুরোধের জন্য Search Ads 360-এর প্রতিক্রিয়া ম্যানেজ করুন দেখুন।