Package google.ads.searchads360.v0.resources

সূচী

অ্যাক্সেসযোগ্য বিডিং কৌশল

এটি বিডিং স্ট্র্যাটেজিস-এর এমন একটি রূপ উপস্থাপন করে যা গ্রাহকের মালিকানাধীন এবং তার সাথে শেয়ার করা হয়।

BiddingStrategy-এর বিপরীতে, এই রিসোর্সটিতে গ্রাহকের নিজস্ব স্ট্র্যাটেজিগুলোর পাশাপাশি, গ্রাহকের ম্যানেজারদের মালিকানাধীন এবং সেই গ্রাহকের সাথে শেয়ার করা স্ট্র্যাটেজিগুলোও অন্তর্ভুক্ত রয়েছে। এই রিসোর্সটি কোনো মেট্রিক্স প্রদান করে না এবং এটি শুধুমাত্র BiddingStrategy অ্যাট্রিবিউটগুলোর একটি সীমিত উপসেট প্রকাশ করে।

ক্ষেত্র
resource_name

string

অ্যাক্সেসযোগ্য বিডিং কৌশলের রিসোর্স নাম। AccessibleBiddingStrategy রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

বিডিং কৌশলের আইডি।

name

string

নিলাম কৌশলের নাম।

type

BiddingStrategyType

দরপত্র কৌশলের ধরণ।

owner_customer_id

int64

যে গ্রাহক বিডিং কৌশলটির মালিক, তার আইডি।

owner_descriptive_name

string

যে গ্রাহক বিডিং কৌশলের মালিক, তার বর্ণনামূলক নাম।

ইউনিয়ন ফিল্ড scheme । দরপত্র স্কিম।

শুধুমাত্র একটিই নির্ধারণ করা যাবে। scheme নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

maximize_conversion_value

MaximizeConversionValue

একটি স্বয়ংক্রিয় বিডিং কৌশল যা আপনার বাজেট খরচ করে ক্যাম্পেইনগুলোর জন্য সর্বাধিক কনভার্সন ভ্যালু পেতে সাহায্য করে।

maximize_conversions

MaximizeConversions

একটি স্বয়ংক্রিয় বিডিং কৌশল যা আপনার বাজেট খরচ করে ক্যাম্পেইনগুলোর জন্য সর্বাধিক কনভার্সন পেতে সাহায্য করে।

target_cpa

TargetCpa

একটি বিডিং কৌশল যা আপনার নির্ধারিত লক্ষ্যমাত্রা অনুযায়ী অধিগ্রহণ প্রতি খরচে (CPA) যত বেশি সম্ভব রূপান্তর পেতে সাহায্য করার জন্য বিড নির্ধারণ করে।

target_impression_share

TargetImpressionShare

একটি বিডিং কৌশল যা স্বয়ংক্রিয়ভাবে একটি নির্বাচিত শতাংশ ইম্প্রেশনের দিকে অপ্টিমাইজ করে।

target_roas

TargetRoas

একটি বিডিং কৌশল যা আপনাকে বিজ্ঞাপনে ব্যয়ের উপর একটি নির্দিষ্ট গড় রিটার্ন (ROAS) অর্জনের মাধ্যমে রাজস্ব সর্বাধিক করতে সাহায্য করে।

target_spend

TargetSpend

একটি বিড কৌশল যা আপনার বাজেটের মধ্যে সর্বাধিক সংখ্যক ক্লিক পেতে সাহায্য করার জন্য বিড নির্ধারণ করে।

রূপান্তর মান সর্বাধিক করুন

একটি স্বয়ংক্রিয় বিডিং কৌশল যা আপনার বাজেট খরচ করে ক্যাম্পেইনগুলোর জন্য সর্বাধিক কনভার্সন ভ্যালু পেতে সাহায্য করে।

ক্ষেত্র
target_roas

double

বিজ্ঞাপন ব্যয়ের উপর লক্ষ্যমাত্রা রিটার্ন (ROAS) বিকল্প। এটি সেট করা থাকলে, বিড স্ট্র্যাটেজি বিজ্ঞাপন ব্যয়ের উপর লক্ষ্যমাত্রা রিটার্নের গড় বজায় রেখে রাজস্ব সর্বাধিক করবে। যদি লক্ষ্যমাত্রা ROAS বেশি হয়, তাহলে বিড স্ট্র্যাটেজি সম্পূর্ণ বাজেট ব্যয় করতে সক্ষম নাও হতে পারে। যদি লক্ষ্যমাত্রা ROAS সেট করা না থাকে, তাহলে বিড স্ট্র্যাটেজি বাজেটের জন্য সর্বোচ্চ সম্ভাব্য ROAS অর্জনের লক্ষ্য রাখবে।

রূপান্তর সর্বাধিক করুন

একটি স্বয়ংক্রিয় বিডিং কৌশল যা আপনার বাজেট খরচ করে ক্যাম্পেইনগুলোর জন্য সর্বাধিক কনভার্সন পেতে সাহায্য করে।

ক্ষেত্র
target_cpa

int64

প্রতি অধিগ্রহণে লক্ষ্যমাত্রা খরচ (CPA) বিকল্প। এটি হলো সেই গড় পরিমাণ যা আপনি প্রতিটি অধিগ্রহণের জন্য ব্যয় করতে চান।

target_cpa_micros

int64

প্রতি অধিগ্রহণে লক্ষ্যমাত্রা খরচ (CPA) বিকল্প। এটি হলো সেই গড় পরিমাণ যা আপনি প্রতিটি অধিগ্রহণের জন্য ব্যয় করতে চান।

টার্গেটসিপিএ

একটি স্বয়ংক্রিয় বিড কৌশল যা আপনার সেট করা লক্ষ্যমাত্রা অনুযায়ী অধিগ্রহণ প্রতি খরচে (CPA) যত বেশি সম্ভব রূপান্তর পেতে সাহায্য করার জন্য বিড নির্ধারণ করে।

ক্ষেত্র
target_cpa_micros

int64

গড় সিপিএ লক্ষ্যমাত্রা। এই লক্ষ্যমাত্রাটি অ্যাকাউন্টের মুদ্রার উপর ভিত্তি করে সর্বনিম্ন বিলযোগ্য ইউনিটের চেয়ে বেশি বা সমান হওয়া উচিত।

টার্গেটইম্প্রেশনশেয়ার

একটি স্বয়ংক্রিয় বিডিং কৌশল যা এমনভাবে বিড নির্ধারণ করে, যাতে সার্চ বিজ্ঞাপনের একটি নির্দিষ্ট শতাংশ প্রথম পৃষ্ঠার শীর্ষে (বা অন্য কোনো নির্দিষ্ট স্থানে) দেখানো হয়।

ক্ষেত্র
location

TargetImpressionShareLocation

অনুসন্ধানের ফলাফল পৃষ্ঠার নির্দিষ্ট অবস্থান।

location_fraction_micros

int64

নির্দিষ্ট স্থানে প্রদর্শিত বিজ্ঞাপনের নির্বাচিত ভগ্নাংশ, যা মাইক্রো এককে প্রকাশ করা হয়। উদাহরণস্বরূপ, ১% মানে ১০,০০০।

cpc_bid_ceiling_micros

int64

স্বয়ংক্রিয় বিডিং সিস্টেমকে সর্বোচ্চ যে CPC বিড নির্দিষ্ট করার অনুমতি দেওয়া হয়। এটি বিজ্ঞাপনদাতার দ্বারা পূরণ করা একটি আবশ্যক ক্ষেত্র, যা সর্বোচ্চ সীমা নির্ধারণ করে এবং স্থানীয় মাইক্রোতে নির্দিষ্ট করা থাকে।

টার্গেটরোয়াস

একটি স্বয়ংক্রিয় বিডিং কৌশল যা আপনাকে বিজ্ঞাপন ব্যয়ের উপর একটি নির্দিষ্ট লক্ষ্যমাত্রার গড় রিটার্ন (ROAS) অর্জনের মাধ্যমে রাজস্ব সর্বাধিক করতে সাহায্য করে।

ক্ষেত্র
target_roas

double

প্রতি ইউনিট ব্যয়ের বিপরীতে নির্বাচিত রাজস্ব (রূপান্তর তথ্যের উপর ভিত্তি করে)।

টার্গেটস্পেন্ড

একটি স্বয়ংক্রিয় বিড কৌশল যা আপনার বাজেটের মধ্যে সর্বাধিক সংখ্যক ক্লিক পেতে সাহায্য করার জন্য বিড নির্ধারণ করে।

ক্ষেত্র
target_spend_micros
(deprecated)

int64

যে ব্যয়ের লক্ষ্যমাত্রার অধীনে সর্বাধিক ক্লিক পাওয়া যাবে। একজন TargetSpend বিডার এই মান অথবা স্বাভাবিক থ্রটলিং ব্যয়ের পরিমাণের মধ্যে যেটি কম, সেই পরিমাণ অর্থ ব্যয় করার চেষ্টা করবে। যদি নির্দিষ্ট করে না দেওয়া হয়, তাহলে বাজেটকেই ব্যয়ের লক্ষ্যমাত্রা হিসেবে ব্যবহার করা হয়। এই ফিল্ডটি এখন আর ব্যবহার করা উচিত নয়। বিস্তারিত জানতে https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html দেখুন।

cpc_bid_ceiling_micros

int64

বিড স্ট্র্যাটেজি দ্বারা নির্ধারণযোগ্য সর্বোচ্চ বিড সীমা। এই সীমাটি স্ট্র্যাটেজি দ্বারা পরিচালিত সকল কীওয়ার্ডের জন্য প্রযোজ্য।

একটি বিজ্ঞাপন।

ক্ষেত্র
resource_name

string

বিজ্ঞাপনের রিসোর্স নাম। বিজ্ঞাপন রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

বিজ্ঞাপনটির জন্য সমস্ত ক্রস-ডোমেইন রিডাইরেক্টের পর সম্ভাব্য চূড়ান্ত ইউআরএল-এর তালিকা।

final_app_urls[]

FinalAppUrl

চূড়ান্ত অ্যাপ ইউআরএল-গুলির একটি তালিকা, যা ব্যবহারকারীর কাছে নির্দিষ্ট অ্যাপটি ইনস্টল করা থাকলে মোবাইলে ব্যবহৃত হবে।

final_mobile_urls[]

string

বিজ্ঞাপনটির জন্য সমস্ত ক্রস-ডোমেইন রিডাইরেক্টের পর সম্ভাব্য চূড়ান্ত মোবাইল ইউআরএল-এর তালিকা।

type

AdType

বিজ্ঞাপনের ধরণ।

synthetic_content_info

SyntheticContentInfo

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

অনুমোদিত AdType মানসমূহ: * HTML5_UPLOAD_AD * DYNAMIC_HTML5_AD * IMAGE_AD

id

int64

বিজ্ঞাপনটির আইডি।

tracking_url_template

string

ট্র্যাকিং ইউআরএল তৈরি করার জন্য ইউআরএল টেমপ্লেট।

final_url_suffix

string

চূড়ান্ত URL তৈরি করার সময় যে সাফিক্সটি ব্যবহার করতে হয়।

display_url

string

কিছু বিজ্ঞাপন ফরম্যাটের ক্ষেত্রে বিজ্ঞাপনের বিবরণে যে URL-টি দেখা যায়।

name

string

বিজ্ঞাপনের নাম। এটি শুধুমাত্র বিজ্ঞাপনটি শনাক্ত করার জন্য ব্যবহৃত হয়। এটির অনন্য হওয়ার প্রয়োজন নেই এবং এটি প্রদর্শিত বিজ্ঞাপনকে প্রভাবিত করে না।

ইউনিয়ন ফিল্ড ad_data । বিজ্ঞাপনের ধরন সম্পর্কিত বিবরণ। ঠিক একটি মান সেট করতে হবে। ad_data নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
text_ad

SearchAds360TextAdInfo

একটি টেক্সট বিজ্ঞাপন সম্পর্কিত বিবরণ।

expanded_text_ad

SearchAds360ExpandedTextAdInfo

বিস্তারিত টেক্সট বিজ্ঞাপন সম্পর্কিত বিবরণ। বিস্তারিত টেক্সট বিজ্ঞাপন এখন আর ব্যবহার করা হয় না। এর পরিবর্তে SearchAds360ResponsiveSearchAd ব্যবহার করুন।

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

রেসপন্সিভ সার্চ অ্যাড সম্পর্কিত বিবরণ।

product_ad

SearchAds360ProductAdInfo

একটি পণ্যের বিজ্ঞাপন সম্পর্কিত বিবরণ।

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

একটি বর্ধিত ডাইনামিক সার্চ বিজ্ঞাপন সম্পর্কিত বিবরণ।

অ্যাডগ্রুপ

একটি বিজ্ঞাপন গোষ্ঠী।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপের রিসোর্স নাম। অ্যাড গ্রুপ রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

বিজ্ঞাপন গোষ্ঠীটির অবস্থা।

type

AdGroupType

বিজ্ঞাপন গোষ্ঠীর ধরণ।

ad_rotation_mode

AdGroupAdRotationMode

বিজ্ঞাপন গ্রুপের বিজ্ঞাপন আবর্তন মোড।

creation_time

string

এই বিজ্ঞাপন-গ্রুপটি তৈরি করার সময়কার টাইমস্ট্যাম্প। টাইমস্ট্যাম্পটি গ্রাহকের টাইম জোনে এবং "yyyy-MM-dd HH:mm:ss" ফরম্যাটে রয়েছে।

targeting_setting

TargetingSetting

সম্পর্কিত বৈশিষ্ট্যগুলিকে লক্ষ্য করার জন্য সেটিং।

labels[]

string

এই বিজ্ঞাপন গোষ্ঠীর সাথে সংযুক্ত লেবেলগুলির রিসোর্স নাম।

effective_labels[]

string

এই অ্যাড গ্রুপের সাথে সংযুক্ত কার্যকরী লেবেলগুলির রিসোর্স নাম। একটি কার্যকরী লেবেল হলো এমন একটি লেবেল যা এই অ্যাড গ্রুপে উত্তরাধিকারসূত্রে প্রাপ্ত বা সরাসরি বরাদ্দ করা হয়েছে।

engine_id

string

এক্সটার্নাল ইঞ্জিন অ্যাকাউন্টে থাকা অ্যাড গ্রুপের আইডি। এই ফিল্ডটি শুধুমাত্র নন-গুগল অ্যাডস অ্যাকাউন্টের জন্য প্রযোজ্য, যেমন—ইয়াহু জাপান, মাইক্রোসফট, বাইদু ইত্যাদি। গুগল অ্যাডস এনটিটির ক্ষেত্রে, এর পরিবর্তে 'ad_group.id' ব্যবহার করুন।

start_date

string

যে তারিখে এই বিজ্ঞাপন গ্রুপটি বিজ্ঞাপন দেখানো শুরু করবে। ডিফল্টরূপে, বিজ্ঞাপন গ্রুপটি এখন অথবা এর শুরুর তারিখে, এই দুটির মধ্যে যেটি পরে হয়, সেই তারিখে শুরু হয়। যদি এই ফিল্ডটি সেট করা থাকে, তাহলে বিজ্ঞাপন গ্রুপটি গ্রাহকের টাইম জোন অনুযায়ী নির্দিষ্ট তারিখের শুরুতে শুরু হবে। এই ফিল্ডটি শুধুমাত্র Microsoft Advertising এবং Facebook gateway অ্যাকাউন্টের জন্য উপলব্ধ।

ফরম্যাট: YYYY-MM-DD উদাহরণ: 2019-03-14

end_date

string

যে তারিখে অ্যাড গ্রুপ বিজ্ঞাপন দেখানো বন্ধ করবে। ডিফল্টরূপে, অ্যাড গ্রুপটি তার নির্ধারিত শেষ তারিখে বন্ধ হয়ে যায়। যদি এই ফিল্ডটি সেট করা থাকে, তাহলে গ্রাহকের টাইম জোন অনুযায়ী নির্দিষ্ট তারিখের শেষে অ্যাড গ্রুপটি বন্ধ হয়ে যাবে। এই ফিল্ডটি শুধুমাত্র Microsoft Advertising এবং Facebook gateway অ্যাকাউন্টের জন্য উপলব্ধ।

ফরম্যাট: YYYY-MM-DD উদাহরণ: 2019-03-14

language_code

string

একটি অ্যাড গ্রুপের বিজ্ঞাপন এবং কীওয়ার্ডের ভাষা। এই ফিল্ডটি শুধুমাত্র Microsoft Advertising অ্যাকাউন্টের জন্য উপলব্ধ। আরও বিস্তারিত: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

last_modified_time

string

এই বিজ্ঞাপন গ্রুপটি সর্বশেষ কখন পরিবর্তন করা হয়েছিল তার তারিখ ও সময়। তারিখ ও সময়টি গ্রাহকের সময় অঞ্চলে এবং "yyyy-MM-dd HH:mm:ss.ssssss" ফরম্যাটে রয়েছে।

id

int64

বিজ্ঞাপন গ্রুপটির আইডি।

name

string

বিজ্ঞাপন গোষ্ঠীর নাম।

নতুন অ্যাড গ্রুপ তৈরি করার সময় এই ফিল্ডটি আবশ্যক এবং এটি খালি রাখা যাবে না।

এতে অবশ্যই ২৫৫টির কম UTF-8 পূর্ণ-প্রস্থের অক্ষর থাকতে হবে।

এতে কোনো নাল (কোড পয়েন্ট 0x0), এনএল লাইন ফিড (কোড পয়েন্ট 0xA) বা ক্যারেজ রিটার্ন (কোড পয়েন্ট 0xD) ক্যারেক্টার থাকতে পারবে না।

tracking_url_template

string

ট্র্যাকিং ইউআরএল তৈরি করার জন্য ইউআরএল টেমপ্লেট।

cpc_bid_micros

int64

সর্বোচ্চ CPC (কস্ট-পার-ক্লিক) বিড। এই ফিল্ডটি তখন ব্যবহৃত হয় যখন অ্যাড গ্রুপের কার্যকর বিডিং স্ট্র্যাটেজি ম্যানুয়াল CPC হয়। যদি অ্যাড গ্রুপের ক্যাম্পেইন পোর্টফোলিও বিডিং স্ট্র্যাটেজি ব্যবহার করে, তাহলে এই ফিল্ডটি প্রযোজ্য নয় এবং উপেক্ষা করা হবে।

engine_status

AdGroupEngineStatus

অ্যাড গ্রুপের জন্য ইঞ্জিন স্ট্যাটাস।

final_url_suffix

string

চূড়ান্ত URL-এ প্যারামিটার যুক্ত করার জন্য URL টেমপ্লেট।

অ্যাডগ্রুপঅ্যাড

একটি বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন।

ক্ষেত্র
resource_name

string

বিজ্ঞাপনের রিসোর্স নাম। বিজ্ঞাপন গ্রুপের বিজ্ঞাপন রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

বিজ্ঞাপনটির অবস্থা।

ad

Ad

বিজ্ঞাপনটি।

creation_time

string

এই ad_group_ad-টি তৈরি করার টাইমস্ট্যাম্প। তারিখ ও সময়টি গ্রাহকের টাইম জোনে এবং "yyyy-MM-dd HH:mm:ss.ssssss" ফরম্যাটে রয়েছে।

labels[]

string

এই বিজ্ঞাপন গোষ্ঠীর সাথে সংযুক্ত লেবেলগুলির রিসোর্স নাম।

effective_labels[]

string

এই বিজ্ঞাপনের সাথে সংযুক্ত কার্যকরী লেবেলগুলোর রিসোর্স নাম। একটি কার্যকরী লেবেল হলো এমন একটি লেবেল যা এই বিজ্ঞাপনে উত্তরাধিকারসূত্রে প্রাপ্ত বা সরাসরি বরাদ্দ করা হয়েছে।

engine_id

string

এক্সটার্নাল ইঞ্জিন অ্যাকাউন্টে থাকা বিজ্ঞাপনের আইডি। এই ফিল্ডটি শুধুমাত্র সার্চ অ্যাডস ৩৬০ অ্যাকাউন্টের জন্য, যেমন—ইয়াহু জাপান, মাইক্রোসফট, বাইডু ইত্যাদি। সার্চ অ্যাডস ৩৬০ নয় এমন সত্তার জন্য, এর পরিবর্তে 'ad_group_ad.ad.id' ব্যবহার করুন।

engine_status

AdGroupAdEngineStatus

এক্সটার্নাল ইঞ্জিন অ্যাকাউন্টে বিজ্ঞাপনের অতিরিক্ত স্ট্যাটাস। সম্ভাব্য স্ট্যাটাসগুলোর মধ্যে (এক্সটার্নাল অ্যাকাউন্টের ধরনের ওপর নির্ভর করে) রয়েছে অ্যাক্টিভ, এলিজিবল, পেন্ডিং রিভিউ ইত্যাদি।

last_modified_time

string

এই বিজ্ঞাপন গ্রুপের বিজ্ঞাপনটি সর্বশেষ কখন পরিবর্তন করা হয়েছিল তার তারিখ ও সময়। তারিখ ও সময়টি গ্রাহকের সময় অঞ্চলে এবং "yyyy-MM-dd HH:mm:ss.ssssss" ফরম্যাটে রয়েছে।

বিজ্ঞাপন গ্রুপ বিজ্ঞাপন কার্যকর লেবেল

একটি অ্যাড গ্রুপ অ্যাড এবং একটি কার্যকরী লেবেলের মধ্যে সম্পর্ক। কার্যকরী লেবেল হলো এমন একটি লেবেল যা এই অ্যাড গ্রুপ অ্যাডটিতে উত্তরাধিকারসূত্রে প্রাপ্ত বা সরাসরি বরাদ্দ করা হয়েছে।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ অ্যাড ইফেক্টিভ লেবেলের রিসোর্স নেম। অ্যাড গ্রুপ অ্যাড ইফেক্টিভ লেবেল রিসোর্স নেমগুলোর গঠন হলো: customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

যে বিজ্ঞাপন গোষ্ঠীর সাথে কার্যকরী লেবেলটি সংযুক্ত থাকে।

label

string

অ্যাড গ্রুপ অ্যাড-কে নির্ধারিত কার্যকর লেবেল।

owner_customer_id

int64

কার্যকরী লেবেলটির মালিক গ্রাহকের আইডি।

বিজ্ঞাপন গ্রুপ বিজ্ঞাপন লেবেল

একটি বিজ্ঞাপন গ্রুপ, একটি বিজ্ঞাপন এবং একটি লেবেলের মধ্যে সম্পর্ক।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ অ্যাড লেবেলের রিসোর্স নেম। অ্যাড গ্রুপ অ্যাড লেবেল রিসোর্স নেমগুলোর গঠন হলো: customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

যে বিজ্ঞাপন গোষ্ঠীর সাথে লেবেলটি সংযুক্ত।

label

string

অ্যাড গ্রুপ 'ad'-কে নির্ধারিত লেবেল।

owner_customer_id

int64

লেবেলটির মালিক গ্রাহকের আইডি।

AdGroupAsset

একটি বিজ্ঞাপন গোষ্ঠী এবং একটি অ্যাসেটের মধ্যে সংযোগ।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ অ্যাসেটের রিসোর্স নাম। AdGroupAsset রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

ad_group

string

প্রয়োজনীয়। যে অ্যাড গ্রুপের সাথে অ্যাসেটটি লিঙ্ক করা আছে।

asset

string

প্রয়োজনীয়। যে অ্যাসেটটি অ্যাড গ্রুপের সাথে লিঙ্ক করা আছে।

status

AssetLinkStatus

বিজ্ঞাপন গ্রুপ অ্যাসেটটির অবস্থা।

AdGroupAssetSet

AdGroupAssetSet হলো একটি অ্যাড গ্রুপ এবং একটি অ্যাসেট সেটের মধ্যকার সংযোগ। একটি AdGroupAssetSet তৈরি করার মাধ্যমে একটি অ্যাসেট সেটকে একটি অ্যাড গ্রুপের সাথে সংযুক্ত করা হয়।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ অ্যাসেট সেটের রিসোর্স নাম। অ্যাড গ্রুপ অ্যাসেট সেটের রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad_group

string

যে বিজ্ঞাপন গোষ্ঠীর সাথে এই অ্যাসেট সেটটি সংযুক্ত।

asset_set

string

অ্যাসেট সেট যা অ্যাড গ্রুপের সাথে লিঙ্ক করা আছে।

status

AssetSetLinkStatus

অ্যাড গ্রুপ অ্যাসেট সেটের অবস্থা। শুধুমাত্র পঠনযোগ্য।

AdGroupAudienceView

একটি বিজ্ঞাপন গোষ্ঠীর দর্শক দৃশ্য। এতে ডিসপ্লে নেটওয়ার্ক ও ইউটিউব নেটওয়ার্ক বিজ্ঞাপনের জন্য আগ্রহ ও রিমার্কেটিং তালিকা এবং সার্চ বিজ্ঞাপনের জন্য রিমার্কেটিং তালিকা (RLSA) থেকে প্রাপ্ত পারফরম্যান্স ডেটা অন্তর্ভুক্ত রয়েছে, যা দর্শক পর্যায়ে একত্রিত করা হয়েছে।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ অডিয়েন্স ভিউ-এর রিসোর্স নেম। অ্যাড গ্রুপ অডিয়েন্স ভিউ রিসোর্স নেমগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

এটি একটি বিজ্ঞাপন গোষ্ঠীর বিড মডিফায়ারকে বোঝায়।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ বিড মডিফায়ারের রিসোর্স নেম। অ্যাড গ্রুপ বিড মডিফায়ার রিসোর্স নেমগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_modifier

double

শর্ত পূরণ হলে বিডের জন্য মডিফায়ার। মডিফায়ারটি অবশ্যই ০.১ - ১০.০ সীমার মধ্যে হতে হবে। কোনো ডিভাইস টাইপ থেকে অপ্ট-আউট করতে ০ ব্যবহার করুন।

ইউনিয়ন ফিল্ড criterion । এই অ্যাড গ্রুপ বিড মডিফায়ারের ক্রাইটেরিয়ন।

V5 থেকে শুরু হওয়া ক্রিয়েট অপারেশনের জন্য এটি আবশ্যক। criterion নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

device

DeviceInfo

একটি ডিভাইস মানদণ্ড।

অ্যাডগ্রুপক্রাইটেরিয়ন

একটি অ্যাড গ্রুপ ক্রাইটেরিয়ন। ad_group_criterion রিপোর্টটি শুধুমাত্র সেই ক্রাইটেরিয়াগুলোই ফেরত দেয় যেগুলো অ্যাড গ্রুপে সুস্পষ্টভাবে যোগ করা হয়েছে।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ ক্রাইটেরিয়নের রিসোর্স নাম। অ্যাড গ্রুপ ক্রাইটেরিয়ন রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

creation_time

string

এই অ্যাড গ্রুপ ক্রাইটেরিয়নটি তৈরি করার সময়কার টাইমস্ট্যাম্প। টাইমস্ট্যাম্পটি গ্রাহকের টাইম জোনে এবং "yyyy-MM-dd HH:mm:ss" ফরম্যাটে থাকে।

status

AdGroupCriterionStatus

মানদণ্ডটির অবস্থা।

এটি ক্লায়েন্ট দ্বারা সেট করা অ্যাড গ্রুপ ক্রাইটেরিয়ন এনটিটির স্ট্যাটাস। দ্রষ্টব্য: UI রিপোর্টে অতিরিক্ত তথ্য অন্তর্ভুক্ত থাকতে পারে যা একটি ক্রাইটেরিয়ন চালানোর যোগ্য কিনা তা প্রভাবিত করে। কিছু ক্ষেত্রে, API-তে REMOVED করা একটি ক্রাইটেরিয়ন UI-তে সক্রিয় হিসাবে দেখানো হতে পারে। উদাহরণস্বরূপ, ক্যাম্পেইনগুলি ডিফল্টরূপে সমস্ত বয়সের ব্যবহারকারীদের দেখানো হয়, যদি না তাদের বাদ দেওয়া হয়। UI প্রতিটি বয়সের পরিসরকে "সক্রিয়" হিসাবে দেখাবে, কারণ তারা বিজ্ঞাপনগুলি দেখার যোগ্য; কিন্তু AdGroupCriterion.status "removed" দেখাবে, কারণ কোনো ইতিবাচক ক্রাইটেরিয়ন যোগ করা হয়নি।

quality_info

QualityInfo

মানদণ্ডের গুণমান সম্পর্কিত তথ্য।

type

CriterionType

মানদণ্ডের ধরণ।

labels[]

string

এই বিজ্ঞাপন গ্রুপ মানদণ্ডের সাথে সংযুক্ত লেবেলগুলির রিসোর্স নাম।

effective_labels[]

string

এই অ্যাড গ্রুপ ক্রাইটেরিয়নের সাথে সংযুক্ত কার্যকরী লেবেলগুলির রিসোর্স নাম। একটি কার্যকরী লেবেল হলো এমন একটি লেবেল যা এই অ্যাড গ্রুপ ক্রাইটেরিয়নে উত্তরাধিকারসূত্রে প্রাপ্ত বা সরাসরি নির্ধারিত।

position_estimates

PositionEstimates

বিভিন্ন পদের জন্য মানদণ্ডভিত্তিক দরপত্রের প্রাক্কলন।

final_urls[]

string

বিজ্ঞাপনটির জন্য সমস্ত ক্রস-ডোমেইন রিডাইরেক্টের পর সম্ভাব্য চূড়ান্ত ইউআরএল-এর তালিকা।

final_mobile_urls[]

string

সমস্ত ক্রস-ডোমেইন রিডাইরেক্টের পর সম্ভাব্য চূড়ান্ত মোবাইল ইউআরএল-এর তালিকা।

url_custom_parameters[]

CustomParameter

tracking_url_template , final_urls , বা mobile_final_urls এ কাস্টম প্যারামিটার ট্যাগ প্রতিস্থাপন করতে ব্যবহৃত ম্যাপিংগুলির তালিকা।

engine_id

string

এক্সটার্নাল ইঞ্জিন অ্যাকাউন্টে অ্যাড গ্রুপ ক্রাইটেরিয়নের আইডি। এই ফিল্ডটি শুধুমাত্র নন-গুগল অ্যাডস অ্যাকাউন্টের জন্য, যেমন—ইয়াহু জাপান, মাইক্রোসফট, বাইদু ইত্যাদি। গুগল অ্যাডস এনটিটির জন্য, এর পরিবর্তে 'ad_group_criterion.criterion_id' ব্যবহার করুন।

last_modified_time

string

এই বিজ্ঞাপন গ্রুপের মানদণ্ডটি সর্বশেষ কখন পরিবর্তন করা হয়েছিল তার তারিখ ও সময়। তারিখ ও সময়টি গ্রাহকের সময় অঞ্চলে এবং "yyyy-MM-dd HH:mm:ss.ssssss" বিন্যাসে রয়েছে।

criterion_id

int64

মানদণ্ডটির আইডি।

ad_group

string

যে বিজ্ঞাপন গোষ্ঠীর অন্তর্ভুক্ত মানদণ্ডটি।

negative

bool

মানদণ্ডটিকে লক্ষ্যবস্তু ( false ) করা হবে নাকি বাদ ( true ) দেওয়া হবে।

এই ক্ষেত্রটি অপরিবর্তনীয়। কোনো মানদণ্ডকে ইতিবাচক থেকে নেতিবাচক করতে, সেটিকে সরিয়ে দিয়ে আবার যোগ করুন।

bid_modifier

double

শর্তটি মিলে গেলে বিডের জন্য মডিফায়ার। মডিফায়ারটি অবশ্যই ০.১ - ১০.০ সীমার মধ্যে হতে হবে। বেশিরভাগ টার্গেটযোগ্য শর্তের ধরণ মডিফায়ার সমর্থন করে।

cpc_bid_micros

int64

সিপিসি (কস্ট-পার-ক্লিক) বিড।

effective_cpc_bid_micros

int64

কার্যকরী CPC (কস্ট-পার-ক্লিক) বিড।

engine_status

AdGroupCriterionEngineStatus

অ্যাড গ্রুপ ক্রাইটেরিয়নের জন্য ইঞ্জিন স্ট্যাটাস।

final_url_suffix

string

চূড়ান্ত URL-এ প্যারামিটার যুক্ত করার জন্য URL টেমপ্লেট।

tracking_url_template

string

ট্র্যাকিং ইউআরএল তৈরি করার জন্য ইউআরএল টেমপ্লেট।

ইউনিয়ন ফিল্ড criterion । অ্যাড গ্রুপ ক্রাইটেরিয়ন।

ঠিক একটি নির্ধারণ করতে হবে। criterion নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

keyword

KeywordInfo

মূলশব্দ।

listing_group

ListingGroupInfo

তালিকাভুক্ত গ্রুপ।

age_range

AgeRangeInfo

বয়সের সীমা।

gender

GenderInfo

লিঙ্গ।

user_list

UserListInfo

ব্যবহারকারী তালিকা।

webpage

WebpageInfo

ওয়েবপেজ

location

LocationInfo

অবস্থান।

অবস্থান অনুমান

বিভিন্ন পদের জন্য মানদণ্ডভিত্তিক দরপত্রের প্রাক্কলন।

ক্ষেত্র
top_of_page_cpc_micros

int64

সার্চ ফলাফলের প্রথম পৃষ্ঠার শীর্ষে বিজ্ঞাপন প্রদর্শনের জন্য প্রয়োজনীয় CPC বিডের আনুমানিক হিসাব।

কোয়ালিটিইনফো

বিজ্ঞাপন গ্রুপের মানদণ্ডের গুণমান সম্পর্কিত তথ্যের জন্য একটি ধারক।

ক্ষেত্র
quality_score

int32

গুণগত মান স্কোর।

মান নির্ধারণ করার জন্য গুগলের কাছে পর্যাপ্ত তথ্য না থাকলে এই ক্ষেত্রটি পূরণ নাও হতে পারে।

AdGroupCriterionEffectiveLabel

একটি বিজ্ঞাপন গোষ্ঠীর মানদণ্ড এবং একটি কার্যকর লেবেলের মধ্যে সম্পর্ক। একটি কার্যকর লেবেল হলো এমন একটি লেবেল যা এই বিজ্ঞাপন গোষ্ঠীর মানদণ্ডে উত্তরাধিকারসূত্রে প্রাপ্ত বা সরাসরি নির্ধারিত হয়।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ ক্রাইটেরিয়ন ইফেক্টিভ লেবেলের রিসোর্স নেম। অ্যাড গ্রুপ ক্রাইটেরিয়ন ইফেক্টিভ লেবেল রিসোর্স নেমগুলোর গঠন হলো: customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

বিজ্ঞাপন গোষ্ঠীর মানদণ্ড, যার সাথে কার্যকরী লেবেলটি সংযুক্ত থাকে।

label

string

বিজ্ঞাপন গ্রুপ মানদণ্ডে নির্ধারিত কার্যকর লেবেল।

owner_customer_id

int64

কার্যকরী লেবেলটির মালিক গ্রাহকের আইডি।

AdGroupCriterionLabel

একটি বিজ্ঞাপন গোষ্ঠীর মানদণ্ড এবং একটি লেবেলের মধ্যে সম্পর্ক।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ ক্রাইটেরিয়ন লেবেলের রিসোর্স নাম। অ্যাড গ্রুপ ক্রাইটেরিয়ন লেবেল রিসোর্স নামগুলোর গঠন হলো: customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

যে বিজ্ঞাপন গোষ্ঠীর মানদণ্ডের সাথে লেবেলটি সংযুক্ত।

label

string

বিজ্ঞাপন গ্রুপ মানদণ্ডে নির্ধারিত লেবেল।

owner_customer_id

int64

লেবেলটির মালিক গ্রাহকের আইডি।

AdGroupEffectiveLabel

একটি অ্যাড গ্রুপ এবং একটি কার্যকরী লেবেলের মধ্যে সম্পর্ক। কার্যকরী লেবেল হলো এমন একটি লেবেল যা এই অ্যাড গ্রুপে উত্তরাধিকারসূত্রে প্রাপ্ত বা সরাসরি বরাদ্দ করা হয়েছে।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপের কার্যকরী লেবেলের রিসোর্স নাম। অ্যাড গ্রুপের কার্যকরী লেবেলের রিসোর্স নামগুলোর গঠন হলো: customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

ad_group

string

যে বিজ্ঞাপন গোষ্ঠীর সাথে কার্যকরী লেবেলটি সংযুক্ত থাকে।

label

string

বিজ্ঞাপন গ্রুপটিকে নির্ধারিত কার্যকর লেবেল।

owner_customer_id

int64

কার্যকরী লেবেলটির মালিক গ্রাহকের আইডি।

AdGroupLabel

একটি বিজ্ঞাপন গোষ্ঠী এবং একটি লেবেলের মধ্যে সম্পর্ক।

ক্ষেত্র
resource_name

string

অ্যাড গ্রুপ লেবেলের রিসোর্স নাম। অ্যাড গ্রুপ লেবেল রিসোর্স নামগুলোর গঠন হলো: customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_group

string

যে বিজ্ঞাপন গোষ্ঠীর সাথে লেবেলটি সংযুক্ত।

label

string

বিজ্ঞাপন গ্রুপটিকে নির্ধারিত লেবেল।

owner_customer_id

int64

লেবেলটির মালিক গ্রাহকের আইডি।

বয়সের পরিসর দেখুন

বয়সসীমা অনুযায়ী দৃশ্য।

এটি বয়সসীমা অনুযায়ী গ্রাহকের পারফরম্যান্স মেট্রিক্সের (যেমন ইম্প্রেশন এবং ক্লিক) সমষ্টিগত চিত্র উপস্থাপন করে। সমস্ত পরিসংখ্যান অ্যাড গ্রুপ পর্যায়ে একত্রিত করা হয়।

দ্রষ্টব্য: যদিও আপনি age_range_view ব্যবহার করে বয়সের সীমা অনুসারে অথবা gender_view ব্যবহার করে লিঙ্গ অনুসারে মেট্রিক ভাগ করতে পারেন, Search Ads 360 API একটি একক কোয়েরিতে একই সাথে বয়সের সীমা এবং লিঙ্গ উভয় অনুসারে মেট্রিক ভাগ করা সমর্থন করে না। Search Ads 360 API-তে উভয় দিক মিলিয়ে পারফরম্যান্স বিশ্লেষণ করা সমর্থিত নয়।

ক্ষেত্র
resource_name

string

বয়সসীমা ভিউ-এর রিসোর্স নাম। বয়সসীমা ভিউ রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

সম্পদ

অ্যাসেট হলো বিজ্ঞাপনের এমন একটি অংশ যা একাধিক বিজ্ঞাপনের মধ্যে শেয়ার করা যায়। এটি একটি ছবি (ImageAsset), একটি ভিডিও (YoutubeVideoAsset) ইত্যাদি হতে পারে। অ্যাসেট অপরিবর্তনীয় এবং সরানো যায় না। কোনো অ্যাসেটের পরিবেশন বন্ধ করতে, যে এনটিটি এটি ব্যবহার করছে সেখান থেকে অ্যাসেটটি সরিয়ে দিন।

ক্ষেত্র
resource_name

string

অ্যাসেটের রিসোর্স নাম। অ্যাসেট রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/assets/{asset_id}

type

AssetType

সম্পদের প্রকারভেদ।

final_urls[]

string

সমস্ত ক্রস ডোমেইন রিডাইরেক্টের পর সম্ভাব্য চূড়ান্ত ইউআরএলগুলোর একটি তালিকা।

final_mobile_urls[]

string

সমস্ত ক্রস ডোমেইন রিডাইরেক্টের পর সম্ভাব্য চূড়ান্ত মোবাইল ইউআরএলগুলোর একটি তালিকা।

url_custom_parameters[]

CustomParameter

tracking_url_template, final_urls, এবং/অথবা final_mobile_urls-এ ইউআরএল কাস্টম প্যারামিটার ট্যাগ প্রতিস্থাপনের জন্য ব্যবহৃত ম্যাপিংগুলোর একটি তালিকা।

status

AssetStatus

সম্পদটির অবস্থা।

creation_time

string

এই অ্যাসেটটি তৈরি করার সময়কার টাইমস্ট্যাম্প। টাইমস্ট্যাম্পটি গ্রাহকের টাইম জোনে এবং "yyyy-MM-dd HH:mm:ss" ফরম্যাটে রয়েছে।

last_modified_time

string

এই অ্যাসেটটি সর্বশেষ কখন পরিবর্তন করা হয়েছিল তার তারিখ ও সময়। তারিখ ও সময়টি গ্রাহকের টাইম জোনে এবং "yyyy-MM-dd HH:mm:ss.ssssss" ফরম্যাটে রয়েছে।

synthetic_content_info

SyntheticContentInfo

অ্যাসেটটির জন্য সিন্থেটিক কন্টেন্ট তথ্য। শুধুমাত্র নির্দিষ্ট অ্যাসেট টাইপের অ্যাসেটগুলোই synthetic_content_info ফিল্ড ব্যবহার করে আপডেটের জন্য যোগ্য।

অনুমোদিত AssetType মানসমূহ: * IMAGE * MEDIA_BUNDLE * YOUTUBE_VIDEO

id

int64

সম্পদটির আইডি।

name

string

সম্পদের নাম ঐচ্ছিক।

tracking_url_template

string

ট্র্যাকিং ইউআরএল তৈরি করার জন্য ইউআরএল টেমপ্লেট।

final_url_suffix

string

প্যারালাল ট্র্যাকিংয়ের মাধ্যমে পরিবেশিত ল্যান্ডিং পেজের ইউআরএল-এ প্যারামিটার যুক্ত করার জন্য ইউআরএল টেমপ্লেট।

engine_status

AssetEngineStatus

একটি অ্যাসেটের ইঞ্জিন স্ট্যাটাস।

ইউনিয়ন ফিল্ড asset_data । অ্যাসেটটির নির্দিষ্ট ধরন। asset_data নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
youtube_video_asset

YoutubeVideoAsset

একটি ইউটিউব ভিডিও অ্যাসেট।

image_asset

ImageAsset

একটি চিত্র সম্পদ।

text_asset

TextAsset

একটি পাঠ্য সম্পদ।

callout_asset

UnifiedCalloutAsset

একটি সমন্বিত কলআউট অ্যাসেট।

page_feed_asset

UnifiedPageFeedAsset

একটি সমন্বিত পেজ ফিড অ্যাসেট।

mobile_app_asset

MobileAppAsset

একটি মোবাইল অ্যাপ অ্যাসেট।

call_asset

UnifiedCallAsset

একটি সমন্বিত কল অ্যাসেট।

call_to_action_asset

CallToActionAsset

পদক্ষেপ গ্রহণের আহ্বান জানানোর একটি উপকরণ।

location_asset

UnifiedLocationAsset

একটি সমন্বিত অবস্থান সম্পদ।

অ্যাসেটগ্রুপ

একটি অ্যাসেট গ্রুপ। কোনো অ্যাসেটকে অ্যাসেট গ্রুপের সাথে লিঙ্ক করতে AssetGroupAsset ব্যবহার করা হয়। কোনো অ্যাসেট গ্রুপের সাথে একটি সিগন্যাল যুক্ত করতে AssetGroupSignal ব্যবহার করা হয়।

ক্ষেত্র
resource_name

string

অ্যাসেট গ্রুপের রিসোর্স নাম। অ্যাসেট গ্রুপ রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

সম্পদ গোষ্ঠীর আইডি।

campaign

string

যে প্রচারাভিযানের সাথে এই সম্পদ গোষ্ঠীটি সংশ্লিষ্ট। যে সম্পদটি সম্পদ গোষ্ঠীটির সাথে সংযুক্ত।

name

string

আবশ্যক। অ্যাসেট গ্রুপের নাম। আবশ্যক। এর সর্বনিম্ন দৈর্ঘ্য ১ এবং সর্বোচ্চ দৈর্ঘ্য ১২৮ হতে হবে। একটি ক্যাম্পেইনের অধীনে এটি অবশ্যই অনন্য হতে হবে।

final_urls[]

string

সমস্ত ক্রস ডোমেইন রিডাইরেক্টের পর চূড়ান্ত ইউআরএলগুলোর একটি তালিকা। পারফরম্যান্স ম্যাক্সে, ডিফল্টরূপে, ইউআরএলগুলো সম্প্রসারণের জন্য যোগ্য থাকে, যদি না তা থেকে অপ্ট-আউট করা হয়।

final_mobile_urls[]

string

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

status

AssetGroupStatus

সম্পদ গোষ্ঠীর অবস্থা।

path1

string

বিজ্ঞাপনে প্রদর্শিত ইউআরএল-এর সাথে যুক্ত হতে পারে এমন পাঠ্যের প্রথম অংশ।

path2

string

বিজ্ঞাপনে প্রদর্শিত ইউআরএল-এর শেষে যুক্ত হতে পারে এমন টেক্সটের দ্বিতীয় অংশ। এই ফিল্ডটি শুধুমাত্র তখনই সেট করা যাবে যখন path1 সেট করা থাকবে।

ad_strength

AdStrength

এই অ্যাসেট গ্রুপের সামগ্রিক বিজ্ঞাপনের শক্তি।

অ্যাসেটগ্রুপঅ্যাসেট

AssetGroupAsset হলো একটি অ্যাসেট এবং একটি অ্যাসেট গ্রুপের মধ্যে সংযোগ স্থাপনকারী। একটি AssetGroupAsset যোগ করার মাধ্যমে একটি অ্যাসেট, একটি অ্যাসেট গ্রুপের সাথে সংযুক্ত হয়।

ক্ষেত্র
resource_name

string

অ্যাসেট গ্রুপ অ্যাসেটের রিসোর্স নাম। অ্যাসেট গ্রুপ অ্যাসেট রিসোর্স নামের গঠনটি নিম্নরূপ:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

asset_group

string

যে সম্পদ গোষ্ঠীটিকে এই সম্পদ গোষ্ঠীটি সংযুক্ত করছে।

asset

string

যে সম্পদটিকে এই সম্পদ গোষ্ঠীর সম্পদটি সংযুক্ত করছে।

field_type

AssetFieldType

অ্যাসেট গ্রুপের মধ্যে অ্যাসেটটির অবস্থানের বিবরণ। উদাহরণস্বরূপ: হেডলাইন, ইউটিউব ভিডিও ইত্যাদি।

status

AssetLinkStatus

একটি সম্পদ এবং সম্পদ গোষ্ঠীর মধ্যে সংযোগের অবস্থা।

AssetGroupAsset CombinationData

সম্পদ গোষ্ঠী সম্পদ সংমিশ্রণ ডেটা

ক্ষেত্র
asset_combination_served_assets[]

AssetUsage

পরিবেশিত সম্পদ।

অ্যাসেটগ্রুপলিস্টিংগ্রুপফিল্টার

AssetGroupListingGroupFilter একটি অ্যাসেট গ্রুপের অন্তর্গত লিস্টিং গ্রুপ ফিল্টার ট্রি নোডকে প্রতিনিধিত্ব করে।

ক্ষেত্র
resource_name

string

অ্যাসেট গ্রুপ লিস্টিং গ্রুপ ফিল্টারের রিসোর্স নাম। অ্যাসেট গ্রুপ লিস্টিং গ্রুপ ফিল্টার রিসোর্স নামের গঠনটি নিম্নরূপ:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

asset_group

string

যে অ্যাসেট গ্রুপটি এই অ্যাসেট গ্রুপ লিস্টিং গ্রুপ ফিল্টারটির অংশ।

id

int64

ListingGroupFilter-এর আইডি।

type

ListingGroupFilterType

লিস্টিং গ্রুপ ফিল্টার নোডের প্রকার।

vertical

ListingGroupFilterVertical

বর্তমান নোড ট্রি যে উল্লম্ব রেখাটিকে প্রতিনিধিত্ব করে। একই ট্রির সমস্ত নোড অবশ্যই একই উল্লম্ব রেখার অন্তর্ভুক্ত হতে হবে।

case_value

ListingGroupFilterDimension

যে ডাইমেনশন ভ্যালু দিয়ে এই লিস্টিং গ্রুপটি তার প্যারেন্টকে পরিমার্জন করছে। রুট গ্রুপের জন্য এটি অনির্ধারিত।

parent_listing_group_filter

string

প্যারেন্ট লিস্টিং গ্রুপ সাবডিভিশনের রিসোর্স নাম। রুট লিস্টিং গ্রুপ ফিল্টার নোডের জন্য নাল।

path

ListingGroupFilterDimensionPath

এই লিস্টিং গ্রুপ ফিল্টারকে সংজ্ঞায়িতকারী ডাইমেনশনগুলোর পথ।

অ্যাসেটগ্রুপসিগন্যাল

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

ক্ষেত্র
resource_name

string

অ্যাসেট গ্রুপ সিগন্যালের রিসোর্স নাম। অ্যাসেট গ্রুপ সিগন্যাল রিসোর্স নামের গঠনটি নিম্নরূপ:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

asset_group

string

যে অ্যাসেট গ্রুপটির অন্তর্গত এই অ্যাসেট গ্রুপ সিগন্যালটি।

ইউনিয়ন ফিল্ড signal । অ্যাসেট গ্রুপের সিগন্যাল। signal নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
audience

AudienceInfo

পারফরম্যান্স ম্যাক্স ক্যাম্পেইনের জন্য ব্যবহৃত অডিয়েন্স সিগন্যাল।

অ্যাসেটগ্রুপটপকম্বিনেশনভিউ

অ্যাসেট গ্রুপ ও অ্যাসেট টপ কম্বিনেশনের ব্যবহার সম্পর্কে একটি পর্যালোচনা।

ক্ষেত্র
resource_name

string

অ্যাসেট গ্রুপ টপ কম্বিনেশন ভিউ-এর রিসোর্স নেম। অ্যাসেট গ্রুপ টপ কম্বিনেশন ভিউ রিসোর্স নেমগুলোর গঠন হলো: `"customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"`

asset_group_top_combinations[]

AssetGroupAssetCombinationData

সম্পদসমূহের সেরা সংমিশ্রণ যেগুলো একত্রে কাজ করেছে।

অ্যাসেটসেট

একটি অ্যাসেট সেট হলো একাধিক অ্যাসেটের একটি সংগ্রহ। কোনো অ্যাসেটকে অ্যাসেট সেটের সাথে লিঙ্ক করতে AssetSetAsset ব্যবহার করুন।

ক্ষেত্র
id

int64

অ্যাসেট সেটের আইডি।

resource_name

string

অ্যাসেট সেটের রিসোর্স নাম। অ্যাসেট সেটের রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/assetSets/{asset_set_id}

অ্যাসেটসেটঅ্যাসেট

AssetSetAsset হলো একটি অ্যাসেট এবং একটি অ্যাসেট সেটের মধ্যেকার সংযোগ। একটি AssetSetAsset যোগ করার মাধ্যমে একটি অ্যাসেট, একটি অ্যাসেট সেটের সাথে সংযুক্ত হয়।

ক্ষেত্র
resource_name

string

অ্যাসেট সেট অ্যাসেটের রিসোর্স নাম। অ্যাসেট সেট অ্যাসেট রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

asset_set

string

যে অ্যাসেট সেটের সাথে এই অ্যাসেট সেটটি লিঙ্ক করছে।

asset

string

যে অ্যাসেটটির সাথে এই অ্যাসেট সেটটি লিঙ্ক করছে।

status

AssetSetAssetStatus

অ্যাসেট সেটের অবস্থা। শুধুমাত্র পঠনযোগ্য।

দর্শক

অডিয়েন্স একটি কার্যকরী টার্গেটিং অপশন, যা আপনাকে আপনার টার্গেট সেগমেন্টের বিভিন্ন অংশের প্রতিনিধিত্বকারী অডিয়েন্স তৈরি করার জন্য বিস্তারিত ডেমোগ্রাফিক্স এবং অ্যাফিনিটিজের মতো বিভিন্ন সেগমেন্ট অ্যাট্রিবিউটকে একত্রিত করতে দেয়।

ক্ষেত্র
resource_name

string

অডিয়েন্সের রিসোর্স নাম। অডিয়েন্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/audiences/{audience_id}

id

int64

দর্শকের পরিচয়।

name

string

আবশ্যক। দর্শকের নাম। এটি সকল দর্শকের জন্য অনন্য হতে হবে। এর সর্বনিম্ন দৈর্ঘ্য ১ এবং সর্বোচ্চ দৈর্ঘ্য ২৫৫ হতে হবে।

description

string

এই দর্শকগোষ্ঠীর বিবরণ।

বিডিং কৌশল

একটি দরপত্র কৌশল।

ক্ষেত্র
resource_name

string

বিডিং স্ট্র্যাটেজির রিসোর্স নাম। বিডিং স্ট্র্যাটেজি রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

দরপত্র কৌশলের অবস্থা।

এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।

type

BiddingStrategyType

বিডিং কৌশলের ধরণ। বিডিং স্কিম নির্ধারণ করে একটি বিডিং কৌশল তৈরি করুন।

এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।

currency_code

string

বিডিং কৌশলে ব্যবহৃত মুদ্রা (আইএসও ৪২১৭ তিন-অক্ষরের কোড)।

ম্যানেজার গ্রাহকদের বিডিং স্ট্র্যাটেজির জন্য, এই কারেন্সিটি তৈরির সময় সেট করা যেতে পারে এবং ডিফল্টরূপে এটি ম্যানেজার গ্রাহকের কারেন্সি ব্যবহার করে। সার্ভিং গ্রাহকদের ক্ষেত্রে, এই ফিল্ডটি সেট করা যায় না; একজন সার্ভিং গ্রাহকের সমস্ত স্ট্র্যাটেজি স্বয়ংক্রিয়ভাবে সেই গ্রাহকের কারেন্সি ব্যবহার করে। সব ক্ষেত্রেই effective_currency_code ফিল্ডটি স্ট্র্যাটেজি দ্বারা ব্যবহৃত কারেন্সিটি রিটার্ন করে।

id

int64

বিডিং কৌশলের আইডি।

name

string

বিডিং স্ট্র্যাটেজির নাম। একটি অ্যাকাউন্টের অন্তর্গত সমস্ত বিডিং স্ট্র্যাটেজির নাম অবশ্যই স্বতন্ত্র হতে হবে।

এই স্ট্রিংটির দৈর্ঘ্য UTF-8 বাইটে (ট্রিম করা) ১ থেকে ২৫৫-এর মধ্যে হতে হবে (উভয় মান সহ)।

effective_currency_code

string

বিডিং কৌশলে ব্যবহৃত মুদ্রা (আইএসও ৪২১৭ তিন-অক্ষরের কোড)।

ম্যানেজার গ্রাহকদের বিডিং স্ট্র্যাটেজির ক্ষেত্রে, এটি হলো স্ট্র্যাটেজি তৈরির সময় বিজ্ঞাপনদাতার দ্বারা সেট করা মুদ্রা। গ্রাহকদের পরিষেবা দেওয়ার ক্ষেত্রে, এটি হলো গ্রাহকের কারেন্সি_কোড।

দরপত্র কৌশলের মেট্রিকগুলো এই মুদ্রায় প্রতিবেদন করা হয়।

এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।

campaign_count

int64

এই বিডিং কৌশলের সাথে সংযুক্ত ক্যাম্পেইনের সংখ্যা।

এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।

non_removed_campaign_count

int64

এই বিডিং কৌশলের সাথে সংযুক্ত, অপসারণ না করা ক্যাম্পেইনগুলোর সংখ্যা।

এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।

ইউনিয়ন ফিল্ড scheme । দরপত্র স্কিম।

শুধুমাত্র একটিই নির্ধারণ করা যাবে। scheme নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:

enhanced_cpc

EnhancedCpc

একটি বিডিং কৌশল যা যেসব ক্লিকের মাধ্যমে কনভার্সন হওয়ার সম্ভাবনা বেশি বলে মনে হয়, সেগুলোর জন্য বিড বাড়িয়ে দেয় এবং যেসব ক্লিকের ক্ষেত্রে সম্ভাবনা কম বলে মনে হয়, সেগুলোর জন্য বিড কমিয়ে দেয়।

maximize_conversion_value

MaximizeConversionValue

একটি স্বয়ংক্রিয় বিডিং কৌশল যা আপনার বাজেট খরচ করে ক্যাম্পেইনগুলোর জন্য সর্বাধিক কনভার্সন ভ্যালু পেতে সাহায্য করে।

maximize_conversions

MaximizeConversions

একটি স্বয়ংক্রিয় বিডিং কৌশল যা আপনার বাজেট খরচ করে ক্যাম্পেইনগুলোর জন্য সর্বাধিক কনভার্সন পেতে সাহায্য করে।

target_cpa

TargetCpa

একটি বিডিং কৌশল যা আপনার নির্ধারিত লক্ষ্যমাত্রা অনুযায়ী অধিগ্রহণ প্রতি খরচে (CPA) যত বেশি সম্ভব রূপান্তর পেতে সাহায্য করার জন্য বিড নির্ধারণ করে।

target_impression_share

TargetImpressionShare

একটি বিডিং কৌশল যা স্বয়ংক্রিয়ভাবে একটি নির্বাচিত শতাংশ ইম্প্রেশনের দিকে অপ্টিমাইজ করে।

target_outrank_share

TargetOutrankShare

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

target_roas

TargetRoas

একটি বিডিং কৌশল যা আপনাকে বিজ্ঞাপনে ব্যয়ের উপর একটি নির্দিষ্ট গড় রিটার্ন (ROAS) অর্জনের মাধ্যমে রাজস্ব সর্বাধিক করতে সাহায্য করে।

target_spend

TargetSpend

একটি বিড কৌশল যা আপনার বাজেটের মধ্যে সর্বাধিক সংখ্যক ক্লিক পেতে সাহায্য করার জন্য বিড নির্ধারণ করে।

প্রচারণা

একটি প্রচারণা।

ক্ষেত্র
resource_name

string

ক্যাম্পেইনের রিসোর্স নাম। ক্যাম্পেইন রিসোর্স নামগুলোর গঠন নিম্নরূপ:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

প্রচারণার অবস্থা।

যখন একটি নতুন ক্যাম্পেইন যোগ করা হয়, তখন স্ট্যাটাসটি ডিফল্টভাবে 'সক্রিয়' (ENABLED) থাকে।

serving_status

CampaignServingStatus

ক্যাম্পেইনটির বিজ্ঞাপন পরিবেশনের অবস্থা।

bidding_strategy_system_status

BiddingStrategySystemStatus

ক্যাম্পেইনের বিডিং কৌশলের সিস্টেম স্ট্যাটাস।

ad_serving_optimization_status

AdServingOptimizationStatus

ক্যাম্পেইনটির বিজ্ঞাপন পরিবেশন অপ্টিমাইজেশন অবস্থা।

advertising_channel_type

AdvertisingChannelType

ক্যাম্পেইনের মধ্যে বিজ্ঞাপন পরিবেশনের প্রধান লক্ষ্য। টার্গেটিং অপশনগুলো network_settings এ আরও পরিমার্জন করা যেতে পারে।

নতুন ক্যাম্পেইন তৈরি করার সময় এই ফিল্ডটি আবশ্যক এবং এটি খালি রাখা যাবে না।

শুধুমাত্র ক্যাম্পেইন তৈরির সময় এটি সেট করা যায়। ক্যাম্পেইন তৈরি হয়ে গেলে এই ফিল্ডটি আর পরিবর্তন করা যায় না।

advertising_channel_sub_type

AdvertisingChannelSubType

advertising_channel_type এর ঐচ্ছিক পরিমার্জন। এটি অবশ্যই মূল চ্যানেল টাইপের একটি বৈধ উপ-প্রকার হতে হবে।

শুধুমাত্র ক্যাম্পেইন তৈরির সময় এটি সেট করা যায়। ক্যাম্পেইন তৈরি হয়ে গেলে এই ফিল্ডটি পরিবর্তন করা যায় না।

url_custom_parameters[]

CustomParameter

tracking_url_template , final_urls , বা mobile_final_urls এ কাস্টম প্যারামিটার ট্যাগ প্রতিস্থাপন করতে ব্যবহৃত ম্যাপিংগুলির তালিকা।

real_time_bidding_setting

RealTimeBiddingSetting

রিয়েল-টাইম বিডিং-এর সেটিংস, এই ফিচারটি শুধুমাত্র অ্যাড এক্সচেঞ্জ নেটওয়ার্ককে টার্গেট করা ক্যাম্পেইনগুলোর জন্য উপলব্ধ।

network_settings

NetworkSettings

ক্যাম্পেইনের জন্য নেটওয়ার্ক সেটিংস।

dynamic_search_ads_setting

DynamicSearchAdsSetting

ডাইনামিক সার্চ অ্যাড (DSA) নিয়ন্ত্রণের সেটিং।

shopping_setting

ShoppingSetting

শপিং ক্যাম্পেইন নিয়ন্ত্রণের সেটিং।

geo_target_type_setting

GeoTargetTypeSetting

বিজ্ঞাপনের জিওটার্গেটিং-এর সেটিং।

effective_labels[]

string

এই ক্যাম্পেইনের সাথে সংযুক্ত কার্যকরী লেবেলগুলোর রিসোর্স নাম। একটি কার্যকরী লেবেল হলো এমন একটি লেবেল যা এই ক্যাম্পেইনের উত্তরাধিকারসূত্রে প্রাপ্ত বা সরাসরি নির্ধারিত।

labels[]

string

এই প্রচারণার সাথে সংযুক্ত লেবেলগুলোর রিসোর্স নাম।

bidding_strategy_type

BiddingStrategyType

দরপত্র কৌশলের ধরণ।

একটি স্ট্যান্ডার্ড বিডিং স্ট্র্যাটেজি তৈরি করতে বিডিং স্কিম সেট করে, অথবা একটি পোর্টফোলিও বিডিং স্ট্র্যাটেজি তৈরি করতে bidding_strategy ফিল্ডটি সেট করে একটি বিডিং স্ট্র্যাটেজি তৈরি করা যেতে পারে।

এই ক্ষেত্রটি শুধুমাত্র পঠনযোগ্য।

accessible_bidding_strategy

string

AccessibleBiddingStrategy-এর রিসোর্স নাম, যা 'bidding_strategy' দ্বারা চিহ্নিত সংযুক্ত পোর্টফোলিও বিডিং স্ট্র্যাটেজির অবাধ অ্যাট্রিবিউটগুলোর একটি রিড-অনলি ভিউ। যদি ক্যাম্পেইনটি কোনো পোর্টফোলিও স্ট্র্যাটেজি ব্যবহার না করে, তবে এটি খালি থাকে। অবাধ স্ট্র্যাটেজি অ্যাট্রিবিউটগুলো সেই সমস্ত গ্রাহকদের জন্য উপলব্ধ যাদের সাথে স্ট্র্যাটেজিটি শেয়ার করা হয়েছে এবং এগুলো AccessibleBiddingStrategy রিসোর্স থেকে পড়া যায়। এর বিপরীতে, সীমাবদ্ধ অ্যাট্রিবিউটগুলো শুধুমাত্র স্ট্র্যাটেজির মালিক গ্রাহক এবং তাদের ম্যানেজারদের জন্য উপলব্ধ। সীমাবদ্ধ অ্যাট্রিবিউটগুলো শুধুমাত্র BiddingStrategy রিসোর্স থেকে পড়া যায়।

frequency_caps[]

FrequencyCapEntry

একটি তালিকা যা নির্ধারণ করে দেয় যে প্রতিটি ব্যবহারকারী এই ক্যাম্পেইনের বিজ্ঞাপনগুলো কতবার দেখতে পাবে।

selective_optimization

SelectiveOptimization

Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.

optimization_goal_setting

OptimizationGoalSetting

Optimization goal setting for this campaign, which includes a set of optimization goal types.

tracking_setting

TrackingSetting

Campaign-level settings for tracking information.

engine_id

string

ID of the campaign in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "campaign.id" instead.

excluded_parent_asset_field_types[]

AssetFieldType

The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level.

create_time

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. create_time will be deprecated in v1. Use creation_time instead.

creation_time

string

The timestamp when this campaign was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

last_modified_time

string

The datetime when this campaign was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

feed_types[]

AssetSetType

Types of feeds that are attached directly to this campaign.

id

int64

The ID of the campaign.

name

string

The name of the campaign.

This field is required and should not be empty when creating new campaigns.

It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.

tracking_url_template

string

The URL template for constructing a tracking URL.

campaign_budget

string

The resource name of the campaign budget of the campaign.

start_date

string

The date when campaign started in serving customer's timezone in YYYY-MM-DD format.

end_date

string

The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. On create, defaults to 2037-12-30, which means the campaign will run indefinitely. To set an existing campaign to run indefinitely, set this field to 2037-12-30.

final_url_suffix

string

Suffix used to append query parameters to landing pages that are served with parallel tracking.

url_expansion_opt_out

bool

Represents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.

Union field campaign_bidding_strategy . The bidding strategy for the campaign.

Must be either portfolio (created through BiddingStrategy service) or standard, that is embedded into the campaign. campaign_bidding_strategy can be only one of the following:

bidding_strategy

string

The resource name of the portfolio bidding strategy used by the campaign.

manual_cpa

ManualCpa

Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns.

manual_cpc

ManualCpc

Standard Manual CPC bidding strategy. Manual click-based bidding where user pays per click.

manual_cpm

ManualCpm

Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.

maximize_conversions

MaximizeConversions

Standard Maximize Conversions bidding strategy that automatically maximizes number of conversions while spending your budget.

maximize_conversion_value

MaximizeConversionValue

Standard Maximize Conversion Value bidding strategy that automatically sets bids to maximize revenue while spending your budget.

target_cpa

TargetCpa

Standard Target CPA bidding strategy that automatically sets bids to help get as many conversions as possible at the target cost-per-acquisition (CPA) you set.

target_impression_share

TargetImpressionShare

Target Impression Share bidding strategy. An automated bidding strategy that sets bids to achieve a chosen percentage of impressions.

target_roas

TargetRoas

Standard Target ROAS bidding strategy that automatically maximizes revenue while averaging a specific target return on ad spend (ROAS).

target_spend

TargetSpend

Standard Target Spend bidding strategy that automatically sets your bids to help get as many clicks as possible within your budget.

percent_cpc

PercentCpc

Standard Percent Cpc bidding strategy where bids are a fraction of the advertised price for some good or service.

target_cpm

TargetCpm

A bidding strategy that automatically optimizes cost per thousand impressions.

DynamicSearchAdsSetting

The setting for controlling Dynamic Search Ads (DSA).

Fields
domain_name

string

Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com".

language_code

string

Required. The language code specifying the language of the domain, for example, "en".

use_supplied_urls_only

bool

Whether the campaign uses advertiser supplied URLs exclusively.

GeoTargetTypeSetting

Represents a collection of settings related to ads geotargeting.

Fields
positive_geo_target_type

PositiveGeoTargetType

The setting used for positive geotargeting in this particular campaign.

negative_geo_target_type

NegativeGeoTargetType

The setting used for negative geotargeting in this particular campaign.

NetworkSettings

The network settings for the campaign.

Fields
target_search_network

bool

Whether ads will be served on sites in the Google Search Partners Network (requires target_google_search to also be true ).

target_content_network

bool

Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.

target_partner_search_network

bool

Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use target_search_network for that instead.

OptimizationGoalSetting

Optimization goal setting for this campaign, which includes a set of optimization goal types.

Fields
optimization_goal_types[]

OptimizationGoalType

The list of optimization goal types.

SelectiveOptimization

Selective optimization setting for this campaign, which includes a set of conversion actions to optimize this campaign towards. This feature only applies to app campaigns that use MULTI_CHANNEL as AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as AdvertisingChannelSubType.

Fields
conversion_actions[]

string

The selected set of resource names for conversion actions for optimizing this campaign.

ShoppingSetting

The setting for Shopping campaigns. Defines the universe of products that can be advertised by the campaign, and how this campaign interacts with other Shopping campaigns.

Fields
feed_label

string

Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated sales_country in the two-letter country code ( XX ) format, the feed_label field should be used instead. For more information see the feed label support article.

use_vehicle_inventory

bool

Whether to target Vehicle Listing inventory.

merchant_id

int64

ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.

sales_country

string

Sales country of products to include in the campaign.

campaign_priority

int32

Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.

enable_local

bool

Whether to include local products.

TrackingSetting

Campaign-level settings for tracking information.

Fields
tracking_url

string

The url used for dynamic tracking.

CampaignAsset

A link between a Campaign and an Asset.

Fields
resource_name

string

The resource name of the campaign asset. CampaignAsset resource names have the form:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

AssetLinkStatus

Status of the campaign asset.

campaign

string

The campaign to which the asset is linked.

asset

string

The asset which is linked to the campaign.

CampaignAssetSet

CampaignAssetSet is the linkage between a campaign and an asset set. Adding a CampaignAssetSet links an asset set with a campaign.

Fields
resource_name

string

The resource name of the campaign asset set. Asset set asset resource names have the form:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

The campaign to which this asset set is linked.

asset_set

string

The asset set which is linked to the campaign.

status

AssetSetLinkStatus

The status of the campaign asset set asset. Read-only.

CampaignAudienceView

A campaign audience view. Includes performance data from interests and remarketing lists for Display Network and YouTube Network ads, and remarketing lists for search ads (RLSA), aggregated by campaign and audience criterion. This view only includes audiences attached at the campaign level.

Fields
resource_name

string

The resource name of the campaign audience view. Campaign audience view resource names have the form:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

A campaign budget.

Fields
resource_name

string

The resource name of the campaign budget. Campaign budget resource names have the form:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

BudgetDeliveryMethod

The delivery method that determines the rate at which the campaign budget is spent.

Defaults to STANDARD if unspecified in a create operation.

period

BudgetPeriod

Period over which to spend the budget. Defaults to DAILY if not specified.

amount_micros

int64

The average daily amount to be spent by the campaign. This field is used when the CampaignBudget period is set to DAILY , which is the default.

Amount is specified in micros in the account's local currency. One million micros is equivalent to one currency unit. The effective monthly spend is capped at 30.4 times this daily amount.

This field is mutually exclusive with 'total_amount_micros'. Only one of 'amount_micros' or 'total_amount_micros' should be set.

CampaignCriterion

A campaign criterion.

Fields
resource_name

string

The resource name of the campaign criterion. Campaign criterion resource names have the form:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

display_name

string

The display name of the criterion.

This field is ignored for mutates.

type

CriterionType

The type of the criterion.

status

CampaignCriterionStatus

The status of the criterion.

last_modified_time

string

The datetime when this campaign criterion was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

criterion_id

int64

The ID of the criterion.

This field is ignored during mutate.

bid_modifier

float

The modifier for the bids when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers. Use 0 to opt out of a Device type.

negative

bool

Whether to target ( false ) or exclude ( true ) the criterion.

Union field criterion . The campaign criterion.

Exactly one must be set. criterion can be only one of the following:

keyword

KeywordInfo

Keyword.

location

LocationInfo

অবস্থান।

device

DeviceInfo

Device.

age_range

AgeRangeInfo

Age range.

gender

GenderInfo

Gender.

user_list

UserListInfo

User List.

language

LanguageInfo

Language.

webpage

WebpageInfo

Webpage.

location_group

LocationGroupInfo

Location Group

CampaignEffectiveLabel

Represents a relationship between a campaign and an effective label. An effective label is a label inherited or directly assigned to this campaign.

Fields
resource_name

string

Name of the resource. CampaignEffectivelabel resource names have the form: customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

The campaign to which the effective label is attached.

label

string

The effective label assigned to the campaign.

owner_customer_id

int64

The ID of the Customer which owns the effective label.

CampaignLabel

Represents a relationship between a campaign and a label.

Fields
resource_name

string

Name of the resource. Campaign label resource names have the form: customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}

campaign

string

The campaign to which the label is attached.

label

string

The label assigned to the campaign.

owner_customer_id

int64

The ID of the Customer which owns the label.

CartDataSalesView

Cart data sales view.

Provides information about the products which were purchased if conversions with cart data is implemented. Performance metrics like revenue, gross profit, lead/cross-sell metrics etc. and Merchant Center attributes such as brand, category etc. are available for products defined in an inventory feed and sold as a result of Google ads. For purchases attributed to clicks on Shopping ads, dimensions of both clicked and sold products can be viewed together.

Fields
resource_name

string

The resource name of the Cart data sales view. Cart data sales view resource names have the form: customers/{customer_id}/cartDataSalesView

Conversion

A conversion.

Fields
resource_name

string

The resource name of the conversion. Conversion resource names have the form:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

id

int64

The ID of the conversion

criterion_id

int64

Search Ads 360 criterion ID. A value of 0 indicates that the criterion is unattributed.

merchant_id

int64

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

ad_id

int64

Ad ID. A value of 0 indicates that the ad is unattributed.

click_id

string

A unique string, for the visit that the conversion is attributed to, that is passed to the landing page as the click id URL parameter.

visit_id

int64

The Search Ads 360 visit ID that the conversion is attributed to.

advertiser_conversion_id

string

For offline conversions, this is an ID provided by advertisers. If an advertiser doesn't specify such an ID, Search Ads 360 generates one. For online conversions, this is equal to the id column or the floodlight_order_id column depending on the advertiser's Floodlight instructions.

product_id

string

The ID of the product clicked on.

product_channel

ProductChannel

The sales channel of the product that was clicked on: Online or Local.

product_language_code

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

product_store_id

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

product_country_code

string

The country (ISO-3166-format) registered for the inventory feed that contains the product clicked on.

attribution_type

AttributionType

What the conversion is attributed to: Visit or Keyword+Ad.

conversion_date_time

string

The timestamp of the conversion event.

conversion_last_modified_date_time

string

The timestamp of the last time the conversion was modified.

conversion_visit_date_time

string

The timestamp of the visit that the conversion is attributed to.

conversion_quantity

int64

The quantity of items recorded by the conversion, as determined by the qty url parameter. The advertiser is responsible for dynamically populating the parameter (such as number of items sold in the conversion), otherwise it defaults to 1.

conversion_revenue_micros

int64

The adjusted revenue in micros for the conversion event. This will always be in the currency of the serving account.

floodlight_original_revenue

int64

The original, unchanged revenue associated with the Floodlight event (in the currency of the current report), before Floodlight currency instruction modifications.

floodlight_order_id

string

The Floodlight order ID provided by the advertiser for the conversion.

status

ConversionStatus

The status of the conversion, either ENABLED or REMOVED..

asset_id

int64

ID of the asset which was interacted with during the conversion event.

asset_field_type

AssetFieldType

Asset field type of the conversion event.

ConversionAction

A conversion action.

Fields
resource_name

string

The resource name of the conversion action. Conversion action resource names have the form:

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

Timestamp of the Floodlight activity's creation, formatted in ISO 8601.

status

ConversionActionStatus

The status of this conversion action for conversion event accrual.

type

ConversionActionType

The type of this conversion action.

category

ConversionActionCategory

The category of conversions reported for this conversion action.

value_settings

ValueSettings

Settings related to the value for conversion events associated with this conversion action.

attribution_model_settings

AttributionModelSettings

Settings related to this conversion action's attribution model.

floodlight_settings

FloodlightSettings

Floodlight settings for Floodlight conversion types.

id

int64

The ID of the conversion action.

name

string

The name of the conversion action.

This field is required and should not be empty when creating new conversion actions.

primary_for_goal

bool

If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional.

owner_customer

string

The resource name of the conversion action owner customer, or null if this is a system-defined conversion action.

include_in_client_account_conversions_metric

bool

Whether this conversion action should be included in the "client_account_conversions" metric.

include_in_conversions_metric

bool

Whether this conversion action should be included in the "conversions" metric.

click_through_lookback_window_days

int64

The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event.

app_id

string

App ID for an app conversion action.

AttributionModelSettings

Settings related to this conversion action's attribution model.

Fields
attribution_model

AttributionModel

The attribution model type of this conversion action.

data_driven_model_status

DataDrivenModelStatus

The status of the data-driven attribution model for the conversion action.

FloodlightSettings

Settings related to a Floodlight conversion action.

Fields
activity_group_tag

string

String used to identify a Floodlight activity group when reporting conversions.

activity_tag

string

String used to identify a Floodlight activity when reporting conversions.

activity_id

int64

ID of the Floodlight activity in DoubleClick Campaign Manager (DCM).

ValueSettings

Settings related to the value for conversion events associated with this conversion action.

Fields
default_value

double

The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value.

default_currency_code

string

The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value.

always_use_default_value

bool

Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action.

ConversionCustomVariable

A conversion custom variable. See "About custom Floodlight metrics and dimensions in the new Search Ads 360" at https://support.google.com/sa360/answer/13567857

Fields
resource_name

string

The resource name of the conversion custom variable. Conversion custom variable resource names have the form:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

The ID of the conversion custom variable.

name

string

Required. The name of the conversion custom variable. Name should be unique. The maximum length of name is 100 characters. There should not be any extra spaces before and after.

tag

string

Required. The tag of the conversion custom variable. Tag should be unique and consist of a "u" character directly followed with a number less than ormequal to 100. For example: "u4".

status

ConversionCustomVariableStatus

The status of the conversion custom variable for conversion event accrual.

owner_customer

string

The resource name of the customer that owns the conversion custom variable.

family

ConversionCustomVariableFamily

Family of the conversion custom variable.

cardinality

ConversionCustomVariableCardinality

Cardinality of the conversion custom variable.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

Fields for Search Ads 360 floodlight conversion custom variables.

custom_column_ids[]

int64

The IDs of custom columns that use this conversion custom variable.

FloodlightConversionCustomVariableInfo

Information for Search Ads 360 Floodlight Conversion Custom Variables.

Fields
floodlight_variable_type

FloodlightVariableType

Floodlight variable type defined in Search Ads 360.

floodlight_variable_data_type

FloodlightVariableDataType

Floodlight variable data type defined in Search Ads 360.

ConversionTrackingSetting

A collection of customer-wide settings related to Search Ads 360 Conversion Tracking.

Fields
accepted_customer_data_terms

bool

Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709 .

conversion_tracking_status

ConversionTrackingStatus

Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request.

enhanced_conversions_for_leads_enabled

bool

Whether the customer is opted-in for enhanced conversions for leads. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only.

google_ads_conversion_customer

string

The resource name of the customer where conversions are created and managed. This field is read-only.

conversion_tracking_id

int64

The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only.

google_ads_cross_account_conversion_tracking_id

int64

The conversion tracking id of the customer's manager. This is set when the customer is opted into conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only.

cross_account_conversion_tracking_id

int64

The conversion tracking id of the customer's manager. This is set when the customer is opted into cross-account conversion tracking, and it overrides conversion_tracking_id.

CustomColumn

A custom column. See Search Ads 360 custom column at https://support.google.com/sa360/answer/9633916

Fields
resource_name

string

The resource name of the custom column. Custom column resource names have the form:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

ID of the custom column.

name

string

User-defined name of the custom column.

description

string

User-defined description of the custom column.

value_type

CustomColumnValueType

The type of the result value of the custom column.

references_attributes

bool

True when the custom column is referring to one or more attributes.

references_metrics

bool

True when the custom column is referring to one or more metrics.

queryable

bool

True when the custom column is available to be used in the query of SearchAds360Service.Search and SearchAds360Service.SearchStream.

referenced_system_columns[]

string

The list of the referenced system columns of this custom column. For example, A custom column "sum of impressions and clicks" has referenced system columns of {"metrics.clicks", "metrics.impressions"}.

render_type

CustomColumnRenderType

How the result value of the custom column should be interpreted.

গ্রাহক

A customer.

Fields
resource_name

string

The resource name of the customer. Customer resource names have the form:

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Conversion tracking setting for a customer.

account_type

AccountType

Engine account type, for example, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, etc.

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM) setting for a manager customer.

account_status

AccountStatus

Account status, for example, Enabled, Paused, Removed, etc.

last_modified_time

string

The datetime when this customer was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.

engine_id

string

ID of the account in the external engine account.

status

CustomerStatus

The status of the customer.

creation_time

string

The timestamp when this customer was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

manager_id

int64

The customer ID of the manager. A 0 value indicates that the customer has no SA360 manager.

manager_descriptive_name

string

The descriptive name of the manager.

sub_manager_id

int64

The customer ID of the sub manager. A 0 value indicates that the customer has no sub SA360 manager.

sub_manager_descriptive_name

string

The descriptive name of the sub manager.

associate_manager_id

int64

The customer ID of the associate manager. A 0 value indicates that the customer has no SA360 associate manager.

associate_manager_descriptive_name

string

The descriptive name of the associate manager.

account_level

AccountLevelType

The account level of the customer: Manager, Sub-manager, Associate manager, Service account.

id

int64

The ID of the customer.

descriptive_name

string

Optional, non-unique descriptive name of the customer.

currency_code

string

The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.

time_zone

string

The local timezone ID of the customer.

tracking_url_template

string

The URL template for constructing a tracking URL out of parameters.

final_url_suffix

string

The URL template for appending params to the final URL.

auto_tagging_enabled

bool

Whether auto-tagging is enabled for the customer.

manager

bool

Whether the customer is a manager.

CustomerAsset

A link between a customer and an asset.

Fields
resource_name

string

The resource name of the customer asset. CustomerAsset resource names have the form:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

Required. The asset which is linked to the customer.

status

AssetLinkStatus

Status of the customer asset.

CustomerAssetSet

CustomerAssetSet is the linkage between a customer and an asset set. Adding a CustomerAssetSet links an asset set with a customer.

Fields
resource_name

string

The resource name of the customer asset set. Asset set asset resource names have the form:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

The asset set which is linked to the customer.

customer

string

The customer to which this asset set is linked.

status

AssetSetLinkStatus

The status of the customer asset set asset. Read-only.

CustomerClient

A link between the given customer and a client customer. CustomerClients only exist for manager customers. All direct and indirect client customers are included, as well as the manager itself.

Fields
resource_name

string

The resource name of the customer client. CustomerClient resource names have the form: customers/{customer_id}/customerClients/{client_customer_id}

applied_labels[]

string

The resource names of the labels owned by the requesting customer that are applied to the client customer. Label resource names have the form:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

The status of the client customer. Read only.

client_customer

string

The resource name of the client-customer which is linked to the given customer. Read only.

hidden

bool

Specifies whether this is a hidden account.

Read only.

level

int64

Distance between given customer and client. For self link, the level value will be 0. Read only.

time_zone

string

Common Locale Data Repository (CLDR) string representation of the time zone of the client, for example, America/Los_Angeles. Read only.

test_account

bool

Identifies if the client is a test account. Read only.

manager

bool

Identifies if the client is a manager. Read only.

descriptive_name

string

Descriptive name for the client. Read only.

currency_code

string

Currency code (for example, 'USD', 'EUR') for the client. Read only.

id

int64

The ID of the client customer. Read only.

DoubleClickCampaignManagerSetting

DoubleClick Campaign Manager (DCM) setting for a manager customer.

Fields
advertiser_id

int64

ID of the Campaign Manager advertiser associated with this customer.

network_id

int64

ID of the Campaign Manager network associated with this customer.

time_zone

string

Time zone of the Campaign Manager network associated with this customer in IANA Time Zone Database format, such as America/New_York.

DynamicSearchAdsSearchTermView

A dynamic search ads search term view.

Fields
resource_name

string

The resource name of the dynamic search ads search term view. Dynamic search ads search term view resource names have the form:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_page

string

The dynamically selected landing page URL of the impression.

This field is read-only.

GenderView

A gender view resource. Represents the view of a customer's performance metrics aggregated by gender. All statistics are aggregated at the ad group level.

Note: While you can segment metrics by age range using age_range_view or by gender using gender_view , the Search Ads 360 API does not support segmenting metrics by both age range and gender simultaneously in a single query. Analyzing performance across both dimensions combined is not supported in the Search Ads 360 API.

Fields
resource_name

string

The resource name of the gender view. Gender view resource names have the form:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

A geo target constant.

Fields
resource_name

string

The resource name of the geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Geo target constant status.

id

int64

The ID of the geo target constant.

name

string

Geo target constant English name.

country_code

string

The ISO-3166-1 alpha-2 country code that is associated with the target.

target_type

string

Geo target constant target type.

canonical_name

string

The fully qualified English name, consisting of the target's name and that of its parent and country.

parent_geo_target

string

The resource name of the parent geo target constant. Geo target constant resource names have the form:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

A keyword view.

Fields
resource_name

string

The resource name of the keyword view. Keyword view resource names have the form:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

লেবেল

A label.

Fields
resource_name

string

Name of the resource. Label resource names have the form: customers/{owner_customer_id}/labels/{label_id}

status

LabelStatus

Status of the label. Read only.

text_label

TextLabel

A type of label displaying text on a colored background.

id

int64

ID of the label. Read only.

name

string

The name of the label.

This field is required and should not be empty when creating a new label.

The length of this string should be between 1 and 80, inclusive.

LanguageConstant

A language.

Fields
resource_name

string

The resource name of the language constant. Language constant resource names have the form:

languageConstants/{criterion_id}

id

int64

The ID of the language constant.

code

string

The language code, for example, "en_US", "en_AU", "es", "fr", etc.

name

string

The full name of the language in English, for example, "English (US)", "Spanish", etc.

targetable

bool

Whether the language is targetable.

ListingGroupFilterDimension

Listing dimensions for the asset group listing group filter.

Fields
Union field dimension . Dimension of one of the types below is always present. dimension can be only one of the following:
product_bidding_category

ProductBiddingCategory

Bidding category of a product offer.

product_brand

ProductBrand

Brand of a product offer.

product_channel

ProductChannel

Locality of a product offer.

product_condition

ProductCondition

Condition of a product offer.

product_custom_attribute

ProductCustomAttribute

Custom attribute of a product offer.

product_item_id

ProductItemId

Item id of a product offer.

product_type

ProductType

Type of a product offer.

ProductBiddingCategory

One element of a bidding category at a certain level. Top-level categories are at level 1, their children at level 2, and so on. We currently support up to 5 levels. The user must specify a dimension type that indicates the level of the category. All cases of the same subdivision must have the same dimension type (category level).

Fields
level

ListingGroupFilterBiddingCategoryLevel

Indicates the level of the category in the taxonomy.

id

int64

ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436

ProductBrand

Brand of the product.

Fields
value

string

String value of the product brand.

ProductChannel

Locality of a product offer.

Fields
channel

ListingGroupFilterProductChannel

Value of the locality.

ProductCondition

Condition of a product offer.

Fields
condition

ListingGroupFilterProductCondition

Value of the condition.

ProductCustomAttribute

Custom attribute of a product offer.

Fields
index

ListingGroupFilterCustomAttributeIndex

Indicates the index of the custom attribute.

value

string

String value of the product custom attribute.

ProductItemId

Item id of a product offer.

Fields
value

string

Value of the id.

পণ্যের ধরণ

Type of a product offer.

Fields
level

ListingGroupFilterProductTypeLevel

Level of the type.

value

string

Value of the type.

ListingGroupFilterDimensionPath

The path defining of dimensions defining a listing group filter.

Fields
dimensions[]

ListingGroupFilterDimension

The complete path of dimensions through the listing group filter hierarchy (excluding the root node) to this listing group filter.

LocationView

A location view summarizes the performance of campaigns by a Location criterion.

Fields
resource_name

string

The resource name of the location view. Location view resource names have the form:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

A Product Bidding Category.

Fields
resource_name

string

The resource name of the product bidding category. Product bidding category resource names have the form:

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Level of the product bidding category.

status

ProductBiddingCategoryStatus

Status of the product bidding category.

id

int64

ID of the product bidding category.

This ID is equivalent to the google_product_category ID as described in this article: https://support.google.com/merchants/answer/6324436 .

country_code

string

Two-letter upper-case country code of the product bidding category.

product_bidding_category_constant_parent

string

Resource name of the parent product bidding category.

language_code

string

Language code of the product bidding category.

localized_name

string

Display value of the product bidding category localized according to language_code.

ProductGroupView

A product group view.

Fields
resource_name

string

The resource name of the product group view. Product group view resource names have the form:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

A field or resource (artifact) used by SearchAds360Service.

Fields
resource_name

string

The resource name of the artifact. Artifact resource names have the form:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

The category of the artifact.

selectable_with[]

string

The names of all resources, segments, and metrics that are selectable with the described artifact.

attribute_resources[]

string

The names of all resources that are selectable with the described artifact. Fields from these resources do not segment metrics when included in search queries.

This field is only set for artifacts whose category is RESOURCE.

metrics[]

string

This field lists the names of all metrics that are selectable with the described artifact when it is used in the FROM clause. It is only set for artifacts whose category is RESOURCE.

segments[]

string

This field lists the names of all artifacts, whether a segment or another resource, that segment metrics when included in search queries and when the described artifact is used in the FROM clause. It is only set for artifacts whose category is RESOURCE.

enum_values[]

string

Values the artifact can assume if it is a field of type ENUM.

This field is only set for artifacts of category SEGMENT or ATTRIBUTE.

data_type

SearchAds360FieldDataType

This field determines the operators that can be used with the artifact in WHERE clauses.

name

string

The name of the artifact.

selectable

bool

Whether the artifact can be used in a SELECT clause in search queries.

filterable

bool

Whether the artifact can be used in a WHERE clause in search queries.

sortable

bool

Whether the artifact can be used in a ORDER BY clause in search queries.

type_url

string

The URL of proto describing the artifact's data type.

is_repeated

bool

Whether the field artifact is repeated.

ShoppingPerformanceView

Shopping performance view.

Provides Shopping campaign and Performance Max campaign statistics aggregated at several product dimension levels. Product dimension values from Merchant Center such as brand, category, custom attributes, product condition, and product type will reflect the state of each dimension as of the date and time when the corresponding event was recorded.

The number of impressions and clicks that shopping_performance_view returns stats for may be different from campaign reports. shopping_performance_view shows impressions and clicks on products appearing in ads, while campaign reports show impressions and clicks on the ads themselves. Depending on the format, an ad can show from zero to several products, so the numbers may not match.

In Search Ads 360 UI, you can query impressions and clicks of products appearing in ads by selecting a column from "Product attributes" in the report editor. For example, selecting the "Brand" column is equivalent to selecting segments.product_brand .

Fields
resource_name

string

The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView

UserList

A user list. This is a list of users a customer may target. The unique key of a user list consists of the following fields: id . Note that the name must also be unique for user lists owned by a given customer, except in some cases where access_reason is set to SHARED . Violating the unique name constraint produces error: UserListError.INVALID_NAME .

Fields
resource_name

string

The resource name of the user list. User list resource names have the form:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Type of this list.

This field is read-only.

id

int64

Id of the user list.

name

string

Name of this user list. Unique per user list, except in some cases where a user list of the same name has access_reason set to SHARED .

UserLocationView

A user location view.

User Location View includes all metrics aggregated at the country level, one row per country. It reports metrics at the actual physical location of the user by targeted or not targeted location. If other segment fields are used, you may get more than one row per country.

Fields
resource_name

string

The resource name of the user location view. UserLocation view resource names have the form:

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

country_criterion_id

int64

Criterion Id for the country.

targeting_location

bool

Indicates whether location was targeted or not.

পরিদর্শন করুন

A visit.

Fields
resource_name

string

The resource name of the visit. Visit resource names have the form:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

The ID of the visit.

criterion_id

int64

Search Ads 360 keyword ID. A value of 0 indicates that the keyword is unattributed.

merchant_id

int64

The Search Ads 360 inventory account ID containing the product that was clicked on. Search Ads 360 generates this ID when you link an inventory account in Search Ads 360.

ad_id

int64

Ad ID. A value of 0 indicates that the ad is unattributed.

click_id

string

A unique string for each visit that is passed to the landing page as the click id URL parameter.

visit_date_time

string

The timestamp of the visit event. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format.

product_id

string

The ID of the product clicked on.

product_channel

ProductChannel

The sales channel of the product that was clicked on: Online or Local.

product_language_code

string

The language (ISO-639-1) that has been set for the Merchant Center feed containing data about the product.

product_store_id

string

The store in the Local Inventory Ad that was clicked on. This should match the store IDs used in your local products feed.

product_country_code

string

The country (ISO-3166 format) registered for the inventory feed that contains the product clicked on.

asset_id

int64

ID of the asset which was interacted with during the visit event.

asset_field_type

AssetFieldType

Asset field type of the visit event.

WebpageView

A webpage view.

Fields
resource_name

string

The resource name of the webpage view. Webpage view resource names have the form:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}