DoubleClick Bid Manager Service

اسکریپت برنامه‌ها با استفاده از سرویس DoubleClick Bid Manager.

سرویس DoubleClick Bid Manager به شما امکان می‌دهد از API مدیریت پیشنهاد DV360 در Google Apps Script استفاده کنید. این API دسترسی برنامه‌نویسی‌شده به گزارش‌گیری DoubleClick Bid Manager (DBM) را فراهم می‌کند.

این یک سرویس پیشرفته است که قبل از استفاده باید فعال شود.

مرجع

برای اطلاعات دقیق در مورد این سرویس، به مستندات مرجع API گزارش‌دهی DBM مراجعه کنید. مانند تمام سرویس‌های پیشرفته در Apps Script، سرویس DoubleClick Bid Manager از همان اشیاء، روش‌ها و پارامترهای API عمومی استفاده می‌کند. برای اطلاعات بیشتر، به بخش «نحوه تعیین امضاهای روش» مراجعه کنید.

برای گزارش مشکلات و یافتن سایر پشتیبانی‌ها، به راهنمای پشتیبانی گزارش‌دهی و قاچاق DBM مراجعه کنید.

کد نمونه

کد نمونه زیر از نسخه ۲ این API استفاده می‌کند.

دریافت لیست سوالات

این نمونه، تمام کوئری‌های موجود در حساب را ثبت می‌کند.

advanced/doubleclickbidmanager.gs
/**
 * Logs all of the queries available in the account.
 */
function listQueries() {
  // Retrieve the list of available queries
  try {
    const queries = DoubleClickBidManager.Queries.list();

    if (queries.queries) {
      // Print out the ID and name of each
      for (let i = 0; i < queries.queries.length; i++) {
        const query = queries.queries[i];
        console.log(
          'Found query with ID %s and name "%s".',
          query.queryId,
          query.metadata.title,
        );
      }
    }
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log("Failed with error: %s", e.error);
  }
}

ایجاد و اجرای یک پرس و جو

این نمونه یک پرس‌وجوی DBM جدید ایجاد و اجرا می‌کند.

advanced/doubleclickbidmanager.gs
/**
 * Create and run a new DBM Query
 */
function createAndRunQuery() {
  let result;
  let execution;
  //We leave the default date range blank for the report run to
  //use the value defined during query creation
  const defaultDateRange = {};
  const partnerId = "1234567"; //Replace with your Partner ID
  const query = {
    metadata: {
      title: "Apps Script Example Report",
      dataRange: {
        range: "YEAR_TO_DATE",
      },
      format: "CSV",
    },
    params: {
      type: "STANDARD",
      groupBys: [
        "FILTER_PARTNER",
        "FILTER_PARTNER_NAME",
        "FILTER_ADVERTISER",
        "FILTER_ADVERTISER_NAME",
      ],
      filters: [{ type: "FILTER_PARTNER", value: partnerId }],
      metrics: ["METRIC_IMPRESSIONS"],
    },
    schedule: {
      frequency: "ONE_TIME",
    },
  };

  try {
    result = DoubleClickBidManager.Queries.create(query);
    if (result.queryId) {
      console.log(
        'Created query with ID %s and name "%s".',
        result.queryId,
        result.metadata.title,
      );
      execution = DoubleClickBidManager.Queries.run(
        defaultDateRange,
        result.queryId,
      );
      if (execution.key) {
        console.log(
          'Created query report with query ID %s and report ID "%s".',
          execution.key.queryId,
          execution.key.reportId,
        );
      }
    }
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log(e);
    console.log("Failed with error: %s", e.error);
  }
}

آخرین گزارش مربوط به یک پرس و جوی DBM را دریافت کنید

این نمونه جدیدترین گزارش را برای یک پرس‌وجوی DBM دریافت کرده و محتوا را ثبت می‌کند.

advanced/doubleclickbidmanager.gs
/**
 * Fetches a report file
 */
function fetchReport() {
  const queryId = "1234567"; // Replace with your query ID.
  const orderBy = "key.reportId desc";

  try {
    const report = DoubleClickBidManager.Queries.Reports.list(queryId, {
      orderBy: orderBy,
    });
    if (report.reports) {
      const firstReport = report.reports[0];
      if (firstReport.metadata.status.state === "DONE") {
        const reportFile = UrlFetchApp.fetch(
          firstReport.metadata.googleCloudStoragePath,
        );
        console.log("Printing report content to log...");
        console.log(reportFile.getContentText());
      } else {
        console.log(
          "Report status is %s, and is not available for download",
          firstReport.metadata.status.state,
        );
      }
    }
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log(e);
    console.log("Failed with error: %s", e.error);
  }
}