DoubleClick বিড ম্যানেজার পরিষেবা

DoubleClick Bid Manager পরিষেবা ব্যবহার করে Apps স্ক্রিপ্ট।

DoubleClick Bid Manager পরিষেবা আপনাকে Google Apps Script-এ DV360 Bid Manager API ব্যবহার করতে দেয়। এই API DoubleClick Bid Manager (DBM) রিপোর্টিং-এ প্রোগ্রাম্যাটিক অ্যাক্সেস প্রদান করে।

এটি একটি উন্নত পরিষেবা যা ব্যবহারের আগে সক্রিয় করতে হবে।

তথ্যসূত্র

এই পরিষেবা সম্পর্কে বিস্তারিত তথ্যের জন্য, DBM রিপোর্টিং API-এর রেফারেন্স ডকুমেন্টেশন দেখুন। অ্যাপস স্ক্রিপ্টের সমস্ত উন্নত পরিষেবার মতো, DoubleClick Bid Manager পরিষেবাটি পাবলিক API-এর মতো একই বস্তু, পদ্ধতি এবং পরামিতি ব্যবহার করে। আরও তথ্যের জন্য, পদ্ধতি স্বাক্ষর কীভাবে নির্ধারণ করা হয় তা দেখুন।

সমস্যাগুলি রিপোর্ট করতে এবং অন্যান্য সহায়তা পেতে, DBM রিপোর্টিং এবং ট্র্যাফিকিং সহায়তা নির্দেশিকা দেখুন।

নমুনা কোড

নিম্নলিখিত নমুনা কোডটি API এর সংস্করণ 2 ব্যবহার করে।

প্রশ্নের একটি তালিকা পান

এই নমুনাটি অ্যাকাউন্টে উপলব্ধ সমস্ত প্রশ্নের লগ করে।

অ্যাডভান্সড/ডাবলক্লিকবিডম্যানেজার.জিএস
/**
 * 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 কোয়েরি তৈরি করে এবং চালায়।

অ্যাডভান্সড/ডাবলক্লিকবিডম্যানেজার.জিএস
/**
 * 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 কোয়েরির জন্য সাম্প্রতিকতম প্রতিবেদনটি সংগ্রহ করে এবং বিষয়বস্তু লগ করে।

অ্যাডভান্সড/ডাবলক্লিকবিডম্যানেজার.জিএস
/**
 * 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);
  }
}