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

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

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

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

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

ব্যবহারকারী-এজেন্ট উপাদান
name

বিশ্লেষণ/বিজ্ঞাপন পণ্যের নাম। ( Google AdMob )

মনে রাখবেন যে যদি ব্যবহারকারী এজেন্ট ক্লায়েন্ট সাইডে তৈরি করা হয়, তাহলে name ক্লায়েন্ট অ্যাপের বান্ডেল আইডি হিসেবে ব্যবহার করা উচিত।


অ্যান্ড্রয়েড
// Specified by API consumer.

আইওএস
// Specified by API consumer.
version

বিশ্লেষণ/বিজ্ঞাপন পণ্যের সংস্করণ। ( 7.10.1 )


অ্যান্ড্রয়েড
// Specified by API consumer.

আইওএস
// Specified by API consumer.
os_and_version

অ্যাপটি যে অপারেটিং সিস্টেম এবং অপারেটিং সিস্টেম সংস্করণে চলছে। ( Android 6.0 )


অ্যান্ড্রয়েড
String osAndVersion =
    "Android " + Build.VERSION.RELEASE;

আইওএস
UIDevice *uid =
  [UIDevice currentDevice];
NSString *osAndVersion =
  [NSString
    stringWithFormat:@"%@ %@",
    [uid systemName],
    [uid systemVersion]];
locale

ডিভাইসের জন্য একটি IETF লোকেল ট্যাগ, যেখানে দুই অক্ষরের ভাষা এবং দেশের কোড একটি আন্ডারস্কোর দ্বারা পৃথক করা হবে। ( en_US )


অ্যান্ড্রয়েড
String locale = Locale.getDefault();

আইওএস
NSString *locale =
  [[NSLocale currentLocale]
    localeIdentifier]
device

বিশ্লেষণ/বিজ্ঞাপন পণ্য চালানোর জন্য ব্যবহৃত ডিভাইসের নাম। ( iPhone9,1 )


অ্যান্ড্রয়েড
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/" এর পরে অপারেটিং সিস্টেমের বিল্ড নম্বর। ( Build/13D15 )


অ্যান্ড্রয়েড
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
যেখানে version হল কনভার্সন ট্র্যাকিং API-এর উদ্দিষ্ট সংস্করণ।

একটি স্ট্যান্ডার্ড অ্যাপ রূপান্তর অনুরোধে অ্যাপ রূপান্তর 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 ফিল্ডে গ্রহণযোগ্য নয়। এই ফিল্ডে ১ থেকে ৬৪টি ইউনিকোড অক্ষর থাকা উচিত (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-এ ইন্টিগ্রেটেড কনভার্সন মেজারমেন্ট ব্যবহার করার সময় প্রয়োজন


অবস্থান: কোয়েরি


গুগল অন ডিভাইস মেজারমেন্ট (ODM) থেকে iOS অ্যাপ ইনস্টল বা রিইনস্টল করার সময় ক্যাপচার করা info কোয়েরি প্যারামিটারের মান: ইভেন্ট ডেটা SDK। এই ক্ষেত্রটি iOS অ্যাপ ক্যাম্পেইনের জন্য ইন্টিগ্রেটেড কনভার্সন মেজারমেন্ট সক্ষম করে।

XYZr_AB8C-_zGtKjUhqtzPLeQ8lbJB5dADVR0tpZ9f-28sN5qN9GTZ_FztjL0OL
FzgxUJDhZr8w6lwGxAwPcxSwR5orjWepZiVP7sRRoCiaHerR-1TP17eJKtazgeSg
_CVEs13LllDTfrhVM8uWISqlg8dXobsLzmj8C7WrOlktHA5P_E23
id_type

প্রয়োজনীয়


rdid ক্ষেত্রে পাস করা শনাক্তকারীর ধরণ।


অ্যান্ড্রয়েড

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 এর সুযোগ।

০: এই ব্যবহারকারী এবং রূপান্তরের ক্ষেত্রে ইউরোপীয় নিয়ম প্রযোজ্য নয়।

১: এই ব্যবহারকারী এবং রূপান্তরের ক্ষেত্রে ইউরোপীয় নিয়মকানুন প্রযোজ্য। উদাহরণস্বরূপ, যদি কোনও ব্যবহারকারী 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

প্রয়োজনীয়


অবস্থান: কোয়েরি


অ্যাপটির বর্তমান সংস্করণ। এটি নিম্নরূপ প্রমিত করা উচিত।


অ্যান্ড্রয়েড

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 ব্যবহার না করে, তাহলে অনুগ্রহ করে 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 কোয়েরি প্যারামিটারের মান।

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

নির্দিষ্ট শর্তে প্রয়োজনীয়


অবস্থান: কোয়েরি


Play Install Referrer API এর মাধ্যমে install_referrer মান থেকে ক্যাপচার করা একটি deep link URL থেকে gclid query প্যারামিটারের মান।

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

নির্দিষ্ট শর্তে প্রয়োজনীয়


অবস্থান: কোয়েরি


যেখানে rdid (advertisingid) উপলব্ধ not অথবা সমস্ত zeroes এবং gclid অথবা market_referrer_gclid উপস্থিত রয়েছে, সেখানে gclid ভিত্তিক অ্যাট্রিবিউশনের জন্য শনাক্তকারী।

1
gbraid

নির্দিষ্ট শর্তে প্রয়োজনীয়


অবস্থান: কোয়েরি


অ্যাপটি খোলার জন্য ডিপ লিঙ্ক URL এর মাধ্যমে সর্বশেষ দেখা 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 এর মাধ্যমে প্রাপ্ত পিং প্রত্যাখ্যান করা হবে।

অনুগ্রহ করে মনে রাখবেন যে যদি অনুরোধের বডি খালি থাকে (যেসব ক্ষেত্রে 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"
  • টাইমস্ট্যাম্প

    • সময়ের বিন্যাস: মাইক্রোসেকেন্ড নির্ভুলতার সাথে 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
       &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

অন ​​ডিভাইস মেজারমেন্ট: ইভেন্ট ডেটা 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 এর জন্য একটি অ্যান্ড্রয়েড নন-ডিটারমিনিস্টিক রূপান্তরের জন্য প্রথম খোলা অনুরোধের একটি উদাহরণ হল:

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 - হয় অনুরোধে "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

সর্বদা উপস্থিত


স্ট্রিং


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

যখন campaign_type ACI অথবা ACE হবে এবং network_type Display হবে তখন null হবে।


স্ট্রিং


এই ক্ষেত্রটি Google বিজ্ঞাপন বিজ্ঞাপন নেটওয়ার্কের "উপ-প্রকার" চিহ্নিত করবে যেখানে বিজ্ঞাপন ইভেন্টটি ঘটেছে। সম্ভাব্য মানগুলি প্রাথমিক নেটওয়ার্কের ধরণ অনুসারে পরিবর্তিত হয়।


সাধারণ গুগল অনুসন্ধান
GoogleSearch
গুগল সার্চ পার্টনার
SearchPartners

প্রদর্শন

মোবাইল ওয়েব প্রকাশক
mGDN
অ্যাপ প্রকাশকগণ
Google AdMob

ইউটিউব

ইউটিউব ভিডিও নেটওয়ার্ক
YouTubeVideos
ইউটিউব সার্চ নেটওয়ার্ক
YouTubeSearch
ভিডিও পার্টনার
VideoPartners

গুগলটিভি

গুগলটিভি ভিডিও নেটওয়ার্ক
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 নয়।


সংখ্যা


বিজ্ঞাপন ইভেন্টের সাথে তৈরি বিজ্ঞাপন গ্রুপের সাংখ্যিক আইডি। এই মানটি অনন্য বলে নিশ্চিত।

123456789
ad_group_name

শুধুমাত্র তখনই প্রদান করা হবে যখন campaign_type ACI , ACE , অথবা ACPRE হয়।


স্ট্রিং


বিজ্ঞাপন ইভেন্ট তৈরি করা বিজ্ঞাপন গ্রুপের বিজ্ঞাপনদাতা-সংজ্ঞায়িত বিজ্ঞাপন গ্রুপের নাম। এই মানটি অনন্য হওয়ার নিশ্চয়তা নেই।

My App AdGroup
creative_id

শুধুমাত্র তখনই প্রদান করা হয় যখন campaign_type ACI , ACE , ACPRE , অথবা Performance_Max নয়


সংখ্যা


যে সৃজনশীল বিজ্ঞাপন ইউনিট বিজ্ঞাপন ইভেন্ট তৈরি করেছে তার সংখ্যাসূচক আইডি। এই মানটি অনন্য বলে নিশ্চিত করা হয়েছে।

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": []
}
{
  "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
}
{
  "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
}
{
  "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

প্রয়োজনীয়


অবস্থান: কোয়েরি


পূর্ববর্তী অনুরোধে অ্যাট্রিবিউশনের সাথে যুক্ত বিজ্ঞাপন ইভেন্ট থেকে 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 প্রতিক্রিয়া পাবে।