DoubleClick-Kampagnen-Service

DoubleClick Campaign Manager- und DoubleClick Digital Marketing-Berichte aus Apps Script

Mit dem DoubleClick Campaigns-Dienst können Sie die DCM/DFA Reporting and Trafficking API in Google Apps Script verwenden. Diese API bietet programmatischen Zugriff auf DoubleClick Campaign Manager (DCM) und DoubleClick Digital Marketing (DDM) Reporting.

Dies ist ein erweiterter Dienst, der vor der Verwendung aktiviert werden muss werden.

Referenz

Ausführliche Informationen zu diesem Dienst finden Sie in der Referenzdokumentation zur DCM/DFA Reporting and Trafficking API. Wie alle erweiterten Dienste in Apps Script verwendet der DoubleClick Campaigns-Dienst dieselben Objekte, Methoden und Parameter wie die öffentliche API. Weitere Informationen finden Sie unter Bestimmen von Methodensignaturen.

Informationen zum Melden von Problemen und zu Supportoptionen finden Sie im DCM/DFA Reporting and Trafficking-Supportleitfaden.

Beispielcode

Im folgenden Beispielcode wird Version 4 der API verwendet.

Liste der Nutzerprofile abrufen

In diesem Beispiel werden alle im Konto verfügbaren Nutzerprofile protokolliert.

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

Liste der aktiven Kampagnen abrufen

In diesem Beispiel werden Namen und IDs aller aktiven Kampagnen protokolliert. Beachten Sie die Verwendung von Paging-Tokens, um die vollständige Liste abzurufen.

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

Neuen Werbetreibenden und neue Kampagne erstellen

In diesem Beispiel wird ein neuer Werbetreibender erstellt und mit diesem Werbetreibenden eine neue Kampagne erstellt. Die Kampagne ist auf einen Monat festgelegt.

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