สร้างคำถาม

ทรัพยากร Bid Manager API Query แสดงสิ่งที่คุณเห็นใน UI เป็น a จอแสดงผลและ รายงาน Video 360 เรียกใช้การค้นหานี้เพื่อสร้าง Report ทรัพยากร หากสําเร็จ ทรัพยากร Report จะระบุ URL ที่ คุณสามารถดาวน์โหลดรายงานที่ได้

หน้านี้จะอธิบายวิธีจัดโครงสร้างและสร้างทรัพยากร Query

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

ใน Query แต่ละรายการ ให้ระบุ Parameters ต่อไปนี้ใน ช่อง params เพื่อปรับแต่งข้อมูลที่แสดงในรายงาน

• filters จำกัดขอบเขตของข้อมูล ตัวกรองจะรับรายการ ของออบเจ็กต์ FilterPair รายการ โดยที่ type คือค่าแจกแจงตัวกรอง และ value คือสตริงการระบุ เช่น รหัสทรัพยากร
• groupBys กำหนดมิติข้อมูลสำหรับรายงาน แสดงด้วยรายการ enum ของตัวกรอง
• metrics กำหนดข้อมูลที่เติมในรายงาน แสดงด้วยรายการ enum ของเมตริก

ดูรายละเอียดเพิ่มเติมเกี่ยวกับโครงสร้าง Query ได้ที่ข้อมูลอ้างอิง เอกสารประกอบ

เคล็ดลับ: หากคุณกำลังสร้างรายงานใหม่ ให้ใช้คอลัมน์ดิสเพลย์และ UI ของวิดีโอ 360 ไปยัง สร้างโครงสร้างรายงาน ใน UI มีข้อจำกัดเกี่ยวกับตัวกรอง ระบบจะบังคับใช้ชุดค่าผสมมิติข้อมูลและเมตริกโดยอัตโนมัติ

เมื่อเลือกค่าเหล่านี้ ให้พิจารณา ReportType ที่ตั้งค่าในช่อง type เมตริกและตัวกรองที่คุณเลือก ค่าต้องเข้ากันได้กับประเภทรายงานสำหรับรายงาน จึงจะสร้างได้สำเร็จ

สร้างคำค้นหา

เมื่อคุณกำหนดโครงสร้างหลักของรายงานได้แล้ว คุณก็สร้าง Query ได้

วิธีสร้างรายงานเฉพาะกิจซึ่งประกอบด้วยข้อมูลจาก 7 วัน:

Java

// Display name of the query to create.
String displayName = display-name;

// The report type.
String reportType = report-type;

// The advertisers and campaigns by which to filter report data.
List<String> advertiserIdFilters =
    Arrays.asList(advertiser-id,...);
List<String> campaignIdFilters =
    Arrays.asList(campaign-id,...);

// The dimensions and metrics for the report.
List<String> dimensions = Arrays.asList(dimension,...);
List<String> metrics = Arrays.asList(metric,...);

// Build a list of filter pairs from given IDs.
List<FilterPair> filters = new ArrayList<FilterPair>();
if (advertiserIdFilters != null) {
  for (String advertiserId : advertiserIdFilters) {
    filters.add(
        new FilterPair().setType("FILTER_ADVERTISER").setValue(advertiserId));
  }
}
if (campaignIdFilters != null) {
  for (String campaignId : campaignIdFilters) {
    filters.add(
        new FilterPair().setType("FILTER_MEDIA_PLAN").setValue(campaignId));
  }
}

// Create the query structure.
Query query = new Query();

// Build and set the metadata object.
QueryMetadata metadata = new QueryMetadata();
metadata.setTitle(displayName);
metadata.setDataRange(new DataRange().setRange("LAST_7_DAYS"));
metadata.setFormat("CSV");
query.setMetadata(metadata);

// Build the parameters object.
Parameters parameters = new Parameters();
parameters.setType(reportType);
parameters.setGroupBys(dimensions);
parameters.setFilters(filters);
parameters.setMetrics(metrics);

// Set parameters object in query.
query.setParams(parameters);

// Build and set the schedule object.
QuerySchedule schedule = new QuerySchedule();
schedule.setFrequency("ONE_TIME");
query.setSchedule(schedule);

// Create the query.
Query queryResponse = service.queries().create(query).execute();

// Log query creation.
System.out.printf("Query %s was created.%n", queryResponse.getQueryId());

Python

# Display name of the query to create.
display_name = display-name

# The report type.
report_type = report-type

# The advertisers and campaigns by which to filter report data.
filtered_advertiser_ids = [advertiser-id,...]
filtered_campaign_ids = [campaign-id,...]

# The dimensions and metrics for the report.
dimensions = [dimension,...]
metrics = [metric,...]

# Build list of FilterPair objects.
filters = []
if filtered_campaign_ids != None:
  filters.extend([
    {"type": "FILTER_MEDIA_PLAN", "value": id}
    for id in filtered_campaign_ids
  ])
if filtered_advertiser_ids != None:
  filters.extend([
    {"type": "FILTER_ADVERTISER", "value": id}
    for id in filtered_advertiser_ids
  ])

# Build query object.
query_obj = {
  "metadata": {
    "title": display_name,
    "dataRange": {"range": "LAST_7_DAYS"},
    "format": "CSV",
  },
  "params": {
    "type": report_type,
    "groupBys": dimensions,
    "filters": filters,
    "metrics": metrics,
  },
  "schedule": {"frequency": "ONE_TIME"}
}

# Create query object.
query_response = service.queries().create(body=query_obj).execute()

# Print new query ID.
print(f'Query {query_response["queryId"]} was created.')

PHP

// Display name of the query to create.
$displayName = display-name;

// The report type.
$reportType = report-type;

  // Advertiser ID and campaign ID by which to filter data.
$advertiserIdFilters = array(advertiser-id,...);
$campaignIdFilters = array(campaign-id,...);

// The dimensions and metrics for the report.
$dimensions = array(dimension,...);
$metrics = array(metric,...);

// Build a list of filter pairs from given IDs.
$filters = array();
foreach ($advertiserIdFilters as $advertiserId) {
    $filterPair = new Google_Service_DoubleClickBidManager_FilterPair();
    $filterPair->setType("FILTER_ADVERTISER");
    $filterPair->setValue($advertiserId);
    array_push($filters, $filterPair);
}
foreach ($campaignIdFilters as $campaignId) {
    $filterPair = new Google_Service_DoubleClickBidManager_FilterPair();
    $filterPair->setType("FILTER_MEDIA_PLAN");
    $filterPair->setValue($campaignId);
    array_push($filters, $filterPair);
}

  // Create the query structure.
$query = new Google_Service_DoubleClickBidManager_Query();

  // Build and set the metadata object.
$metadata = new Google_Service_DoubleClickBidManager_QueryMetadata();
$metadata->setTitle($displayName);
$metadata->setFormat("CSV");

$dataRange = new Google_Service_DoubleClickBidManager_DataRange();
$dataRange->setRange("LAST_7_DAYS");
$metadata->setDataRange($dataRange);

$query->setMetadata($metadata);

  // Build and set the parameters object.
$parameters = new Google_Service_DoubleClickBidManager_Parameters();
$parameters->setType($reportType);
$parameters->setGroupBys($dimensions);
$parameters->setFilters($filters);
$parameters->setMetrics($metrics);
$query->setParams($parameters);

  // Build and set the schedule object.
$schedule = new Google_Service_DoubleClickBidManager_QuerySchedule();
$schedule->setFrequency("ONE_TIME");
$query->setSchedule($schedule);

// Call the API, creating the query.
$queryResult = $this->service->queries->create($query);

printf('Query %s was created.<br>', $queryResult->getQueryId());