অ্যাপ ব্যবহারকারী-এজেন্ট
স্প্যাম মোকাবেলায় আমাদের বৃহত্তর প্রচেষ্টার অংশ হিসাবে, আমরা একটি অ্যাপ ব্যবহারকারীর পক্ষ থেকে বিশ্লেষণ/বিজ্ঞাপন পণ্য দ্বারা প্রেরিত ব্যবহারকারী-এজেন্ট শিরোনামের জন্য একটি প্রমিত স্পেসিফিকেশন তৈরি করেছি। অ্যাপ ব্যবহারকারী-এজেন্ট নিম্নলিখিত স্পেসিফিকেশন মেনে নেটিভ কোড থেকে প্রাপ্ত করা যেতে পারে:
name version (os_and_version; locale; device; build; Proxy)
এই ক্ষেত্রগুলির সংজ্ঞা নিম্নরূপ:
ব্যবহারকারী-এজেন্ট উপাদান | |
---|---|
name | বিশ্লেষণ/বিজ্ঞাপন পণ্যের নাম। ( মনে রাখবেন যে যদি ব্যবহারকারী এজেন্ট ক্লায়েন্টের পাশে তৈরি করা হয়, অ্যান্ড্রয়েড// Specified by API consumer. iOS// Specified by API consumer. |
version | বিশ্লেষণ/বিজ্ঞাপন পণ্যের সংস্করণ। ( অ্যান্ড্রয়েড// Specified by API consumer. iOS// Specified by API consumer. |
os_and_version | অপারেটিং সিস্টেম এবং অপারেটিং সিস্টেম সংস্করণে অ্যাপটি চলছে। ( অ্যান্ড্রয়েডString osAndVersion = "Android " + Build.VERSION.RELEASE; iOSUIDevice *uid = [UIDevice currentDevice]; NSString *osAndVersion = [NSString stringWithFormat:@"%@ %@", [uid systemName], [uid systemVersion]]; |
locale | একটি আন্ডারস্কোর দ্বারা পৃথক করা দুই-অক্ষরের ভাষা এবং দেশের কোড ব্যবহার করে ডিভাইসের জন্য একটি IETF লোকেল ট্যাগ। ( অ্যান্ড্রয়েডString locale = Locale.getDefault(); iOSNSString *locale = [[NSLocale currentLocale] localeIdentifier] |
device | অ্যানালিটিক্স/বিজ্ঞাপন পণ্য চালানোর ফিজিক্যাল ডিভাইসের নাম। ( অ্যান্ড্রয়েড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 | "বিল্ড/" এর পরে অপারেটিং সিস্টেমের বিল্ড নম্বর। ( অ্যান্ড্রয়েড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
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
|
app_event_name | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: জিজ্ঞাসা যে কোনো কাস্টম অ্যাপ ইভেন্টের নাম যা level_achieved Level Achieved এই ক্ষেত্রটিতে |
app_event_data | ঐচ্ছিক অবস্থান: শরীর মানগুলিতে একটি সাধারণ JSON অবজেক্ট ম্যাপিং স্ট্রিং কী হিসাবে কোনও অতিরিক্ত সমৃদ্ধ ইভেন্ট ডেটা ফরোয়ার্ড করুন। গ্রহণযোগ্য মান হল স্ট্রিং এবং স্ট্রিং এর অ্যারে। {"level": 5, "attempts": 20} |
rdid | প্রয়োজন অবস্থান: প্রশ্ন একটি বৈধ UUID স্ট্রিং কাঁচা ডিভাইস আইডি প্রতিনিধিত্ব করে। f10e1de2-e237-4f50-b6aa-843c45cc63d6 যদি ডিভাইস আইডি অনুপস্থিত থাকে, যেমন একটি ATT অসম্মত ব্যবহারকারীর ডিভাইস আইডি, এটি সম্পূর্ণ শূন্য হিসাবে সেট করুন। 00000000-0000-0000-0000-000000000000 |
id_type | প্রয়োজন অবস্থান: প্রশ্ন অ্যান্ড্রয়েডadvertisingid iOSidfa |
eea | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: প্রশ্ন EEA সুযোগ।
|
ad_personalization | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: প্রশ্ন ব্যক্তিগতকৃত বিজ্ঞাপনের পতাকা
|
ad_user_data | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: প্রশ্ন বিজ্ঞাপনের উদ্দেশ্যে ব্যবহারকারীর ডেটা ব্যবহারের জন্য সম্মতির পতাকা
|
lat | প্রয়োজন অবস্থান: জিজ্ঞাসা ডিভাইসের জন্য সীমা-বিজ্ঞাপন-ট্র্যাকিং অবস্থা।
|
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 ব্যবহার না করে, তাহলে অনুগ্রহ করে 1.9.5r6 |
timestamp | প্রয়োজন অবস্থান: জিজ্ঞাসা UNIX টাইমস্ট্যাম্পে রূপান্তর ঘটনা ঘটেছে, মাইক্রোসেকেন্ড পর্যন্ত নির্ভুলতার সাথে সেকেন্ডে। 1432681913.123456 |
value | ঐচ্ছিক অবস্থান: প্রশ্ন ইভেন্টের আর্থিক মূল্য, যদি থাকে। মানটির পূর্ণসংখ্যা এবং ভগ্নাংশকে আলাদা করতে দশমিক বিন্দু ব্যবহার করে এটি সর্বদা মেশিন-পাঠযোগ্য ফ্লোটিং পয়েন্ট মান হিসাবে ফর্ম্যাট করা উচিত। 1.99 |
currency_code | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: জিজ্ঞাসা USD |
gclid | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: প্রশ্ন অ্যাপটি খোলা একটি গভীর লিঙ্ক URL থেকে Cj0KEQjw0dy4BRCuuL_e5M |
market_referrer_gclid | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: প্রশ্ন Play Install Referrer API এর মাধ্যমে install_referrer মান থেকে ক্যাপচার করা একটি গভীর লিঙ্ক URL থেকে BX3QojHp4mY5MrJtFM_d1u |
gclid_only_request | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: প্রশ্ন এমন পরিস্থিতিতে 1 |
gbraid | নির্দিষ্ট শর্তের অধীনে প্রয়োজনীয় অবস্থান: প্রশ্ন শেষবার দেখা 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 এর মাধ্যমে প্রাপ্ত 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 &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.0 ?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.0 ?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.0 ?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.0 ?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
ইভেন্ট ডেটা এনকোডিং
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"
-
- তারিখ বিন্যাস: yyyy-mm-dd
টাইমস্ট্যাম্প
- সময়ের বিন্যাস: ইউনিক্স/ইপোচ টাইমস্ট্যাম্প ইউটিসি টাইমজোনে মাইক্রোসেকেন্ড পর্যন্ত নির্ভুলতার সাথে সংজ্ঞায়িত করা হয়েছে
- বৈধ উদাহরণ:
-
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
।
ত্রুটি কোড
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" ফিল্ড সেট করা হয়নি বা এটি অবৈধ। সমস্ত ইন-স্কোপ ডিএমএ অনুরোধের জন্য "বিজ্ঞাপন_ব্যক্তিগতকরণ" ক্ষেত্রটি প্রয়োজন৷
বিজ্ঞাপন ইভেন্ট হল অ্যাপ অ্যাট্রিবিউশনের মূল বিষয় এবং এতে নিম্নলিখিত বৈশিষ্ট্য থাকবে।
ব্যবহারকারীর সম্মতির উপর নির্ভরশীল প্রতিক্রিয়া আচরণ সম্পর্কিত গুরুত্বপূর্ণ নোট:
রূপান্তরটিতে বিজ্ঞাপন ব্যবহারকারীর ডেটার সম্মতি থাকলে এবং ব্যবহারকারীর তাদের Google ব্যবহারকারী সেটিংসের মধ্যে ক্রস-ইউজ সম্মতি থাকলে, Google Ads তার সমস্ত CPS জুড়ে একটি শেষ ক্লিকে প্রতিক্রিয়া জানাবে। ব্যবহারকারী যদি তাদের Google ব্যবহারকারী সেটিংসের মধ্যে ক্রস-ইউজের সম্মতিতে সম্মতি না দেন, তাহলে Google Ads প্রতি CPS ভিত্তিতে একাধিক শেষ ক্লিকের সাথে প্রতিক্রিয়া জানাবে।
যদি কনভার্সনে ব্যবহারকারী-নির্বাচিত ক্রস-ব্যবহারের সম্মতিতে কিছু CPS অন্তর্ভুক্ত থাকে তবে অন্যদের নয়, তাহলে Google Ads ক্রস-ব্যবহারের সম্মতি দেওয়া CPSগুলিতে একটি শেষ ক্লিকের সাথে প্রতিক্রিয়া জানাবে, কিন্তু CPS-এর ভিত্তিতে একাধিক শেষ ক্লিকের সাথে, সেই CPS-দের ক্রস-ব্যবহারের সম্মতি দেওয়া হয়নি।
রূপান্তর ট্র্যাকিং প্রতিক্রিয়া | |
---|---|
ad_event_id | সর্বদা উপস্থিত স্ট্রিং Q2owS0VRancwZHk0QlJDdXVMX2U1TQ |
conversion_metric | সর্বদা উপস্থিত স্ট্রিং অ্যাট্রিবিউশনের জন্য ব্যবহৃত রূপান্তর মেট্রিক। আমরা প্রাথমিকভাবে একটি রূপান্তর মেট্রিক সমর্থন করব। conversion |
timestamp | সর্বদা উপস্থিত সংখ্যা ইউনিক্স টাইমস্ট্যাম্প বিজ্ঞাপন ইভেন্টটি ঘটেছে, মাইক্রোসেকেন্ড পর্যন্ত নির্ভুলতার সাথে সেকেন্ডে। এই মানটি লাস্ট-ক্লিক অ্যাট্রিবিউশনের জন্য ব্যবহার করা উচিত। 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 Ads API রেফারেন্স দেখুন। |
network_type | সর্বদা উপস্থিত স্ট্রিং এই ক্ষেত্রটি বিজ্ঞাপন ইভেন্টটি ঘটেছে এমন Google বিজ্ঞাপন বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করবে। সম্ভাব্য মান নিম্নরূপ। Search Display YouTube GoogleTv cross-network |
network_subtype | স্ট্রিং এই ক্ষেত্রটি Google Ads বিজ্ঞাপন নেটওয়ার্কের "সাবটাইপ" সনাক্ত করবে যে বিজ্ঞাপন ইভেন্টটি ঘটেছে। সম্ভাব্য মান প্রাথমিক নেটওয়ার্কের প্রকার অনুসারে পরিবর্তিত হয়। অনুসন্ধান করুনসাধারণ Google অনুসন্ধানGoogleSearch SearchPartners প্রদর্শনমোবাইল ওয়েব পাবলিশার্সmGDN Google AdMob YouTubeইউটিউব ভিডিও নেটওয়ার্কYouTubeVideos YouTubeSearch VideoPartners GoogleTvGoogleTV ভিডিও নেটওয়ার্ক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 | এই ক্ষেত্র সবসময় ব্যস্ততা থাকবে. স্ট্রিং |
নমুনা প্রতিক্রিয়া
অনুরোধে ত্রুটি থাকাকালীন একটি রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ হল:
{ "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": [] }
অনুসন্ধান প্রচারাভিযানের জন্য নন-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": "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": [] }
একটি বৈশিষ্ট্যযুক্ত রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ যেখানে রূপান্তরটি প্লে + অনুসন্ধান বিজ্ঞাপন ইন্টারঅ্যাকশন উভয়ের জন্য দায়ী করা হয় কিন্তু 5(2)(b) + 5(2)(c) ক্রস-ব্যবহারের সম্মতি Play + অনুসন্ধান 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": "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 }
অ্যাট্রিবিউটেড কনভার্সন ট্র্যাকিং রেসপন্সের একটি উদাহরণ যেখানে প্লে + সার্চ বিজ্ঞাপন ইন্টারঅ্যাকশন এবং 5(2)(b) + 5(2)(c) ক্রস-ইউজ কনসেন্ট গৃহীত হয় উভয়ের জন্যই কনভার্সনটি অ্যাট্রিবিউট করা হয় প্লে + সার্চ 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 }, ], "errors": [], "warnings": [], "attributed": true }
একটি বৈশিষ্ট্যযুক্ত রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ যেখানে রূপান্তরটি প্লে, অনুসন্ধান এবং YouTube বিজ্ঞাপন ইন্টারঅ্যাকশন উভয়ের জন্য দায়ী করা হয় এবং 5(2)(b) + 5(2)(c) ক্রস-ব্যবহারের সম্মতিটি Play + অনুসন্ধান 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": 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.0/cross_network
এবং দুটি প্রয়োজনীয় পরামিতি যোগ করুন:
ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধ | |
---|---|
ad_event_id | প্রয়োজন অবস্থান: জিজ্ঞাসা পূর্বের অনুরোধে অ্যাট্রিবিউশনের সাথে যুক্ত বিজ্ঞাপন ইভেন্ট থেকে |
attributed | প্রয়োজন অবস্থান: প্রশ্ন এপিআই গ্রাহকের দ্বারা রূপান্তরের জন্য Google বিজ্ঞাপন ক্রেডিট পেয়েছে কি না। হয় |
একটি বৈধ ক্রস-নেটওয়ার্ক অ্যাট্রিবিউশন অনুরোধের একটি উদাহরণ হল:
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 ×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 প্রতিক্রিয়া পাবে।