‘Ad Traffic By Keywords’ টাস্ক সেট করুন
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
‘Ad Traffic By Keywords’ টাস্ক সেট করুন
নির্দিষ্ট bid ও match ধরনের জন্য keywords-এর ক্লিক, ইম্প্রেশন ও খরচের পূর্বাভাস কিউতে রাখে এবং একটি টাস্ক id ফেরত দেয়। search_partners-এ Google-এর পার্টনার নেটওয়ার্ক থাকে। DataForSEO-এর এনভেলপে মোড়ানো: ডেটা tasks[0].result-এ, ফলাফল tasks[0].status_code-এ - প্রত্যাখ্যাত রিকোয়েস্টও HTTP 200 ফেরত দেয়। এখানে Google Ads-এর এটিই একমাত্র এন্ডপয়েন্ট যার কোনো লাইভ রূপ নেই — পূর্বাভাস সবসময় কিউতে যায়। get_dataforseo_keywords_gads_ad_traffic_fetch দিয়ে আনুন।
মূল্য রেফারেন্স
- মিটারিং: রিপোর্ট করা রেসপন্স খরচ
- রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.09
- রেফারেন্স গ্রাহক গুণক: 1.0। ইতিমধ্যে নিষ্পত্তি হওয়া গ্রাহক অর্থের উপর এটি আবার প্রয়োগ করবেন না
শুধুমাত্র রেফারেন্স মেটাডেটা, কোনো অ্যাকাউন্ট কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo বিলিং রেকর্ড অনুযায়ী হয়।
- টাইপ: array (object | null)[]
- bidটাইপ: number
সর্বোচ্চ কাস্টম বিড
আবশ্যক ফিল্ড
সংগৃহীত ডেটা এই মানের উপর ভিত্তি করে হবে
এটি সেই মূল্য বোঝায় যা আপনি একটি বিজ্ঞাপনের জন্য দিতে প্রস্তুত; এখানে যত বেশি মান নির্দিষ্ট করবেন, ফেরত দেওয়া মেট্রিকে তত বেশি মান পাবেন
আরও জানুন এই Help Center নিবন্ধে - dateটাইপ: string
_from পূর্বাভাস সময়সীমার শুরুর তারিখ
date_toনির্দিষ্ট করলে আবশ্যক ফিল্ড
আপনিdate_fromওdate_toনির্দিষ্ট করলেdate_intervalনির্দিষ্ট করার প্রয়োজন নেই
সর্বনিম্ন মান আগামীকালের তারিখdate_from-এ নির্দিষ্ট মানdate_to-এর পরে হতে পারবে না
তারিখের ফরম্যাট:"yyyy-mm-dd"
উদাহরণ:"2021-10-30"যদি Status endpointactual_dataফিল্ডেfalseফেরত দেয়, তাহলেdate_fromগত মাসের আগের মাস এবং তার আগে পর্যন্ত সেট করা যাবে;
যদি Status endpointactual_dataফিল্ডেtrueফেরত দেয়, তাহলেdate_fromগত মাস এবং তার আগে পর্যন্ত সেট করা যাবে - dateটাইপ: string | null
_interval পূর্বাভাস তারিখের ব্যবধান
ঐচ্ছিক ফিল্ড
আপনিdate_intervalনির্দিষ্ট করলেdate_fromওdate_toনির্দিষ্ট করার প্রয়োজন নেই
সম্ভাব্য মান:next_week,next_month,next_quarter
ডিফল্ট মান:next_month - dateটাইপ: string
_to পূর্বাভাস সময়সীমার শেষ তারিখ
date_fromনির্দিষ্ট করলে আবশ্যক ফিল্ড
আপনিdate_fromওdate_toনির্দিষ্ট করলেdate_intervalনির্দিষ্ট করার প্রয়োজন নেই
সর্বনিম্ন মানdate_from+1 দিন
সর্বোচ্চ মান পরবর্তী বছরের বর্তমান দিন ও মাস
তারিখের ফরম্যাট:"yyyy-mm-dd"
উদাহরণ:"2022-10-30" - keywordsটাইপ: array string[]
কীওয়ার্ড
আবশ্যক ফিল্ড
সর্বোচ্চ কতগুলো কীওয়ার্ড নির্দিষ্ট করতে পারবেন: 1000
প্রতিটি কীওয়ার্ডের জন্য সর্বোচ্চ অক্ষর: 80
প্রতিটি কীওয়ার্ড বাক্যাংশের জন্য সর্বোচ্চ শব্দ: 10
আপনার নির্দিষ্ট করা কীওয়ার্ড lowercase ফরম্যাটে রূপান্তরিত হবে
নোট #1: Google Ads কিছু কীওয়ার্ড গোষ্ঠীর জন্য কোনো ডেটা ফেরত নাও দিতে পারে;
নোট #2: Google Ads একই ধরনের কীওয়ার্ড গোষ্ঠীর জন্য সম্মিলিত সার্চ ভলিউম মান প্রদান করে
একই ধরনের কীওয়ার্ডের সার্চ ভলিউম পেতে আমরা এ ধরনের কীওয়ার্ড আলাদা রিকোয়েস্টে জমা দেওয়ার পরামর্শ দিই;
নোট #3: Google Ads কিছু প্রতীক ও অক্ষর (যেমন UTF প্রতীক, ইমোজি) ব্যবহারের অনুমতি দেয় না, তাই টাস্ক সেট করার সময় সেগুলো ব্যবহার করা যাবে না;
কোন প্রতীক ও অক্ষর ব্যবহার করা যাবে তা জানতে এই নিবন্ধ দেখুনDataForSEO API-তে
keywordওkeywordsফিল্ডের নিয়ম ও সীমাবদ্ধতা সম্পর্কে এই Help Center নিবন্ধে জানুন - languageটাইপ: string | null
_code সার্চ ইঞ্জিন ভাষা কোড
ঐচ্ছিক ফিল্ডlanguage_code-সহ উপলব্ধ সার্চ ইঞ্জিন ভাষার তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
উদাহরণ:en - languageটাইপ: string | null
_name সার্চ ইঞ্জিন ভাষার পূর্ণ নাম
ঐচ্ছিক ফিল্ডlanguage_name-সহ উপলব্ধ সার্চ ইঞ্জিন ভাষার তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
উদাহরণ:English - locationটাইপ: integer | null
_code সার্চ ইঞ্জিন অবস্থান কোড
ঐচ্ছিক ফিল্ড
আপনি অবস্থান নির্দিষ্ট না করলে আপনি বিশ্বব্যাপী ফলাফল পাবেন, অর্থাৎ সব উপলব্ধ অবস্থানের জন্য;
আপনি এই ফিল্ড ব্যবহার করলেlocation_nameবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেই;location_code-সহ উপলব্ধ সার্চ ইঞ্জিন অবস্থানের তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
উদাহরণ:2840 - locationটাইপ: string | null
_coordinate অবস্থানের GPS স্থানাঙ্ক
ঐচ্ছিক ফিল্ড
আপনি অবস্থান নির্দিষ্ট না করলে আপনি বিশ্বব্যাপী ফলাফল পাবেন, অর্থাৎ সব উপলব্ধ অবস্থানের জন্য;
আপনি এই ফিল্ড ব্যবহার করলেlocation_nameবাlocation_codeনির্দিষ্ট করার প্রয়োজন নেই;location_coordinateপ্যারামিটার "latitude,longitude" ফরম্যাটে উল্লেখ করতে হবে;
ডেটা সেই দেশের জন্য দেওয়া হবে যার অন্তর্গত নির্দিষ্ট স্থানাঙ্ক;
উদাহরণ:52.6178549,-155.352142 - locationটাইপ: string | null
_name সার্চ ইঞ্জিন অবস্থানের পূর্ণ নাম
ঐচ্ছিক ফিল্ড
আপনি অবস্থান নির্দিষ্ট না করলে আপনি বিশ্বব্যাপী ফলাফল পাবেন, অর্থাৎ সব উপলব্ধ অবস্থানের জন্য;
আপনি এই ফিল্ড ব্যবহার করলেlocation_codeবাlocation_coordinateনির্দিষ্ট করার প্রয়োজন নেইlocation_name-সহ উপলব্ধ সার্চ ইঞ্জিন অবস্থানের তালিকা পেতে আলাদা রিকোয়েস্ট পাঠান:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
উদাহরণ:London,England,United Kingdom - matchটাইপ: string
কীওয়ার্ড ম্যাচ-টাইপ
আবশ্যক ফিল্ড
নিম্নলিখিত মান নিতে পারে:exact,broad,phrase - pingbackটাইপ: string | null
_url সম্পন্ন টাস্কের নোটিফিকেশন URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা আপনার নির্দিষ্ট URL-এ GET রিকোয়েস্ট পাঠিয়ে জানাব
আপনি ‘$id’ স্ট্রিংকে$idভ্যারিয়েবল হিসেবে এবং ‘$tag’ কে URL-এনকোডেড$tagভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
উদাহরণ:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
নোট:pingback_url-এ বিশেষ অক্ষর URL-এনকোড হবে;
অর্থাৎ,#অক্ষরটি%23হিসেবে এনকোড হবে - postbackটাইপ: string | null
_url টাস্কের ফলাফল পাঠানোর URL
ঐচ্ছিক ফিল্ড
টাস্ক সম্পন্ন হলে আমরা তার ফলাফলgzipফরম্যাটে কম্প্রেস করে আপনার নির্দিষ্টpostback_url-এ POST রিকোয়েস্ট পাঠাব
আপনি ‘$id’ স্ট্রিংকে$idভ্যারিয়েবল হিসেবে এবং ‘$tag’ কে URL-এনকোডেড$tagভ্যারিয়েবল হিসেবে ব্যবহার করতে পারেন। রিকোয়েস্ট পাঠানোর আগে আমরা প্রয়োজনীয় মান সেট করব।
উদাহরণ:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
নোট:postback_url-এ বিশেষ অক্ষর URL-এনকোড হবে;
অর্থাৎ,#অক্ষরটি%23হিসেবে এনকোড হবে - sortটাইপ: string | null
_by ফলাফল সর্টিং প্যারামিটার
ঐচ্ছিক ফিল্ড
ফলাফলগুলোকেrelevance,average_cpc,costবাclicksঅনুযায়ী অবরোহী ক্রমে সাজাতে এই প্যারামিটারগুলো ব্যবহার করুন
ডিফল্ট মান:relevance - tagটাইপ: string | null
ব্যবহারকারী-নির্ধারিত টাস্ক আইডেন্টিফায়ার
ঐচ্ছিক ফিল্ড
অক্ষরসীমা 255
এই প্যারামিটার দিয়ে টাস্ক শনাক্ত করে ফলাফলের সঙ্গে মিলিয়ে নিতে পারেন
নির্দিষ্টtagমান response-এরdataঅবজেক্টে পাবেন
- টাইপ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo200
- টাইপ: number | null ফরম্যাট: doublecost
টাস্কের মোট খরচ, USD
- টাইপ: integer | nullstatus
_code সাধারণ স্ট্যাটাস কোড সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- টাইপ: string | nullstatus
_message সাধারণ তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- টাইপ: array (object | null)[] | nulltasks
টাস্কের অ্যারে
- টাইপ: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
- costটাইপ: number | null ফরম্যাট: double
টাস্কের মোট খরচ, USD
- dataটাইপ: object | null
এতে POST রিকোয়েস্টে আপনি যে প্যারামিটারগুলো নির্দিষ্ট করেছিলেন সেগুলোই থাকে
- propertyটাইপ: object | null
Name
- idটাইপ: string | null
টাস্ক আইডেন্টিফায়ার আমাদের সিস্টেমে অনন্য টাস্ক আইডেন্টিফায়ার, UUID ফরম্যাটে
- pathটাইপ: array (string | null)[] | null
URL পাথ
- resultটাইপ: object | null
ফলাফলের অ্যারে
এই ক্ষেত্রে মানnullহবে - resultটাইপ: integer | null ফরম্যাট: int64
_count result অ্যারেতে এলিমেন্টের সংখ্যা
- statusটাইপ: integer | null
_code টাস্কের স্ট্যাটাস কোড DataForSEO কর্তৃক তৈরি, যা নিম্নলিখিত পরিসরে হতে পারে: 10000-60000 সম্পূর্ণ response কোড তালিকা এখানে দেখতে পাবেন
- statusটাইপ: string | null
_message টাস্কের তথ্যমূলক বার্তা সাধারণ তথ্যমূলক বার্তার সম্পূর্ণ তালিকা এখানে দেখতে পাবেন
- timeটাইপ: string | null
সম্পাদনের সময়, সেকেন্ড
- টাইপ: integer | null ফরম্যাট: int64tasks
_count tasks অ্যারেতে টাস্কের সংখ্যা
- টাইপ: integer | null ফরম্যাট: int64tasks
_error ত্রুটিসহ ফেরত দেওয়া tasks অ্যারেতে টাস্কের সংখ্যা
- টাইপ: string | nulltime
মোট সম্পাদন সময়, সেকেন্ড
- টাইপ: string | nullversion
API-এর বর্তমান সংস্করণ
application/json - 400
রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।
- 401
একটি বৈধ Felo API key আবশ্যক।
- 402
বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।
- 403
অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।
- 429
রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।
- 502
পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।
- 503
API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।
- 504
রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।
- default
ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"bid": 999,
"match": "exact",
"keywords": [
"seo marketing"
]
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}