DoubleClick প্রচারাভিযান পরিষেবা

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

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

রেফারেন্স

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

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

নমুনা কোড

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

ব্যবহারকারীদের প্রোফাইলের একটি তালিকা পান

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

অ্যাডভান্সড/ডাবলক্লিক.জিএস
/**
 * Logs all of the user profiles available in the account.
 */
function listUserProfiles() {
  // Retrieve the list of available user profiles
  try {
    const profiles = DoubleClickCampaigns.UserProfiles.list();

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

সক্রিয় ক্যাম্পেইনগুলোর একটি তালিকা পান

এই নমুনাটি সমস্ত সক্রিয় ক্যাম্পেইনের নাম এবং আইডি লগ করে। সম্পূর্ণ তালিকাটি পুনরুদ্ধার করতে পেজিং টোকেনের ব্যবহার লক্ষ্য করুন।

অ্যাডভান্সড/ডাবলক্লিক.জিএস
/**
 * Logs names and ID's of all active campaigns.
 * Note the use of paging tokens to retrieve the whole list.
 */
function listActiveCampaigns() {
  const profileId = "1234567"; // Replace with your profile ID.
  const fields = "nextPageToken,campaigns(id,name)";
  let result;
  let pageToken;
  try {
    do {
      result = DoubleClickCampaigns.Campaigns.list(profileId, {
        archived: false,
        fields: fields,
        pageToken: pageToken,
      });
      if (result.campaigns) {
        for (let i = 0; i < result.campaigns.length; i++) {
          const campaign = result.campaigns[i];
          console.log(
            'Found campaign with ID %s and name "%s".',
            campaign.id,
            campaign.name,
          );
        }
      }
      pageToken = result.nextPageToken;
    } while (pageToken);
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log("Failed with error: %s", e.error);
  }
}

একটি নতুন বিজ্ঞাপনদাতা এবং প্রচারাভিযান তৈরি করুন

এই নমুনাটি একজন নতুন বিজ্ঞাপনদাতা তৈরি করে এবং সেই বিজ্ঞাপনদাতার সাথে একটি নতুন ক্যাম্পেইন তৈরি করে। ক্যাম্পেইনটি এক মাস স্থায়ী হবে বলে সেট করা হয়েছে।

অ্যাডভান্সড/ডাবলক্লিক.জিএস
/**
 * Creates a new advertiser, and creates a new campaign with that advertiser.
 * The campaign is set to last for one month.
 */
function createAdvertiserAndCampaign() {
  const profileId = "1234567"; // Replace with your profile ID.

  const advertiser = {
    name: "Example Advertiser",
    status: "APPROVED",
  };

  try {
    const advertiserId = DoubleClickCampaigns.Advertisers.insert(
      advertiser,
      profileId,
    ).id;

    const landingPage = {
      advertiserId: advertiserId,
      archived: false,
      name: "Example landing page",
      url: "https://www.google.com",
    };
    const landingPageId = DoubleClickCampaigns.AdvertiserLandingPages.insert(
      landingPage,
      profileId,
    ).id;

    const campaignStart = new Date();
    // End campaign after 1 month.
    const campaignEnd = new Date();
    campaignEnd.setMonth(campaignEnd.getMonth() + 1);

    const campaign = {
      advertiserId: advertiserId,
      defaultLandingPageId: landingPageId,
      name: "Example campaign",
      startDate: Utilities.formatDate(campaignStart, "GMT", "yyyy-MM-dd"),
      endDate: Utilities.formatDate(campaignEnd, "GMT", "yyyy-MM-dd"),
    };
    DoubleClickCampaigns.Campaigns.insert(campaign, profileId);
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log("Failed with error: %s", e.error);
  }
}