বিজ্ঞাপন কার্যকলাপ রিপোর্ট Alpha API

বিজ্ঞাপন কার্যকলাপ রিপোর্ট হল আপনার বিজ্ঞাপনের কার্যক্ষমতার একটি কেন্দ্রীভূত দৃশ্য। এটি নেটওয়ার্ক রিপোর্ট API এবং মধ্যস্থতা রিপোর্ট API থেকে ডেটা, মেট্রিক্স এবং মাত্রাগুলিকে একত্রিত করে সেইসাথে একটি একক ইউনিফাইড রিপোর্টে বিডিং ডেটা।

বিজ্ঞাপন কার্যকলাপ প্রতিবেদন API মধ্যস্থতা প্রতিবেদন API এবং নেটওয়ার্ক রিপোর্ট API থেকে অতিরিক্ত উন্নতি প্রদান করে যা নীচের সারণীতে দেখা গেছে:

নেটওয়ার্ক রিপোর্ট API মধ্যস্থতা প্রতিবেদন API বিজ্ঞাপন কার্যকলাপ প্রতিবেদন API
নেটওয়ার্ক কর্মক্ষমতা ✅ ✅ ✅
জলপ্রপাত কর্মক্ষমতা ✅ ✅
বিডিং কর্মক্ষমতা ✅
মধ্যস্থতা A/B পরীক্ষা কর্মক্ষমতা ✅
ঘন্টায় রিপোর্টিং ✅
রিপোর্টের আকার 100k 100k 500k

মেট্রিক্স, মাত্রা এবং মাত্রা ফিল্টার

নেটওয়ার্ক রিপোর্ট এপিআই এবং মেডিয়েশন রিপোর্ট এপিআই-এ উপলভ্য অনেক মেট্রিক ছাড়াও বিজ্ঞাপন অ্যাক্টিভিটি রিপোর্ট API-এ নিম্নলিখিত মেট্রিকগুলি যোগ করা হয়েছে।

মেট্রিক বর্ণনা
BID_REQUEST বিডিং বিজ্ঞাপনের উৎসে করা অনুরোধের সংখ্যা।
BIDS_IN_AUCTION বিডিং নিলামে অংশগ্রহণকারী বিজ্ঞাপন উত্স দ্বারা জমা দেওয়া বিডের সংখ্যা।
WINNING_BIDS একটি বিডিং নিলামে জিতেছে এমন দরগুলির সংখ্যা৷

নিম্নলিখিত নতুন মাত্রাগুলি বিজ্ঞাপন কার্যকলাপ প্রতিবেদন API-এ অন্তর্ভুক্ত করা হয়েছে।

মাত্রা বর্ণনা
সপ্তাহ YYYYMMDD ফরম্যাটে (উদাহরণস্বরূপ, "20210701") সপ্তাহের প্রথম দিনের তারিখ (স্থানীয়করণ সেটিংসে উল্লিখিত ভাষা কোড অনুসারে)। অনুরোধ DATE, WEEK, বা MONTH সময়ের মাত্রার মধ্যে শুধুমাত্র একটি নির্দিষ্ট করতে পারে।
ঘন্টা PST সময়ে HH বিন্যাসে ঘন্টা। উদাহরণস্বরূপ, 5am PST-এর জন্য "05", 1pm PST-এর জন্য "13"৷ অনুরোধে DATE মাত্রাও উল্লেখ করতে হবে। HOUR মাত্রা নির্দিষ্ট করা হলে সর্বাধিক 28 দিনের ডেটা ফেরত দেওয়া হয়। তারিখ ব্যাপ্তি শুরুর তারিখ যা বর্তমান তারিখের 28 দিনের বেশি আগে একটি ত্রুটি প্রদান করে।
MEDIATION_AB_TEST (পরীক্ষার নাম) মধ্যস্থতা A/B পরীক্ষা দ্বারা কর্মক্ষমতা দেখুন। VARIANT মাত্রা নির্দিষ্ট করা থাকলে এটি নির্দিষ্ট করা বাধ্যতামূলক।
MEDIATION_AB_TEST_VARIANT (ভেরিয়েন্ট A, ভেরিয়েন্ট B) মধ্যস্থতা A/B পরীক্ষার বৈকল্পিক দ্বারা কর্মক্ষমতা দেখুন।
মধ্যস্থতা প্রতিবেদন API-এ মাত্রার নাম বিজ্ঞাপন কার্যকলাপ প্রতিবেদন API-এ মাত্রার নাম বর্ণনা
AD_UNIT 1 AD_UNIT_ID বিজ্ঞাপন ইউনিটের অনন্য আইডি (যেমন, "123456789")।
AD_UNIT_NAME বিজ্ঞাপন ইউনিটের নাম।
অ্যাপ 1 APP_ID মোবাইল অ্যাপ্লিকেশনের অনন্য আইডি (উদাহরণস্বরূপ, "1234567890")।
APP_NAME অ্যাপটির নাম।
AD_SOURCE 1 AD_SOURCE_ID বিজ্ঞাপন উৎসের অনন্য আইডি (উদাহরণস্বরূপ, "1234567890123456789"।
AD_SOURCE_NAME বিজ্ঞাপন উৎসের নাম (উদাহরণস্বরূপ, "AdMob নেটওয়ার্ক")।
AD_SOURCE_INSTANCE 1 AD_SOURCE_INSTANCE_ID বিজ্ঞাপন উত্স উদাহরণের অনন্য আইডি (যেমন, "123456789012")।
AD_SOURCE_INSTANCE_NAME বিজ্ঞাপন উৎসের উদাহরণের নাম (যেমন, "AdMob (ডিফল্ট)")।
MEDIATION_GROUP 1 MEDIATION_GROUP_ID মধ্যস্থতা গোষ্ঠীর অনন্য আইডি (উদাহরণস্বরূপ, "1234567890")।
MEDIATION_GROUP_NAME মধ্যস্থতা গোষ্ঠীর অনন্য আইডি (উদাহরণস্বরূপ, "AdMob (ডিফল্ট)")।

1 : অতিরিক্ত তথ্যের জন্য স্কেলার দেখুন।

নিম্নলিখিত মাত্রাগুলির একটি আপডেট ফর্ম্যাট রয়েছে৷

মধ্যস্থতা প্রতিবেদন API-এ মাত্রার নাম মধ্যস্থতা প্রতিবেদন API-এ বর্ণনা বিজ্ঞাপন কার্যকলাপ প্রতিবেদন API-এ বর্ণনা
ESTIMATED_EARNINGS AdMob প্রকাশকের আনুমানিক আয়। উপার্জনের মেট্রিক্সের মুদ্রা একক (USD, EUR, বা অন্য) মুদ্রার স্থানীয়করণ সেটিং দ্বারা নির্ধারিত হয়। পরিমাণ মাইক্রোতে আছে। উদাহরণস্বরূপ, $6.50 6500000 হিসাবে উপস্থাপন করা হবে।

প্রতি মধ্যস্থতা গোষ্ঠী এবং বিজ্ঞাপন উত্স প্রতি আনুমানিক আয় 20 অক্টোবর, 2019 তারিখে সমর্থিত। 20 অক্টোবর, 2019-এর আগের তারিখের জন্য তৃতীয় পক্ষের আনুমানিক উপার্জন 0 দেখাবে।

 AdMob প্রকাশকের আনুমানিক আয়। উপার্জনের মেট্রিক্সের মুদ্রা একক (USD, EUR, বা অন্য) মুদ্রার স্থানীয়করণ সেটিং দ্বারা নির্ধারিত হয়।
OBSERVED_ECPM তৃতীয় পক্ষের বিজ্ঞাপন নেটওয়ার্কের আনুমানিক গড় eCPM। উপার্জনের মেট্রিক্সের মুদ্রা একক (USD, EUR, বা অন্য) মুদ্রার স্থানীয়করণ সেটিং দ্বারা নির্ধারিত হয়। পরিমাণ মাইক্রোতে আছে। উদাহরণস্বরূপ, $2.30 2300000 হিসাবে উপস্থাপন করা হবে।

মধ্যস্থতা গোষ্ঠী প্রতি আনুমানিক গড় eCPM এবং প্রতি বিজ্ঞাপন উৎসের ইন্সট্যান্স লেভেল 20 অক্টোবর, 2019 তারিখে সমর্থিত। তৃতীয় পক্ষের আনুমানিক গড় eCPM 20 অক্টোবর, 2019-এর আগের তারিখের জন্য 0 দেখাবে।

 সমস্ত বিজ্ঞাপনের গড় eCPM। উপার্জনের মেট্রিক্সের মুদ্রা একক (USD, EUR, বা অন্য) মুদ্রার স্থানীয়করণ সেটিং দ্বারা নির্ধারিত হয়।

মধ্যস্থতা গোষ্ঠী প্রতি গড় eCPM এবং প্রতি বিজ্ঞাপন সোর্স ইন্সট্যান্স লেভেল 20 অক্টোবর, 2019 তারিখে সমর্থিত। OBSERVED_ECPM 20 অক্টোবর, 2019-এর আগের তারিখগুলির জন্য 0 দেখাবে।

স্কেলার

নিচের ডাইমেনশনগুলিকে বিজ্ঞাপন অ্যাক্টিভিটি রিপোর্ট API-এ অবজেক্টের পরিবর্তে স্কেলার মান হিসেবে আপডেট করা হয়েছে। এটি প্রতিক্রিয়া সহজতর করবে এবং জটিলতা হ্রাস করবে।

মধ্যস্থতা প্রতিবেদন API এবং নেটওয়ার্ক প্রতিবেদন API-এ প্রভাবিত মাত্রা:

  • AD_UNIT
  • APP
  • AD_SOURCE
  • AD_SOURCE_INSTANCE
  • MEDIATION_GROUP
নমুনা রিপোর্ট প্রতিক্রিয়া তথ্য
মধ্যস্থতা / নেটওয়ার্ক API মাত্রা বিন্যাস 
"AD_UNIT": {
   "value":"ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY",
   "displayLabel": "Test ad unit name"
   }
AAR API মাত্রা বিন্যাস 
"AD_UNIT_NAME": "Test ad unit name",
"AD_UNIT_ID": "ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY"

ঘন্টায় রিপোর্টিং

আপনি এখন AdMob API-এ ঘণ্টার পর ঘণ্টা পারফরম্যান্স দেখতে পারেন। ঘন্টায় রিপোর্টিং 28 দিন পর্যন্ত উপলব্ধ।

প্রতি ঘণ্টার ডেটা পুনরুদ্ধারের অনুরোধে DATE মাত্রাও উল্লেখ করতে হবে। HOUR মাত্রা নির্দিষ্ট করা হলে সর্বাধিক 28 দিনের ডেটা ফেরত দেওয়া হয়। তারিখ ব্যাপ্তি শুরুর তারিখ যা বর্তমান তারিখের 28 দিনের বেশি আগে একটি ত্রুটি প্রদান করে।

বড় রিপোর্ট আকার

বিজ্ঞাপন কার্যকলাপ প্রতিবেদন API আপনাকে মোট 500,000 সারি পুনরুদ্ধার করতে দেয়। অতিরিক্ত তথ্যের জন্য, কোটা নির্দেশিকা দেখুন।

একটি অনুরোধ করুন

একটি অনুরোধ করতে এই পদক্ষেপগুলি অনুসরণ করুন.

কার্ল (কমান্ড লাইন)

কার্ল ব্যবহার করে অনুরোধ

  1. ক্লায়েন্ট সিক্রেটস ফাইল লোড করুন এবং অনুমোদনের শংসাপত্র তৈরি করুন।

    প্রথমবার যখন আপনি এই পদক্ষেপটি সম্পাদন করেন তখন আপনাকে আপনার ব্রাউজারে একটি অনুমোদন প্রম্পট গ্রহণ করতে বলা হবে। স্বীকার করার আগে, নিশ্চিত করুন যে আপনি একটি Google অ্যাকাউন্ট দিয়ে সাইন ইন করেছেন যেটির AdMob API-এ অ্যাক্সেস রয়েছে৷ আপনার অ্যাপ্লিকেশনটি বর্তমানে যে অ্যাকাউন্টে লগ ইন করা আছে তার পক্ষ থেকে ডেটা অ্যাক্সেস করার জন্য অনুমোদিত হবে৷

    প্রমাণীকরণ এবং অনুমোদনের জন্য, আমরা oauth2l ব্যবহার করার পরামর্শ দিই, Google OAuth 2.0 এর সাথে কাজ করার জন্য একটি সাধারণ কমান্ড-লাইন টুল। oauth2l ইনস্টল করুন এবং নীচের কমান্ডটি চালান, path_to_credentials_json একটি credentials.json ফাইলের পাথ দিয়ে প্রতিস্থাপন করুন যা আপনি আপনার ক্লাউড অ্যাপ্লিকেশন নিবন্ধন করার সময় ডাউনলোড করেন। প্রথম রানের জন্য, কমান্ডটি আপনাকে OAuth 2.0 অনুমোদন প্রবাহের মাধ্যমে নিয়ে যায়। পরবর্তী রান স্বয়ংক্রিয়ভাবে টোকেন রিফ্রেশ করে।

    ~/go/bin/oauth2l header --json path_to_credentials_json \
        https://www.googleapis.com/auth/admob.readonly

  2. একটি বিজ্ঞাপন কার্যকলাপ রিপোর্ট তৈরি করুন.

    curl -X POST https://admob.googleapis.com/v1alpha/accounts/pub-XXXXXXXXXXXXXXXX/adsActivityReport:generate \
     -H "Content-Type: application/json" \
     -H "$(~/go/bin/oauth2l header --json path_to_credentials_json https://www.googleapis.com/auth/admob.readonly)"  --data @- << EOF
      {
        "report_spec": {
        "date_range": {
          "start_date": {"year": 2023, "month": 1, "day": 1},
          "end_date": {"year": 2023, "month": 1, "day": 2}
        },
        "dimensions": ["DATE", "HOUR", "MEDIATION_AB_TEST", "VARIANT", "AD_SOURCE_ID", "AD_SOURCE_NAME"],
        "metrics": ["CLICKS", "BID_REQUEST","WINNING_BIDS", "IMPRESSIONS", "ESTIMATED_EARNINGS" ],
        "dimension_filters": [{"dimension": "COUNTRY", "matches_any": {"values": ["US"]}}],
        "sort_conditions": [{"metric":"CLICKS", "order": "DESCENDING"}],
        "localization_settings": {"currency_code": "USD", "language_code": "en-US"}
        }
      }
EOF

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

    {
"rows": [
  {
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant A"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 0
      },
      "BID_REQUEST": {
        "integerValue": "27"
      },
      "WINNING_BIDS": {
        "doubleValue": 0.1111111111111111
      },
      "IMPRESSIONS": {
        "integerValue": "2"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0
      }
    }
  },
{
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant B"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 1
      },
      "BID_REQUEST": {
        "integerValue": "6"
      },
      "WINNING_BIDS": {
        "doubleValue": 1
      },
      "IMPRESSIONS": {
        "integerValue": "3"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0.000427519
      }
    }
  }
]}