অ্যাপ ব্যবহারকারী-এজেন্ট
স্প্যাম মোকাবেলায় আমাদের বৃহত্তর প্রচেষ্টার অংশ হিসেবে, আমরা একজন অ্যাপ ব্যবহারকারীর পক্ষ থেকে একটি বিশ্লেষণ/বিজ্ঞাপন পণ্য দ্বারা প্রেরিত ব্যবহারকারী-এজেন্ট হেডারের জন্য একটি স্ট্যান্ডার্ডাইজড স্পেসিফিকেশন তৈরি করেছি। নিম্নলিখিত স্পেসিফিকেশন মেনে চলার জন্য ব্যবহারকারী-এজেন্ট অ্যাপটি নেটিভ কোড থেকে নেওয়া যেতে পারে:
name version (os_and_version; locale; device; build; Proxy)
এই ক্ষেত্রগুলির সংজ্ঞা নিম্নরূপ:
| ব্যবহারকারী-এজেন্ট উপাদান | |
|---|---|
| name | বিশ্লেষণ/বিজ্ঞাপন পণ্যের নাম। ( মনে রাখবেন যে যদি ব্যবহারকারী এজেন্ট ক্লায়েন্ট সাইডে তৈরি করা হয়, তাহলে অ্যান্ড্রয়েড// Specified by API consumer. আইওএস// Specified by API consumer. |
| version | বিশ্লেষণ/বিজ্ঞাপন পণ্যের সংস্করণ। ( অ্যান্ড্রয়েড// Specified by API consumer. আইওএস// Specified by API consumer. |
| os_and_version | অ্যাপটি যে অপারেটিং সিস্টেম এবং অপারেটিং সিস্টেম সংস্করণে চলছে। ( অ্যান্ড্রয়েডString osAndVersion =
"Android " + Build.VERSION.RELEASE;আইওএসUIDevice *uid = [UIDevice currentDevice]; NSString *osAndVersion = [NSString stringWithFormat:@"%@ %@", [uid systemName], [uid systemVersion]]; |
| locale | ডিভাইসের জন্য একটি IETF লোকেল ট্যাগ, যেখানে দুই অক্ষরের ভাষা এবং দেশের কোড একটি আন্ডারস্কোর দ্বারা পৃথক করা হবে। ( অ্যান্ড্রয়েডString locale = Locale.getDefault(); আইওএসNSString *locale = [[NSLocale currentLocale] localeIdentifier] |
| device | বিশ্লেষণ/বিজ্ঞাপন পণ্য চালানোর জন্য ব্যবহৃত ডিভাইসের নাম। ( অ্যান্ড্রয়েডString device = Build.MODEL; আইওএস@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/" এর পরে অপারেটিং সিস্টেমের বিল্ড নম্বর। ( অ্যান্ড্রয়েডString build = "Build/" + Build.ID; আইওএস@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 অ্যাপের শেষে User-Agent সার্ভার সাইডে অন্তর্ভুক্ত করুন। যদি User-Agent অ্যাপটি সম্পূর্ণরূপে ক্লায়েন্ট সাইডে তৈরি করা হয়, ; Proxy বাদ দিন। সুতরাং, একটি অ্যাপ User-Agent হতে পারে:
- অ্যান্ড্রয়েড:
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 ডোমেনে করা হয়। রূপান্তর অনুরোধগুলি হল নিম্নলিখিত পথে HTTPS এর মাধ্যমে POST অনুরোধ:
/pagead/conversion/app/version
একটি স্ট্যান্ডার্ড অ্যাপ রূপান্তর অনুরোধে অ্যাপ রূপান্তর 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
|
app_event_name | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি যেকোনো কাস্টম অ্যাপ ইভেন্টের নাম যা level_achieved Level Achieved এই ফিল্ডে |
app_event_data | ঐচ্ছিক অবস্থান: দেহ যেকোনো অতিরিক্ত সমৃদ্ধ ইভেন্ট ডেটা একটি সাধারণ JSON অবজেক্ট ম্যাপিং স্ট্রিং কী হিসেবে মানগুলিতে ফরোয়ার্ড করুন। গ্রহণযোগ্য মান হল স্ট্রিং এবং স্ট্রিংগুলির অ্যারে। {"level": 5, "attempts": 20} |
odm_info | iOS-এ ইন্টিগ্রেটেড কনভার্সন মেজারমেন্ট ব্যবহার করার সময় প্রয়োজন অবস্থান: কোয়েরি গুগল অন ডিভাইস মেজারমেন্ট (ODM) থেকে iOS অ্যাপ ইনস্টল বা রিইনস্টল করার সময় ক্যাপচার করা XYZr_AB8C-_zGtKjUhqtzPLeQ8lbJB5dADVR0tpZ9f-28sN5qN9GTZ_FztjL0OL FzgxUJDhZr8w6lwGxAwPcxSwR5orjWepZiVP7sRRoCiaHerR-1TP17eJKtazgeSg _CVEs13LllDTfrhVM8uWISqlg8dXobsLzmj8C7WrOlktHA5P_E23 |
id_type | প্রয়োজনীয় অ্যান্ড্রয়েডadvertisingid appsetid আইওএসidfa idfv |
rdid | প্রয়োজনীয় অবস্থান: কোয়েরি একটি বৈধ UUID স্ট্রিং যা কাঁচা ডিভাইস আইডি উপস্থাপন করে। f10e1de2-e237-4f50-b6aa-843c45cc63d6 যদি সেই ডিভাইস আইডিটি অনুপস্থিত থাকে, যেমন ATT ব্যবহারকারীর সম্মতিহীন ডিভাইস আইডি, তাহলে এটিকে "সব শূন্য" হিসেবে সেট করুন। 00000000-0000-0000-0000-000000000000 |
ctry_c | প্রয়োজনীয় অবস্থান: কোয়েরি দুই অক্ষরের ISO দেশের কোড যা রূপান্তরের উৎপত্তিস্থলের দেশ নির্দেশ করে। iOS এবং Android-এ নন-ইউজার লেভেল অ্যাপ কনভার্সন পরিমাপ সক্ষম করার জন্য এই ফিল্ডটি প্রয়োজন। US, IN |
eea | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি EEA এর সুযোগ।
|
ad_personalization | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি ব্যক্তিগতকৃত বিজ্ঞাপনের জন্য পতাকা
|
ad_user_data | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি বিজ্ঞাপনের উদ্দেশ্যে ব্যবহারকারীর ডেটা ব্যবহারের জন্য সম্মতির পতাকা
|
lat | প্রয়োজনীয় অবস্থান: কোয়েরি ডিভাইসের জন্য বিজ্ঞাপন ট্র্যাকিংয়ের সীমাবদ্ধতা।
|
app_version | প্রয়োজনীয় অবস্থান: কোয়েরি অ্যাপটির বর্তমান সংস্করণ। এটি নিম্নরূপ প্রমিত করা উচিত। অ্যান্ড্রয়েডpackageManager.getPackageInfo(packageName(), PackageManager.GET_META_DATA).versionName আইওএস[[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"] 1.2.4 |
os_version | প্রয়োজনীয় অবস্থান: কোয়েরি অ্যাপের হোস্ট ওএসের বর্তমান সংস্করণ। এটি নিম্নরূপ মানসম্মত করা উচিত। অ্যান্ড্রয়েডandroid.os.Build.VERSION.RELEASE আইওএস[[UIDevice currentDevice] systemVersion] |
sdk_version | প্রয়োজনীয় অবস্থান: কোয়েরি SDK-এর যে ভার্সনটি ইভেন্টটি পরিমাপ করেছে। যেহেতু এটি মূলত ডিবাগিংয়ের জন্য ব্যবহৃত হয়, তাই এটি আপনার SDK রিলিজের সাথে প্রকাশিত রিলিজ ভার্সনটিকে ঠিক যেভাবে প্রতিফলিত করে, ঠিক সেভাবেই প্রতিফলিত হওয়া উচিত। যদি অ্যাপটি SDK ব্যবহার না করে, তাহলে অনুগ্রহ করে 1.9.5r6 |
timestamp | প্রয়োজনীয় অবস্থান: কোয়েরি UNIX টাইমস্ট্যাম্পে রূপান্তর ঘটনাটি ঘটেছিল, মাইক্রোসেকেন্ডের নির্ভুলতার সাথে কয়েক সেকেন্ডে। 1432681913.123456 |
fot | প্রয়োজনীয় অবস্থান: কোয়েরি পরবর্তী সকল সেশন এবং ইনস্টলেশন পরবর্তী ইভেন্টের জন্য মাইক্রোসেকেন্ড নির্ভুলতার সাথে সেকেন্ডে সংশ্লিষ্ট 1432681913.123456 |
value | ঐচ্ছিক অবস্থান: কোয়েরি ইভেন্টের আর্থিক মূল্য, যদি থাকে। এটি সর্বদা একটি মেশিন-পঠনযোগ্য ভাসমান বিন্দু মান হিসাবে ফর্ম্যাট করা উচিত যাতে মানের পূর্ণসংখ্যা এবং ভগ্নাংশ অংশ পৃথক করার জন্য একটি দশমিক বিন্দু ব্যবহার করা হয়। 1.99 |
currency_code | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি USD |
gclid | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি অ্যাপটি খোলার জন্য একটি ডিপ লিঙ্ক URL থেকে Cj0KEQjw0dy4BRCuuL_e5M |
market_referrer_gclid | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি Play Install Referrer API এর মাধ্যমে install_referrer মান থেকে ক্যাপচার করা একটি deep link URL থেকে BX3QojHp4mY5MrJtFM_d1u |
gclid_only_request | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি যেখানে rdid (advertisingid) উপলব্ধ 1 |
gbraid | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি অ্যাপটি খোলার জন্য ডিপ লিঙ্ক URL এর মাধ্যমে সর্বশেষ দেখা ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O |
app_open_source | নির্দিষ্ট শর্তে প্রয়োজনীয় অবস্থান: কোয়েরি বিজ্ঞাপন ক্লিক ডিপলিঙ্ক বা অর্গানিক অ্যাপ সেশন শনাক্ত করার মান। 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 বডি প্যারামিটারের জন্য, আদিম ডেটা টাইপের জন্য নিম্নলিখিত নিয়মগুলি ব্যবহার করুন:
ভাসা
- অ্যাপ স্থানীয়করণ নির্বিশেষে দশমিক বিভাজক হিসেবে ডট অক্ষর ব্যবহার করুন
- আর্থিক মান উপস্থাপন করতে দুই-অঙ্কের দশমিক নির্ভুলতা ব্যবহার করুন। যেমন 2.99
- সূচকীয় স্বরলিপি ব্যবহার করবেন না , যেমন 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"
-
- তারিখের ফর্ম্যাট: yyyy-mm-dd
টাইমস্ট্যাম্প
- সময়ের বিন্যাস: মাইক্রোসেকেন্ড নির্ভুলতার সাথে UTC টাইমজোনে সংজ্ঞায়িত সেকেন্ডে ইউনিক্স/ইপোক টাইমস্ট্যাম্প
- বৈধ উদাহরণ:
-
1478713087বুধবারের জন্য, ০৯ নভেম্বর ২০১৬ ১৭:৩৮:০৭ GMT -
1073513982.123000বুধবার, ৭ জানুয়ারী ২০০৪ ২২:১৯:৪২.১২৩ 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
×tamp=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
×tamp=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
×tamp=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অন ডিভাইস মেজারমেন্ট: ইভেন্ট ডেটা 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
×tamp=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-8ACAPI v1.1 এর জন্য একটি অ্যান্ড্রয়েড নন-ডিটারমিনিস্টিক রূপান্তরের জন্য প্রথম খোলা অনুরোধের একটি উদাহরণ হল:
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
×tamp=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
×tamp=1432681913.123456
&value=1.99
¤cy_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
×tamp=1432681913.123456
&value=1.99
¤cy_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
×tamp=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
×tamp=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
×tamp=1432681913.123456
&value=1.99
¤cy_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 - হয় অনুরোধে "eea" ক্ষেত্র সেট ছিল না অথবা এটি অবৈধ ছিল।
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 - হয় অনুরোধে "ad_personalization" ফিল্ড সেট ছিল না অথবা এটি অবৈধ ছিল। সমস্ত ইন-স্কোপ DMA অনুরোধের জন্য "ad_personalization" ফিল্ডটি প্রয়োজন।
অ্যাপ অ্যাট্রিবিউশনের মূল বিষয় হল বিজ্ঞাপন ইভেন্ট, এবং এতে নিম্নলিখিত বৈশিষ্ট্যগুলি থাকবে।
ব্যবহারকারীর সম্মতির উপর নির্ভরশীল প্রতিক্রিয়া আচরণ সম্পর্কিত গুরুত্বপূর্ণ নোট:
যদি রূপান্তরটিতে বিজ্ঞাপন ব্যবহারকারীর ডেটা সম্মতি থাকে এবং ব্যবহারকারীর Google ব্যবহারকারী সেটিংসে ক্রস-ব্যবহারের সম্মতি থাকে, তাহলে Google বিজ্ঞাপন তার সমস্ত CPS জুড়ে একটি শেষ ক্লিকের মাধ্যমে প্রতিক্রিয়া জানাবে। যদি ব্যবহারকারী তাদের Google ব্যবহারকারী সেটিংসে ক্রস-ব্যবহারের সম্মতিতে সম্মতি না দিয়ে থাকেন, তাহলে Google বিজ্ঞাপন প্রতি CPS ভিত্তিতে একাধিক শেষ ক্লিকের মাধ্যমে প্রতিক্রিয়া জানাবে।
যদি রূপান্তরটিতে ব্যবহারকারীর নির্বাচিত ক্রস-ব্যবহার সম্মতিতে কিছু নির্দিষ্ট CPS থাকে কিন্তু অন্যগুলি না থাকে, তাহলে Google Ads ক্রস-ব্যবহার সম্মতি মঞ্জুর করা CPS গুলিতে একটি শেষ ক্লিকের মাধ্যমে প্রতিক্রিয়া জানাবে, তবে প্রতি CPS ভিত্তিতে, যে CPS গুলিকে ক্রস-ব্যবহার সম্মতি মঞ্জুর করা হয়নি তাদের জন্য একাধিক শেষ ক্লিকের মাধ্যমে প্রতিক্রিয়া জানাবে।
| রূপান্তর ট্র্যাকিং প্রতিক্রিয়া | |
|---|---|
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 বিজ্ঞাপন অ্যাকাউন্টগুলিকে আলাদা করতে ব্যবহার করা যেতে পারে। 123456789 |
location | সর্বদা উপস্থিত সংখ্যা বিজ্ঞাপন ইভেন্টের ভৌগোলিক অবস্থানের জন্য অবস্থান আইডি কোড। অবস্থান কোডগুলি ব্যাখ্যা করতে Google বিজ্ঞাপন API রেফারেন্সটি দেখুন। |
network_type | সর্বদা উপস্থিত স্ট্রিং এই ক্ষেত্রটি সেই Google বিজ্ঞাপন বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করবে যেখানে বিজ্ঞাপন ইভেন্টটি সংঘটিত হয়েছিল। সম্ভাব্য মানগুলি নিম্নরূপ। Search Display YouTube GoogleTv cross-network |
network_subtype | যখন স্ট্রিং এই ক্ষেত্রটি Google বিজ্ঞাপন বিজ্ঞাপন নেটওয়ার্কের "উপ-প্রকার" চিহ্নিত করবে যেখানে বিজ্ঞাপন ইভেন্টটি ঘটেছে। সম্ভাব্য মানগুলি প্রাথমিক নেটওয়ার্কের ধরণ অনুসারে পরিবর্তিত হয়। অনুসন্ধান করুনসাধারণ গুগল অনুসন্ধানGoogleSearch SearchPartners প্রদর্শনমোবাইল ওয়েব প্রকাশকmGDN Google AdMob ইউটিউবইউটিউব ভিডিও নেটওয়ার্কYouTubeVideos YouTubeSearch VideoPartners গুগলটিভিগুগলটিভি ভিডিও নেটওয়ার্কGoogleTvVideos ক্রস-নেটওয়ার্কপারফরম্যান্স সর্বোচ্চ ক্রস নেটওয়ার্কcross-network |
video_id | শুধুমাত্র তখনই প্রদান করা হবে যখন স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে সম্পর্কিত YouTube ভিডিও আইডি। dQw4w9WgXcQ |
keyword | শুধুমাত্র তখনই প্রদান করা হবে যখন স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে সম্পর্কিত অনুসন্ধান কীওয়ার্ড। +food +delivery |
match_type | শুধুমাত্র তখনই প্রদান করা হবে যখন স্ট্রিং অনুসন্ধান কীওয়ার্ডের জন্য মিলের ধরণ। সঠিকe p b |
placement | শুধুমাত্র তখনই প্রদান করা হবে যখন স্ট্রিং বিজ্ঞাপন ইভেন্টের সাথে সম্পর্কিত স্থান নির্ধারণ। mobileapp::1-343200656 |
ad_group_id | শুধুমাত্র তখনই প্রদান করা হবে যখন সংখ্যা বিজ্ঞাপন ইভেন্টের সাথে তৈরি বিজ্ঞাপন গ্রুপের সাংখ্যিক আইডি। এই মানটি অনন্য বলে নিশ্চিত। 123456789 |
ad_group_name | শুধুমাত্র তখনই প্রদান করা হবে যখন স্ট্রিং বিজ্ঞাপন ইভেন্ট তৈরি করা বিজ্ঞাপন গ্রুপের বিজ্ঞাপনদাতা-সংজ্ঞায়িত বিজ্ঞাপন গ্রুপের নাম। এই মানটি অনন্য হওয়ার নিশ্চয়তা নেই। My App AdGroup |
creative_id | শুধুমাত্র তখনই প্রদান করা হয় যখন সংখ্যা যে সৃজনশীল বিজ্ঞাপন ইউনিট বিজ্ঞাপন ইভেন্ট তৈরি করেছে তার সংখ্যাসূচক আইডি। এই মানটি অনন্য বলে নিশ্চিত করা হয়েছে। 123456789 |
interaction_type | এই ক্ষেত্রটি সর্বদা ব্যস্ত থাকবে। স্ট্রিং |
is_deterministic | অ্যাট্রিবিউশন পদ্ধতিটি নির্ধারক কিনা তা নির্দেশ করে। বুলিয়ান true, false |
device_model | ডিভাইস মডেল যা বিজ্ঞাপন ইভেন্টটি তৈরি করেছে। স্ট্রিং sm-s936w, sm-3936w |
os_version | বিজ্ঞাপন ইভেন্টটি তৈরি করা প্রধান ওএস সংস্করণ। স্ট্রিং 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": null,
"ad_group_name": 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": null,
"ad_group_name": null,
"is_deterministic": false
},
"device_info": {
"device_model": "iphone12,3",
"os_version": "14",
},
"timestamp": 1432681918.123456
}],
"errors": [],
"attributed": true
}একটি অ্যান্ড্রয়েড নন-ডিটারমিনিস্টিক রূপান্তরের প্রতিক্রিয়ার একটি উদাহরণ হল:
{
"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": null,
"ad_group_name": 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",
"is_deterministic": true
"timestamp": 0.000000,
}],
"errors": [],
"attributed": true
"warnings" [],
}অনুরোধে ত্রুটি থাকলে রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:
{
"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,
"warnings": []
}সার্চ ক্যাম্পেইনের জন্য একজন নন-ইইএ ব্যবহারকারীর জন্য ইতিবাচক রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:
{
"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,
"warnings": []
}ডিসপ্লে ক্যাম্পেইনের জন্য একজন নন-ইইএ ব্যবহারকারীর জন্য একটি ইতিবাচক রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার উদাহরণ হল:
{
"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,
"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": "My App AdGroup",
"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": null,
"ad_group_name": "",
"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": null,
"ad_group_name": "",
"creative_id": null,
"timestamp": 1432681913.123456
},
],
"errors": [],
"warnings": [],
"attributed": true
}একটি অ্যাট্রিবিউটেড কনভার্সন ট্র্যাকিং রেসপন্সের উদাহরণ যেখানে রূপান্তরটি 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": null,
"ad_group_name": "",
"creative_id": null,
"timestamp": 1432681913.123456
},
],
"errors": [],
"warnings": [],
"attributed": true
}একটি অ্যাট্রিবিউটেড কনভার্সন ট্র্যাকিং রেসপন্সের উদাহরণ যেখানে রূপান্তরটি Play, Search এবং YouTube বিজ্ঞাপন ইন্টারঅ্যাকশন উভয়ের জন্যই দায়ী করা হয় এবং Play + Search CPS-এর মধ্যে 5(2)(b) + 5(2)(c) ক্রস-ইউজ সম্মতি গৃহীত হয় কিন্তু 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": null,
"ad_group_name": "",
"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": null,
"ad_group_name": "",
"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 | প্রয়োজনীয় অবস্থান: কোয়েরি পূর্ববর্তী অনুরোধে অ্যাট্রিবিউশনের সাথে যুক্ত বিজ্ঞাপন ইভেন্ট থেকে |
attributed | প্রয়োজনীয় অবস্থান: কোয়েরি API গ্রাহক রূপান্তরের জন্য Google Ads ক্রেডিট পেয়েছে কিনা। হয় |
একটি বৈধ ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধের একটি উদাহরণ হল:
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
×tamp=1432681913.123456
&value=1.99
¤cy_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 প্রতিক্রিয়া পাবে।