আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

অ্যাপ কনভার্সন ট্র্যাকিং ও রিমার্কেটিং - অনুরোধ/উত্তর সংক্রান্ত স্পেসিফিকেশন

অ্যাপ ইউজার-এজেন্ট

স্প্যামের বিরুদ্ধে লড়াই করার জন্য আমাদের বৃহত্তর প্রচেষ্টার অংশ হিসেবে, আমরা অ্যাপ ব্যবহারকারীর পক্ষে কোনও অ্যানালিটিক্স/বিজ্ঞাপন প্রোডাক্টের পাঠানো User-Agent হেডার জন্য একটি স্ট্যান্ডার্ড স্পেসিফিকেশন তৈরি করেছি। নিম্নলিখিত স্পেসিফিকেশন মেনে চলার জন্য নেটিভ কোড থেকে অ্যাপের ইউজার-এজেন্ট পাওয়া যেতে পারে:

name version (os_and_version; locale; device; build; Proxy)

এইসব ফিল্ডের সংজ্ঞা নিচে দেওয়া হল:

User-Agent কম্পোনেন্ট
`name`	অ্যানালিটিক্স/বিজ্ঞাপন প্রোডাক্টের নাম। (`Google AdMob`) মনে রাখবেন, ক্লায়েন্ট সাইডে ব্যবহারকারীর এজেন্ট তৈরি করা হলে, `name` এর পরিবর্তে ক্লায়েন্ট অ্যাপের বান্ডেল আইডি ব্যবহার করতে হবে। Android // Specified by API consumer. iOS // Specified by API consumer.
`version`	Analytics/বিজ্ঞাপন প্রোডাক্টের ভার্সন। (`7.10.1`) Android // Specified by API consumer. iOS // Specified by API consumer.
`os_and_version`	অ্যাপটি যে অপারেটিং সিস্টেম ও অপারেটিং সিস্টেম ভার্সনে চলছে। (`Android 6.0` ) Android String osAndVersion = "Android " + Build.VERSION.RELEASE; iOS UIDevice uid = [UIDevice currentDevice]; NSString osAndVersion = [NSString stringWithFormat:@"%@ %@", [uid systemName], [uid systemVersion]];
`locale`	ডিভাইসের জন্য IETF লোকেল ট্যাগ, আন্ডারস্কোর দিয়ে আলাদা করা দুই অক্ষরের ভাষা ও দেশের কোড ব্যবহার করে। (`en_US`) Android String locale = Locale.getDefault(); iOS NSString *locale = [[NSLocale currentLocale] localeIdentifier]
`device`	যে ফিজিক্যাল ডিভাইসে অ্যানালিটিক্স/বিজ্ঞাপন প্রোডাক্ট চলছে সেটির নাম। (`iPhone9,1`) Android String device = Build.MODEL; iOS @import Darwin.sys.sysctl; NSString device(void) { size_t bufferSize = 64; NSMutableData buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname("hw.machine", buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding]; }
`build`	"Build/" এবং তারপরে অপারেটিং সিস্টেমের বিল্ড নম্বর। (`Build/13D15`) Android String build = "Build/" + Build.ID; iOS @import Darwin.sys.sysctl; NSString build(void) { size_t bufferSize = 64; NSMutableData buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname("kern.osversion", buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding]; }

অ্যাপ ইউজার-এজেন্ট সার্ভার সাইড তৈরি করার সময় অ্যাপ ইউজার-এজেন্টের শেষে শুধু ; Proxy যোগ করুন। অ্যাপের ইউজার-এজেন্ট যদি সম্পূর্ণভাবে ক্লায়েন্ট সাইডে তৈরি করা হয়, তাহলে ; Proxy বাদ দিন। তাই, কোনও অ্যাপের User-Agent এমন হতে পারে:

Android: AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
iOS: AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)

কনভার্সন ট্র্যাকিং সংক্রান্ত অনুরোধের গাইড

কনভার্সন ট্র্যাক করার অনুরোধের উদ্দেশ্য হল, কোনও অ্যাপ ইভেন্ট সম্পর্কে Google Ads-কে জানানো যা কনভার্সন হিসেবে ট্র্যাক করা উচিত এবং/অথবা রিমার্কেটিং তালিকা পূরণ করতে ব্যবহার করা উচিত এবং ইভেন্টের আগে হওয়া যেকোনও ক্লিক বর্ণনা করে এমন মেটাডেটা পাওয়া।

সব API কল www.googleadservices.com ডোমেনে করা হয়। কনভার্সন অনুরোধ হল POST নিম্নলিখিত পাথ ব্যবহার করে HTTPS-এর মাধ্যমে করা অনুরোধ:

/pagead/conversion/app/version

যেখানে version হল কনভার্সন ট্র্যাকিং API-এর কাঙ্ক্ষিত ভার্সন।

একটি সাধারণ অ্যাপ কনভার্সন অনুরোধে App Conversion API v1.1-এর জন্য নিম্নলিখিত প্যারামিটার থাকবে।

কনভার্সন ট্র্যাকিং সংক্রান্ত অনুরোধ
`dev_token`	আবশ্যক লোকেশন: কোয়েরি API গ্রাহককে ইস্যু করা অনন্য, স্ট্যাটিক ডেভেলপার টোকেন। Z_eErE4DkvcKjDM1OVE4c4
`link_id`	আবশ্যক লোকেশন: কোয়েরি নির্দিষ্ট অ্যাপের সাথে API কনজিউমারের ডেভেলপার টোকেনকে বাইন্ড করা লিঙ্ক শনাক্তকারী। 31FF8D67E5BB5DD5029DCC2734C2F884
`app_event_type`	আবশ্যক লোকেশন: কোয়েরি ঘটে যাওয়া অ্যাপ ইভেন্টের নাম। এই ফিল্ডটি হল একটি এনুমেরেশন এবং শুধুমাত্র নিম্নলিখিত ভ্যালু গ্রহণ করবে: • first_open • session_start • in_app_purchase • view_item_list • view_item • view_search_results • add_to_cart • ecommerce_purchase • custom ইনস্টল অ্যাট্রিবিউট করার জন্য সবসময় `first_open` ইভেন্ট এবং সেশন রিঅ্যাট্রিবিউট করার জন্য সবসময় `session_start` ইভেন্ট পাঠাতে হবে। নেটিভ অ্যাপ স্টোরের মাধ্যমে করা কেনাকাটার জন্য `in_app_purchase` ব্যবহার করুন; অন্যান্য সব কেনাকাটার জন্য `ecommerce_purchase` ব্যবহার করুন।
`app_event_name`	নির্দিষ্ট শর্তে প্রয়োজন লোকেশন: কোয়েরি `app_event_type` ফিল্ডে গ্রহণ করা হয় না এমন কোনও কাস্টম অ্যাপ ইভেন্টের নাম। এই ফিল্ডে ১ থেকে ৬৪টি Unicode অক্ষর (UTF-8 এনকোডিং ব্যবহার করে) থাকতে হবে। এটি কাস্টম* হলে এই ফিল্ডটি পূরণ করতে হবে* `app_event_type` । level_achieved Level Achieved এই ফিল্ডে `app_event_type`-এর জন্য সংরক্ষিত কোনও ভ্যালু থাকা চলবে না। রিজার্ভ করা ইভেন্টের নাম ব্যবহার করা হলে, API একটি `APP_EVENT_NAME_RESERVED_VALUE` সমস্যা দেখাবে।
`app_event_data`	ঐচ্ছিক লোকেশন: বডি কী থেকে ভ্যালু পর্যন্ত ম্যাপিং স্ট্রিং সহ একটি সাধারণ JSON অবজেক্ট হিসেবে যেকোনও অতিরিক্ত সমৃদ্ধ ইভেন্ট ডেটা ফরওয়ার্ড করুন। গ্রহণযোগ্য মান হল স্ট্রিং ও স্ট্রিংয়ের অ্যারে। {"level": 5, "attempts": 20}
`odm_info`	iOS-এ ইন্টিগ্রেটেড কনভার্সন মেজারমেন্ট ব্যবহার করার সময় প্রয়োজন লোকেশন: কোয়েরি iOS অ্যাপ ইনস্টল বা Google On Device Measurement (ODM) থেকে আবার ইনস্টল করার পরে ক্যাপচার করা `info` কোয়েরি প্যারামিটারের ভ্যালু : ইভেন্ট ডেটা SDK. এই ফিল্ড iOS অ্যাপ ক্যাম্পেনের জন্য ইন্টিগ্রেটেড কনভার্সন মেজারমেন্ট চালু করে। XYZr_AB8C-_zGtKjUhqtzPLeQ8lbJB5dADVR0tpZ9f-28sN5qN9GTZ_FztjL0OL FzgxUJDhZr8w6lwGxAwPcxSwR5orjWepZiVP7sRRoCiaHerR-1TP17eJKtazgeSg _CVEs13LllDTfrhVM8uWISqlg8dXobsLzmj8C7WrOlktHA5P_E23 মনে রাখবেন: এই ফিল্ডটি অ্যাপ বা সার্ভার সাইডে ক্যাশে করতে হবে যাতে এটি অ্যাপে হওয়া ডাউনস্ট্রিম কনভার্সনের সাথে পাঠানো যায়। ODM SDK কোনও ভ্যালু তৈরি না করে থাকলে, এটি বাদ দিতে হবে।
`id_type`	আবশ্যক `rdid` ফিল্ডে পাস করা শনাক্তকারীর ধরন। Android advertisingid appsetid মনে রাখবেন: কনভার্সন ইভেন্টের সময় `advertisingid` উপলভ্য না থাকলে, পরিবর্তে `appsetid` যোগ করুন। iOS idfa idfv মনে রাখবেন: কনভার্সন ইভেন্টের সময় `idfa` উপলভ্য না থাকলে, পরিবর্তে `idfv` যোগ করুন।
`rdid`	আবশ্যক লোকেশন: কোয়েরি র ডিভাইস আইডির প্রতিনিধিত্বকারী একটি সঠিক UUID স্ট্রিং। f10e1de2-e237-4f50-b6aa-843c45cc63d6 যদি সেই ডিভাইস আইডিটি অনুপস্থিত থাকে, যেমন ATT-এর সম্মতি না দেওয়া ব্যবহারকারীর ডিভাইস আইডি, তাহলে এটিকে সব শূন্য হিসেবে সেট করুন। 00000000-0000-0000-0000-000000000000
`ctry_c`	আবশ্যক লোকেশন: কোয়েরি যে দেশ থেকে কনভার্সন শুরু হয়েছে সেটি বোঝাতে দুই অক্ষরের ISO দেশের কোড। iOS ও Android-এ ব্যবহারকারী লেভেল ছাড়া অ্যাপ কনভার্সন পরিমাপ করার সুবিধা চালু করতে এই ফিল্ডটি প্রয়োজন। US, IN
`eea`	নির্দিষ্ট কিছু শর্তে প্রয়োজন লোকেশন: কোয়েরি EEA-এর সুযোগ। ০: এই ব্যবহারকারী ও কনভার্সনের ক্ষেত্রে ইউরোপিয়ান রেগুলেশন প্রযোজ্য নয় ১: এই ব্যবহারকারী ও কনভার্সনের ক্ষেত্রে ইউরোপিয়ান রেগুলেশন প্রযোজ্য। যেমন, কোনও ব্যবহারকারী EEA-তে থাকলে, তিনি প্রযোজ্য ইউরোপিয়ান রেগুলেশনের আওতায় পড়েন। *Required to be sent when the value is known.
`ad_personalization`	নির্দিষ্ট কিছু শর্তে প্রয়োজন লোকেশন: কোয়েরি পছন্দমতো বিজ্ঞাপনের জন্য ফ্ল্যাগ ০: ব্যবহারকারী পছন্দমতো বিজ্ঞাপন সংক্রান্ত সম্মতি বাতিল করেছেন ১: ব্যবহারকারী পছন্দমতো বিজ্ঞাপন সংক্রান্ত সম্মতি দিয়েছেন *Required to be sent when the value is known.
`ad_user_data`	নির্দিষ্ট কিছু শর্তে প্রয়োজন লোকেশন: কোয়েরি বিজ্ঞাপনের উদ্দেশ্যে ব্যবহারকারীর ডেটা ব্যবহারের জন্য সম্মতি ফ্ল্যাগ ০: বিজ্ঞাপনের উদ্দেশ্যে Google-এ ব্যবহারকারীর লেভেল ডেটা ট্রান্সমিট করার জন্য ব্যবহারকারী সম্মতি দেননি ১: বিজ্ঞাপনের উদ্দেশ্যে Google-এ ব্যবহারকারীর লেভেল ডেটা ট্রান্সমিট করার জন্য ব্যবহারকারী সম্মতি দিয়েছেন *Required to be sent when the value is known.
`lat`	আবশ্যক লোকেশন: কোয়েরি ডিভাইসের জন্য বিজ্ঞাপন ট্র্যাকিং সীমিত করার স্ট্যাটাস। `0`: ব্যবহারকারী বিজ্ঞাপন ট্র্যাকিং সীমিত করার বিকল্প বেছে নেননি। `1`: ব্যবহারকারী বিজ্ঞাপন ট্র্যাকিং সীমিত করার বিকল্প বেছে নিয়েছেন।
`app_version`	আবশ্যক লোকেশন: কোয়েরি অ্যাপের বর্তমান ভার্সন। এটি নিম্নলিখিতভাবে স্ট্যান্ডার্ডাইজ করা উচিত। Android packageManager.getPackageInfo(packageName(), PackageManager.GET_META_DATA).versionName iOS [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"] 1.2.4
`os_version`	আবশ্যক লোকেশন: কোয়েরি অ্যাপের হোস্ট OS-এর বর্তমান ভার্সন। এটি নিম্নলিখিতভাবে স্ট্যান্ডার্ডাইজ করা উচিত। Android android.os.Build.VERSION.RELEASE iOS [[UIDevice currentDevice] systemVersion]
`sdk_version`	আবশ্যক লোকেশন: কোয়েরি যে SDK ইভেন্ট পরিমাপ করেছে তার ভার্সন। এটি মূলত ডিবাগিংয়ের জন্য ব্যবহার করা হয় বলে, এটি আপনার SDK রিলিজের সাথে ঠিক যেভাবে প্রকাশ করা হয়েছে সেইভাবে রিলিজ ভার্সনটি দেখাতে হবে। অ্যাপটি SDK ব্যবহার না করলে, `app_version` হিসেবে একই ভ্যালু পাস করুন। 1.9.5r6
`timestamp`	আবশ্যক লোকেশন: কোয়েরি কনভার্সন ইভেন্টটি যে UNIX টাইমস্ট্যাম্পে ঘটেছে, তা মাইক্রোসেকেন্ডের নির্ভুলতা সহ সেকেন্ডে দেখানো হয়। 1432681913.123456
`fot`	আবশ্যক লোকেশন: কোয়েরি পরবর্তী সব সেশন ও ইনস্টল করার পরে হওয়া ইভেন্টের জন্য মাইক্রোসেকেন্ডের নির্ভুলতা সহ সংশ্লিষ্ট `first_open` থেকে সেকেন্ডে UNIX টাইমস্ট্যাম্প। 1432681913.123456
`value`	ঐচ্ছিক লোকেশন: কোয়েরি ইভেন্টের আর্থিক মূল্য, যদি থাকে। এটি সবসময় মেশিন-রিডেবল ফ্লোটিং পয়েন্ট ভ্যালু হিসেবে ফর্ম্যাট করা উচিত। এর জন্য দশমিক বিন্দু ব্যবহার করে ভ্যালুর পূর্ণসংখ্যা ও ভগ্নাংশ অংশ আলাদা করতে হবে। 1.99
`currency_code`	নির্দিষ্ট শর্তে প্রয়োজন লোকেশন: কোয়েরি `value` প্যারামিটারের জন্য ISO 4217 মুদ্রা কোড। `value` প্যারামিটার দেওয়া থাকলে এবং সেটি খালি না থাকলে এই ফিল্ডটি পূরণ করা আবশ্যক। USD
`gclid`	নির্দিষ্ট শর্তে প্রয়োজন লোকেশন: কোয়েরি অ্যাপ খোলা হয়েছে এমন ডিপ লিঙ্ক URL থেকে `gclid` কোয়েরি প্যারামিটারের ভ্যালু। `app_event_type` `session_start` থাকলে এবং সেশনটি কোনও `gclid` কোয়েরি প্যারামিটার সহ ডিপ লিঙ্ক থেকে শুরু হলে এই ফিল্ডটি পূরণ করতে হবে। অন্যথায়, এটি বাদ দিতে হবে। মনে রাখবেন: rdid (advertisingid) উপলভ্য না থাকলে, gclid-কে অ্যাপ বা সার্ভার সাইডে ক্যাশে করতে হবে যাতে এটি অ্যাপে (session_start ছাড়াও) ভবিষ্যতে হওয়া কনভার্সনের সাথে পাঠানো যায়। `gclid`-এ ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এবং অনুরোধে এটিকে না ছোট/বড় হাতের অক্ষরে পরিবর্তন করা উচিত নয়। Cj0KEQjw0dy4BRCuuL_e5M
`market_referrer_gclid`	নির্দিষ্ট শর্তে প্রয়োজন লোকেশন: কোয়েরি Play ইনস্টল রেফারার API-এর মাধ্যমে install_referrer ভ্যালু থেকে ক্যাপচার করা ডিপ লিঙ্ক URL-এর `gclid` কোয়েরি প্যারামিটারের ভ্যালু। মনে রাখবেন, এটি অ্যাপ বা সার্ভার সাইডে ক্যাশে করতে হবে যাতে অ্যাপে হওয়া ভবিষ্যতের কনভার্সনের সাথে এটি পাঠানো যায়। অন্যথায়, এটি বাদ দিতে হবে। `gclid`-এ ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এবং অনুরোধে এটিকে না ছোট/বড় হাতের অক্ষরে পরিবর্তন করা উচিত নয়। BX3QojHp4mY5MrJtFM_d1u
`gclid_only_request`	নির্দিষ্ট শর্তে প্রয়োজন লোকেশন: কোয়েরি যেসব পরিস্থিতিতে `gclid`-ভিত্তিক অ্যাট্রিবিউশনের জন্য শনাক্তকারী, যেখানে rdid (advertisingid) `not` উপলভ্য অথবা সব `zeroes` এবং `gclid` অথবা `market_referrer_gclid` উপস্থিত। rdid(advertisingid) উপলভ্য না থাকলে `1` (true) হিসেবে সেট করতে হবে। id_type এবং lat-এর মতো অন্যান্য ডিভাইস আইডি ভিত্তিক ফিল্ডকে যেমন আছে তেমন পাস করতে হবে এবং `gclid_only_request`-এর জন্য এগুলি বাদ দেওয়া যাবে না। 1
`gbraid`	নির্দিষ্ট শর্তে প্রয়োজন লোকেশন: কোয়েরি অ্যাপ খোলার জন্য ডিপ লিঙ্ক URL-এর মাধ্যমে পাঠানো `gbraid` ভ্যালু শেষবার দেখা হয়েছে । মনে রাখবেন, এটি অ্যাপে ক্যাশে করতে হবে যাতে এটি অ্যাপে হওয়া ভবিষ্যতের কনভার্সনের সাথে পাঠানো যায়। iOS ও Android-এ ব্যবহারকারী লেভেল ছাড়া অ্যাপ কনভার্সন পরিমাপ চালু করতে এই ফিল্ডটি প্রয়োজনীয়। `gbraid`-এ ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এবং অনুরোধে এটিকে না ছোট/বড় হাতের অক্ষরে পরিবর্তন করা উচিত নয়। ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
`app_open_source`	নির্দিষ্ট শর্তে প্রয়োজন লোকেশন: কোয়েরি বিজ্ঞাপনে ক্লিক করা ডিপ লিঙ্ক বা অর্গানিক অ্যাপ সেশন শনাক্ত করার ভ্যালু। শুধুমাত্র সেশন শুরু হওয়ার ইভেন্টের সাথে পাঠাতে হবে এবং gbraid সহ কোনও ডিপ লিঙ্ক দ্বারা session_start ইভেন্ট পরিচালিত হলে `"ad_click"` হিসেবে সেট করতে হবে অথবা কোনও session_start ইভেন্ট অর্গ্যানিক উপায়ে পরিচালিত হলে `"organic"` হিসেবে সেট করতে হবে। অন্যথায়, এই ফিল্ডটি বাদ দিতে হবে। ad_click or organic
`User-Agent`	আবশ্যক লোকেশন: হেডার আগের বিভাগে যেভাবে অ্যাপ ইউজার এজেন্টকে সংজ্ঞায়িত করা হয়েছে। AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M)
`X-Forwarded-For`	আবশ্যক লোকেশন: হেডার যে ডিভাইসে ইভেন্ট পরিমাপ করা হয়েছে সেটির পাবলিক IPv4 বা IPv6 অ্যাড্রেস। 216.58.194.174

সব অনুরোধ HTTPS-এর মাধ্যমে পাঠাতে হবে। HTTP-এর মাধ্যমে পাওয়া পিং বাতিল করা হবে।

মনে রাখবেন, অনুরোধের বডি খালি থাকলে (যেসব ক্ষেত্রে app_event_data পেলোডে কোনও রিচ ইভেন্ট ডেটা পাস করা হয় না), আমাদের সার্ভার চায় যে আপনি অনুরোধে স্পষ্টভাবে Content-Length: 0 হেডার সেট করুন।

ইভেন্ট ডেটা এনকোডিং

app_event_data বডি প্যারামিটারের জন্য, আদিম ডেটা ধরনের ক্ষেত্রে নিম্নলিখিত কনভেনশন ব্যবহার করুন:

ফ্লোট
- অ্যাপ লোকালাইজেশন থেকে আলাদাভাবে দশমিক বিভাজক হিসেবে ডট ক্যারেক্টার ব্যবহার করা
- অর্থের পরিমাণ বোঝাতে দুই-অঙ্কের দশমিক নির্ভুলতা ব্যবহার করুন। যেমন, ২.৯৯
- সূচকীয় নোটেশন ব্যবহার করবেন না, যেমন 2E+9
- সংখ্যার গ্রুপ আলাদা করতে কমা ব্যবহার করবেন না, যেমন ১,০০০,০০০
- সঠিক উদাহরণ:
  - -0.5
  - 2.99
  - 1000000.123
পূর্ণসংখ্যা
- শুধুমাত্র পূর্ণসংখ্যা মান পাঠান, কোনও দশমিক সংখ্যা পাঠাবেন না
- সংখ্যার গ্রুপ আলাদা করতে কমা ব্যবহার করবেন না, যেমন ১,০০০,০০০
- সঠিক উদাহরণ:
  - 1000
  - -11
  - 0
তারিখ
- তারিখের ফর্ম্যাট: yyyy-mm-dd
  - yyyy = চার সংখ্যা দিয়ে বছর, যেমন, ২০১৬
  - mm = দুই সংখ্যার মাস, যেমন, সেপ্টেম্বরের জন্য ০৯
  - dd = দুই সংখ্যার দিন, যেমন মাসের ২৩তম দিনের জন্য ২৩
- সবসময় উপরে উল্লেখ করা সংখ্যার ডিজিট পাঠাবেন, যেমন, মাসের ৫ম দিনের জন্য dd-এর ভ্যালু পাঠালে, 05 পাঠান।
- সঠিক উদাহরণ:
  - "2016-09-23"
  - "1990-12-31"
টাইমস্ট্যাম্প
- সময় ফর্ম্যাট: মাইক্রোসেকেন্ডের নির্ভুলতা সহ UTC টাইমজোনে সেকেন্ডে সংজ্ঞায়িত Unix/Epoch টাইমস্ট্যাম্প
- সঠিক উদাহরণ:
  - 1478713087 for Wed, 09 Nov 2016 17:38:07 GMT
  - 1073513982.123000 for Wed, 07 Jan 2004 22:19:42.123 GMT
অ্যারে
- শুধুমাত্র আদিম ভ্যালুর (স্ট্রিং, সংখ্যা ও বুলিয়ান) অ্যারে পাঠাতে হবে
- সঠিক উদাহরণ:
  - [123, 456, 789]
  - ["abc"]

নমুনা অনুরোধগুলি

অন-ডিভাইস পরিমাপ সহ প্রথমবার খোলার অনুরোধের উদাহরণ: ইভেন্ট ডেটা ইন্টিগ্রেটেড কনভার্সন পরিমাপের জন্য SDK হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

অন-ডিভাইস পরিমাপ ছাড়া প্রথমবার খোলার অনুরোধের একটি উদাহরণ হল: ইন্টিগ্রেটেড কনভার্সন পরিমাপের জন্য ইভেন্ট ডেটা SDK:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

অন-ডিভাইস পরিমাপ সহ পোস্ট ইনস্টল অনুরোধের একটি উদাহরণ: ইন্টিগ্রেটেড কনভার্সন পরিমাপের জন্য ইভেন্ট ডেটা SDK হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &&fot=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

অন ডিভাইস মেজারমেন্ট: Event Data SDK ছাড়া প্রথমবার খোলার অনুরোধের একটি উদাহরণ হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ACAPI v1.1-এর জন্য Android-এর নন-ডিটারমিনিস্টিক কনভার্সনের প্রথমবার খোলার অনুরোধের একটি উদাহরণ হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=appsetid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &ctry_c=IN
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (android 11; en-GB; RMX2040; Build/_; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

কাস্টম নয় এমন ইভেন্ট টাইপ ও উপার্জন সংক্রান্ত তথ্য সহ বৈধ কনভার্সন ট্র্যাকিং অনুরোধের উদাহরণ হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=0
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

{"app_event_data":{"item_id":["Crayons","Markers"]}}

কাস্টম নয় এমন ইভেন্ট টাইপ ও উপার্জন সংক্রান্ত তথ্য সহ rdid (advertisingid) উপলভ্য নেই এমন কনভার্সন ট্র্যাকিং অনুরোধের উদাহরণ হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

{"app_event_data":{"item_id":["Crayons","Markers"]}}

সঠিক সেশন শুরু করার অনুরোধের একটি উদাহরণ হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

কোনও সেশনের জন্য সেশন শুরু রিঅ্যাট্রিবিউশন অনুরোধের একটি সঠিক উদাহরণ যা ডিপ লিঙ্ক থেকে শুরু হয়েছে example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M তা হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

বিজ্ঞাপন ব্যবহারকারী ডেটা সংক্রান্ত সম্মতি দেওয়া এবং পছন্দমতো বিজ্ঞাপন বেছে নেওয়ার সুবিধা প্রত্যাখ্যান করা EEA ব্যবহারকারীর জন্য বৈধ কনভার্সন ট্র্যাকিং অনুরোধের একটি উদাহরণ হল:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=1
       &ad_personalization=0
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

কনভার্সন ট্র্যাকিং সংক্রান্ত উত্তরের গাইড

কনভার্সন ট্র্যাকিংয়ের উত্তরে নিম্নলিখিত ফর্ম্যাট থাকে:

{
  "ad_events": [<ad event objects>],
  "errors": [<error strings>],
  "attributed": true|false
}

ad_events ও errors, দুটি অ্যারেই খালি থাকতে পারে।

আমরা আশা করি যে সমস্যাগুলি মেশিন রিডেবল সমস্যা কোড হবে, যেমন invalid_timestamp।

সমস্যার কোড

invalid_timestamp - অনুরোধে সঠিক টাইমস্ট্যাম্প নেই।
eea_missing_or_invalid - Either request did not have the "eea" field set or it was invalid.
ad_user_data_missing - "ad_user_data" অনুরোধ ফিল্ড সেট করা হয়নি। ইন-স্কোপ DMA অনুরোধের জন্য "ad_user_data" ফিল্ড প্রয়োজন।
ad_user_data_invalid - "ad_user_data" অনুরোধের ভ্যালু সঠিক ছিল না। ইন-স্কোপ DMA অনুরোধের জন্য "ad_user_data" ফিল্ড প্রয়োজন।
ad_personalization_missing_or_invalid - Either request did not have the "ad_personalization" field set or it was invalid. স্কোপের মধ্যে থাকা সব DMA অনুরোধের জন্য "ad_personalization" ফিল্ড প্রয়োজনীয়।

বিজ্ঞাপন ইভেন্ট হল অ্যাপ অ্যাট্রিবিউশনের মূল অবজেক্ট এবং এতে নিম্নলিখিত প্রপার্টি থাকবে।

attributed শুধুমাত্র তখনই true রিটার্ন করতে পারে যদি ইভেন্টটি সেই Google Ads অ্যাকাউন্টের কনভার্সন ট্র্যাকিং অ্যাকাউন্টে ইমপোর্ট করা হয় যেটি ইন্টার‍্যাকশন ড্রাইভ করেছে।

ব্যবহারকারীর সম্মতির উপর নির্ভর করে উত্তর দেওয়ার আচরণ সংক্রান্ত গুরুত্বপূর্ণ নোট:
কনভার্সনে যদি বিজ্ঞাপন ব্যবহারকারীর ডেটা সংক্রান্ত সম্মতি থাকে এবং ব্যবহারকারীর Google ব্যবহারকারী সেটিংসের মধ্যে ক্রস-ইউজ সম্মতি থাকে, তাহলে Google Ads তার সমস্ত CPS জুড়ে একটি করে শেষ ক্লিক সহ উত্তর দেবে। ব্যবহারকারী যদি তার Google ব্যবহারকারী সেটিংসের মধ্যে ক্রস-ইউজ সম্মতিতে সম্মতি না দিয়ে থাকেন, তাহলে Google Ads একাধিক শেষ ক্লিক সহ উত্তর দেবে, যা প্রতি CPS ভিত্তিতে হবে।

কনভার্সনে ব্যবহারকারীর বেছে নেওয়া ক্রস-ইউজ সম্মতিতে নির্দিষ্ট কিছু CPS অন্তর্ভুক্ত থাকলে কিন্তু অন্যগুলি না থাকলে, Google Ads ক্রস-ইউজ সম্মতি দেওয়া CPS-এর জন্য একটি করে সিঙ্গেল লাস্ট ক্লিক সহ উত্তর দেবে, কিন্তু ক্রস-ইউজ সম্মতি না দেওয়া CPS-এর জন্য প্রতি CPS একাধিক লাস্ট ক্লিক সহ উত্তর দেবে।

কনভার্সন ট্র্যাকিং সংক্রান্ত উত্তর
`ad_event_id`	সবসময় উপস্থিত স্ট্রিং `ad_event_id` বিজ্ঞাপন ইভেন্টের জন্য অনন্য শনাক্তকারী হিসেবে কাজ করে। এটি ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধে আবার ব্যবহার করা হয় এবং ডিবাগিংয়ের উদ্দেশ্যে লগ করা/সংরক্ষণ করা উচিত। Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
`conversion_metric`	সবসময় উপস্থিত স্ট্রিং অ্যাট্রিবিউশনের জন্য ব্যবহৃত কনভার্সন মেট্রিক। আমরা প্রাথমিকভাবে একটি কনভার্সন মেট্রিক সাপোর্ট করব। conversion
`timestamp`	সবসময় উপস্থিত নম্বর বিজ্ঞাপন ইভেন্টটি যে UNIX টাইমস্ট্যাম্পে ঘটেছে, তা মাইক্রোসেকেন্ড নির্ভুলতার সাথে সেকেন্ডে দেখানো হয়। এই ভ্যালু শেষ ক্লিক অ্যাট্রিবিউশনের জন্য ব্যবহার করা উচিত। 1432681913.123456
`campaign_type`	সবসময় উপস্থিত স্ট্রিং এই ফিল্ডটি বিজ্ঞাপন ইভেন্ট তৈরি করা ক্যাম্পেনের ধরন শনাক্ত করবে। সম্ভাব্য মানগুলি নিচে দেওয়া হল। ACI ACE ACPRE Search Display Video Shopping Hotel Performance_Max Other ACI হল 'বিজ্ঞাপনে দেখানো অ্যাপ ইনস্টল করা বিষয়ক অ্যাপ ক্যাম্পেন'-এর সংক্ষিপ্ত রূপ। ACE হল এনগেজমেন্টের জন্য অ্যাপ ক্যাম্পেনের সংক্ষিপ্ত রূপ।
`campaign_id`	সবসময় উপস্থিত নম্বর বিজ্ঞাপন ইভেন্ট তৈরি করা ক্যাম্পেনের সংখ্যাসূচক ক্যাম্পেন আইডি। এই মান অনন্য হবে। 123456789
`campaign_name`	সবসময় উপস্থিত স্ট্রিং বিজ্ঞাপনদাতার দ্বারা নির্ধারিত সেই ক্যাম্পেনের নাম যেখান থেকে বিজ্ঞাপন ইভেন্ট তৈরি হয়েছে। এই মান অনন্য হবে এমন গ্যারান্টি নেই। Occasional Gamers (Video)
`ad_type`	সবসময় উপস্থিত স্ট্রিং বিজ্ঞাপন ইভেন্টের ফলে যে ধরনের বিজ্ঞাপন দেখানো হয়েছে। এই ভ্যালু নিম্নলিখিত উপায়ে বিভিন্ন ধরনের ইনভেনটরিকে আলাদা আলাদা করে চিহ্নিত করতে ব্যবহার করা যেতে পারে। অ্যাপের প্রচার ClickToDownload অ্যাপ এনগেজমেন্ট AppDeepLink অ্যাপ এনগেজমেন্ট — ইনস্টল ও চালিয়ে যাওয়া সংক্রান্ত ফ্লো AppDeepLinkContinue অন্যান্য ভ্যালুর জন্য ক্যাচ-অল Unknown
`external_customer_id`	সবসময় উপস্থিত নম্বর বিজ্ঞাপনদাতার শনাক্তকারী, যে বিজ্ঞাপনদাতা সেই ক্যাম্পেনের মালিক যে বিজ্ঞাপন ইভেন্ট তৈরি করেছে। এই ভ্যালু Google Ads অ্যাকাউন্টগুলির মধ্যে পার্থক্য করতে ব্যবহার করা যেতে পারে। 123456789
`location`	সবসময় উপস্থিত নম্বর বিজ্ঞাপন ইভেন্টের ভৌগোলিক লোকেশনের জন্য লোকেশন আইডি কোড। লোকেশন কোড ব্যাখ্যা করতে Google Ads API রেফারেন্স দেখুন।
`network_type`	সবসময় উপস্থিত স্ট্রিং এই ফিল্ডটি সেই Google Ads বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করবে যেখানে বিজ্ঞাপন ইভেন্টটি ঘটেছে। সম্ভাব্য ভ্যালুগুলি নিচে উল্লেখ করা হল। Search Display YouTube GoogleTv cross-network
`network_subtype`	`campaign_type`-এর মান `ACI` বা `ACE` এবং `network_type`-এর মান `Display` হলে, `null` হবে। স্ট্রিং এই ফিল্ডটি Google Ads বিজ্ঞাপন নেটওয়ার্কের "সাবটাইপ" শনাক্ত করবে যেখানে বিজ্ঞাপন ইভেন্টটি ঘটেছে। সম্ভাব্য মানগুলি প্রাথমিক নেটওয়ার্কের ধরন অনুযায়ী আলাদা আলাদা হয়। সার্চ করুন সাধারণ Google Search GoogleSearch Google Search পার্টনার SearchPartners ডিসপ্লে মোবাইল ওয়েব প্রকাশক mGDN অ্যাপ প্রকাশক Google AdMob YouTube YouTube ভিডিও নেটওয়ার্ক YouTubeVideos YouTube সার্চ নেটওয়ার্ক YouTubeSearch ভিডিও পার্টনার VideoPartners GoogleTv GoogleTV Videos নেটওয়ার্ক GoogleTvVideos ক্রস-নেটওয়ার্ক পারফর্ম্যান্স ম্যাক্স ক্রস নেটওয়ার্ক cross-network
`video_id`	শুধুমাত্র `network_type` `YouTube` হলে এবং `campaign_type` না `ACI` ও `ACE` হলে তবেই প্রদান করা হয়। স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে যুক্ত YouTube ভিডিও আইডি। dQw4w9WgXcQ
`keyword`	শুধুমাত্র `network_type` `Search` হলে এবং `campaign_type` না `ACI` ও `ACE` হলে তবেই প্রদান করা হয়। স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে যুক্ত সার্চ কীওয়ার্ড। +food +delivery
`match_type`	শুধুমাত্র `network_type` `Search` হলে এবং `campaign_type` না `ACI` ও `ACE` হলে তবেই প্রদান করা হয়। স্ট্রিং সার্চ কীওয়ার্ডের জন্য ম্যাচের ধরন। যথাযথ e বাক্যাংশ p ব্রড b
`placement`	শুধুমাত্র `network_type` `Display` হলে এবং `campaign_type` না `ACI` ও `ACE` হলে তবেই প্রদান করা হয়। স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে যুক্ত প্লেসমেন্ট। mobileapp::1-343200656
`ad_group_id`	`campaign_type`, `Performance_Max`-এর থেকে আলাদা না হলে তবেই প্রদান করা হয়। নম্বর বিজ্ঞাপন ইভেন্টের সাথে তৈরি হওয়া বিজ্ঞাপন গ্রুপের সংখ্যাসূচক আইডি। এই ভ্যালু অনন্য হবে। এই ফিল্ডটি gbraid-অ্যাট্রিবিউট করা বিজ্ঞাপন ইভেন্টের জন্য প্রদান করা হয় না যা নির্ধারিতভাবে অ্যাট্রিবিউট করা হয় (`is_deterministic` হল `true`), যেমন ডিপ লিঙ্ক অ্যাট্রিবিউশন। 123456789
`ad_group_name`	`campaign_type`-এর মান `ACI`, `ACE` বা `ACPRE` হলে তবেই প্রদান করা হয়। স্ট্রিং বিজ্ঞাপনদাতার সংজ্ঞায়িত বিজ্ঞাপন গ্রুপের নাম, যে বিজ্ঞাপন গ্রুপ থেকে বিজ্ঞাপন ইভেন্ট তৈরি হয়েছে। এই মান অনন্য হবে এমন গ্যারান্টি নেই। এই ফিল্ডটি gbraid-অ্যাট্রিবিউট করা বিজ্ঞাপন ইভেন্টের জন্য প্রদান করা হয় না যা নির্ধারিতভাবে অ্যাট্রিবিউট করা হয় (`is_deterministic` হল `true`), যেমন ডিপ লিঙ্ক অ্যাট্রিবিউশন। My App AdGroup
`asset_group_id`	`campaign_type`, `Performance_Max`-এর থেকে ছোট হলে তবেই প্রদান করা হয়। নম্বর বিজ্ঞাপন ইভেন্ট তৈরি করা অ্যাসেট গ্রুপের সংখ্যাসূচক আইডি। এই মানটি অনন্য। 123456789
`creative_id`	`campaign_type` না `ACI`, `ACE`, `ACPRE` বা `Performance_Max` হলে তবেই প্রদান করা হয়। নম্বর বিজ্ঞাপন ইভেন্ট তৈরি করা ক্রিয়েটিভ বিজ্ঞাপন ইউনিটের সংখ্যাসূচক আইডি। এই ভ্যালু অনন্য হবে। 123456789
`interaction_type`	এই ফিল্ড সবসময় এনগেজমেন্ট হবে। স্ট্রিং
`is_deterministic`	অ্যাট্রিবিউশন পদ্ধতিটি ডিটারমিনিস্টিক কিনা তা নির্দেশ করে। বুলিয়ান true, false
`device_model`	বিজ্ঞাপন ইভেন্ট তৈরি করা ডিভাইসের মডেল। স্ট্রিং sm-s936w, sm-3936w
`os_version`	বিজ্ঞাপন ইভেন্ট তৈরি করা প্রধান OS ভার্সন। স্ট্রিং 14, 12
`country`	বিজ্ঞাপন ইভেন্ট তৈরি করা দেশের দুই-অক্ষরের কোড। স্ট্রিং CA, US
`city`	যে শহর থেকে বিজ্ঞাপন ইভেন্ট তৈরি হয়েছে। স্ট্রিং san jose, london
`region`	যে রাজ্য বা প্রদেশে বিজ্ঞাপন ইভেন্ট তৈরি হয়েছে। স্ট্রিং california, british columbia

নমুনা উত্তর

ডিটারমিনিস্টিক কনভার্সনের জন্য উত্তরের একটি উদাহরণ হল:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "is_deterministic": true,
    "timestamp": 1234567.898765
  }],
  "errors": [],
  "attributed": true
}

iOS-এর ক্ষেত্রে অনির্দিষ্ট কনভার্সনের জন্য উত্তরের একটি উদাহরণ হল:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "is_deterministic": false,
    },
    "device_info": {
        "device_model": "iphone12,3",
        "os_version": "14"
    },
    "timestamp": 1432681918.123456
    }],
  "errors": [],
  "attributed": true
}

Android-এর অনির্দিষ্ট কনভার্সনের জন্য উত্তরের একটি উদাহরণ হল:

{
  "ad_events": [
    {
      "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
      "conversion_metric": "conversion",
      "interaction_type": "click",
      "campaign_type": "ACI",
      "campaign_id": 123456789,
      "campaign_name": "My App Campaign",
      "network_type": null,
      "network_subtype": null,
      "ad_group_id": 123456789,
      "ad_group_name": "My App AdGroup",
      "asset_group_id": null,
      "is_deterministic": false,
      "geo_info": {
        "city": "san jose",
        "country": "US",
        "region": "california"
      },
      "device_info": {
          "device_model": "sm-s926u",
          "os_version": "14"
      },
      "timestamp": 1432681918.123456
    },
    ],
    "errors": [],
    "warnings": []
  }

gbraid-এর মাধ্যমে অ্যাট্রিবিউট করা iOS/Android কনভার্সনের উত্তরের একটি উদাহরণ হল:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "interaction_type": "engagement",
    "network_type": null,
    "ad_group_id": null,
    "ad_group_name": null,
    "asset_group_id": null,
    "is_deterministic": true,
    "timestamp": 0.000000
  }],
  "errors": [],
  "attributed": true,
  "warnings": [],
}

অনুরোধে সমস্যা থাকলে কনভার্সন ট্র্যাকিং উত্তরের একটি উদাহরণ হল:

{
  "ad_events": [],
  "errors": ["INVALID_CURRENCY_CODE"],
  "attributed": false
}

কনভার্সন ট্র্যাকিং সংক্রান্ত নেতিবাচক উত্তরের উদাহরণ হল:

{
  "ad_events": [],
  "errors": [],
  "attributed": false
}

কনভার্সন ট্র্যাকিং সংক্রান্ত সব অনুরোধের জন্য কনভার্সন ট্র্যাকিং সংক্রান্ত উত্তর প্রদান করা হবে।

EEA-এর বাইরের ব্যবহারকারীর জন্য ইউনিভার্সাল অ্যাপ ক্যাম্পেনে কনভার্সন ট্র্যাকিং সংক্রান্ত ইতিবাচক উত্তরের উদাহরণ হল:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

EEA-এর বাইরের ব্যবহারকারীর জন্য সার্চ ক্যাম্পেনে কনভার্সন ট্র্যাকিং সংক্রান্ত ইতিবাচক উত্তরের উদাহরণ:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Search",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": "+space +birds",
    "match_type": "b",
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

EEA-এর বাইরের ব্যবহারকারীর জন্য ডিসপ্লে ক্যাম্পেনে কনভার্সন ট্র্যাকিং সংক্রান্ত ইতিবাচক উত্তরের উদাহরণ:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Display",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "mGDN",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": "mobile-app::2-343200656",
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

YouTube ক্যাম্পেনের জন্য EEA-এর বাইরের ব্যবহারকারীর ক্ষেত্রে কনভার্সন ট্র্যাকিংয়ের ইতিবাচক উত্তরের একটি উদাহরণ হল:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Video",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": "dQw4w9WgXcQ",
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

অ্যাট্রিবিউট করা কনভার্সন ট্র্যাকিং উত্তরের একটি উদাহরণ যেখানে কনভার্সনটি Play + Search বিজ্ঞাপন ইন্টার‍্যাকশন দু'টির জন্যই অ্যাট্রিবিউট করা হয়েছে কিন্তু Play + Search CPS-এর মধ্যে 5(2)(b) + 5(2)(c) ক্রস-ইউজ সম্মতি প্রত্যাখ্যান করা হয়েছে:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

অ্যাট্রিবিউট করা কনভার্সন ট্র্যাকিং উত্তরের একটি উদাহরণ যেখানে কনভার্সনটি Play + Search বিজ্ঞাপন ইন্টার‍্যাকশন এবং Play + Search CPS-এর মধ্যে ৫(২)(খ) + ৫(২)(গ) ক্রস-ইউজ সম্মতি গ্রহণ করা হয়েছে, আজকের কনভার্সন আচরণের মতো:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

অ্যাট্রিবিউট করা কনভার্সন ট্র্যাকিং উত্তরের একটি উদাহরণ যেখানে কনভার্সনটি Play, Search এবং YouTube বিজ্ঞাপন ইন্টার‍্যাকশন এবং Play + Search CPS-এর মধ্যে ৫(২)(খ) + ৫(২)(গ) ক্রস-ইউজ সম্মতি গৃহীত হয়েছে কিন্তু YouTube CPS-এর জন্য তা প্রত্যাখ্যান করা হয়েছে:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}

ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধ

কনভার্সন ট্র্যাকিংয়ের অনুরোধের উত্তরে Google Ads ইতিবাচক উত্তর দিলে, API কনজিউমারকে শেষ ক্লিক শনাক্ত করার পরে Google Ads-কে ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন সংক্রান্ত সিদ্ধান্তের ব্যাপারে জানাতে হবে।

ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধটি আসল কনভার্সন ট্র্যাকিং অনুরোধের মতোই, তবে এর অনুরোধের পাথ হল:

/pagead/conversion/app/1.1/cross_network

এবং দুটি প্রয়োজনীয় প্যারামিটার যোগ করা হয়েছে:

ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধ

ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধ
`ad_event_id`	আবশ্যক লোকেশন: কোয়েরি আগের অনুরোধে অ্যাট্রিবিউশনের সাথে যুক্ত বিজ্ঞাপন ইভেন্ট থেকে পাওয়া `ad_event_id` শনাক্তকারী। `ad_event_id`-এ ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এবং অনুরোধে এটিকে বড়/ছোট হাতের অক্ষরে পরিবর্তন করা যাবে না।
`attributed`	আবশ্যক লোকেশন: কোয়েরি API কনজিউমার দ্বারা কনভার্সনের জন্য Google Ads ক্রেডিট পেয়েছে কিনা। `0` অথবা `1`।

ad_event_id

আবশ্যক

লোকেশন: কোয়েরি

আগের অনুরোধে অ্যাট্রিবিউশনের সাথে যুক্ত বিজ্ঞাপন ইভেন্ট থেকে পাওয়া ad_event_id শনাক্তকারী।

ad_event_id-এ ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এবং অনুরোধে এটিকে বড়/ছোট হাতের অক্ষরে পরিবর্তন করা যাবে না।

attributed

আবশ্যক

লোকেশন: কোয়েরি

API কনজিউমার দ্বারা কনভার্সনের জন্য Google Ads ক্রেডিট পেয়েছে কিনা। 0 অথবা 1।

সঠিক ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধের উদাহরণ হল:

POST /pagead/conversion/app/1.1/cross_network
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=custom
       &app_event_name=level_achieved
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &ad_event_id=Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
       &attributed=1
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

সঠিক ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধের ক্ষেত্রে সবসময় কোনও রেসপন্স বডি ছাড়াই একটি জেনেরিক 200 রেসপন্স পাঠানো হবে।

অ্যাপ ইউজার-এজেন্ট

Android

iOS

Android

iOS

Android

iOS

Android

iOS

Android

iOS

Android

iOS

কনভার্সন ট্র্যাকিং সংক্রান্ত অনুরোধের গাইড

Android

iOS

Android

iOS

Android

iOS

ইভেন্ট ডেটা এনকোডিং

নমুনা অনুরোধগুলি

কনভার্সন ট্র্যাকিং সংক্রান্ত উত্তরের গাইড

সার্চ করুন

ডিসপ্লে

YouTube

GoogleTv

ক্রস-নেটওয়ার্ক

নমুনা উত্তর

ডিটারমিনিস্টিক কনভার্সনের জন্য উত্তরের একটি উদাহরণ হল:

iOS-এর ক্ষেত্রে অনির্দিষ্ট কনভার্সনের জন্য উত্তরের একটি উদাহরণ হল:

Android-এর অনির্দিষ্ট কনভার্সনের জন্য উত্তরের একটি উদাহরণ হল:

gbraid-এর মাধ্যমে অ্যাট্রিবিউট করা iOS/Android কনভার্সনের উত্তরের একটি উদাহরণ হল:

অনুরোধে সমস্যা থাকলে কনভার্সন ট্র্যাকিং উত্তরের একটি উদাহরণ হল:

কনভার্সন ট্র্যাকিং সংক্রান্ত নেতিবাচক উত্তরের উদাহরণ হল:

EEA-এর বাইরের ব্যবহারকারীর জন্য সার্চ ক্যাম্পেনে কনভার্সন ট্র্যাকিং সংক্রান্ত ইতিবাচক উত্তরের উদাহরণ:

EEA-এর বাইরের ব্যবহারকারীর জন্য ডিসপ্লে ক্যাম্পেনে কনভার্সন ট্র্যাকিং সংক্রান্ত ইতিবাচক উত্তরের উদাহরণ:

YouTube ক্যাম্পেনের জন্য EEA-এর বাইরের ব্যবহারকারীর ক্ষেত্রে কনভার্সন ট্র্যাকিংয়ের ইতিবাচক উত্তরের একটি উদাহরণ হল:

ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধ