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

ডাবলক্লিক বিড ম্যানেজার পরিষেবা ব্যবহার করে অ্যাপস স্ক্রিপ্ট।

ডাবলক্লিক বিড ম্যানেজার পরিষেবা আপনাকে গুগল অ্যাপস স্ক্রিপ্টে ডিভি৩৬০ বিড ম্যানেজার এপিআই ব্যবহার করার সুযোগ দেয়। এই এপিআই ডাবলক্লিক বিড ম্যানেজার (ডিবিএম) রিপোর্টিং-এ প্রোগ্রাম্যাটিক অ্যাক্সেস প্রদান করে।

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

রেফারেন্স

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

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

নমুনা কোড

নিম্নলিখিত নমুনা কোডটিতে 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);
  }
}