DoubleClick 廣告活動服務

您可以在 Apps Script 中使用 DoubleClick Campaigns 服務的 DCM/DFA Reporting and Trafficking API。這個 API 可讓您透過程式輔助的方式，存取 DoubleClick Campaign Manager (DCM) 和 DoubleClick Digital Marketing (DDM) 報表。

參考資料

如要進一步瞭解這項服務，請參閱 DCM/DFA Reporting and Trafficking API 的參考說明文件。與 Apps Script 中的所有進階服務一樣，DoubleClick Campaigns 服務使用的物件、方法和參數，都與公開 API 相同。詳情請參閱「如何判斷方法簽章」。

如要回報問題及尋求其他支援，請參閱 DCM/DFA Reporting and Trafficking 支援指南。

程式碼範例

下列程式碼範例使用 API 的第 4 版。

取得使用者設定檔清單

這個範例會記錄帳戶中所有可用的使用者設定檔。

advanced/doubleclick.gs
/**  * 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);   } }

取得有效廣告活動清單

這個範例會記錄所有有效廣告活動的名稱和 ID。請注意，使用分頁符記可擷取完整清單。

advanced/doubleclick.gs
/**  * 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
/**  * 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);   } }