API อัลฟ่าของรายงานกิจกรรมโฆษณา

รายงานกิจกรรมโฆษณาคือ มุมมองส่วนกลางสำหรับประสิทธิภาพโฆษณา โดยจะรวบรวมข้อมูล เมตริก และ จาก API รายงานเครือข่ายและ API รายงานสื่อกลาง รวมถึง ข้อมูลการเสนอราคาลงในรายงานแบบรวมฉบับเดียว

API รายงานกิจกรรมโฆษณามีการปรับปรุงเพิ่มเติมจากสื่อกลาง Report API และ Network Report API ดังที่แสดงในตารางด้านล่าง

API รายงานเครือข่าย API รายงานสื่อกลาง API รายงานกิจกรรมของโฆษณา
ประสิทธิภาพของเครือข่าย ✅ ✅ ✅
ประสิทธิภาพของ Waterfall ✅ ✅
ประสิทธิภาพของการเสนอราคา ✅
ประสิทธิภาพของการทดสอบ A/B สำหรับสื่อกลาง ✅
การรายงานรายชั่วโมง ✅
ขนาดรายงาน 1 แสน 1 แสน 5 แสน

ตัวกรองเมตริก มิติข้อมูล และมิติข้อมูล

มีการเพิ่มเมตริกต่อไปนี้ใน API รายงานกิจกรรมโฆษณาใน นอกเหนือจากเมตริกจำนวนมากที่มีอยู่ใน Network Report API และ API รายงานสื่อกลาง

เมตริก คำอธิบาย
BID_REQUEST จํานวนคําขอที่ส่งไปยังแหล่งที่มาของโฆษณาซึ่งใช้การเสนอราคา
BIDS_IN_AUCTION จำนวนราคาเสนอที่ส่งจากแหล่งที่มาของโฆษณาที่เข้าร่วมการประมูลเสนอราคา
WINNING_BIDS จำนวนราคาเสนอที่ชนะการประมูลเสนอราคา

มิติข้อมูลใหม่ต่อไปนี้จะรวมอยู่ใน API รายงานกิจกรรมโฆษณา

มิติข้อมูล คำอธิบาย
สัปดาห์ วันที่ของวันแรกของสัปดาห์ (ตามภาษา ที่ระบุในการตั้งค่าการแปล) ในรูปแบบ ปปปปดดวว (สำหรับ เช่น "20210701") คำขอสามารถระบุวันที่ DATE, WEEK หรือ MONTH ได้เพียง 1 รายการเท่านั้น มิติข้อมูลเวลา
ชั่วโมง ชั่วโมงในรูปแบบ HH ในเวลา PST เช่น "05" เวลา 5.00 น. PST "13" เวลา 13:00 น. PST คุณต้องระบุมิติข้อมูล DATE ในคำขอด้วย ต ระบบจะส่งคืนข้อมูลได้สูงสุด 28 วันเมื่อระบุมิติข้อมูล HOUR วันที่เริ่มต้นของช่วงวันที่ที่มากกว่า 28 วันก่อนวันที่ปัจจุบัน แสดงข้อผิดพลาด
MEDIATION_AB_TEST (ชื่อการทดสอบ) ดูประสิทธิภาพตามการทดสอบ A/B สำหรับสื่อกลาง คุณต้องระบุข้อมูลนี้ หากระบุมิติข้อมูล VARIANT
MEDIATION_AB_TEST_VARIANT (ตัวแปร A, ตัวแปร B) ดูประสิทธิภาพตามตัวแปรการทดสอบ A/B สำหรับสื่อกลาง
ชื่อมิติข้อมูลใน API รายงานสื่อกลาง ชื่อมิติข้อมูลใน API รายงานกิจกรรมของโฆษณา คำอธิบาย
หน่วยโฆษณา1 AD_UNIT_ID รหัสที่ไม่ซ้ำกันของหน่วยโฆษณา (เช่น "123456789")
AD_UNIT_NAME ชื่อของหน่วยโฆษณา
แอป1 APP_ID รหัสที่ไม่ซ้ำกันของแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ (เช่น "1234567890")
APP_NAME ชื่อแอป
AD_SOURCE1 AD_SOURCE_ID รหัสที่ไม่ซ้ำกันของแหล่งที่มาของโฆษณา (เช่น "1234567890123456789"
AD_SOURCE_NAME ชื่อแหล่งที่มาของโฆษณา (เช่น "เครือข่าย AdMob")
AD_SOURCE_INSTANCE1 AD_SOURCE_INSTANCE_ID รหัสที่ไม่ซ้ำกันของอินสแตนซ์แหล่งที่มาของโฆษณา (เช่น "123456789012")
AD_SOURCE_INSTANCE_NAME ชื่ออินสแตนซ์แหล่งที่มาของโฆษณา (เช่น "AdMob (ค่าเริ่มต้น)")
กลุ่มสื่อ1 MEDIATION_GROUP_ID รหัสที่ไม่ซ้ำกันของกลุ่มสื่อกลาง (เช่น "1234567890")
MEDIATION_GROUP_NAME รหัสที่ไม่ซ้ำกันของกลุ่มสื่อกลาง (เช่น "AdMob (ค่าเริ่มต้น)")

1: ดูข้อมูลเพิ่มเติมที่ Scalars

มิติข้อมูลต่อไปนี้มีรูปแบบที่อัปเดต

ชื่อมิติข้อมูลใน API รายงานสื่อกลาง คำอธิบายใน API รายงานสื่อกลาง คำอธิบายใน API รายงานกิจกรรมโฆษณา
ESTIMATED_EARNINGS รายได้โดยประมาณของผู้เผยแพร่โฆษณา AdMob หน่วยสกุลเงิน (USD, ยูโร หรืออื่นๆ) ของเมตริกรายได้จะกำหนดโดยการแปล การตั้งค่าสำหรับสกุลเงิน จำนวนเงินเป็นไมโคร ตัวอย่างเช่น $6.50 จะเป็น แสดงเป็น 6500000

รายได้โดยประมาณต่อกลุ่มสื่อกลางและต่ออินสแตนซ์แหล่งที่มาของโฆษณาเท่ากับ ข้อมูลที่รองรับตั้งแต่วันที่ 20 ตุลาคม 2019 รายได้โดยประมาณของบุคคลที่สามจะ แสดง 0 สำหรับวันที่ก่อนวันที่ 20 ตุลาคม 2019

รายได้โดยประมาณของผู้เผยแพร่โฆษณา AdMob หน่วยสกุลเงิน (USD, ยูโร หรืออื่นๆ) ของเมตริกรายได้จะกำหนดโดยการแปล การตั้งค่าสำหรับสกุลเงิน
OBSERVED_ECPM eCPM เฉลี่ยโดยประมาณของเครือข่ายโฆษณาบุคคลที่สาม หน่วยสกุลเงิน (USD, EUR หรืออื่นๆ) ของเมตริกรายได้จะกำหนดโดยการแปล การตั้งค่าสำหรับสกุลเงิน จำนวนเงินเป็นไมโคร เช่น $2.30 จะเป็น แสดงเป็น 2300000

eCPM เฉลี่ยโดยประมาณต่อกลุ่มสื่อกลางและต่ออินสแตนซ์แหล่งที่มาของโฆษณา ใช้ได้ตั้งแต่วันที่ 20 ตุลาคม 2019 ค่าเฉลี่ยโดยประมาณของบุคคลที่สาม eCPM จะแสดงเป็น 0 สำหรับวันที่ก่อนวันที่ 20 ตุลาคม 2019

eCPM เฉลี่ยของโฆษณาทั้งหมด หน่วยสกุลเงิน (USD, EUR หรืออื่นๆ) ของ เมตริกรายได้จะกำหนดโดยการตั้งค่าการแปลสำหรับสกุลเงิน

eCPM เฉลี่ยต่อกลุ่มสื่อกลางและต่ออินสแตนซ์แหล่งที่มาของโฆษณาเท่ากับ ข้อมูลที่รองรับตั้งแต่วันที่ 20 ตุลาคม 2019 OBSERVED_ECPM จะแสดงเป็น 0 สำหรับวันที่ ก่อนวันที่ 20 ตุลาคม 2019

Scalars

มิติข้อมูลด้านล่างได้รับการอัปเดตใน 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 ในคำขอเพื่อเรียกข้อมูลรายชั่วโมงด้วย ส่งคืนข้อมูลได้สูงสุด 28 วันเมื่อมิติข้อมูล HOUR คือ ที่ระบุ วันที่เริ่มต้นของช่วงวันที่ที่มากกว่า 28 วันก่อนวันที่ วันที่ปัจจุบันแสดงผลข้อผิดพลาด

รายงานมีขนาดใหญ่ขึ้น

API รายงานกิจกรรมโฆษณาช่วยให้คุณดึงข้อมูลแถวได้ทั้งหมด 500,000 แถว สำหรับ โปรดดูข้อมูลเพิ่มเติมในคู่มือโควต้า

ส่งคำขอ

ทำตามขั้นตอนต่อไปนี้เพื่อส่งคำขอ

curl (บรรทัดคำสั่ง)

คำขอที่ใช้ curl

  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
      }
    }
  }
]}