ফিল্ড মাস্ক

Google Ads API-এ, ফিল্ড মাস্ক ব্যবহার করে আপডেট করা হয়। ফিল্ড মাস্ক আপনি আপডেটের সাথে পরিবর্তন করতে চান এমন সমস্ত ক্ষেত্র তালিকাভুক্ত করে এবং যে কোনো নির্দিষ্ট ক্ষেত্র যা ফিল্ড মাস্কে নেই তা উপেক্ষা করা হয়, এমনকি সার্ভারে পাঠানো হলেও।

ফিল্ডমাস্ক ইউটিলিটি

ফিল্ড মাস্ক তৈরি করার প্রস্তাবিত উপায় হল আমাদের বিল্ট-ইন ফিল্ড মাস্ক ইউটিলিটি ( FieldMasks ) ব্যবহার করা, যা আপনাকে স্ক্র্যাচ থেকে তৈরি করার পরিবর্তে একটি পরিবর্তিত বস্তু থেকে ফিল্ড মাস্ক তৈরি করতে দেয়।

একটি প্রচারাভিযান আপডেট করার জন্য এখানে একটি উদাহরণ:

my $campaign = Google::Ads::GoogleAds::V17::Resources::Campaign->new({
    resourceName =>
      Google::Ads::GoogleAds::V17::Utils::ResourceNames::campaign(
        $customer_id, $campaign_id
      ),
    status => PAUSED,
    networkSettings =>
      Google::Ads::GoogleAds::V17::Resources::NetworkSettings->new({
        targetSearchNetwork => "false"
      })
    });

my $campaign_operation =
  Google::Ads::GoogleAds::V17::Services::CampaignService::CampaignOperation->new({
    update     => $campaign,
    updateMask => all_set_fields_of($campaign)
  });

এই উদাহরণটি প্রথমে ResourceNames ইউটিলিটি ব্যবহার করে তার রিসোর্স নাম সেট করে একটি Campaign অবজেক্ট তৈরি করে, যাতে API জানতে পারে কোন প্রচারাভিযান আপডেট করা হচ্ছে।

উদাহরণটি প্রচারে FieldMasks::all_set_fields_of() পদ্ধতি ব্যবহার করে স্বয়ংক্রিয়ভাবে একটি ফিল্ড মাস্ক তৈরি করে যা সমস্ত সেট ক্ষেত্র গণনা করে। তারপরে আপনি ফিরে আসা মাস্কটি সরাসরি আপডেট কলে পাস করতে পারেন।

FieldMasks::all_set_fields_of() হল FieldMasks::field_mask() এর জন্য একটি সুবিধাজনক পদ্ধতি। এটি আপনার পাস করা বস্তুটিকে একই শ্রেণীর একটি খালি বস্তুর সাথে তুলনা করে। তাই উপরের কোডে, আপনিও ব্যবহার করতে পারেন

field_mask(Google::Ads::GoogleAds::V17::Resources::Campaign->new({}), $campaign)

all_set_fields_of($campaign) এর পরিবর্তে।

ম্যানুয়ালি একটি মুখোশ তৈরি করুন

স্ক্র্যাচ থেকে একটি ফিল্ড মাস্ক তৈরি করতে, আপনি প্রথমে একটি Google::Ads::GoogleAds::Common::FieldMask অবজেক্ট তৈরি করবেন, তারপরে আপনি যে সমস্ত ক্ষেত্রের পরিবর্তন করতে চান তার নাম দিয়ে একটি অ্যারে রেফারেন্স তৈরি করুন এবং অবশেষে বরাদ্দ করুন ফিল্ড মাস্কের paths ক্ষেত্রের অ্যারে রেফারেন্স।

my $field_mask = Google::Ads::GoogleAds::Common::FieldMask->new({
    paths => ["status", "name"]
  });

অবজেক্ট ক্ষেত্র এবং তাদের সাবফিল্ড আপডেট করা হচ্ছে

অবজেক্ট ফিল্ডে সাবফিল্ড থাকতে পারে (যেমন MaximizeConversions যার তিনটি আছে: target_cpa_micros , cpc_bid_ceiling_micros , এবং cpc_bid_floor_micros ); অথবা তাদের কিছুই থাকতে পারে না (যেমন ManualCpm )।

কোনো সংজ্ঞায়িত সাবফিল্ড ছাড়া অবজেক্ট ক্ষেত্র

পার্লের একটি অবজেক্ট ফিল্ড জিআরপিসি-তে চলমান ক্লায়েন্ট লাইব্রেরিতে প্রোটোবাফ MESSAGE সমতুল্য। কোনো সাবফিল্ডের সাথে সংজ্ঞায়িত নয় এমন একটি অবজেক্ট ফিল্ড আপডেট করার সময়, উপরে বর্ণিত হিসাবে একটি ফিল্ড মাস্ক তৈরি করতে FieldMasks ইউটিলিটি ব্যবহার করুন।

সংজ্ঞায়িত সাবফিল্ড সহ অবজেক্ট ক্ষেত্র

একটি অবজেক্ট ফিল্ড আপডেট করার সময় যেটি সাবফিল্ডের সাথে সংজ্ঞায়িত করা হয়েছে সেই বার্তায় স্পষ্টভাবে কোনো সাবফিল্ড সেট না করে, আপনাকে অবশ্যই FieldMask প্রতিটি পরিবর্তনযোগ্য অবজেক্ট সাবফিল্ড যোগ করতে হবে, উপরের উদাহরণের মতো যা স্ক্র্যাচ থেকে একটি ফিল্ড মাস্ক তৈরি করে।

একটি সাধারণ উদাহরণ হল নতুন বিডিং কৌশলে কোনো ক্ষেত্র সেট না করেই একটি প্রচারাভিযানের বিডিং কৌশল আপডেট করা। নিচের উদাহরণে দেখানো হয়েছে কিভাবে বিডিং কৌশলে কোনো সাবফিল্ড সেট না করেই MaximizeConversions বিডিং কৌশল ব্যবহার করার জন্য একটি প্রচারাভিযান আপডেট করতে হয়।

এই ক্ষেত্রে, FieldMasks ইউটিলিটির all_set_fields_of() এবং field_mask() পদ্ধতি ব্যবহার করে লক্ষ্য অর্জন করা যায় না।

নিম্নলিখিত উদাহরণটি একটি ফিল্ড মাস্ক তৈরি করে যাতে maximize_conversions অন্তর্ভুক্ত থাকে। যাইহোক, Google Ads API এই আচরণের অনুমতি দেয় না, যাতে ভুলবশত ক্ষেত্রগুলি সাফ করা রোধ করা যায় এবং একটি FieldMaskError.FIELD_HAS_SUBFIELDS ত্রুটি তৈরি করে।

সতর্কতা: নিম্নলিখিত কোডটি একটি ত্রুটি তৈরি করে।

# Creates a campaign with the proper resource name and an empty
# MaximizeConversions field.
my $campaign = Google::Ads::GoogleAds::V17::Resources::Campaign->new({
    resourceName =>
      Google::Ads::GoogleAds::V17::Utils::ResourceNames::campaign(
        $customer_id, $campaign_id
      ),
    maximizeConversions =>
      Google::Ads::GoogleAds::V17::Resources::MaximizeConversions->new()
    });

# Constructs an operation, using the FieldMasks' all_set_fields_of utility to
# derive the update mask. The field mask will include 'maximize_conversions',
# which will produce a FieldMaskError.FIELD_HAS_SUBFIELDS error.
my $campaign_operation =
  Google::Ads::GoogleAds::V17::Services::CampaignService::CampaignOperation->new({
    update     => $campaign,
    updateMask => all_set_fields_of($campaign)
  });

# Sends the operation in a mutate request that will result in a
# FieldMaskError.FIELD_HAS_SUBFIELDS error because empty object fields cannot
# be included in a field mask.
my $response = $api_client->CampaignService()->mutate({
    customerId => $customer_id,
    operations => [$campaign_operation]
  });

নিম্নলিখিত উদাহরণটি প্রদর্শন করে যে কীভাবে একটি প্রচারাভিযানের কোনো সাবফিল্ড সেট না করেই MaximizeConversions বিডিং কৌশল ব্যবহার করার জন্য সঠিকভাবে আপডেট করা যায়।

সাফল্য: নীচের কোডটি সফলভাবে প্রচারাভিযান বিডিং কৌশল আপডেট করে।

# Creates a campaign with the proper resource name.
my $campaign = Google::Ads::GoogleAds::V17::Resources::Campaign->new({
    resourceName => Google::Ads::GoogleAds::V17::Utils::ResourceNames::campaign(
      $customer_id, $campaign_id
    )
  });

# Creates a field mask from the existing campaign and adds all of the fields
# on the MaximizeConversions bidding strategy to the field mask. Because these
# fields are included in the field mask but excluded from the campaign object,
# the Google Ads API will set the campaign's bidding strategy to a
# MaximizeConversions object with none of its subfields set.
# Only include 'maximize_conversions.target_cpa_micros' in the field mask
# as it is the only mutable subfield on MaximizeConversions when used as a
# standard bidding strategy.
#
# Learn more about standard and portfolio bidding strategies here:
# https://developers.google.com/google-ads/api/docs/campaigns/bidding/assign-strategies
my $field_mask = all_set_fields_of($campaign);
push @{$field_mask->{paths}}, "maximize_conversions.target_cpa_micros";

# Creates an operation to update the campaign with the specified fields.
my $campaign_operation =
  Google::Ads::GoogleAds::V17::Services::CampaignService::CampaignOperation->new({
    update     => $campaign,
    updateMask => $field_mask
  });

ক্ষেত্র পরিষ্কার করা হচ্ছে

ক্ষেত্রগুলিকে উপরে দেখানো হিসাবে ফিল্ড মাস্কে যোগ করে বা খালি বা অনির্ধারিত মানের ফিল্ড সেট করে স্পষ্টভাবে সাফ করা যেতে পারে। উদাহরণ স্বরূপ, ধরে নিন আপনার একটি প্রচারাভিযান রয়েছে যা একটি MaximizeConversions বিডিং কৌশল ব্যবহার করে এবং target_cpa_micros ফিল্ডটি 0 এর বেশি মান দিয়ে সেট করা হয়েছে।

সাফল্য: নিম্নলিখিত কোড target_cpa_micros ক্ষেত্রটি সাফ করে।

# Creates a campaign with the proper resource name and a MaximizeConversions
# object with target_cpa_micros set to 0.
my $campaign =
  Google::Ads::GoogleAds::V17::Resources::Campaign->new({
    resourceName => Google::Ads::GoogleAds::V17::Utils::ResourceNames::campaign(
      $customer_id, $campaign_id
    ),
    maximizeConversions => Google::Ads::GoogleAds::V17::Resources::MaximizeConversions->new({
      targetCpaMicros => 0
    })
  });

# Constructs an operation, using the FieldMasks' all_set_fields_of utility to
# derive the update mask, which will include 'maximize_conversions.target_cpa_micros'.
my $campaign_operation =
  Google::Ads::GoogleAds::V17::Services::CampaignService::CampaignOperation->new({
    update     => $campaign,
    updateMask => all_set_fields_of($campaign)
  });

নোট করুন যে নেস্টেড সাবফিল্ড সহ ক্ষেত্রগুলি শুধুমাত্র প্রতিটি পৃথক সাবফিল্ড সাফ করে সাফ করা যেতে পারে, যেমনটি সংজ্ঞায়িত সাবফিল্ড সহ অবজেক্ট ক্ষেত্রগুলিতে প্রদর্শিত হয়েছে।