উল্লম্ব বিজ্ঞাপনের জন্য নিয়ন্ত্রণ এবং ইনভেন্টরি ফিল্টারিং

ভার্টিকাল অ্যাডগুলি AI Max for Search ক্যাম্পেইন-সক্ষম সার্চ ক্যাম্পেইনগুলির জন্য বিশেষ বৈশিষ্ট্য প্রদান করে, যা হোটেল-এর মতো কোনো ভার্টিকাল ফিডের সাথে লিঙ্কযুক্ত থাকে। আপনি অ্যাড গ্রুপ লেভেলে কোন ভার্টিকাল অ্যাড ফরম্যাটগুলি দেখানো হবে তা নিয়ন্ত্রণ করতে পারেন এবং ভার্টিকাল অ্যাড আইটেম গ্রুপ রুল ব্যবহার করে কোন ফিড এনটিটিগুলিকে টার্গেট করা হবে তাও নিয়ন্ত্রণ করতে পারেন।

সংক্ষিপ্ত বিবরণ

এই নির্দেশিকায় ভার্টিকাল বিজ্ঞাপন পরিচালনার দুটি প্রধান বৈশিষ্ট্য আলোচনা করা হয়েছে:

  1. ফরম্যাট নিয়ন্ত্রণ: অ্যাড গ্রুপ লেভেলে নির্দিষ্ট অ্যাড ফরম্যাট (টেক্সট অ্যাড, বুকিং লিঙ্ক, এবং ভার্টিকাল প্রোমোশন অ্যাড) অন্তর্ভুক্ত বা বর্জন করুন।
  2. ভার্টিকাল অ্যাড আইটেম ব্যবস্থাপনা: SharedSet এবং SharedCriterion সমন্বিত একটি নিয়ম-ভিত্তিক সিস্টেম ব্যবহার করে আপনার লিঙ্ক করা ভার্টিকাল (পূর্বে ট্র্যাভেল নামে পরিচিত) ফিড থেকে নির্দিষ্ট ইনভেন্টরি ফিল্টার ও টার্গেট করুন।

পূর্বশর্ত

এই বৈশিষ্ট্যগুলি প্রয়োগ করার আগে, নিশ্চিত করুন যে আপনার প্রচারাভিযান নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

সার্চ অ্যাডে ট্র্যাভেল ফিড (TFSA) সক্রিয় করতে এবং আপনার ক্যাম্পেইনের মধ্যে ভার্টিকাল অ্যাড কন্ট্রোল চালু করতে, আপনি নিম্নলিখিত ধাপগুলি অনুসরণ করে ক্যাম্পেইন লেভেলে আপনার ভার্টিকাল ডেটা ফিড অ্যাসেট সেট লিঙ্ক করতে পারেন। বিকল্পভাবে, আপনার অ্যাকাউন্টের সমস্ত ক্যাম্পেইনের জন্য এই ফিচারগুলি চালু করতে, আপনি 'সার্চ অ্যাডে ট্র্যাভেল ফিড' গাইডে দেওয়া কাস্টমার-লেভেল লিঙ্কিং নির্দেশাবলী অনুসরণ করে কাস্টমার লেভেলে ফিডটি লিঙ্ক করতে পারেন।

  1. একটি CampaignAssetSet অবজেক্ট তৈরি করুন, যেখানে asset_set জায়গায় আপনার ভার্টিকাল ফিড অ্যাসেট সেটের রিসোর্স নেম এবং campaign-এর জায়গায় আপনার ক্যাম্পেইনের রিসোর্স নেম সেট campaign ।
  2. CampaignAssetSetOperation তৈরি করুন এবং এর create অপশনটি CampaignAssetSet এর জন্য সেট করুন।
  3. CampaignAssetSetService.MutateCampaignAssetSets ব্যবহার করে অপারেশনটি জমা দিন।

বৃহৎ পরিসরে ট্র্যাভেল ফিড পরিচালনা করার বিষয়ে আরও বিস্তারিত জানতে, সার্চ অ্যাডের ট্র্যাভেল ফিড ডকুমেন্টেশনটি দেখুন।

বিজ্ঞাপন গ্রুপ বিন্যাস নিয়ন্ত্রণ

একটি নির্দিষ্ট অ্যাড গ্রুপের জন্য কোন ভার্টিকাল অ্যাড ফরম্যাটগুলো সক্রিয় থাকবে, তা আপনি কনফিগার করতে পারেন। এটি AdGroup রিসোর্সের vertical_ads_format_setting ( VerticalAdsFormatSetting ) ফিল্ডের মাধ্যমে পরিচালিত হয়।

উপলব্ধ ফরম্যাট

  • টেক্সট বিজ্ঞাপন ( disable_text_ads ): ডিফল্টরূপে সক্রিয় থাকে। নিষ্ক্রিয় করা যেতে পারে।
  • বুকিং লিঙ্ক ( enable_booking_links ): সম্মতি আবশ্যক।
  • ভার্টিকাল প্রোমোশন বিজ্ঞাপন ( enable_vertical_promotion_ads ): অপ্ট-ইন আবশ্যক।

বৈধতার নিয়মাবলী

  • আপনি একটিমাত্র অ্যাড গ্রুপের জন্য একই সাথে তিনটি ফরম্যাট থেকেই অপ্ট-আউট করতে পারবেন না।
  • এই সেটিংসগুলো শুধুমাত্র SEARCH_STANDARD এবং SEARCH_DYNAMIC_ADS অ্যাড গ্রুপ টাইপগুলোর জন্য প্রযোজ্য।

উদাহরণ: ফরম্যাট সেটিংস আপডেট করুন

নিম্নলিখিত জাভা উদাহরণটি দেখায় কিভাবে একটি বিদ্যমান বিজ্ঞাপন গ্রুপের জন্য টেক্সট বিজ্ঞাপন নিষ্ক্রিয় করতে এবং উল্লম্ব প্রচারমূলক বিজ্ঞাপন সক্রিয় করতে হয়:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

উল্লম্ব বিজ্ঞাপন আইটেম ব্যবস্থাপনা

আপনার ফিড ইনভেন্টরির একটি নির্দিষ্ট উপসেটকে টার্গেট করতে, যেমন 'বস্টনের হোটেলসমূহ' বা '১-তারা হোটেল বাদ দিন', আপনাকে অবশ্যই ভার্টিকাল অ্যাডস আইটেম গ্রুপ রুলস ব্যবহার করতে হবে।

ডেটা মডেল কীভাবে কাজ করে

ডেটা মডেলটি একটি সাধারণ মানদণ্ড পদ্ধতি ব্যবহার করে:

  1. SharedSet : VERTICAL_ADS_ITEM_GROUP_RULE_LIST টাইপের একটি SharedSet তৈরি করুন।
  2. SharedCriterion : এই সেটে নিয়ম (ক্রাইটেরিয়া) যোগ করুন। প্রতিটি নিয়ম একটি ডাইমেনশন (যেমন সিটি বা হোটেল ক্লাস) এবং একটি ভ্যালু নির্দিষ্ট করে। আইটেম বাদ দেওয়ার জন্য আপনি নেগেটিভ ক্রাইটেরিয়াও তৈরি করতে পারেন।
  3. AdGroupCriterion : একটি AdGroupCriterion ( vertical_ads_item_group_rule_list ) ব্যবহার করে SharedSet আপনার AdGroup এর সাথে লিঙ্ক করুন।

সমর্থিত মাত্রা

আপনি SharedCriterion ( VerticalAdsItemGroupRuleInfo )-এর নিম্নলিখিত ডাইমেনশনগুলোর উপর ভিত্তি করে এনটিটিগুলো ফিল্টার করতে পারেন:

  • item_code : নির্দিষ্ট লিস্টিং আইডি।
  • city_criterion_id , region_criterion_id , country_criterion_id : জিও টার্গেট কনস্ট্যান্ট রিসোর্সের নাম ( geoTargetConstants/{id} )।
  • hotel_class : তারকা রেটিং (১-৫)।
  • user_rating , venue , event_participant_display_name ( v24 থেকে শুরু): ইভেন্ট এবং ভার্টিকাল লিস্টিংয়ের রেটিং, ভেন্যু এবং অংশগ্রহণকারীর নাম ফিল্টার।

এই পাইথন উদাহরণটি 'বোস্টন' বা 'সান ফ্রান্সিসকো'-তে থাকা আইটেমগুলিকে অন্তর্ভুক্ত করার এবং '১-তারা' ও '২-তারা' হোটেলগুলিকে বাদ দেওয়ার জন্য একটি নিয়ম তৈরি করে:

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

কর্মক্ষমতা প্রতিবেদন

আপনি GoogleAdsService.SearchStream অথবা GoogleAdsService.Search মেথড ব্যবহার করে ভার্টিকাল অ্যাডের পারফরম্যান্স মেট্রিক্স পেতে পারেন।

উল্লম্ব বিজ্ঞাপন বিভাগ

  • segments.vertical_ads_hotel_class : একটি হোটেল তালিকার শ্রেণী রেটিং নির্দিষ্ট করার জন্য পূর্ণসংখ্যা মান (১ থেকে ৫ তারকা)।
  • segments.vertical_ads_listing : একটি নির্দিষ্ট উল্লম্ব বিজ্ঞাপন তালিকার শনাক্তকারী।
  • segments.vertical_ads_listing_brand : একটি ভার্টিকাল বিজ্ঞাপন তালিকার সাথে যুক্ত ব্র্যান্ড।
  • segments.vertical_ads_listing_city : লিস্টিংটির সাথে সংশ্লিষ্ট শহর।
  • segments.vertical_ads_listing_country : লিস্টিংটির সাথে সংশ্লিষ্ট দেশ।
  • segments.vertical_ads_listing_region : লিস্টিংটির সাথে সংশ্লিষ্ট অঞ্চল।
  • segments.vertical_ads_partner_account : একটি পার্টনার সেন্টারের (যেমন, হোটেল সেন্টার) অন্তর্গত সেই পার্টনার অ্যাকাউন্ট, যা ইনভেন্টরি ফিড ডেটা সরবরাহ করে।
  • segments.vertical_ads_vertical : উল্লম্ব ধরণ, যেমন হোটেল বা ভাড়ার গাড়ি।
  • segments.vertical_ads_event_participant_display_names ( v24 থেকে শুরু): একটি ইভেন্ট তালিকায় অংশগ্রহণকারীদের প্রদর্শিত নাম, যেমন পারফর্মার, স্পিকার বা টিম।
  • segments.vertical_ads_listing_user_rating ( v24 থেকে শুরু): একটি পূর্ণসংখ্যা (১ থেকে ৫) যা ভার্টিকাল অ্যাডস লিস্টিং-এর ব্যবহারকারী রেটিং নির্দিষ্ট করে।
  • segments.vertical_ads_listing_venue ( v24 থেকে শুরু): ভার্টিকাল অ্যাডস লিস্টিং-এর জন্য ভেন্যুর নাম (উদাহরণস্বরূপ, একটি কনসার্টের ভেন্যু)।
  • segments.vertical_ads_price_tier ( v25 থেকে শুরু): হোটেল তালিকার জন্য আপেক্ষিক মূল্য প্রতিযোগিতার স্তর।
  • segments.vertical_ads_rate_rule_id ( v25 থেকে শুরু): বিড বা ইম্প্রেশনে প্রয়োগ করা ব্যক্তিগত বা শর্তসাপেক্ষ রেট নিয়মের সাথে সম্পর্কিত স্ট্রিং শনাক্তকারী।
  • segments.vertical_ads_rate_type ( v25 থেকে শুরু): পাবলিক, প্রাইভেট, বা কন্ডিশনাল রেট টাইপের শ্রেণিবিন্যাস।

ভ্রমণপথের মাত্রা অংশ

v25 থেকে শুরু করে, ভ্রমণ এবং আবাসন ফিডের সাথে লিঙ্কযুক্ত ভার্টিকাল বিজ্ঞাপনগুলির জন্য, আপনি ভ্রমণপথের ডাইমেনশন ব্যবহার করে পারফরম্যান্স রিপোর্টগুলিকে ভাগ করতে পারবেন:

  • segments.advance_booking_window : ভ্রমণসূচীটির জন্য অগ্রিম বুকিং করার সময়সীমা (দিনে)।
  • segments.length_of_booking : ভ্রমণসূচীটির বুকিংয়ের মেয়াদ (দিনে)।
  • segments.start_date : বুকিং শুরুর তারিখ, যা yyyy-MM-dd ফরম্যাটে থাকবে।
  • segments.start_day_of_week : বুকিং শুরু হওয়ার সপ্তাহের দিন।
  • segments.user_set_dates : ব্যবহারকারী-নির্দিষ্ট তারিখ নির্বাচন করা হয়েছে কিনা তা নির্দেশ করে ( USER_SELECTED অথবা DEFAULT_SELECTION )।

উল্লম্ব বিজ্ঞাপন মেট্রিক্স

v25 থেকে শুরু করে, আপনি নিম্নলিখিত ভার্টিকাল অ্যাডস মেট্রিকগুলি পেতে পারেন:

  • metrics.vertical_ads_potential_impressions : সম্ভাব্য ইম্প্রেশন, যা কোয়েরি কনটেক্সট জুড়ে উপলব্ধ মোট ভিউ-ক্যাপড যোগ্য ইম্প্রেশনকে প্রতিনিধিত্ব করে।
  • metrics.vertical_ads_average_booking_value_micros : মোট অবস্থানকালের জন্য, ট্যাক্স এবং ফি সহ, ক্লিকের উপর ভিত্তি করে নির্ধারিত গড় দৈনিক রেট (মাইক্রো এককে)।
  • metrics.vertical_ads_price_difference_percentage : একই সম্পত্তির জন্য বিজ্ঞাপনদাতার প্রস্তাবিত মূল্য এবং সর্বনিম্ন প্রতিযোগী মূল্যের মধ্যে শতাংশ পার্থক্য।

নমুনা GAQL কোয়েরি 

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

ত্রুটি পরিচালনা

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

ত্রুটি কোড কারণ সুপারিশকৃত পদক্ষেপ
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING তিনটি বিজ্ঞাপন ফরম্যাটই (টেক্সট, বুকিং লিঙ্ক, প্রচারমূলক বিজ্ঞাপন) একই সাথে নিষ্ক্রিয় করা হয়েছিল। VerticalAdsFormatSetting এ অন্তত একটি ফরম্যাট সক্রিয় আছে কিনা তা নিশ্চিত করুন।
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX এই ক্যাম্পেইনটিতে AI Max for Search campaigns সক্রিয় করা নেই। ক্যাম্পেইন সেটিংসে সার্চ ক্যাম্পেইনের জন্য এআই ম্যাক্স (AI Max) সক্রিয় করুন।
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED ক্যাম্পেইনটিতে একটি সক্রিয় ভার্টিকাল ডেটা ফিডের অভাব রয়েছে। গ্রাহক বা ক্যাম্পেইন পর্যায়ে একটি বৈধ ভার্টিকাল ফিড লিঙ্ক করা আছে কিনা তা নিশ্চিত করুন।
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST AdGroupCriterion এ প্রদত্ত SharedSet রিসোর্স নামটি বিদ্যমান নেই। shared_set রিসোর্স নামটি তৈরি করা সেটের সাথে মেলে কিনা তা যাচাই করুন।
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE ব্যবহৃত মানদণ্ডের মাত্রাটি নির্দিষ্ট ক্ষেত্রটির জন্য সমর্থিত নয়, যেমন গাড়ি ভাড়ার ক্ষেত্রে হোটেলের শ্রেণি। vertical_ads_item_group_rule এর ডাইমেনশন আপনার vertical type-এর সাথে মেলে কিনা তা যাচাই করুন।
,

ভার্টিকাল অ্যাডগুলি AI Max for Search ক্যাম্পেইন-সক্ষম সার্চ ক্যাম্পেইনগুলির জন্য বিশেষ বৈশিষ্ট্য প্রদান করে, যা হোটেল-এর মতো কোনো ভার্টিকাল ফিডের সাথে লিঙ্কযুক্ত থাকে। আপনি অ্যাড গ্রুপ লেভেলে কোন ভার্টিকাল অ্যাড ফরম্যাটগুলি দেখানো হবে তা নিয়ন্ত্রণ করতে পারেন এবং ভার্টিকাল অ্যাড আইটেম গ্রুপ রুল ব্যবহার করে কোন ফিড এনটিটিগুলিকে টার্গেট করা হবে তাও নিয়ন্ত্রণ করতে পারেন।

সংক্ষিপ্ত বিবরণ

এই নির্দেশিকায় ভার্টিকাল বিজ্ঞাপন পরিচালনার দুটি প্রধান বৈশিষ্ট্য আলোচনা করা হয়েছে:

  1. ফরম্যাট নিয়ন্ত্রণ: অ্যাড গ্রুপ লেভেলে নির্দিষ্ট অ্যাড ফরম্যাট (টেক্সট অ্যাড, বুকিং লিঙ্ক, এবং ভার্টিকাল প্রোমোশন অ্যাড) অন্তর্ভুক্ত বা বর্জন করুন।
  2. ভার্টিকাল অ্যাড আইটেম ব্যবস্থাপনা: SharedSet এবং SharedCriterion সমন্বিত একটি নিয়ম-ভিত্তিক সিস্টেম ব্যবহার করে আপনার লিঙ্ক করা ভার্টিকাল (পূর্বে ট্র্যাভেল নামে পরিচিত) ফিড থেকে নির্দিষ্ট ইনভেন্টরি ফিল্টার ও টার্গেট করুন।

পূর্বশর্ত

এই বৈশিষ্ট্যগুলি প্রয়োগ করার আগে, নিশ্চিত করুন যে আপনার প্রচারাভিযান নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

সার্চ অ্যাডে ট্র্যাভেল ফিড (TFSA) সক্রিয় করতে এবং আপনার ক্যাম্পেইনের মধ্যে ভার্টিকাল অ্যাড কন্ট্রোল চালু করতে, আপনি নিম্নলিখিত ধাপগুলি অনুসরণ করে ক্যাম্পেইন লেভেলে আপনার ভার্টিকাল ডেটা ফিড অ্যাসেট সেট লিঙ্ক করতে পারেন। বিকল্পভাবে, আপনার অ্যাকাউন্টের সমস্ত ক্যাম্পেইনের জন্য এই ফিচারগুলি চালু করতে, আপনি 'সার্চ অ্যাডে ট্র্যাভেল ফিড' গাইডে দেওয়া কাস্টমার-লেভেল লিঙ্কিং নির্দেশাবলী অনুসরণ করে কাস্টমার লেভেলে ফিডটি লিঙ্ক করতে পারেন।

  1. একটি CampaignAssetSet অবজেক্ট তৈরি করুন, যেখানে asset_set জায়গায় আপনার ভার্টিকাল ফিড অ্যাসেট সেটের রিসোর্স নেম এবং campaign-এর জায়গায় আপনার ক্যাম্পেইনের রিসোর্স নেম সেট campaign ।
  2. CampaignAssetSetOperation তৈরি করুন এবং এর create অপশনটি CampaignAssetSet এর জন্য সেট করুন।
  3. CampaignAssetSetService.MutateCampaignAssetSets ব্যবহার করে অপারেশনটি জমা দিন।

বৃহৎ পরিসরে ট্র্যাভেল ফিড পরিচালনা করার বিষয়ে আরও বিস্তারিত জানতে, সার্চ অ্যাডের ট্র্যাভেল ফিড ডকুমেন্টেশনটি দেখুন।

বিজ্ঞাপন গ্রুপ বিন্যাস নিয়ন্ত্রণ

একটি নির্দিষ্ট অ্যাড গ্রুপের জন্য কোন ভার্টিকাল অ্যাড ফরম্যাটগুলো সক্রিয় থাকবে, তা আপনি কনফিগার করতে পারেন। এটি AdGroup রিসোর্সের vertical_ads_format_setting ( VerticalAdsFormatSetting ) ফিল্ডের মাধ্যমে পরিচালিত হয়।

উপলব্ধ ফরম্যাট

  • টেক্সট বিজ্ঞাপন ( disable_text_ads ): ডিফল্টরূপে সক্রিয় থাকে। নিষ্ক্রিয় করা যেতে পারে।
  • বুকিং লিঙ্ক ( enable_booking_links ): সম্মতি আবশ্যক।
  • ভার্টিকাল প্রোমোশন বিজ্ঞাপন ( enable_vertical_promotion_ads ): অপ্ট-ইন আবশ্যক।

বৈধতার নিয়মাবলী

  • আপনি একটিমাত্র অ্যাড গ্রুপের জন্য একই সাথে তিনটি ফরম্যাট থেকেই অপ্ট-আউট করতে পারবেন না।
  • এই সেটিংসগুলো শুধুমাত্র SEARCH_STANDARD এবং SEARCH_DYNAMIC_ADS অ্যাড গ্রুপ টাইপগুলোর জন্য প্রযোজ্য।

উদাহরণ: ফরম্যাট সেটিংস আপডেট করুন

নিম্নলিখিত জাভা উদাহরণটি দেখায় কিভাবে একটি বিদ্যমান বিজ্ঞাপন গ্রুপের জন্য টেক্সট বিজ্ঞাপন নিষ্ক্রিয় করতে এবং উল্লম্ব প্রচারমূলক বিজ্ঞাপন সক্রিয় করতে হয়:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

উল্লম্ব বিজ্ঞাপন আইটেম ব্যবস্থাপনা

আপনার ফিড ইনভেন্টরির একটি নির্দিষ্ট উপসেটকে টার্গেট করতে, যেমন 'বস্টনের হোটেলসমূহ' বা '১-তারা হোটেল বাদ দিন', আপনাকে অবশ্যই ভার্টিকাল অ্যাডস আইটেম গ্রুপ রুলস ব্যবহার করতে হবে।

ডেটা মডেল কীভাবে কাজ করে

ডেটা মডেলটি একটি সাধারণ মানদণ্ড পদ্ধতি ব্যবহার করে:

  1. SharedSet : VERTICAL_ADS_ITEM_GROUP_RULE_LIST টাইপের একটি SharedSet তৈরি করুন।
  2. SharedCriterion : এই সেটে নিয়ম (ক্রাইটেরিয়া) যোগ করুন। প্রতিটি নিয়ম একটি ডাইমেনশন (যেমন সিটি বা হোটেল ক্লাস) এবং একটি ভ্যালু নির্দিষ্ট করে। আইটেম বাদ দেওয়ার জন্য আপনি নেগেটিভ ক্রাইটেরিয়াও তৈরি করতে পারেন।
  3. AdGroupCriterion : একটি AdGroupCriterion ( vertical_ads_item_group_rule_list ) ব্যবহার করে SharedSet আপনার AdGroup এর সাথে লিঙ্ক করুন।

সমর্থিত মাত্রা

আপনি SharedCriterion ( VerticalAdsItemGroupRuleInfo )-এর নিম্নলিখিত ডাইমেনশনগুলোর উপর ভিত্তি করে এনটিটিগুলো ফিল্টার করতে পারেন:

  • item_code : নির্দিষ্ট লিস্টিং আইডি।
  • city_criterion_id , region_criterion_id , country_criterion_id : জিও টার্গেট কনস্ট্যান্ট রিসোর্সের নাম ( geoTargetConstants/{id} )।
  • hotel_class : তারকা রেটিং (১-৫)।
  • user_rating , venue , event_participant_display_name ( v24 থেকে শুরু): ইভেন্ট এবং ভার্টিকাল লিস্টিংয়ের রেটিং, ভেন্যু এবং অংশগ্রহণকারীর নাম ফিল্টার।

এই পাইথন উদাহরণটি 'বোস্টন' বা 'সান ফ্রান্সিসকো'-তে থাকা আইটেমগুলিকে অন্তর্ভুক্ত করার এবং '১-তারা' ও '২-তারা' হোটেলগুলিকে বাদ দেওয়ার জন্য একটি নিয়ম তৈরি করে:

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

কর্মক্ষমতা প্রতিবেদন

আপনি GoogleAdsService.SearchStream অথবা GoogleAdsService.Search মেথড ব্যবহার করে ভার্টিকাল অ্যাডের পারফরম্যান্স মেট্রিক্স পেতে পারেন।

উল্লম্ব বিজ্ঞাপন বিভাগ

  • segments.vertical_ads_hotel_class : একটি হোটেল তালিকার শ্রেণী রেটিং নির্দিষ্ট করার জন্য পূর্ণসংখ্যা মান (১ থেকে ৫ তারকা)।
  • segments.vertical_ads_listing : একটি নির্দিষ্ট উল্লম্ব বিজ্ঞাপন তালিকার শনাক্তকারী।
  • segments.vertical_ads_listing_brand : একটি ভার্টিকাল বিজ্ঞাপন তালিকার সাথে যুক্ত ব্র্যান্ড।
  • segments.vertical_ads_listing_city : লিস্টিংটির সাথে সংশ্লিষ্ট শহর।
  • segments.vertical_ads_listing_country : লিস্টিংটির সাথে সংশ্লিষ্ট দেশ।
  • segments.vertical_ads_listing_region : লিস্টিংটির সাথে সংশ্লিষ্ট অঞ্চল।
  • segments.vertical_ads_partner_account : একটি পার্টনার সেন্টারের (যেমন, হোটেল সেন্টার) অন্তর্গত সেই পার্টনার অ্যাকাউন্ট, যা ইনভেন্টরি ফিড ডেটা সরবরাহ করে।
  • segments.vertical_ads_vertical : উল্লম্ব ধরণ, যেমন হোটেল বা ভাড়ার গাড়ি।
  • segments.vertical_ads_event_participant_display_names ( v24 থেকে শুরু): একটি ইভেন্ট তালিকায় অংশগ্রহণকারীদের প্রদর্শিত নাম, যেমন পারফর্মার, স্পিকার বা টিম।
  • segments.vertical_ads_listing_user_rating ( v24 থেকে শুরু): একটি পূর্ণসংখ্যা (১ থেকে ৫) যা ভার্টিকাল অ্যাডস লিস্টিং-এর ব্যবহারকারী রেটিং নির্দিষ্ট করে।
  • segments.vertical_ads_listing_venue ( v24 থেকে শুরু): ভার্টিকাল অ্যাডস লিস্টিং-এর জন্য ভেন্যুর নাম (উদাহরণস্বরূপ, একটি কনসার্টের ভেন্যু)।
  • segments.vertical_ads_price_tier ( v25 থেকে শুরু): হোটেল তালিকার জন্য আপেক্ষিক মূল্য প্রতিযোগিতার স্তর।
  • segments.vertical_ads_rate_rule_id ( v25 থেকে শুরু): বিড বা ইম্প্রেশনে প্রয়োগ করা ব্যক্তিগত বা শর্তসাপেক্ষ রেট নিয়মের সাথে সম্পর্কিত স্ট্রিং শনাক্তকারী।
  • segments.vertical_ads_rate_type ( v25 থেকে শুরু): পাবলিক, প্রাইভেট, বা কন্ডিশনাল রেট টাইপের শ্রেণিবিন্যাস।

ভ্রমণপথের মাত্রা অংশ

v25 থেকে শুরু করে, ভ্রমণ এবং আবাসন ফিডের সাথে লিঙ্কযুক্ত ভার্টিকাল বিজ্ঞাপনগুলির জন্য, আপনি ভ্রমণপথের ডাইমেনশন ব্যবহার করে পারফরম্যান্স রিপোর্টগুলিকে ভাগ করতে পারবেন:

  • segments.advance_booking_window : ভ্রমণসূচীটির জন্য অগ্রিম বুকিং করার সময়সীমা (দিনে)।
  • segments.length_of_booking : ভ্রমণসূচীটির বুকিংয়ের মেয়াদ (দিনে)।
  • segments.start_date : বুকিং শুরুর তারিখ, যা yyyy-MM-dd ফরম্যাটে থাকবে।
  • segments.start_day_of_week : বুকিং শুরু হওয়ার সপ্তাহের দিন।
  • segments.user_set_dates : ব্যবহারকারী-নির্দিষ্ট তারিখ নির্বাচন করা হয়েছে কিনা তা নির্দেশ করে ( USER_SELECTED অথবা DEFAULT_SELECTION )।

উল্লম্ব বিজ্ঞাপন মেট্রিক্স

v25 থেকে শুরু করে, আপনি নিম্নলিখিত ভার্টিকাল অ্যাডস মেট্রিকগুলি পেতে পারেন:

  • metrics.vertical_ads_potential_impressions : সম্ভাব্য ইম্প্রেশন, যা কোয়েরি কনটেক্সট জুড়ে উপলব্ধ মোট ভিউ-ক্যাপড যোগ্য ইম্প্রেশনকে প্রতিনিধিত্ব করে।
  • metrics.vertical_ads_average_booking_value_micros : মোট অবস্থানকালের জন্য, ট্যাক্স এবং ফি সহ, ক্লিকের উপর ভিত্তি করে নির্ধারিত গড় দৈনিক রেট (মাইক্রো এককে)।
  • metrics.vertical_ads_price_difference_percentage : একই সম্পত্তির জন্য বিজ্ঞাপনদাতার প্রস্তাবিত মূল্য এবং সর্বনিম্ন প্রতিযোগী মূল্যের মধ্যে শতাংশ পার্থক্য।

নমুনা GAQL কোয়েরি 

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

ত্রুটি পরিচালনা

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

ত্রুটি কোড কারণ সুপারিশকৃত পদক্ষেপ
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING তিনটি বিজ্ঞাপন ফরম্যাটই (টেক্সট, বুকিং লিঙ্ক, প্রচারমূলক বিজ্ঞাপন) একই সাথে নিষ্ক্রিয় করা হয়েছিল। VerticalAdsFormatSetting এ অন্তত একটি ফরম্যাট সক্রিয় আছে কিনা তা নিশ্চিত করুন।
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX এই ক্যাম্পেইনটিতে AI Max for Search campaigns সক্রিয় করা নেই। ক্যাম্পেইন সেটিংসে সার্চ ক্যাম্পেইনের জন্য এআই ম্যাক্স (AI Max) সক্রিয় করুন।
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED ক্যাম্পেইনটিতে একটি সক্রিয় ভার্টিকাল ডেটা ফিডের অভাব রয়েছে। গ্রাহক বা ক্যাম্পেইন পর্যায়ে একটি বৈধ ভার্টিকাল ফিড লিঙ্ক করা আছে কিনা তা নিশ্চিত করুন।
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST AdGroupCriterion এ প্রদত্ত SharedSet রিসোর্স নামটি বিদ্যমান নেই। shared_set রিসোর্স নামটি তৈরি করা সেটের সাথে মেলে কিনা তা যাচাই করুন।
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE ব্যবহৃত মানদণ্ডের মাত্রাটি নির্দিষ্ট ক্ষেত্রটির জন্য সমর্থিত নয়, যেমন গাড়ি ভাড়ার ক্ষেত্রে হোটেলের শ্রেণি। vertical_ads_item_group_rule এর ডাইমেনশন আপনার vertical type-এর সাথে মেলে কিনা তা যাচাই করুন।
,

ভার্টিকাল অ্যাডগুলি AI Max for Search ক্যাম্পেইন-সক্ষম সার্চ ক্যাম্পেইনগুলির জন্য বিশেষ বৈশিষ্ট্য প্রদান করে, যা হোটেল-এর মতো কোনো ভার্টিকাল ফিডের সাথে লিঙ্কযুক্ত থাকে। আপনি অ্যাড গ্রুপ লেভেলে কোন ভার্টিকাল অ্যাড ফরম্যাটগুলি দেখানো হবে তা নিয়ন্ত্রণ করতে পারেন এবং ভার্টিকাল অ্যাড আইটেম গ্রুপ রুল ব্যবহার করে কোন ফিড এনটিটিগুলিকে টার্গেট করা হবে তাও নিয়ন্ত্রণ করতে পারেন।

সংক্ষিপ্ত বিবরণ

এই নির্দেশিকায় ভার্টিকাল বিজ্ঞাপন পরিচালনার দুটি প্রধান বৈশিষ্ট্য আলোচনা করা হয়েছে:

  1. ফরম্যাট নিয়ন্ত্রণ: অ্যাড গ্রুপ লেভেলে নির্দিষ্ট অ্যাড ফরম্যাট (টেক্সট অ্যাড, বুকিং লিঙ্ক, এবং ভার্টিকাল প্রোমোশন অ্যাড) অন্তর্ভুক্ত বা বর্জন করুন।
  2. ভার্টিকাল অ্যাড আইটেম ব্যবস্থাপনা: SharedSet এবং SharedCriterion সমন্বিত একটি নিয়ম-ভিত্তিক সিস্টেম ব্যবহার করে আপনার লিঙ্ক করা ভার্টিকাল (পূর্বে ট্র্যাভেল নামে পরিচিত) ফিড থেকে নির্দিষ্ট ইনভেন্টরি ফিল্টার ও টার্গেট করুন।

পূর্বশর্ত

এই বৈশিষ্ট্যগুলি প্রয়োগ করার আগে, নিশ্চিত করুন যে আপনার প্রচারাভিযান নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

সার্চ অ্যাডে ট্র্যাভেল ফিড (TFSA) সক্রিয় করতে এবং আপনার ক্যাম্পেইনের মধ্যে ভার্টিকাল অ্যাড কন্ট্রোল চালু করতে, আপনি নিম্নলিখিত ধাপগুলি অনুসরণ করে ক্যাম্পেইন লেভেলে আপনার ভার্টিকাল ডেটা ফিড অ্যাসেট সেট লিঙ্ক করতে পারেন। বিকল্পভাবে, আপনার অ্যাকাউন্টের সমস্ত ক্যাম্পেইনের জন্য এই ফিচারগুলি চালু করতে, আপনি 'সার্চ অ্যাডে ট্র্যাভেল ফিড' গাইডে দেওয়া কাস্টমার-লেভেল লিঙ্কিং নির্দেশাবলী অনুসরণ করে কাস্টমার লেভেলে ফিডটি লিঙ্ক করতে পারেন।

  1. একটি CampaignAssetSet অবজেক্ট তৈরি করুন, যেখানে asset_set জায়গায় আপনার ভার্টিকাল ফিড অ্যাসেট সেটের রিসোর্স নেম এবং campaign-এর জায়গায় আপনার ক্যাম্পেইনের রিসোর্স নেম সেট campaign ।
  2. CampaignAssetSetOperation তৈরি করুন এবং এর create অপশনটি CampaignAssetSet এর জন্য সেট করুন।
  3. CampaignAssetSetService.MutateCampaignAssetSets ব্যবহার করে অপারেশনটি জমা দিন।

বৃহৎ পরিসরে ট্র্যাভেল ফিড পরিচালনা করার বিষয়ে আরও বিস্তারিত জানতে, সার্চ অ্যাডের ট্র্যাভেল ফিড ডকুমেন্টেশনটি দেখুন।

বিজ্ঞাপন গ্রুপ বিন্যাস নিয়ন্ত্রণ

একটি নির্দিষ্ট অ্যাড গ্রুপের জন্য কোন ভার্টিকাল অ্যাড ফরম্যাটগুলো সক্রিয় থাকবে, তা আপনি কনফিগার করতে পারেন। এটি AdGroup রিসোর্সের vertical_ads_format_setting ( VerticalAdsFormatSetting ) ফিল্ডের মাধ্যমে পরিচালিত হয়।

উপলব্ধ ফরম্যাট

  • টেক্সট বিজ্ঞাপন ( disable_text_ads ): ডিফল্টরূপে সক্রিয় থাকে। নিষ্ক্রিয় করা যেতে পারে।
  • বুকিং লিঙ্ক ( enable_booking_links ): সম্মতি আবশ্যক।
  • ভার্টিকাল প্রোমোশন বিজ্ঞাপন ( enable_vertical_promotion_ads ): অপ্ট-ইন আবশ্যক।

বৈধতার নিয়মাবলী

  • আপনি একটিমাত্র অ্যাড গ্রুপের জন্য একই সাথে তিনটি ফরম্যাট থেকেই অপ্ট-আউট করতে পারবেন না।
  • এই সেটিংসগুলো শুধুমাত্র SEARCH_STANDARD এবং SEARCH_DYNAMIC_ADS অ্যাড গ্রুপ টাইপগুলোর জন্য প্রযোজ্য।

উদাহরণ: ফরম্যাট সেটিংস আপডেট করুন

নিম্নলিখিত জাভা উদাহরণটি দেখায় কিভাবে একটি বিদ্যমান বিজ্ঞাপন গ্রুপের জন্য টেক্সট বিজ্ঞাপন নিষ্ক্রিয় করতে এবং উল্লম্ব প্রচারমূলক বিজ্ঞাপন সক্রিয় করতে হয়:

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .setVerticalAdsFormatSetting(
        VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

উল্লম্ব বিজ্ঞাপন আইটেম ব্যবস্থাপনা

আপনার ফিড ইনভেন্টরির একটি নির্দিষ্ট উপসেটকে টার্গেট করতে, যেমন 'বস্টনের হোটেলসমূহ' বা '১-তারা হোটেল বাদ দিন', আপনাকে অবশ্যই ভার্টিকাল অ্যাডস আইটেম গ্রুপ রুলস ব্যবহার করতে হবে।

ডেটা মডেল কীভাবে কাজ করে

ডেটা মডেলটি একটি সাধারণ মানদণ্ড পদ্ধতি ব্যবহার করে:

  1. SharedSet : VERTICAL_ADS_ITEM_GROUP_RULE_LIST টাইপের একটি SharedSet তৈরি করুন।
  2. SharedCriterion : এই সেটে নিয়ম (ক্রাইটেরিয়া) যোগ করুন। প্রতিটি নিয়ম একটি ডাইমেনশন (যেমন সিটি বা হোটেল ক্লাস) এবং একটি ভ্যালু নির্দিষ্ট করে। আইটেম বাদ দেওয়ার জন্য আপনি নেগেটিভ ক্রাইটেরিয়াও তৈরি করতে পারেন।
  3. AdGroupCriterion : একটি AdGroupCriterion ( vertical_ads_item_group_rule_list ) ব্যবহার করে SharedSet আপনার AdGroup এর সাথে লিঙ্ক করুন।

সমর্থিত মাত্রা

আপনি SharedCriterion ( VerticalAdsItemGroupRuleInfo )-এর নিম্নলিখিত ডাইমেনশনগুলোর উপর ভিত্তি করে এনটিটিগুলো ফিল্টার করতে পারেন:

  • item_code : নির্দিষ্ট লিস্টিং আইডি।
  • city_criterion_id , region_criterion_id , country_criterion_id : জিও টার্গেট কনস্ট্যান্ট রিসোর্সের নাম ( geoTargetConstants/{id} )।
  • hotel_class : তারকা রেটিং (১-৫)।
  • user_rating , venue , event_participant_display_name ( v24 থেকে শুরু): ইভেন্ট এবং ভার্টিকাল লিস্টিংয়ের রেটিং, ভেন্যু এবং অংশগ্রহণকারীর নাম ফিল্টার।

এই পাইথন উদাহরণটি 'বোস্টন' বা 'সান ফ্রান্সিসকো'-তে থাকা আইটেমগুলিকে অন্তর্ভুক্ত করার এবং '১-তারা' ও '২-তারা' হোটেলগুলিকে বাদ দেওয়ার জন্য একটি নিয়ম তৈরি করে:

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = (
    client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
)
shared_set.vertical_ads_item_vertical_type = (
    client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
included_city_ids = [1006543, 1014221]  # Geo Target Constant IDs
for city_id in included_city_ids:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.city_criterion_id = (
      geo_target_constant_service.geo_target_constant_path(city_id)
  )
  shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
  op = client.get_type("SharedCriterionOperation")
  criterion = op.create
  criterion.shared_set = shared_set_resource_name
  criterion.vertical_ads_item_group_rule.hotel_class = star_rating
  criterion.negative = True  # Mark as exclusion
  shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

কর্মক্ষমতা প্রতিবেদন

আপনি GoogleAdsService.SearchStream অথবা GoogleAdsService.Search মেথড ব্যবহার করে ভার্টিকাল অ্যাডের পারফরম্যান্স মেট্রিক্স পেতে পারেন।

উল্লম্ব বিজ্ঞাপন বিভাগ

  • segments.vertical_ads_hotel_class : একটি হোটেল তালিকার শ্রেণী রেটিং নির্দিষ্ট করার জন্য পূর্ণসংখ্যা মান (১ থেকে ৫ তারকা)।
  • segments.vertical_ads_listing : একটি নির্দিষ্ট উল্লম্ব বিজ্ঞাপন তালিকার শনাক্তকারী।
  • segments.vertical_ads_listing_brand : একটি ভার্টিকাল বিজ্ঞাপন তালিকার সাথে যুক্ত ব্র্যান্ড।
  • segments.vertical_ads_listing_city : লিস্টিংটির সাথে সংশ্লিষ্ট শহর।
  • segments.vertical_ads_listing_country : লিস্টিংটির সাথে সংশ্লিষ্ট দেশ।
  • segments.vertical_ads_listing_region : লিস্টিংটির সাথে সংশ্লিষ্ট অঞ্চল।
  • segments.vertical_ads_partner_account : একটি পার্টনার সেন্টারের (যেমন, হোটেল সেন্টার) অন্তর্গত সেই পার্টনার অ্যাকাউন্ট, যা ইনভেন্টরি ফিড ডেটা সরবরাহ করে।
  • segments.vertical_ads_vertical : উল্লম্ব ধরণ, যেমন হোটেল বা ভাড়ার গাড়ি।
  • segments.vertical_ads_event_participant_display_names ( v24 থেকে শুরু): একটি ইভেন্ট তালিকায় অংশগ্রহণকারীদের প্রদর্শিত নাম, যেমন পারফর্মার, স্পিকার বা টিম।
  • segments.vertical_ads_listing_user_rating ( v24 থেকে শুরু): একটি পূর্ণসংখ্যা (১ থেকে ৫) যা ভার্টিকাল অ্যাডস লিস্টিং-এর ব্যবহারকারী রেটিং নির্দিষ্ট করে।
  • segments.vertical_ads_listing_venue ( v24 থেকে শুরু): ভার্টিকাল অ্যাডস লিস্টিং-এর জন্য ভেন্যুর নাম (উদাহরণস্বরূপ, একটি কনসার্টের ভেন্যু)।
  • segments.vertical_ads_price_tier ( v25 থেকে শুরু): হোটেল তালিকার জন্য আপেক্ষিক মূল্য প্রতিযোগিতার স্তর।
  • segments.vertical_ads_rate_rule_id ( v25 থেকে শুরু): বিড বা ইম্প্রেশনে প্রয়োগ করা ব্যক্তিগত বা শর্তসাপেক্ষ রেট নিয়মের সাথে সম্পর্কিত স্ট্রিং শনাক্তকারী।
  • segments.vertical_ads_rate_type ( v25 থেকে শুরু): পাবলিক, প্রাইভেট, বা কন্ডিশনাল রেট টাইপের শ্রেণিবিন্যাস।

ভ্রমণপথের মাত্রা অংশ

v25 থেকে শুরু করে, ভ্রমণ এবং আবাসন ফিডের সাথে লিঙ্কযুক্ত ভার্টিকাল বিজ্ঞাপনগুলির জন্য, আপনি ভ্রমণপথের ডাইমেনশন ব্যবহার করে পারফরম্যান্স রিপোর্টগুলিকে ভাগ করতে পারবেন:

  • segments.advance_booking_window : ভ্রমণসূচীটির জন্য অগ্রিম বুকিং করার সময়সীমা (দিনে)।
  • segments.length_of_booking : ভ্রমণসূচীটির বুকিংয়ের মেয়াদ (দিনে)।
  • segments.start_date : বুকিং শুরুর তারিখ, যা yyyy-MM-dd ফরম্যাটে থাকবে।
  • segments.start_day_of_week : বুকিং শুরু হওয়ার সপ্তাহের দিন।
  • segments.user_set_dates : ব্যবহারকারী-নির্দিষ্ট তারিখ নির্বাচন করা হয়েছে কিনা তা নির্দেশ করে ( USER_SELECTED অথবা DEFAULT_SELECTION )।

উল্লম্ব বিজ্ঞাপন মেট্রিক্স

v25 থেকে শুরু করে, আপনি নিম্নলিখিত ভার্টিকাল অ্যাডস মেট্রিকগুলি পেতে পারেন:

  • metrics.vertical_ads_potential_impressions : সম্ভাব্য ইম্প্রেশন, যা কোয়েরি কনটেক্সট জুড়ে উপলব্ধ মোট ভিউ-ক্যাপড যোগ্য ইম্প্রেশনকে প্রতিনিধিত্ব করে।
  • metrics.vertical_ads_average_booking_value_micros : মোট অবস্থানকালের জন্য, ট্যাক্স এবং ফি সহ, ক্লিকের উপর ভিত্তি করে নির্ধারিত গড় দৈনিক রেট (মাইক্রো এককে)।
  • metrics.vertical_ads_price_difference_percentage : একই সম্পত্তির জন্য বিজ্ঞাপনদাতার প্রস্তাবিত মূল্য এবং সর্বনিম্ন প্রতিযোগী মূল্যের মধ্যে শতাংশ পার্থক্য।

নমুনা GAQL কোয়েরি 

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

ত্রুটি পরিচালনা

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

ত্রুটি কোড কারণ সুপারিশকৃত পদক্ষেপ
AdGroupError.INVALID_VERTICAL_ADS_FORMAT_SETTING তিনটি বিজ্ঞাপন ফরম্যাটই (টেক্সট, বুকিং লিঙ্ক, প্রচারমূলক বিজ্ঞাপন) একই সাথে নিষ্ক্রিয় করা হয়েছিল। VerticalAdsFormatSetting এ অন্তত একটি ফরম্যাট সক্রিয় আছে কিনা তা নিশ্চিত করুন।
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_AI_MAX এই ক্যাম্পেইনটিতে AI Max for Search campaigns সক্রিয় করা নেই। ক্যাম্পেইন সেটিংসে সার্চ ক্যাম্পেইনের জন্য এআই ম্যাক্স (AI Max) সক্রিয় করুন।
AdGroupError.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_FOR_CAMPAIGNS_WITHOUT_ENABLED_TRAVEL_FEED ক্যাম্পেইনটিতে একটি সক্রিয় ভার্টিকাল ডেটা ফিডের অভাব রয়েছে। গ্রাহক বা ক্যাম্পেইন পর্যায়ে একটি বৈধ ভার্টিকাল ফিড লিঙ্ক করা আছে কিনা তা নিশ্চিত করুন।
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST AdGroupCriterion এ প্রদত্ত SharedSet রিসোর্স নামটি বিদ্যমান নেই। shared_set রিসোর্স নামটি তৈরি করা সেটের সাথে মেলে কিনা তা যাচাই করুন।
CriterionError.VERTICAL_ADS_ITEM_GROUP_RULE_NOT_SUPPORTED_FOR_THE_VERTICAL_TYPE ব্যবহৃত মানদণ্ডের মাত্রাটি নির্দিষ্ট ক্ষেত্রটির জন্য সমর্থিত নয়, যেমন গাড়ি ভাড়ার ক্ষেত্রে হোটেলের শ্রেণি। vertical_ads_item_group_rule এর ডাইমেনশন আপনার vertical type-এর সাথে মেলে কিনা তা যাচাই করুন।