DoubleClick Kampanyalar Hizmeti

DoubleClick Campaigns hizmeti, Apps Komut Dosyası'nda DCM/DFA Raporlama ve Trafik İşlemleri API'sini kullanmanıza olanak tanır. Bu API, DoubleClick Campaign Manager (DCM) ve DoubleClick Digital Marketing (DDM) Raporlama'ya programatik erişim sağlar.

Not: Bu, kullanımdan önce etkinleştirilmesi gereken ileri düzey bir hizmettir.

Referans

Bu hizmetle ilgili ayrıntılı bilgi için DCM/DFA Raporlama ve Trafik İşlemleri API'sinin referans belgelerine bakın. Apps Komut Dosyası'ndaki tüm gelişmiş hizmetler gibi DoubleClick Campaigns hizmeti de herkese açık API ile aynı nesneleri, yöntemleri ve parametreleri kullanır. Daha fazla bilgi için Yöntem imzaları nasıl belirlenir? başlıklı makaleyi inceleyin.

Sorunları bildirmek ve diğer destek seçeneklerini öğrenmek için DCM/DFA Raporlama ve Trafik İşlemleri Destek Kılavuzu'na bakın.

Örnek kod

Aşağıdaki örnek kodda API'nin 4. sürümü kullanılmaktadır.

Kullanıcı profillerinin listesini alma

Bu örnek, hesaptaki tüm kullanıcı profillerini günlüğe kaydeder.

advanced/doubleclick.gs

GitHub'da göster

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

Etkin kampanyaların listesini alma

Bu örnek, etkin tüm kampanyaların adlarını ve kimliklerini günlüğe kaydeder. Listenin tamamını almak için sayfalama jetonlarının kullanıldığını unutmayın.

advanced/doubleclick.gs

GitHub'da göster

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

Yeni bir reklamveren ve kampanya oluşturma

Bu örnekte yeni bir reklamveren ve bu reklamvereni içeren yeni bir kampanya oluşturulur. Kampanya bir ay sürecek şekilde ayarlanmıştır.

advanced/doubleclick.gs

GitHub'da göster

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