บริการแคมเปญ DoubleClick

บริการแคมเปญ DoubleClick ช่วยให้คุณสามารถใช้ API การรายงานและการดูแลการแสดงโฆษณา DCM/DFA ใน Apps Script ได้ API นี้ให้สิทธิ์เข้าถึง DoubleClick Campaign Manager (DCM) และการรายงานการตลาดดิจิทัล DoubleClick (DDM) แบบเป็นโปรแกรม

หมายเหตุ: นี่เป็นบริการขั้นสูงที่ต้องเปิดใช้ก่อนใช้งาน

ข้อมูลอ้างอิง

หากต้องการข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ โปรดดูเอกสารอ้างอิงสำหรับ API การรายงานและการดูแลการแสดงโฆษณา DCM/DFA เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script บริการแคมเปญ DoubleClick จะใช้ออบเจ็กต์ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อวิธีกำหนดลายเซ็นของเมธอด

หากต้องการรายงานปัญหาและค้นหาการสนับสนุนอื่นๆ โปรดดูคู่มือการสนับสนุนการรายงานและการดูแลการแสดงโฆษณา DCM

รหัสตัวอย่าง

โค้ดตัวอย่างด้านล่างใช้ API เวอร์ชัน 3.3

ดูรายการโปรไฟล์ผู้ใช้

ตัวอย่างนี้จะบันทึกโปรไฟล์ผู้ใช้ทั้งหมดที่มีในบัญชี

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

สร้างผู้ลงโฆษณาและแคมเปญใหม่

ตัวอย่างนี้สร้างผู้ลงโฆษณารายใหม่ และสร้างแคมเปญใหม่กับผู้ลงโฆษณานั้น แคมเปญนี้มีการตั้งค่าให้ใช้งานได้เป็นเวลา 1 เดือน

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