Usługa Kampanie DoubleClick

Usługa DoubleClick Campaigns umożliwia korzystanie z interfejsu DCM/DFA Reporting and Trafficking API w Apps Script. Ten interfejs API zapewnia programowy dostęp do raportowania w DoubleClick Campaign Managerze (DCM) i DoubleClick Digital Marketingu (DDM).

Dokumentacja

Szczegółowe informacje o tej usłudze znajdziesz w dokumentacji referencyjnej interfejsu DCM/DFA Reporting and Trafficking API. Podobnie jak wszystkie zaawansowane usługi w Apps Script, usługa DoubleClick Campaigns używa tych samych obiektów, metod i parametrów co publiczny interfejs API. Więcej informacji znajdziesz w artykule Jak określane są sygnatury metod.

Aby zgłaszać problemy i uzyskać pomoc, zapoznaj się z przewodnikiem pomocy dotyczącym raportowania i zarządzania ruchem w DCM/DFA.

Przykładowy kod

Poniższy przykładowy kod korzysta z wersji 4 interfejsu API.

Pobieranie listy profili użytkowników

Ten przykładowy kod rejestruje wszystkie profile użytkowników dostępne na koncie.

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

Pobieranie listy aktywnych kampanii

Ten przykładowy kod rejestruje nazwy i identyfikatory wszystkich aktywnych kampanii. Zwróć uwagę na użycie tokenów stronicowania do pobrania całej listy.

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

Tworzenie nowego reklamodawcy i nowej kampanii

Ten przykład tworzy nowego reklamodawcę i nową kampanię powiązaną z tym reklamodawcą. Kampania ma trwać miesiąc.

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