কুকবুক কোয়েরি করা

এই গাইডে Google Ads কোয়েরি ল্যাঙ্গুয়েজ (GAQL) কোয়েরি দেওয়া আছে যা সাধারণ Google Ads UI স্ক্রিনের মতো একই ডেটা রিটার্ন করে এবং জিও কনস্ট্যান্ট লুক-আপ করে। কোনও পরিবর্তন না করেই এইসব কোয়েরি ব্যবহার করুন অথবা আপনার রিপোর্টিং ওয়ার্কফ্লোর জন্য সেগুলি মানানসই করে নিন।

API রিসোর্সে UI রিপোর্টের আরও বিস্তারিত ম্যাপিংয়ের জন্য, Google Ads UI-তে রিপোর্ট দেখুন। Google Ads UI-তে API রিসোর্স ও ফিল্ড চেক করতে Google Ads API রিপোর্টিং এক্সটেনশন ব্যবহার করুন। কাস্টম কোয়েরি তৈরি ও যাচাই করতে ইন্টার‍্যাক্টিভ কোয়েরি বিল্ডার ব্যবহার করুন।

curlটি এনভায়রনমেন্ট ভেরিয়েবল সেট করুন

curl ট্যাব REST searchStream এন্ডপয়েন্ট-এ কম্প্রেস করা স্ট্রিমিং অনুরোধ পাঠায়। curl কমান্ড রান করার আগে, আপনার শেলে নিম্নলিখিত এনভায়রনমেন্ট ভেরিয়েবল সেট করুন:

• API_VERSION: API ভার্সন নম্বর, যার শুরুতে v নেই (যেমন, 26)।
• CUSTOMER_ID: হাইফেন ছাড়া ১০ সংখ্যার টার্গেট ক্লায়েন্ট কাস্টমার আইডি।
• MANAGER_CUSTOMER_ID: হাইফেন ছাড়া ১০ সংখ্যার ম্যানেজার অ্যাকাউন্ট আইডি। আপনি সরাসরি টার্গেট ক্লায়েন্ট অ্যাকাউন্ট হিসেবে যাচাই করলে, MANAGER_CUSTOMER_ID-কে CUSTOMER_ID হিসেবে সেট করুন অথবা login-customer-id হেডার বাদ দিন (লগ-ইন কাস্টমার আইডি দেখুন)।
• OAUTH2_ACCESS_TOKEN: একটি সঠিক OAuth 2.0 অ্যাক্সেস টোকেন।

Google Ads UI স্ক্রিন রেপ্লিকেট করা

এই বিভাগে API কোয়েরি দেখানো হয় যা Google Ads UI-এর ডিফল্ট স্ক্রিনের মতো একই ডেটা ফেরত দেয়। আপনি যদি এমন কোনও অ্যাপ তৈরি করেন যা Google Ads-এর মতো মেট্রিক এবং ডেটা দেখায়, তাহলে এই কোয়েরিগুলি আপনাকে API থেকে অনুরূপ ডেটা পেতে সাহায্য করতে পারে।

মনে রাখবেন: অন্যভাবে উল্লেখ করা না থাকলে, এই গাইডে তারিখ উল্লেখ করা সব কোয়েরি ডিফল্ট হিসেবে গত সাত দিনের ডেটা দেখায়। আপনার Google Ads UI ওয়ার্কস্পেস বারে সরিয়ে দেওয়া পেরেন্ট এন্টিটি বাদ দেওয়া হলে, চাইল্ড-এন্টিটি কোয়েরিতে AND campaign.status != 'REMOVED' বা AND ad_group.status != 'REMOVED' যোগ করুন।

পরামর্শ: অব্যবহৃত resource_name ফিল্ড বাদ দিতে এবং searchStream পেলোড কমাতে, PARAMETERS omit_unselected_resource_names = true ক্লজ যোগ করুন (omit_unselected_resource_names প্যারামিটার দেখুন)।

ক্যাম্পেন

Google Ads UI-তে ডিফল্ট ক্যাম্পেন ওভারভিউ স্ক্রিন থেকে ডেটা রিট্রিভ করুন।

GAQL

SELECT campaign.name,
  campaign_budget.amount_micros,
  campaign.status,
  campaign.optimization_score,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.bidding_strategy_type
FROM campaign
WHERE segments.date DURING LAST_7_DAYS
  AND campaign.status != 'REMOVED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT campaign.name,
      campaign_budget.amount_micros,
      campaign.status,
      campaign.optimization_score,
      campaign.advertising_channel_type,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.bidding_strategy_type
    FROM campaign
    WHERE segments.date DURING LAST_7_DAYS
      AND campaign.status != 'REMOVED'
  "
}
EOF

বিজ্ঞাপন গোষ্ঠীগুলি

Google Ads UI-তে ডিফল্ট বিজ্ঞাপন গ্রুপ ওভারভিউ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

GAQL

SELECT ad_group.name,
  campaign.name,
  ad_group.status,
  ad_group.type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group.status != 'REMOVED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group.name,
      campaign.name,
      ad_group.status,
      ad_group.type,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM ad_group
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group.status != 'REMOVED'
  "
}
EOF

বিজ্ঞাপন

Google Ads UI-তে ডিফল্ট Ads ওভারভিউ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন। এই কোয়েরি বিজ্ঞাপন এবং বিজ্ঞাপনের ক্ষমতা কলামের জন্য রেসপন্সিভ সার্চ বিজ্ঞাপনের AdTextAsset শিরোনাম এবং বিবরণ, ফাইনাল URL এবং বিজ্ঞাপনের ক্ষমতা সংক্রান্ত তথ্য নিয়ে আসে।

মনে রাখবেন: অন্যান্য ধরনের বিজ্ঞাপন সরানো না হলে, সেগুলি এখনও responsive_search_ad ফিল্ড সেট না করেই দেখানো হয়। রেসপন্সিভ সার্চ বিজ্ঞাপনে ফলাফল সীমিত করতে, WHERE ক্লজে AND ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' যোগ করুন।

GAQL

SELECT ad_group_ad.ad.responsive_search_ad.headlines,
  ad_group_ad.ad.responsive_search_ad.descriptions,
  ad_group_ad.ad.final_urls,
  campaign.name,
  ad_group.name,
  ad_group_ad.status,
  ad_group_ad.policy_summary.approval_status,
  ad_group_ad.ad.type,
  ad_group_ad.ad_strength,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM ad_group_ad
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_ad.status != 'REMOVED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_ad.ad.responsive_search_ad.headlines,
      ad_group_ad.ad.responsive_search_ad.descriptions,
      ad_group_ad.ad.final_urls,
      campaign.name,
      ad_group.name,
      ad_group_ad.status,
      ad_group_ad.policy_summary.approval_status,
      ad_group_ad.ad.type,
      ad_group_ad.ad_strength,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM ad_group_ad
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group_ad.status != 'REMOVED'
  "
}
EOF

মূলশব্দগুলি খুঁজুন

Google Ads UI-এর ডিফল্ট সার্চের কীওয়ার্ড ওভারভিউ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

GAQL

SELECT ad_group_criterion.keyword.text,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.keyword.match_type,
  ad_group_criterion.approval_status,
  ad_group_criterion.final_urls,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM keyword_view
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_criterion.status != 'REMOVED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.keyword.text,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.keyword.match_type,
      ad_group_criterion.approval_status,
      ad_group_criterion.final_urls,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM keyword_view
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group_criterion.status != 'REMOVED'
  "
}
EOF

সার্চ করা শব্দ

Google Ads UI-তে ডিফল্ট সার্চ করা শব্দ ওভারভিউ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

মনে রাখবেন: search_term_view রিসোর্স বিজ্ঞাপন গ্রুপ লেভেলে অ্যাগ্রিগেট করে এবং পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন বাদ দেয়। পারফর্ম্যান্স ম্যাক্স সার্চ করা শব্দের জন্য, পরিবর্তে campaign_search_term_view রিসোর্স কোয়েরি করুন ( সার্চ করা শব্দের পারফর্ম্যান্স দেখুন)।

GAQL

SELECT search_term_view.search_term,
  segments.keyword.info.match_type,
  search_term_view.status,
  campaign.name,
  ad_group.name,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM search_term_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT search_term_view.search_term,
      segments.keyword.info.match_type,
      search_term_view.status,
      campaign.name,
      ad_group.name,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM search_term_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

অডিয়েন্স

Google Ads UI-তে ডিফল্ট দর্শক ওভারভিউ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

গুরুত্বপূর্ণ পয়েন্ট: রিপোর্টিং API ক্রাইটেরিয়ন আইডি অনুযায়ী দর্শক ফিরিয়ে আনে। তাদের ডিসপ্লে নাম পেতে, কোড ও ফর্ম্যাট পৃষ্ঠায় দেওয়া রেফারেন্স টেবিলে আইডিগুলি দেখুন। কোন ধরনের শর্তের টেবিল ব্যবহার করতে হবে তা নির্ধারণ করতে আপনি ad_group_criterion.type ফিল্ড থেকে শুরু করতে পারেন।

GAQL

SELECT ad_group_criterion.resource_name,
  ad_group_criterion.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM ad_group_audience_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.resource_name,
      ad_group_criterion.type,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM ad_group_audience_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

বয়স (জনসংখ্যাতত্ত্ব)

Google Ads UI-এর ডিফল্ট বয়স জনসংখ্যাতত্ত্ব ওভারভিউ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

GAQL

SELECT ad_group_criterion.age_range.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM age_range_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.age_range.type,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM age_range_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

লিঙ্গ (জনসংখ্যাতত্ত্ব)

Google Ads UI-তে ডিফল্ট লিঙ্গগত পরিচয় ডেমোগ্রাফিক ওভারভিউ স্ক্রিন থেকে ডেটা রিট্রিভ করুন।

GAQL

SELECT ad_group_criterion.gender.type,
  campaign.name,
  ad_group.name,
  ad_group_criterion.system_serving_status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  campaign.advertising_channel_type
FROM gender_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.gender.type,
      campaign.name,
      ad_group.name,
      ad_group_criterion.system_serving_status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      campaign.advertising_channel_type
    FROM gender_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

লোকেশন

Google Ads UI-তে ডিফল্ট লোকেশন ওভারভিউ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

গুরুত্বপূর্ণ পয়েন্ট: রিপোর্টিং API ক্রাইটেরিয়ন আইডি অনুযায়ী লোকেশন দেখায়। সেগুলির দেখানো নাম পেতে, জিও টার্গেট ডেটা-তে campaign_criterion.location.geo_target_constant ফিল্ড দেখুন অথবা geo_target_constant রিসোর্স কোয়েরি করতে API ব্যবহার করুন। লোকেশন > ভৌগোলিক রিপোর্ট থেকে ব্যবহারকারীর ফিজিক্যাল বা আগ্রহের লোকেশনের জন্য, geographic_view রিসোর্স কোয়েরি করুন।

GAQL

SELECT campaign_criterion.location.geo_target_constant,
  campaign.name,
  campaign_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM location_view
WHERE segments.date DURING LAST_7_DAYS
  AND campaign_criterion.status != 'REMOVED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT campaign_criterion.location.geo_target_constant,
      campaign.name,
      campaign_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM location_view
    WHERE segments.date DURING LAST_7_DAYS
      AND campaign_criterion.status != 'REMOVED'
  "
}
EOF

অবস্থানগুলি:

managed_placement_view রিসোর্স কোয়েরি করে Google Ads UI-এর কন্টেন্ট > প্লেসমেন্ট স্ক্রিন থেকে স্পষ্টভাবে টার্গেট করা প্লেসমেন্টের ডেটা ফিরিয়ে আনুন।

মনে রাখার মতো বিষয়: managed_placement_view, group_placement_view, detail_placement_view এবং performance_max_placement_view রিসোর্সের মধ্যে থেকে বেছে নিতে, বিজ্ঞাপনের প্লেসমেন্ট ও পারফর্ম্যান্স ট্র্যাক করুন দেখুন।

GAQL

SELECT ad_group_criterion.placement.url,
  campaign.name,
  ad_group.name,
  ad_group_criterion.status,
  ad_group_criterion.bid_modifier,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_7_DAYS
  AND ad_group_criterion.status != 'REMOVED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT ad_group_criterion.placement.url,
      campaign.name,
      ad_group.name,
      ad_group_criterion.status,
      ad_group_criterion.bid_modifier,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM managed_placement_view
    WHERE segments.date DURING LAST_7_DAYS
      AND ad_group_criterion.status != 'REMOVED'
  "
}
EOF

যেখানে বিজ্ঞাপন দেখানো হয়েছে

group_placement_view রিসোর্স কোয়েরি করে Google Ads UI-এর কন্টেন্ট > যেখানে বিজ্ঞাপন দেখানো হয়েছে স্ক্রিন থেকে ডোমেন, মোবাইল অ্যাপ ও YouTube চ্যানেল প্লেসমেন্ট ডেটা ফিরিয়ে আনুন।

মনে রাখবেন: API সেইসব প্লেসমেন্ট বাদ দেয় যেগুলি ন্যূনতম অ্যাক্টিভিটি থ্রেশহোল্ড পূরণ করে না এবং UI-এর মোট: অন্যান্য সারসংক্ষেপের সারি দেখায় না। "মোট: অন্যান্য" সারি এবং উপলভ্য নয় এমন প্লেসমেন্টের বিবরণ সহ সারি দেখুন।

GAQL

SELECT group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  campaign.name,
  ad_group.name,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT group_placement_view.display_name,
      group_placement_view.target_url,
      group_placement_view.placement_type,
      campaign.name,
      ad_group.name,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM group_placement_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

প্লেসমেন্টের বিবরণ

detail_placement_view রিসোর্স কোয়েরি করে Google Ads UI-তে কন্টেন্ট > যেখানে বিজ্ঞাপন দেখানো হয়েছে > বিবরণ দেখুন থেকে URL-লেভেল ও ভিডিও-লেভেল প্লেসমেন্ট মেট্রিক ফিরিয়ে আনুন।

মনে রাখবেন: যেহেতু detail_placement_view রিসোর্স প্রতিটি URL বা ভিডিওর জন্য অ্যাক্টিভিটি থ্রেশহোল্ড মূল্যায়ন করে, তাই এর রো-এর মোট সংখ্যা group_placement_view-এর মোট সংখ্যার চেয়ে কম হতে পারে। প্লেসমেন্ট ভিউয়ের মধ্যে মেট্রিক সংক্রান্ত পার্থক্য এবং উপলভ্য নয় এমন প্লেসমেন্টের বিবরণ সহ সারি দেখুন।

GAQL

SELECT detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  campaign.name,
  ad_group.name,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT detail_placement_view.display_name,
      detail_placement_view.target_url,
      detail_placement_view.group_placement_target_url,
      detail_placement_view.placement_type,
      campaign.name,
      ad_group.name,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM detail_placement_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

পারফর্ম্যান্স ম্যাক্স প্লেসমেন্ট

ইনসাইট ও রিপোর্ট > রিপোর্ট এডিটর-এ গিয়ে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন প্লেসমেন্ট পূর্বনির্ধারিত রিপোর্ট থেকে প্লেসমেন্ট ইম্প্রেশন ফিরিয়ে আনুন। এর জন্য performance_max_placement_view রিসোর্স কোয়েরি করুন।

মনে রাখবেন: performance_max_placement_view রিসোর্স শুধুমাত্র metrics.impressions মেট্রিক দেখায়। v24 এবং তার পরবর্তী ভার্সনে, নেটওয়ার্ক অনুযায়ী ইম্প্রেশন সেগমেন্ট করতে segments.ad_network_type ফিল্ড যোগ করুন ( পারফর্ম্যান্স ম্যাক্স প্লেসমেন্ট ভিউ দেখুন)।

GAQL

SELECT performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  campaign.name,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT performance_max_placement_view.display_name,
      performance_max_placement_view.target_url,
      performance_max_placement_view.placement_type,
      campaign.name,
      metrics.impressions
    FROM performance_max_placement_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

ল্যান্ডিং পৃষ্ঠা

landing_page_view রিসোর্স কোয়েরি করে Google Ads UI-এর ডিফল্ট ল্যান্ডিং পৃষ্ঠা স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

মনে রাখবেন: campaign এবং ad_group রিসোর্স সেগমেন্ট landing_page_view মেট্রিক্স এবং ad_group ফিল্ড বেছে নিলে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন বাদ দেওয়া হয়। অ্যাকাউন্ট-লেভেল URL-এর মোট সংখ্যার জন্য, campaign.name ফিল্ডটি বাদ দিন। ValueTrack সাবস্টিটিউশন এবং ফাইনাল URL এক্সপ্যানশনের পরে URL-এর জন্য, expanded_landing_page_view রিসোর্স কোয়েরি করুন।

GAQL

SELECT landing_page_view.unexpanded_final_url,
  campaign.name,
  metrics.mobile_friendly_clicks_percentage,
  metrics.speed_score,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM landing_page_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT landing_page_view.unexpanded_final_url,
      campaign.name,
      metrics.mobile_friendly_clicks_percentage,
      metrics.speed_score,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros
    FROM landing_page_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

অ্যাসেট গ্রুপ

asset_group রিসোর্স কোয়েরি করে Google Ads UI-তে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের জন্য অ্যাসেট গ্রুপ স্ক্রিন থেকে ডেটা ফিরিয়ে আনুন।

GAQL

SELECT asset_group.name,
  campaign.name,
  asset_group.status,
  asset_group.ad_strength,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.conversions
FROM asset_group
WHERE segments.date DURING LAST_7_DAYS
  AND asset_group.status != 'REMOVED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT asset_group.name,
      campaign.name,
      asset_group.status,
      asset_group.ad_strength,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      metrics.conversions
    FROM asset_group
    WHERE segments.date DURING LAST_7_DAYS
      AND asset_group.status != 'REMOVED'
  "
}
EOF

প্রোডাক্ট

Google Ads UI-তে শপিং ও পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের জন্য প্রোডাক্ট স্ক্রিন থেকে প্রোডাক্ট-লেভেল মেট্রিক shopping_performance_view রিসোর্স কোয়েরি করে উদ্ধার করুন।

মনে রাখবেন: পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন সম্পর্কে রিপোর্ট করার সময়, ad_group ফিল্ড বেছে নেবেন না, কারণ ad_group রিসোর্স shopping_performance_view মেট্রিককে সেগমেন্ট করে এবং পারফর্ম্যান্স ম্যাক্স সারি বাদ দেয়। একাধিক ফিড জুড়ে অফারগুলি অস্পষ্ট করতে, segments.product_merchant_id, segments.product_channel, segments.product_language এবং segments.product_feed_label ফিল্ড যোগ করুন। প্রোডাক্টের বর্তমান যোগ্যতা, ডায়াগনস্টিক সমস্যা বা জিরো-ইম্প্রেশন ইনভেনটরি চেক করতে, shopping_product রিসোর্স কোয়েরি করুন (শপিং বিজ্ঞাপনের জন্য প্রোডাক্ট রিপোর্টিং দেখুন)।

GAQL

SELECT segments.product_item_id,
  segments.product_title,
  segments.product_brand,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.conversions
FROM shopping_performance_view
WHERE segments.date DURING LAST_7_DAYS

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT segments.product_item_id,
      segments.product_title,
      segments.product_brand,
      campaign.name,
      campaign.advertising_channel_type,
      metrics.clicks,
      metrics.impressions,
      metrics.ctr,
      metrics.average_cpc,
      metrics.cost_micros,
      metrics.conversions
    FROM shopping_performance_view
    WHERE segments.date DURING LAST_7_DAYS
  "
}
EOF

জিও কনস্ট্যান্ট খোঁজা

কোড ও ফর্ম্যাট পৃষ্ঠায় API-তে ব্যবহৃত বেশিরভাগ কনস্ট্যান্টের জন্য রেফারেন্স টেবিল দেওয়া আছে। তবে, আপনি Google Ads কোয়েরি ল্যাঙ্গুয়েজ ব্যবহার করে ডায়নামিক উপায়ে কিছু কনস্ট্যান্টও দেখতে পারেন।

এই স্যাম্পেল থেকে জানা যায় যে কীভাবে কোনও লোকেশন তার রিসোর্স নাম বা ডিসপ্লে নাম দিয়ে খুঁজতে হয়।

রিসোর্সের নাম অনুযায়ী

রিসোর্সের নাম geoTargetConstants/1014044 দিয়ে Mountain View, CA খুঁজুন।

GAQL

SELECT geo_target_constant.canonical_name,
  geo_target_constant.country_code,
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.status,
  geo_target_constant.target_type
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT geo_target_constant.canonical_name,
      geo_target_constant.country_code,
      geo_target_constant.id,
      geo_target_constant.name,
      geo_target_constant.status,
      geo_target_constant.target_type
    FROM geo_target_constant
    WHERE geo_target_constant.resource_name = 'geoTargetConstants/1014044'
  "
}
EOF

যে নাম দেখানো হবে তার ভিত্তিতে

মার্কিন যুক্তরাষ্ট্রের একটি শহরের নাম হিসেবে "Mountain View" খুঁজুন।

মনে রাখবেন: নাম দিয়ে লোকেশন কোয়েরি করলে, আপনি সম্ভবত একাধিক মিল পাবেন। geo_target_constant.country_code, geo_target_constant.target_type, এবং geo_target_constant.status দ্বারা ফিল্টার করুন এবং আপনার ক্লায়েন্ট কোডে ফলাফল তালিকা দ্ব্যর্থহীন করতে geo_target_constant.canonical_name পরীক্ষা করুন।

GAQL

SELECT geo_target_constant.canonical_name,
  geo_target_constant.country_code,
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.status,
  geo_target_constant.target_type
FROM geo_target_constant
WHERE geo_target_constant.country_code = 'US'
  AND geo_target_constant.target_type = 'City'
  AND geo_target_constant.name = 'Mountain View'
  AND geo_target_constant.status = 'ENABLED'

কার্ল

curl --compressed --fail-with-body --request POST \
  "https://googleads.googleapis.com/v${API_VERSION}/customers/${CUSTOMER_ID}/googleAds:searchStream" \
  --header "Content-Type: application/json" \
  --header "login-customer-id: ${MANAGER_CUSTOMER_ID}" \
  --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \
  --data @- <<'EOF'
{
  "query": "
    SELECT geo_target_constant.canonical_name,
      geo_target_constant.country_code,
      geo_target_constant.id,
      geo_target_constant.name,
      geo_target_constant.status,
      geo_target_constant.target_type
    FROM geo_target_constant
    WHERE geo_target_constant.country_code = 'US'
      AND geo_target_constant.target_type = 'City'
      AND geo_target_constant.name = 'Mountain View'
      AND geo_target_constant.status = 'ENABLED'
  "
}
EOF