خدمة حملات DoubleClick

‫DoubleClick Campaign Manager وDoubleClick Digital Marketing Reporting من Apps Script

تتيح لك خدمة "حملات DoubleClick" استخدام DCM/DFA Reporting and Trafficking API في Google Apps Script. توفّر واجهة برمجة التطبيقات هذه إمكانية الوصول الآلي إلى تقارير DoubleClick Campaign Manager‏ (DCM) وDoubleClick Digital Marketing‏ (DDM).

هذه خدمة متقدّمة يجب تفعيلها قبل الاستخدام.

مراجع

للحصول على معلومات تفصيلية عن هذه الخدمة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بـ DCM/DFA Reporting and Trafficking API. مثل جميع الخدمات المتقدّمة في Apps Script، تستخدم خدمة "الحملات" من DoubleClick العناصر والطرق والمعلَمات نفسها التي تستخدمها واجهة برمجة التطبيقات العامة. لمزيد من المعلومات، اطّلِع على كيفية تحديد التواقيع.

للإبلاغ عن المشاكل والعثور على دعم آخر، يُرجى الاطّلاع على دليل دعم "إعداد التقارير" و"إدارة الحملات" في "إدارة الحملات على DoubleClick" و"إدارة الإعلانات على DoubleClick".

نموذج التعليمات البرمجية

يستخدم نموذج الرمز التالي الإصدار 4 من واجهة برمجة التطبيقات.

الحصول على قائمة بملفات المستخدمين

تسجّل هذه العيّنة جميع الملفات الشخصية للمستخدمين المتاحة في الحساب.

advanced/doubleclick.gs

عرض على GitHub

/**
 * 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);
  }
}

الحصول على قائمة بالحملات النشطة

تسجّل هذه العيّنة أسماء جميع الحملات النشطة ومعرّفاتها. يُرجى العِلم أنّه يتم استخدام رموز مميّزة خاصة بتقسيم المحتوى إلى صفحات لاسترداد القائمة بأكملها.

advanced/doubleclick.gs

عرض على GitHub

/**
 * 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);
  }
}

إنشاء معلِن وحملة جديدَين

ينشئ هذا النموذج معلِنًا جديدًا، وينشئ حملة جديدة باستخدام هذا المعلِن. تمّ ضبط الحملة لتستمرّ لمدة شهر واحد.

advanced/doubleclick.gs

عرض على GitHub

/**
 * 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);
  }
}