অ্যাপ রূপান্তর ট্র্যাকিং এবং পুনঃবিপণন - অনুরোধ/প্রতিক্রিয়া নির্দিষ্টকরণ

অ্যাপ ব্যবহারকারী-এজেন্ট

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

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

এই ক্ষেত্রগুলির সংজ্ঞা নিম্নরূপ:

ব্যবহারকারী-এজেন্ট উপাদান
name	বিশ্লেষণ/বিজ্ঞাপন পণ্যের নাম। ( Google AdMob ) মনে রাখবেন যে যদি ব্যবহারকারী এজেন্ট ক্লায়েন্টের পাশে তৈরি করা হয়, তাহলে name পরিবর্তে ক্লায়েন্ট অ্যাপের বান্ডেল আইডি হওয়া উচিত। অ্যান্ড্রয়েড // Specified by API consumer. iOS // Specified by API consumer.
version	বিশ্লেষণ/বিজ্ঞাপন পণ্যের সংস্করণ। ( 7.10.1 ) অ্যান্ড্রয়েড // Specified by API consumer. iOS // Specified by API consumer.
os_and_version	অপারেটিং সিস্টেম এবং অপারেটিং সিস্টেম সংস্করণে অ্যাপটি চলছে। ( Android 6.0 ) অ্যান্ড্রয়েড String osAndVersion = "Android " + Build.VERSION.RELEASE; iOS UIDevice *uid = [UIDevice currentDevice]; NSString *osAndVersion = [NSString stringWithFormat:@"%@ %@", [uid systemName], [uid systemVersion]];
locale	একটি আন্ডারস্কোর দ্বারা পৃথক করা দুই-অক্ষরের ভাষা এবং দেশের কোড ব্যবহার করে ডিভাইসের জন্য একটি IETF লোকেল ট্যাগ। ( en_US ) অ্যান্ড্রয়েড String locale = Locale.getDefault(); iOS NSString *locale = [[NSLocale currentLocale] localeIdentifier]
device	অ্যানালিটিক্স/বিজ্ঞাপন পণ্য চালানোর ফিজিক্যাল ডিভাইসের নাম। ( iPhone9,1 ) অ্যান্ড্রয়েড 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/13D15 ) অ্যান্ড্রয়েড 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 । যদি অ্যাপ ব্যবহারকারী-এজেন্ট সম্পূর্ণরূপে ক্লায়েন্ট সাইডে নির্মিত হয়, বাদ দিন ; Proxy সুতরাং একটি অ্যাপ্লিকেশন ব্যবহারকারী-এজেন্ট হতে পারে:

• 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 বিজ্ঞাপনকে অবহিত করা যা একটি রূপান্তর হিসাবে ট্র্যাক করা উচিত এবং/অথবা একটি পুনঃবিপণন তালিকা তৈরি করতে এবং ইভেন্টের আগে যে কোনো ক্লিকের বর্ণনা মেটাডেটা পুনরুদ্ধার করা।

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

/pagead/conversion/app/version

যেখানে version হল রূপান্তর ট্র্যাকিং API-এর উদ্দিষ্ট সংস্করণ। বর্তমানে একমাত্র বৈধ সংস্করণ হল 1.0 ।

একটি আদর্শ অ্যাপ রূপান্তরের অনুরোধে নিম্নলিখিত পরামিতিগুলি থাকবে৷

রূপান্তর ট্র্যাকিং অনুরোধ
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 ক্ষেত্রে গৃহীত হয় না। এই ক্ষেত্রটিতে 1 থেকে 64টি ইউনিকোড অক্ষর থাকা উচিত (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}
rdid	প্রয়োজন অবস্থান: জিজ্ঞাসা একটি বৈধ UUID স্ট্রিং কাঁচা ডিভাইস আইডি প্রতিনিধিত্ব করে। f10e1de2-e237-4f50-b6aa-843c45cc63d6 যদি ডিভাইস আইডি অনুপস্থিত থাকে, যেমন একটি ATT অসম্মত ব্যবহারকারীর ডিভাইস আইডি, এটি সম্পূর্ণ শূন্য হিসাবে সেট করুন। 00000000-0000-0000-0000-000000000000
id_type	প্রয়োজন অবস্থান: জিজ্ঞাসা rdid ক্ষেত্রে সংরক্ষিত শনাক্তকারীর ধরন। আমরা ভবিষ্যতে এখানে আরও মান গ্রহণ করতে পারি, তবে শুরুতে, আমরা নিম্নলিখিতগুলিকে সমর্থন করব৷ অ্যান্ড্রয়েড advertisingid iOS idfa
lat	প্রয়োজন অবস্থান: জিজ্ঞাসা ডিভাইসের জন্য সীমা-বিজ্ঞাপন-ট্র্যাকিং অবস্থা। 0 : ব্যবহারকারী বিজ্ঞাপন ট্র্যাকিং সীমিত করতে বেছে নেননি৷ 1 : ব্যবহারকারী বিজ্ঞাপন ট্র্যাকিং সীমিত করতে বেছে নিয়েছে।
app_version	প্রয়োজন অবস্থান: জিজ্ঞাসা অ্যাপটির বর্তমান সংস্করণ। এটি নিম্নরূপ প্রমিত করা উচিত। অ্যান্ড্রয়েড packageManager.getPackageInfo(packageName(), PackageManager.GET_META_DATA).versionName iOS [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"] 1.2.4
os_version	প্রয়োজন অবস্থান: জিজ্ঞাসা অ্যাপটির হোস্ট ওএসের বর্তমান সংস্করণ। এটি নিম্নরূপ প্রমিত করা উচিত। অ্যান্ড্রয়েড android.os.Build.VERSION.RELEASE iOS [[UIDevice currentDevice] systemVersion]
sdk_version	প্রয়োজন অবস্থান: জিজ্ঞাসা SDK-এর সংস্করণ যা ইভেন্টটি পরিমাপ করেছে। যেহেতু এটি প্রধানত ডিবাগিংয়ের জন্য ব্যবহৃত হয়, এটি আপনার SDK রিলিজের সাথে প্রকাশিত হওয়ার মতোই প্রকাশের সংস্করণটিকে প্রতিফলিত করবে। অ্যাপটি যদি SDK ব্যবহার না করে, তাহলে অনুগ্রহ করে app_version এর মতো একই মান পাস করুন । 1.9.5r6
timestamp	প্রয়োজন অবস্থান: জিজ্ঞাসা 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 অ্যাপ বা সার্ভারের দিকে ক্যাশে করা দরকার যাতে এটি অ্যাপে (সেশন_স্টার্ট ছাড়াও) ভবিষ্যতের রূপান্তরগুলির সাথে পাঠানো যেতে পারে। gclid কেস সংবেদনশীল এবং অনুরোধে বড়/লোয়ার কেসে রূপান্তর করা উচিত নয় । Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid	নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: জিজ্ঞাসা Play Install Referrer API এর মাধ্যমে install_referrer মান থেকে ক্যাপচার করা একটি গভীর লিঙ্ক URL থেকে gclid ক্যোয়ারী প্যারামিটারের মান। মনে রাখবেন যে এটি অ্যাপ বা সার্ভারের দিকে ক্যাশে করা দরকার যাতে এটি অ্যাপে ঘটতে থাকা ভবিষ্যতের রূপান্তরগুলির সাথে পাঠানো যেতে পারে। অন্যথায়, এটি বাদ দেওয়া উচিত। gclid কেস সংবেদনশীল এবং অনুরোধে বড়/লোয়ার কেসে রূপান্তর করা উচিত নয় । BX3QojHp4mY5MrJtFM_d1u
gclid_only_request	নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: জিজ্ঞাসা এমন পরিস্থিতিতে gclid ভিত্তিক অ্যাট্রিবিউশনের শনাক্তকারী যেখানে rdid (advertisingid) উপলব্ধ not বা সমস্ত zeroes এবং হয় gclid বা market_referrer_gclid উপস্থিত। rdid (advertisingid) উপলব্ধ না হলে 1 (সত্য) সেট করা আবশ্যক। অন্যান্য ডিভাইস আইডি ভিত্তিক ক্ষেত্র যেমন id_type এবং lat যেমন আছে তেমনি পাস করা উচিত এবং gclid_only_request এর জন্য এড়িয়ে যাওয়া উচিত নয়। 1
gbraid	নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: জিজ্ঞাসা শেষবার দেখা gbraid মান ডিপ লিঙ্ক URL এর মাধ্যমে পাঠানো হয়েছে যা অ্যাপটি খুলেছে। মনে রাখবেন যে এটি অ্যাপে ক্যাশে করা দরকার যাতে এটি অ্যাপে ঘটতে থাকা ভবিষ্যতের রূপান্তরগুলির সাথে পাঠানো যেতে পারে। iOS-এ ATT কমপ্লায়েন্ট অ্যাপ রূপান্তর পরিমাপ সক্ষম করতে এই ক্ষেত্রটি প্রয়োজন। gbraid কেস সংবেদনশীল এবং অনুরোধে বড়/লোয়ার কেসে রূপান্তর করা উচিত নয় । ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
app_open_source	নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: জিজ্ঞাসা বিজ্ঞাপন ক্লিক ডিপলিংক বা অর্গানিক অ্যাপ সেশন সনাক্ত করার মান। শুধুমাত্র সেশন স্টার্ট ইভেন্টের সাথে পাঠানোর প্রয়োজন এবং যখন একটি session_start ইভেন্ট gbraid সমন্বিত একটি ডিপলিংক দ্বারা চালিত হয় তখন "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 এর মাধ্যমে প্রাপ্ত Pings প্রত্যাখ্যান করা হবে।

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

নমুনা অনুরোধ

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

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &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
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
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 বডি প্যারামিটারের জন্য, অনুগ্রহ করে আদিম ডেটা প্রকারের জন্য নিম্নলিখিত নিয়মগুলি ব্যবহার করুন:

• ভাসা

  • অ্যাপ স্থানীয়করণ থেকে স্বাধীনভাবে দশমিক বিভাজক হিসাবে ডট অক্ষর ব্যবহার করুন
  • আর্থিক মান উপস্থাপন করতে দুই-অঙ্কের দশমিক নির্ভুলতা ব্যবহার করুন। যেমন 2.99
  • সূচকীয় স্বরলিপি ব্যবহার করবেন না , যেমন 2E+9
  • সংখ্যার গোষ্ঠীগুলিকে আলাদা করতে একটি কমা অক্ষর ব্যবহার করবেন না , যেমন 1,000,000
  • বৈধ উদাহরণ:
    • -0.5
    • 2.99
    • 1000000.123

• পূর্ণসংখ্যা

  • দশমিক সংখ্যা ছাড়াই শুধুমাত্র সম্পূর্ণ পূর্ণসংখ্যার মান পাঠান
  • সংখ্যার গোষ্ঠীগুলিকে আলাদা করতে একটি কমা অক্ষর ব্যবহার করবেন না , যেমন 1,000,000
  • বৈধ উদাহরণ:
    • 1000
    • -11
    • 0

• তারিখ

  • তারিখ বিন্যাস: yyyy-mm-dd
    • yyyy = চার অঙ্কের বছর, যেমন 2016
    • mm = দুই অঙ্কের মাস, যেমন সেপ্টেম্বরের জন্য 09
    • dd = দুই অঙ্কের দিন, যেমন মাসের 23তম দিনের জন্য 23
  • সর্বদা উপরে উল্লিখিত সংখ্যার সংখ্যা পাঠান, যেমন মাসের 5 তম দিনে dd-এর মান পাঠাতে হলে, 05 পাঠান।
  • বৈধ উদাহরণ:
    • "2016-09-23"
    • "1990-12-31"

• টাইমস্ট্যাম্প

  • সময়ের বিন্যাস: ইউনিক্স/ইপোচ টাইমস্ট্যাম্প ইউটিসি টাইমজোনে মাইক্রোসেকেন্ড পর্যন্ত নির্ভুলতার সাথে সংজ্ঞায়িত করা হয়েছে
  • বৈধ উদাহরণ:
    • 1478713087 জন্য, 09 নভেম্বর 2016 17:38:07 GMT
    • বুধের জন্য 1073513982.123000 , 07 জানুয়ারী 2004 22:19:42.123 GMT

• অ্যারে

  • শুধুমাত্র আদিম মানের অ্যারে পাঠান (স্ট্রিং, সংখ্যা এবং বুলিয়ান)
  • বৈধ উদাহরণ:
    • [123, 456, 789]
    • ["abc"]

রূপান্তর ট্র্যাকিং প্রতিক্রিয়া

রূপান্তর ট্র্যাকিং প্রতিক্রিয়া নিম্নলিখিত বিন্যাস আছে:

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

বিজ্ঞাপন_ইভেন্ট এবং ত্রুটির অ্যারে উভয়ই খালি হতে পারে।

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

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

রূপান্তর ট্র্যাকিং প্রতিক্রিয়া
ad_event_id	সর্বদা উপস্থিত স্ট্রিং ad_event_id বিজ্ঞাপন ইভেন্টের জন্য একটি অনন্য শনাক্তকারী হিসাবে কাজ করে। এটি ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধে পুনঃব্যবহার করা হয় এবং ডিবাগিং উদ্দেশ্যে লগ-ইন/ধারণ করা উচিত। Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric	সর্বদা উপস্থিত স্ট্রিং অ্যাট্রিবিউশনের জন্য ব্যবহৃত রূপান্তর মেট্রিক। আমরা প্রাথমিকভাবে একটি রূপান্তর মেট্রিক সমর্থন করব। conversion
timestamp	সর্বদা উপস্থিত সংখ্যা ইউনিক্স টাইমস্ট্যাম্প বিজ্ঞাপন ইভেন্টটি ঘটেছে, মাইক্রোসেকেন্ড পর্যন্ত নির্ভুলতার সাথে সেকেন্ডে। এই মানটি লাস্ট-ক্লিক অ্যাট্রিবিউশনের জন্য ব্যবহার করা উচিত। 1432681913.123456
campaign_type	সর্বদা উপস্থিত স্ট্রিং এই ক্ষেত্রটি প্রচারের ধরন সনাক্ত করবে যা বিজ্ঞাপন ইভেন্টটি তৈরি করেছে। সম্ভাব্য মান নিম্নরূপ। ACI ACE 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 বিজ্ঞাপন অ্যাকাউন্টগুলিকে আলাদা করতে ব্যবহার করা যেতে পারে। 123456789
location	সর্বদা উপস্থিত সংখ্যা বিজ্ঞাপন ইভেন্টের ভৌগলিক অবস্থানের জন্য অবস্থান আইডি কোড। অবস্থান কোড ব্যাখ্যা করতে Google Ads API রেফারেন্স দেখুন।
network_type	সর্বদা উপস্থিত স্ট্রিং এই ক্ষেত্রটি বিজ্ঞাপন ইভেন্টটি ঘটেছে এমন Google বিজ্ঞাপন বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করবে। সম্ভাব্য মান নিম্নরূপ। Search Display YouTube
network_subtype	campaign_type ACI বা ACE হলে এবং নেটওয়ার্ক_টাইপ Display হলে null network_type । স্ট্রিং এই ক্ষেত্রটি Google Ads বিজ্ঞাপন নেটওয়ার্কের "সাবটাইপ" সনাক্ত করবে যে বিজ্ঞাপন ইভেন্টটি ঘটেছে। সম্ভাব্য মান প্রাথমিক নেটওয়ার্কের প্রকার অনুসারে পরিবর্তিত হয়। অনুসন্ধান করুন সাধারণ Google অনুসন্ধান GoogleSearch Google অনুসন্ধান অংশীদার SearchPartners প্রদর্শন মোবাইল ওয়েব পাবলিশার্স mGDN অ্যাপ পাবলিশার্স Google AdMob YouTube YouTube ভিডিও নেটওয়ার্ক YouTubeVideos YouTube অনুসন্ধান নেটওয়ার্ক YouTubeSearch ভিডিও অংশীদার VideoPartners
video_id	ACI YouTube হলেই প্রদান করা হয় এবং campaign_type network_type এবং ACE নয় । স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে যুক্ত YouTube ভিডিও আইডি। dQw4w9WgXcQ
keyword	শুধুমাত্র নেটওয়ার্ক_টাইপ Search ACI দেওয়া হয় এবং campaign_type network_type এবং ACE নয় । স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে সম্পর্কিত অনুসন্ধান কীওয়ার্ড। +food +delivery
match_type	শুধুমাত্র নেটওয়ার্ক_টাইপ Search ACI দেওয়া হয় এবং campaign_type network_type এবং ACE নয় । স্ট্রিং সার্চ কীওয়ার্ডের মিলের ধরন। সঠিক e বাক্যাংশ p বিস্তৃত b
placement	শুধুমাত্র ACI Display হলেই প্রদান করা হয় এবং campaign_type network_type এবং ACE নয় । স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে যুক্ত অবস্থান। mobileapp::1-343200656
ad_group_id	সর্বদা উপস্থিত সংখ্যা বিজ্ঞাপন ইভেন্টের সাথে তৈরি করা বিজ্ঞাপন গোষ্ঠীর সংখ্যাসূচক আইডি। এই মান অনন্য নিশ্চিত করা হয়. 123456789
ad_group_name	campaign_type যখন ACI , ACE , বা ACPRE হয় শুধুমাত্র তখনই প্রদান করা হয়। স্ট্রিং বিজ্ঞাপন ইভেন্টটি তৈরি করা বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপনদাতা-নির্ধারিত বিজ্ঞাপন গোষ্ঠীর নাম। এই মান অনন্য নিশ্চিত করা হয় না. My App AdGroup
creative_id	campaign_type ACI এবং ACE না হলে শুধুমাত্র প্রদান করা হয়। সংখ্যা ক্রিয়েটিভ বিজ্ঞাপন ইউনিটের সাংখ্যিক আইডি যা বিজ্ঞাপন ইভেন্টটি তৈরি করেছে। এই মান অনন্য নিশ্চিত করা হয়. 123456789
interaction_type	এই ক্ষেত্র সবসময় ব্যস্ততা থাকবে. স্ট্রিং

নমুনা প্রতিক্রিয়া

অনুরোধে ত্রুটি থাকাকালীন একটি রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:

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

নেতিবাচক রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:

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

সমস্ত রূপান্তর ট্র্যাকিং অনুরোধের জন্য একটি রূপান্তর ট্র্যাকিং প্রতিক্রিয়া ফেরত দেওয়া হবে৷

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

{
  "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": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

একটি অনুসন্ধান প্রচারাভিযানের জন্য একটি ইতিবাচক রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:

{
  "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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

একটি প্রদর্শন প্রচারাভিযানের জন্য একটি ইতিবাচক রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:

{
  "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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

একটি YouTube প্রচারের জন্য একটি ইতিবাচক রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:

{
  "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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

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

যখন Google Ads একটি রূপান্তর ট্র্যাকিং অনুরোধে ইতিবাচকভাবে সাড়া দেয়, তখন API গ্রাহককে অবশ্যই শেষ ক্লিক শনাক্ত করার পরে তার ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন সিদ্ধান্তের বিষয়ে Google Adsকে অবহিত করতে হবে।

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

/pagead/conversion/app/1.0/cross_network

এবং দুটি প্রয়োজনীয় পরামিতি যোগ করুন:

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

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

POST /pagead/conversion/app/1.0/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 প্রতিক্রিয়া পাবে।