Genel Trafik İşlemleri

Bu sayfada, DCM/DFA Raporlaması ve Trafficking API kullanılarak en yaygın trafik işlemleri görevlerinden bazılarının nasıl yapılacağı açıklanmıştır.

Kodlamayla ilgili genel ipuçları

  • Zorunlu ve isteğe bağlı özellikler ile parametreler: API çağrısı için bir özelliğin veya parametrenin gerekli olup olmadığını öğrenmek üzere referans belgelerine bakın.
  • Joker karakterle ad aramaları: Nesne adlarını ararken yıldız işareti (*) joker karakterini kullanabilirsiniz. Yıldız işareti, herhangi bir karakterin sıfır veya daha fazla tekrarıyla eşleşir. API, örtülü bir alt dize aramasını da destekler. Dolayısıyla "abc" araması, dolaylı olarak "*abc*" araması yapar.
  • Güncelleme ve yama uygulama: Mevcut bir nesneyi değiştirmek için iki seçeneğiniz vardır:
    1. Güncelleniyor: Bir nesne güncellenirken ekleme sırasında tüm alanların üzerine yazılır. Güncellemek istediğiniz nesneyi yüklemeniz ve bu nesnede değişiklik yapmanız önemlidir. Aksi takdirde, güncelleme isteğinde bulunmayan alanlar ayarlanmadan bırakılır.
    2. Yama: Yama uygulanırken ekleme sırasında yalnızca belirtilen alanların üzerine yazılır. Bu durumda, yeni bir nesne oluşturabilir, güncellenecek nesneyle aynı kimliği atayabilir, alanları güncellenecek ve yama isteğini yürütebilirsiniz.
  • Boyutlar: Fiziksel boyutlar, boyutlar hizmeti tarafından tanımlanan bir Size nesnesiyle temsil edilir. Hesap bir dizi standart boyut sağlar ve bu listeye kendi özel boyutlarınızı ekleyebilirsiniz.
  • Tarihler ve saatler: Tarihleri/saatleri yerel saat dilimlerini kullanarak RFC 3339 biçiminde kaydedebilirsiniz; API tarafından döndürülen tüm değerler UTC saat dilimindedir. Bu saat dilimi, yapılandırdığınız saat diliminde (varsayılan olarak Amerika/New York saati) tarih ve saatlerin gösterildiği web sitesinden farklıdır.

Reklamveren oluşturma

C#

  1. Bir Advertiser nesnesi oluşturun ve nesnenin gerekli name ile status özelliklerini ayarlayın.
    // Create the advertiser structure.
    Advertiser advertiser = new Advertiser();
    advertiser.Name = advertiserName;
    advertiser.Status = "APPROVED";
    
  2. Reklamvereni kaydetmek için advertisers.insert() yöntemini çağırın.
    // Create the advertiser.
    Advertiser result = service.Advertisers.Insert(advertiser, profileId).Execute();
    

Java

  1. Bir Advertiser nesnesi oluşturun ve nesnenin gerekli name ile status özelliklerini ayarlayın.
    // Create the advertiser structure.
    Advertiser advertiser = new Advertiser();
    advertiser.setName(advertiserName);
    advertiser.setStatus("APPROVED");
    
  2. Reklamvereni kaydetmek için advertisers.insert() yöntemini çağırın.
    // Create the advertiser.
    Advertiser result = reporting.advertisers().insert(profileId, advertiser).execute();
    

PHP

  1. Bir Advertiser nesnesi oluşturun ve nesnenin gerekli name ile status özelliklerini ayarlayın.
    $advertiser = new Google_Service_Dfareporting_Advertiser();
    $advertiser->setName($values['advertiser_name']);
    $advertiser->setStatus('APPROVED');
    
  2. Reklamvereni kaydetmek için advertisers.insert() yöntemini çağırın.
    $result = $this->service->advertisers->insert(
        $values['user_profile_id'],
        $advertiser
    );
    

Python

  1. Bir Advertiser nesnesi oluşturun ve nesnenin gerekli name ile status özelliklerini ayarlayın.
    # Construct and save advertiser.
    advertiser = {
        'name': 'Test Advertiser',
        'status': 'APPROVED'
    }
    
  2. Reklamvereni kaydetmek için advertisers.insert() yöntemini çağırın.
    request = service.advertisers().insert(
        profileId=profile_id, body=advertiser)
    
    # Execute request and print response.
    response = request.execute()
    

Ruby

  1. Bir Advertiser nesnesi oluşturun ve nesnenin gerekli name ile status özelliklerini ayarlayın.
    # Create a new advertiser resource to insert.
    advertiser = DfareportingUtils::API_NAMESPACE::Advertiser.new(
      name: format('Example Advertiser #%s', SecureRandom.hex(3)),
      status: 'APPROVED'
    )
    
  2. Reklamvereni kaydetmek için advertisers.insert() yöntemini çağırın.
    # Insert the advertiser.
    result = service.insert_advertiser(profile_id, advertiser)
    

Kampanya oluşturma

C#

  1. Bir Campaign nesnesi oluşturun ve gerekli özelliklerini ayarlayın:

    • advertiserId - Bu kampanyanın ilişkilendirileceği reklamveren.
    • name - Bu değer, bu reklamverene ait tüm kampanyalarda benzersiz olmalıdır.
    • defaultLandingPageId - Bu kampanyadaki bir reklama atanmamış kullanıcıların, bu kampanyadaki bir reklamı tıkladıklarında yönlendirileceği açılış sayfası. advertiserLandingPages.list numaralı telefonu arayarak mevcut açılış sayfalarını arayabilir veya advertiserLandingPages.insert numaralı telefonu arayarak yeni bir açılış sayfası oluşturabilirsiniz.
    • Başlangıç ve bitiş tarihleri: Bunlar gelecekte olmalıdır ve güne kadar doğru olabilir. Daha fazla bilgi için Genel kodlama bilgileri başlıklı makaledeki tarihler ve saatler madde işaretini inceleyin. Belirli bir kampanya bitiş tarihine kadar doldurulmamışsa reklam tarihlerinin belirli bir sayıda işlem için bir sözleşmeyi gerçekleştirmesini sağlamak amacıyla tek reklam tarihleri bitiş tarihini aşabilir.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(service, profileId, advertiserId);
    
    // Create the campaign structure.
    Campaign campaign = new Campaign();
    campaign.Name = campaignName;
    campaign.AdvertiserId = advertiserId;
    campaign.Archived = false;
    campaign.DefaultLandingPageId = defaultLandingPage.Id;
    
    // Set the campaign start date. This example uses today's date.
    campaign.StartDate =
        DfaReportingDateConverterUtil.convertToDateString(DateTime.Now);
    
    // Set the campaign end date. This example uses one month from today's date.
    campaign.EndDate =
        DfaReportingDateConverterUtil.convertToDateString(DateTime.Now.AddMonths(1));
    
  2. Kampanyayı kaydetmek için campaigns.insert() numaralı telefonu arayın.

    // Insert the campaign.
    Campaign result = service.Campaigns.Insert(campaign, profileId).Execute();
    

Java

  1. Bir Campaign nesnesi oluşturun ve gerekli özelliklerini ayarlayın:

    • advertiserId - Bu kampanyanın ilişkilendirileceği reklamveren.
    • name - Bu değer, bu reklamverene ait tüm kampanyalarda benzersiz olmalıdır.
    • defaultLandingPageId - Bu kampanyadaki bir reklama atanmamış kullanıcıların, bu kampanyadaki bir reklamı tıkladıklarında yönlendirileceği açılış sayfası. advertiserLandingPages.list numaralı telefonu arayarak mevcut açılış sayfalarını arayabilir veya advertiserLandingPages.insert numaralı telefonu arayarak yeni bir açılış sayfası oluşturabilirsiniz.
    • Başlangıç ve bitiş tarihleri: Bunlar gelecekte olmalıdır ve güne kadar doğru olabilir. Daha fazla bilgi için Genel kodlama bilgileri başlıklı makaledeki tarihler ve saatler madde işaretini inceleyin. Belirli bir kampanya bitiş tarihine kadar doldurulmamışsa reklam tarihlerinin belirli bir sayıda işlem için bir sözleşmeyi gerçekleştirmesini sağlamak amacıyla tek reklam tarihleri bitiş tarihini aşabilir.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(reporting, profileId, advertiserId);
    
    // Create the campaign structure.
    Campaign campaign = new Campaign();
    campaign.setName(campaignName);
    campaign.setAdvertiserId(advertiserId);
    campaign.setArchived(false);
    campaign.setDefaultLandingPageId(defaultLandingPage.getId());
    
    // Set the campaign start date. This example uses today's date.
    Calendar today = Calendar.getInstance();
    DateTime startDate = new DateTime(true, today.getTimeInMillis(), null);
    campaign.setStartDate(startDate);
    
    // Set the campaign end date. This example uses one month from today's date.
    Calendar nextMonth = Calendar.getInstance();
    nextMonth.add(Calendar.MONTH, 1);
    DateTime endDate = new DateTime(true, nextMonth.getTimeInMillis(), null);
    campaign.setEndDate(endDate);
    
  2. Kampanyayı kaydetmek için campaigns.insert() numaralı telefonu arayın.

    // Insert the campaign.
    Campaign result = reporting.campaigns().insert(profileId, campaign).execute();
    

PHP

  1. Bir Campaign nesnesi oluşturun ve gerekli özelliklerini ayarlayın:

    • advertiserId - Bu kampanyanın ilişkilendirileceği reklamveren.
    • name - Bu değer, bu reklamverene ait tüm kampanyalarda benzersiz olmalıdır.
    • defaultLandingPageId - Bu kampanyadaki bir reklama atanmamış kullanıcıların, bu kampanyadaki bir reklamı tıkladıklarında yönlendirileceği açılış sayfası. advertiserLandingPages.list numaralı telefonu arayarak mevcut açılış sayfalarını arayabilir veya advertiserLandingPages.insert numaralı telefonu arayarak yeni bir açılış sayfası oluşturabilirsiniz.
    • Başlangıç ve bitiş tarihleri: Bunlar gelecekte olmalıdır ve güne kadar doğru olabilir. Daha fazla bilgi için Genel kodlama bilgileri başlıklı makaledeki tarihler ve saatler madde işaretini inceleyin. Belirli bir kampanya bitiş tarihine kadar doldurulmamışsa reklam tarihlerinin belirli bir sayıda işlem için bir sözleşmeyi gerçekleştirmesini sağlamak amacıyla tek reklam tarihleri bitiş tarihini aşabilir.
    $startDate = new DateTime('today');
    $endDate = new DateTime('+1 month');
    
    $campaign = new Google_Service_Dfareporting_Campaign();
    $campaign->setAdvertiserId($values['advertiser_id']);
    $campaign->setDefaultLandingPageId($values['default_landing_page_id']);
    $campaign->setName($values['campaign_name']);
    $campaign->setStartDate($startDate->format('Y-m-d'));
    $campaign->setEndDate($endDate->format('Y-m-d'));
    
  2. Kampanyayı kaydetmek için campaigns.insert() numaralı telefonu arayın.

    $result = $this->service->campaigns->insert(
        $values['user_profile_id'],
        $campaign
    );
    

Python

  1. Bir Campaign nesnesi oluşturun ve gerekli özelliklerini ayarlayın:

    • advertiserId - Bu kampanyanın ilişkilendirileceği reklamveren.
    • name - Bu değer, bu reklamverene ait tüm kampanyalarda benzersiz olmalıdır.
    • defaultLandingPageId - Bu kampanyadaki bir reklama atanmamış kullanıcıların, bu kampanyadaki bir reklamı tıkladıklarında yönlendirileceği açılış sayfası. advertiserLandingPages.list numaralı telefonu arayarak mevcut açılış sayfalarını arayabilir veya advertiserLandingPages.insert numaralı telefonu arayarak yeni bir açılış sayfası oluşturabilirsiniz.
    • Başlangıç ve bitiş tarihleri: Bunlar gelecekte olmalıdır ve güne kadar doğru olabilir. Daha fazla bilgi için Genel kodlama bilgileri başlıklı makaledeki tarihler ve saatler madde işaretini inceleyin. Belirli bir kampanya bitiş tarihine kadar doldurulmamışsa reklam tarihlerinin belirli bir sayıda işlem için bir sözleşmeyi gerçekleştirmesini sağlamak amacıyla tek reklam tarihleri bitiş tarihini aşabilir.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
                                                       advertiser_id)
    
    # Construct and save campaign.
    campaign = {
        'name': 'Test Campaign #%s' % uuid.uuid4(),
        'advertiserId': advertiser_id,
        'archived': 'false',
        'defaultLandingPageId': default_landing_page['id'],
        'startDate': '2015-01-01',
        'endDate': '2020-01-01'
    }
    
  2. Kampanyayı kaydetmek için campaigns.insert() numaralı telefonu arayın.

    request = service.campaigns().insert(profileId=profile_id, body=campaign)
    
    # Execute request and print response.
    response = request.execute()
    

Ruby

  1. Bir Campaign nesnesi oluşturun ve gerekli özelliklerini ayarlayın:

    • advertiserId - Bu kampanyanın ilişkilendirileceği reklamveren.
    • name - Bu değer, bu reklamverene ait tüm kampanyalarda benzersiz olmalıdır.
    • defaultLandingPageId - Bu kampanyadaki bir reklama atanmamış kullanıcıların, bu kampanyadaki bir reklamı tıkladıklarında yönlendirileceği açılış sayfası. advertiserLandingPages.list numaralı telefonu arayarak mevcut açılış sayfalarını arayabilir veya advertiserLandingPages.insert numaralı telefonu arayarak yeni bir açılış sayfası oluşturabilirsiniz.
    • Başlangıç ve bitiş tarihleri: Bunlar gelecekte olmalıdır ve güne kadar doğru olabilir. Daha fazla bilgi için Genel kodlama bilgileri başlıklı makaledeki tarihler ve saatler madde işaretini inceleyin. Belirli bir kampanya bitiş tarihine kadar doldurulmamışsa reklam tarihlerinin belirli bir sayıda işlem için bir sözleşmeyi gerçekleştirmesini sağlamak amacıyla tek reklam tarihleri bitiş tarihini aşabilir.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
      advertiser_id)
    
    # Create a new campaign resource to insert.
    campaign = DfareportingUtils::API_NAMESPACE::Campaign.new(
      advertiser_id: advertiser_id,
      archived: false,
      default_landing_page_id: default_landing_page.id,
      name: format('Example Campaign #%s', SecureRandom.hex(3)),
      start_date: '2014-01-01',
      end_date: '2020-01-01'
    )
    
  2. Kampanyayı kaydetmek için campaigns.insert() numaralı telefonu arayın.

    # Insert the campaign.
    result = service.insert_campaign(profile_id, campaign)
    

Yerleşim oluşturma

C#

  1. Bir Placement nesnesi oluşturun ve gerekli yerleşim özelliklerini (campaignId ve siteId dahil) ayarlayın. Ayrıca, web sitenizle pazarlık yaptığınız yerleşim için yerleşim türünü ve boyutunu doğru şekilde ayarladığınızdan emin olun.
    // Create the placement.
    Placement placement = new Placement();
    placement.Name = placementName;
    placement.CampaignId = campaignId;
    placement.Compatibility = "DISPLAY";
    placement.PaymentSource = "PLACEMENT_AGENCY_PAID";
    placement.SiteId = dfaSiteId;
    placement.TagFormats = new List<string>() { "PLACEMENT_TAG_STANDARD" };
    
    // Set the size of the placement.
    Size size = new Size();
    size.Id = sizeId;
    placement.Size = size;
    
  2. Yerleşime atanacak yeni bir PricingSchedule nesnesi oluşturun.
    // Set the pricing schedule for the placement.
    PricingSchedule pricingSchedule = new PricingSchedule();
    pricingSchedule.EndDate = campaign.EndDate;
    pricingSchedule.PricingType = "PRICING_TYPE_CPM";
    pricingSchedule.StartDate = campaign.StartDate;
    placement.PricingSchedule = pricingSchedule;
    
  3. placements.insert() yöntemini çağırarak Placement nesnesini kaydedin. Döndürülen kimliği, bir Reklama veya Reklam Öğesine atamak için kullanmak istiyorsanız sakladığınızdan emin olun.
    // Insert the placement.
    Placement result = service.Placements.Insert(placement, profileId).Execute();
    

Java

  1. Bir Placement nesnesi oluşturun ve gerekli yerleşim özelliklerini (campaignId ve siteId dahil) ayarlayın. Ayrıca, web sitenizle pazarlık yaptığınız yerleşim için yerleşim türünü ve boyutunu doğru şekilde ayarladığınızdan emin olun.
    // Create the placement.
    Placement placement = new Placement();
    placement.setName(placementName);
    placement.setCampaignId(campaignId);
    placement.setCompatibility("DISPLAY");
    placement.setPaymentSource("PLACEMENT_AGENCY_PAID");
    placement.setSiteId(dfaSiteId);
    placement.setTagFormats(ImmutableList.of("PLACEMENT_TAG_STANDARD"));
    
    // Set the size of the placement.
    Size size = new Size();
    size.setId(sizeId);
    placement.setSize(size);
    
  2. Yerleşime atanacak yeni bir PricingSchedule nesnesi oluşturun.
    // Set the pricing schedule for the placement.
    PricingSchedule pricingSchedule = new PricingSchedule();
    pricingSchedule.setEndDate(campaign.getEndDate());
    pricingSchedule.setPricingType("PRICING_TYPE_CPM");
    pricingSchedule.setStartDate(campaign.getStartDate());
    placement.setPricingSchedule(pricingSchedule);
    
  3. placements.insert() yöntemini çağırarak Placement nesnesini kaydedin. Döndürülen kimliği, bir Reklama veya Reklam Öğesine atamak için kullanmak istiyorsanız sakladığınızdan emin olun.
    // Insert the placement.
    Placement result = reporting.placements().insert(profileId, placement).execute();
    

PHP

  1. Bir Placement nesnesi oluşturun ve gerekli yerleşim özelliklerini (campaignId ve siteId dahil) ayarlayın. Ayrıca, web sitenizle pazarlık yaptığınız yerleşim için yerleşim türünü ve boyutunu doğru şekilde ayarladığınızdan emin olun.
    $placement = new Google_Service_Dfareporting_Placement();
    $placement->setCampaignId($values['campaign_id']);
    $placement->setCompatibility('DISPLAY');
    $placement->setName($values['placement_name']);
    $placement->setPaymentSource('PLACEMENT_AGENCY_PAID');
    $placement->setSiteId($values['site_id']);
    $placement->setTagFormats(['PLACEMENT_TAG_STANDARD']);
    
    // Set the size of the placement.
    $size = new Google_Service_Dfareporting_Size();
    $size->setId($values['size_id']);
    $placement->setSize($size);
    
  2. Yerleşime atanacak yeni bir PricingSchedule nesnesi oluşturun.
    // Set the pricing schedule for the placement.
    $pricingSchedule = new Google_Service_Dfareporting_PricingSchedule();
    $pricingSchedule->setEndDate($campaign->getEndDate());
    $pricingSchedule->setPricingType('PRICING_TYPE_CPM');
    $pricingSchedule->setStartDate($campaign->getStartDate());
    $placement->setPricingSchedule($pricingSchedule);
    
  3. placements.insert() yöntemini çağırarak Placement nesnesini kaydedin. Döndürülen kimliği, bir Reklama veya Reklam Öğesine atamak için kullanmak istiyorsanız sakladığınızdan emin olun.
    // Insert the placement.
    $result = $this->service->placements->insert(
        $values['user_profile_id'],
        $placement
    );
    

Python

  1. Bir Placement nesnesi oluşturun ve gerekli yerleşim özelliklerini (campaignId ve siteId dahil) ayarlayın. Ayrıca, web sitenizle pazarlık yaptığınız yerleşim için yerleşim türünü ve boyutunu doğru şekilde ayarladığınızdan emin olun.
    # Construct and save placement.
    placement = {
        'name': 'Test Placement',
        'campaignId': campaign_id,
        'compatibility': 'DISPLAY',
        'siteId': site_id,
        'size': {
            'height': '1',
            'width': '1'
        },
        'paymentSource': 'PLACEMENT_AGENCY_PAID',
        'tagFormats': ['PLACEMENT_TAG_STANDARD']
    }
    
  2. Yerleşime atanacak yeni bir PricingSchedule nesnesi oluşturun.
    # Set the pricing schedule for the placement.
    placement['pricingSchedule'] = {
        'startDate': campaign['startDate'],
        'endDate': campaign['endDate'],
        'pricingType': 'PRICING_TYPE_CPM'
    }
    
  3. placements.insert() yöntemini çağırarak Placement nesnesini kaydedin. Döndürülen kimliği, bir Reklama veya Reklam Öğesine atamak için kullanmak istiyorsanız sakladığınızdan emin olun.
    request = service.placements().insert(profileId=profile_id, body=placement)
    
    # Execute request and print response.
    response = request.execute()
    

Ruby

  1. Bir Placement nesnesi oluşturun ve gerekli yerleşim özelliklerini (campaignId ve siteId dahil) ayarlayın. Ayrıca, web sitenizle pazarlık yaptığınız yerleşim için yerleşim türünü ve boyutunu doğru şekilde ayarladığınızdan emin olun.
    # Create a new placement resource to insert.
    placement = DfareportingUtils::API_NAMESPACE::Placement.new(
      campaign_id: campaign_id,
      compatibility: 'DISPLAY',
      name: 'Example Placement',
      payment_source: 'PLACEMENT_AGENCY_PAID',
      site_id: site_id,
      size: DfareportingUtils::API_NAMESPACE::Size.new(
        height: 1,
        width: 1
      ),
      tag_formats: ['PLACEMENT_TAG_STANDARD']
    )
    
  2. Yerleşime atanacak yeni bir PricingSchedule nesnesi oluşturun.
    # Set the pricing schedule for the placement.
    placement.pricing_schedule =
      DfareportingUtils::API_NAMESPACE::PricingSchedule.new(
        end_date: campaign.end_date,
        pricing_type: 'PRICING_TYPE_CPM',
        start_date: campaign.start_date
      )
    
  3. placements.insert() yöntemini çağırarak Placement nesnesini kaydedin. Döndürülen kimliği, bir Reklama veya Reklam Öğesine atamak için kullanmak istiyorsanız sakladığınızdan emin olun.
    # Insert the placement strategy.
    result = service.insert_placement(profile_id, placement)
    

Öğe yükle

Medya yükleme olarak bilinen bir işlem aracılığıyla birçok öğe türünü yükleyebilirsiniz. Bu süreç tüm reklam öğesi türleri için benzer olsa da bazı türler, doğru şekilde kullanılmaları için belirli özelliklerin meta veri olarak aktarılmasını gerektirebilir.

C#

  1. Bir assetIdentifier nesnesi oluşturun ve gerekli özellikleri ayarlayın. Türü veya nasıl kullanıldığı fark etmeksizin tüm öğelerde assetIdentifier belirtilmesi gerekir. Öğe bir reklam öğesine atanırken, öğeye tekrar başvuruda bulunmak için bu nesne kullanılır. Aşağıdaki özelliklerin doldurulması zorunludur:

    • name özelliği (bu, sunucudaki öğenin adı). Ad, .png veya .gif gibi dosya türünü belirten bir uzantı içermelidir ve tarayıcıda öğe adı olarak gösterilir. Ancak adın, orijinal dosya adıyla aynı olması gerekmez. Bu adın sunucuda benzersiz olması için Campaign Manager 360 tarafından değiştirilebileceğini unutmayın; döndürülen değeri kontrol edin.
    • Öğenin türünü tanımlayan type özelliği. Bu özellik, öğenin ilişkilendirilebileceği reklam öğesi türlerini belirtir.
    // Create the creative asset ID and Metadata.
    CreativeAssetId assetId = new CreativeAssetId();
    assetId.Name = Path.GetFileName(assetFile);
    assetId.Type = assetType;
    
  2. creativeAssets.insert() numaralı telefonu arayarak dosyayı yükleyin. Aynı isteğin bir parçası olarak hem assetIdentifier hem de dosya içeriğini ileterek çok parçalı yükleme gerçekleştirin. İşlem başarılı olursa bu öğeyi bir reklam öğesine atamak için kullanacağınız bir assetIdentifier ile birlikte bir CreativeAsset kaynağı döndürülür.

    // Prepare an input stream.
    FileStream assetContent = new FileStream(assetFile, FileMode.Open, FileAccess.Read);
    
    
    CreativeAssetMetadata metaData = new CreativeAssetMetadata();
    metaData.AssetIdentifier = assetId;
    
    // Insert the creative.
    String mimeType = determineMimeType(assetFile, assetType);
    CreativeAssetsResource.InsertMediaUpload request =
        Service.CreativeAssets.Insert(metaData, ProfileId, AdvertiserId, assetContent, mimeType);
    
    IUploadProgress progress = request.Upload();
    if (UploadStatus.Failed.Equals(progress.Status)) {
        throw progress.Exception;
    }
    

Java

  1. Bir assetIdentifier nesnesi oluşturun ve gerekli özellikleri ayarlayın. Türü veya nasıl kullanıldığı fark etmeksizin tüm öğelerde assetIdentifier belirtilmesi gerekir. Öğe bir reklam öğesine atanırken, öğeye tekrar başvuruda bulunmak için bu nesne kullanılır. Aşağıdaki özelliklerin doldurulması zorunludur:

    • name özelliği (bu, sunucudaki öğenin adı). Ad, .png veya .gif gibi dosya türünü belirten bir uzantı içermelidir ve tarayıcıda öğe adı olarak gösterilir. Ancak adın, orijinal dosya adıyla aynı olması gerekmez. Bu adın sunucuda benzersiz olması için Campaign Manager 360 tarafından değiştirilebileceğini unutmayın; döndürülen değeri kontrol edin.
    • Öğenin türünü tanımlayan type özelliği. Bu özellik, öğenin ilişkilendirilebileceği reklam öğesi türlerini belirtir.
    // Create the creative asset ID and Metadata.
    CreativeAssetId assetId = new CreativeAssetId();
    assetId.setName(assetName);
    assetId.setType(assetType);
    
  2. creativeAssets.insert() numaralı telefonu arayarak dosyayı yükleyin. Aynı isteğin bir parçası olarak hem assetIdentifier hem de dosya içeriğini ileterek çok parçalı yükleme gerçekleştirin. İşlem başarılı olursa bu öğeyi bir reklam öğesine atamak için kullanacağınız bir assetIdentifier ile birlikte bir CreativeAsset kaynağı döndürülür.

    // Open the asset file.
    File file = new File(assetFile);
    
    // Prepare an input stream.
    String contentType = getMimeType(assetFile);
    InputStreamContent assetContent =
        new InputStreamContent(contentType, new BufferedInputStream(new FileInputStream(file)));
    assetContent.setLength(file.length());
    
    
    CreativeAssetMetadata metaData = new CreativeAssetMetadata();
    metaData.setAssetIdentifier(assetId);
    
    // Insert the creative.
    CreativeAssetMetadata result = reporting.creativeAssets()
        .insert(profileId, advertiserId, metaData, assetContent).execute();
    

PHP

  1. Bir assetIdentifier nesnesi oluşturun ve gerekli özellikleri ayarlayın. Türü veya nasıl kullanıldığı fark etmeksizin tüm öğelerde assetIdentifier belirtilmesi gerekir. Öğe bir reklam öğesine atanırken, öğeye tekrar başvuruda bulunmak için bu nesne kullanılır. Aşağıdaki özelliklerin doldurulması zorunludur:

    • name özelliği (bu, sunucudaki öğenin adı). Ad, .png veya .gif gibi dosya türünü belirten bir uzantı içermelidir ve tarayıcıda öğe adı olarak gösterilir. Ancak adın, orijinal dosya adıyla aynı olması gerekmez. Bu adın sunucuda benzersiz olması için Campaign Manager 360 tarafından değiştirilebileceğini unutmayın; döndürülen değeri kontrol edin.
    • Öğenin türünü tanımlayan type özelliği. Bu özellik, öğenin ilişkilendirilebileceği reklam öğesi türlerini belirtir.
    $assetId = new Google_Service_Dfareporting_CreativeAssetId();
    $assetId->setName($asset['name']);
    $assetId->setType($type);
    
  2. creativeAssets.insert() numaralı telefonu arayarak dosyayı yükleyin. Aynı isteğin bir parçası olarak hem assetIdentifier hem de dosya içeriğini ileterek çok parçalı yükleme gerçekleştirin. İşlem başarılı olursa bu öğeyi bir reklam öğesine atamak için kullanacağınız bir assetIdentifier ile birlikte bir CreativeAsset kaynağı döndürülür.

    $metadata = new Google_Service_Dfareporting_CreativeAssetMetadata();
    $metadata->setAssetIdentifier($assetId);
    
    $result = $service->creativeAssets->insert(
        $userProfileId,
        $advertiserId,
        $metadata,
        ['data' => file_get_contents($asset['tmp_name']),
         'mimeType' => $asset['type'],
         'uploadType' => 'multipart']
    );
    

Python

  1. Bir assetIdentifier nesnesi oluşturun ve gerekli özellikleri ayarlayın. Türü veya nasıl kullanıldığı fark etmeksizin tüm öğelerde assetIdentifier belirtilmesi gerekir. Öğe bir reklam öğesine atanırken, öğeye tekrar başvuruda bulunmak için bu nesne kullanılır. Aşağıdaki özelliklerin doldurulması zorunludur:

    • name özelliği (bu, sunucudaki öğenin adı). Ad, .png veya .gif gibi dosya türünü belirten bir uzantı içermelidir ve tarayıcıda öğe adı olarak gösterilir. Ancak adın, orijinal dosya adıyla aynı olması gerekmez. Bu adın sunucuda benzersiz olması için Campaign Manager 360 tarafından değiştirilebileceğini unutmayın; döndürülen değeri kontrol edin.
    • Öğenin türünü tanımlayan type özelliği. Bu özellik, öğenin ilişkilendirilebileceği reklam öğesi türlerini belirtir.
    # Construct the creative asset metadata
    creative_asset = {'assetIdentifier': {'name': asset_name, 'type': asset_type}}
    
  2. creativeAssets.insert() numaralı telefonu arayarak dosyayı yükleyin. Aynı isteğin bir parçası olarak hem assetIdentifier hem de dosya içeriğini ileterek çok parçalı yükleme gerçekleştirin. İşlem başarılı olursa bu öğeyi bir reklam öğesine atamak için kullanacağınız bir assetIdentifier ile birlikte bir CreativeAsset kaynağı döndürülür.

    media = MediaFileUpload(path_to_asset_file)
    if not media.mimetype():
      media = MediaFileUpload(path_to_asset_file, 'application/octet-stream')
    
    response = service.creativeAssets().insert(
        advertiserId=advertiser_id,
        profileId=profile_id,
        media_body=media,
        body=creative_asset).execute()
    

Ruby

  1. Bir assetIdentifier nesnesi oluşturun ve gerekli özellikleri ayarlayın. Türü veya nasıl kullanıldığı fark etmeksizin tüm öğelerde assetIdentifier belirtilmesi gerekir. Öğe bir reklam öğesine atanırken, öğeye tekrar başvuruda bulunmak için bu nesne kullanılır. Aşağıdaki özelliklerin doldurulması zorunludur:

    • name özelliği (bu, sunucudaki öğenin adı). Ad, .png veya .gif gibi dosya türünü belirten bir uzantı içermelidir ve tarayıcıda öğe adı olarak gösterilir. Ancak adın, orijinal dosya adıyla aynı olması gerekmez. Bu adın sunucuda benzersiz olması için Campaign Manager 360 tarafından değiştirilebileceğini unutmayın; döndürülen değeri kontrol edin.
    • Öğenin türünü tanımlayan type özelliği. Bu özellik, öğenin ilişkilendirilebileceği reklam öğesi türlerini belirtir.
    # Construct the creative asset metadata
    creative_asset = DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
      asset_identifier: DfareportingUtils::API_NAMESPACE::CreativeAssetId.new(
        name: asset_name,
        type: asset_type
      )
    )
    
  2. creativeAssets.insert() numaralı telefonu arayarak dosyayı yükleyin. Aynı isteğin bir parçası olarak hem assetIdentifier hem de dosya içeriğini ileterek çok parçalı yükleme gerçekleştirin. İşlem başarılı olursa bu öğeyi bir reklam öğesine atamak için kullanacağınız bir assetIdentifier ile birlikte bir CreativeAsset kaynağı döndürülür.

    # Upload the asset.
    mime_type = determine_mime_type(path_to_asset_file, asset_type)
    
    result = @service.insert_creative_asset(
      @profile_id,
      advertiser_id,
      creative_asset,
      content_type: mime_type,
      upload_source: path_to_asset_file
    )
    

Reklam öğesi oluşturma

Creative nesnesi, mevcut bir öğeyi sarmalar. Ana makine sayfasındaki reklam öğelerini nasıl kullanacağınıza bağlı olarak farklı reklam öğesi türlerinden Creative nesneleri oluşturabilirsiniz. Size uygun olan türü belirlemek için referans belgelerine göz atın.

Aşağıdaki örnekte yeni bir HTML5 görüntülü reklam öğesinin nasıl oluşturulacağı gösterilmektedir.

C#

  1. Öğeleri yükleyin. Farklı reklam öğeleri, farklı tür ve miktarlarda öğe gerektirir. ayrıntılar için Öğe yükleme konusuna bakın. Başarılı bir şekilde her öğe yüklediğinizde yanıtta assetIdenfitier alırsınız; reklam öğenizde bu öğelere referans vermek için geleneksel bir kimlik yerine depolanan dosya adını ve türünü kullanacaksınız.
  2. Bir reklam öğesi oluşturun ve uygun değerleri atayın. Bir Creative örneği gösterin ve doğru type değerini ayarlayın; Creative nesnesinin türünü kaydettikten sonra değiştiremezsiniz. Öğeleri AssetIdentifier ve role değerleriyle belirtin.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(service, profileId, advertiserId);
    
    // Create the creative structure.
    Creative creative = new Creative();
    creative.AdvertiserId = advertiserId;
    creative.Name = "Test HTML5 display creative";
    creative.Size = new Size() { Id = sizeId };
    creative.Type = "DISPLAY";
    
    // Upload the HTML5 asset.
    CreativeAssetUtils assetUtils = new CreativeAssetUtils(service, profileId, advertiserId);
    CreativeAssetId html5AssetId =
        assetUtils.uploadAsset(pathToHtml5AssetFile, "HTML").AssetIdentifier;
    
    CreativeAsset html5Asset = new CreativeAsset();
    html5Asset.AssetIdentifier = html5AssetId;
    html5Asset.Role = "PRIMARY";
    
    // Upload the backup image asset.
    CreativeAssetId imageAssetId =
        assetUtils.uploadAsset(pathToImageAssetFile, "HTML_IMAGE").AssetIdentifier;
    
    CreativeAsset imageAsset = new CreativeAsset();
    imageAsset.AssetIdentifier = imageAssetId;
    imageAsset.Role = "BACKUP_IMAGE";
    
    // Add the creative assets.
    creative.CreativeAssets = new List<CreativeAsset>() { html5Asset, imageAsset };
    
    // Configure the bacup image.
    creative.BackupImageClickThroughUrl = new CreativeClickThroughUrl() {
      LandingPageId = defaultLandingPage.Id
    };
    creative.BackupImageReportingLabel = "backup";
    creative.BackupImageTargetWindow = new TargetWindow() { TargetWindowOption = "NEW_WINDOW" };
    
    // Add a click tag.
    ClickTag clickTag = new ClickTag();
    clickTag.Name = "clickTag";
    clickTag.EventName = "exit";
    clickTag.ClickThroughUrl = new CreativeClickThroughUrl() {
      LandingPageId = defaultLandingPage.Id
    };
    creative.ClickTags = new List<ClickTag>() { clickTag };
    
  3. Reklam öğesini kaydedin. Bu işlemi, creatives.insert() numaralı telefonu arayarak gerçekleştirebilirsiniz. Bu reklam öğesinin ilişkilendirileceği reklamveren kimliğinin belirtilmesi gerekir.
    Creative result = service.Creatives.Insert(creative, profileId).Execute();
    
  4. (İsteğe bağlı) Reklam öğesini bir kampanyayla ilişkilendirin. Bu işlem, campaignCreativeAssociations.insert() çağırıp kampanya ve reklam öğesi kimliklerini ileterek yapılabilir.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.CreativeId = creativeId;
    
    // Insert the association.
    CampaignCreativeAssociation result =
        service.CampaignCreativeAssociations.Insert(association, profileId, campaignId).Execute();
    

Java

  1. Öğeleri yükleyin. Farklı reklam öğeleri, farklı tür ve miktarlarda öğe gerektirir. ayrıntılar için Öğe yükleme konusuna bakın. Başarılı bir şekilde her öğe yüklediğinizde yanıtta assetIdenfitier alırsınız; reklam öğenizde bu öğelere referans vermek için geleneksel bir kimlik yerine depolanan dosya adını ve türünü kullanacaksınız.
  2. Bir reklam öğesi oluşturun ve uygun değerleri atayın. Bir Creative örneği gösterin ve doğru type değerini ayarlayın; Creative nesnesinin türünü kaydettikten sonra değiştiremezsiniz. Öğeleri AssetIdentifier ve role değerleriyle belirtin.
    // Locate an advertiser landing page to use as a default.
    LandingPage defaultLandingPage = getAdvertiserLandingPage(reporting, profileId, advertiserId);
    
    // Create the creative structure.
    Creative creative = new Creative();
    creative.setAdvertiserId(advertiserId);
    creative.setName("Test HTML5 display creative");
    creative.setSize(new Size().setId(sizeId));
    creative.setType("DISPLAY");
    
    // Upload the HTML5 asset.
    CreativeAssetId html5AssetId = CreativeAssetUtils.uploadAsset(reporting, profileId,
        advertiserId, HTML5_ASSET_NAME, PATH_TO_HTML5_ASSET_FILE, "HTML").getAssetIdentifier();
    
    CreativeAsset html5Asset =
        new CreativeAsset().setAssetIdentifier(html5AssetId).setRole("PRIMARY");
    
    // Upload the backup image asset (note: asset type must be set to HTML_IMAGE).
    CreativeAssetId imageAssetId = CreativeAssetUtils.uploadAsset(reporting, profileId,
        advertiserId, IMAGE_ASSET_NAME, PATH_TO_IMAGE_ASSET_FILE, "HTML_IMAGE")
        .getAssetIdentifier();
    
    CreativeAsset backupImageAsset =
        new CreativeAsset().setAssetIdentifier(imageAssetId).setRole("BACKUP_IMAGE");
    
    // Add the creative assets.
    creative.setCreativeAssets(ImmutableList.of(html5Asset, backupImageAsset));
    
    // Configure the backup image.
    creative.setBackupImageClickThroughUrl(
        new CreativeClickThroughUrl().setLandingPageId(defaultLandingPage.getId()));
    creative.setBackupImageReportingLabel("backup");
    creative.setBackupImageTargetWindow(new TargetWindow().setTargetWindowOption("NEW_WINDOW"));
    
    // Add a click tag.
    ClickTag clickTag =
        new ClickTag().setName("clickTag").setEventName("exit").setClickThroughUrl(
            new CreativeClickThroughUrl().setLandingPageId(defaultLandingPage.getId()));
    creative.setClickTags(ImmutableList.of(clickTag));
    
  3. Reklam öğesini kaydedin. Bu işlemi, creatives.insert() numaralı telefonu arayarak gerçekleştirebilirsiniz. Bu reklam öğesinin ilişkilendirileceği reklamveren kimliğinin belirtilmesi gerekir.
    Creative result = reporting.creatives().insert(profileId, creative).execute();
    
  4. (İsteğe bağlı) Reklam öğesini bir kampanyayla ilişkilendirin. Bu işlem, campaignCreativeAssociations.insert() çağırıp kampanya ve reklam öğesi kimliklerini ileterek yapılabilir.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.setCreativeId(creativeId);
    
    // Insert the association.
    CampaignCreativeAssociation result = reporting
        .campaignCreativeAssociations().insert(profileId, campaignId, association)
        .execute();
    

PHP

  1. Öğeleri yükleyin. Farklı reklam öğeleri, farklı tür ve miktarlarda öğe gerektirir. ayrıntılar için Öğe yükleme konusuna bakın. Başarılı bir şekilde her öğe yüklediğinizde yanıtta assetIdenfitier alırsınız; reklam öğenizde bu öğelere referans vermek için geleneksel bir kimlik yerine depolanan dosya adını ve türünü kullanacaksınız.
  2. Bir reklam öğesi oluşturun ve uygun değerleri atayın. Bir Creative örneği gösterin ve doğru type değerini ayarlayın; Creative nesnesinin türünü kaydettikten sonra değiştiremezsiniz. Öğeleri AssetIdentifier ve role değerleriyle belirtin.
    $creative = new Google_Service_Dfareporting_Creative();
    $creative->setAdvertiserId($values['advertiser_id']);
    $creative->setAutoAdvanceImages(true);
    $creative->setName('Test HTML5 display creative');
    $creative->setType('DISPLAY');
    
    $size = new Google_Service_Dfareporting_Size();
    $size->setId($values['size_id']);
    $creative->setSize($size);
    
    // Upload the HTML5 asset.
    $html = uploadAsset(
        $this->service,
        $values['user_profile_id'],
        $values['advertiser_id'],
        $values['html_asset_file'],
        'HTML'
    );
    
    $htmlAsset = new Google_Service_Dfareporting_CreativeAsset();
    $htmlAsset->setAssetIdentifier($html->getAssetIdentifier());
    $htmlAsset->setRole('PRIMARY');
    
    // Upload the backup image asset.
    $image = uploadAsset(
        $this->service,
        $values['user_profile_id'],
        $values['advertiser_id'],
        $values['image_asset_file'],
        'HTML_IMAGE'
    );
    
    $imageAsset = new Google_Service_Dfareporting_CreativeAsset();
    $imageAsset->setAssetIdentifier($image->getAssetIdentifier());
    $imageAsset->setRole('BACKUP_IMAGE');
    
    // Add the creative assets.
    $creative->setCreativeAssets([$htmlAsset, $imageAsset]);
    
    // Configure the default click-through URL.
    $clickThroughUrl =
        new Google_Service_Dfareporting_CreativeClickThroughUrl();
    $clickThroughUrl->setLandingPageId($values['landing_page_id']);
    
    // Configure the backup image.
    $creative->setBackupImageClickThroughUrl($clickThroughUrl);
    $creative->setBackupImageReportingLabel('backup');
    
    $targetWindow = new Google_Service_Dfareporting_TargetWindow();
    $targetWindow->setTargetWindowOption('NEW_WINDOW');
    $creative->setBackupImageTargetWindow($targetWindow);
    
    // Add a click tag.
    $clickTag = new Google_Service_Dfareporting_ClickTag();
    $clickTag->setName('clickTag');
    $clickTag->setEventName('exit');
    $clickTag->setClickThroughUrl($clickThroughUrl);
    $creative->setClickTags([$clickTag]);
    
  3. Reklam öğesini kaydedin. Bu işlemi, creatives.insert() numaralı telefonu arayarak gerçekleştirebilirsiniz. Bu reklam öğesinin ilişkilendirileceği reklamveren kimliğinin belirtilmesi gerekir.
    $result = $this->service->creatives->insert(
        $values['user_profile_id'],
        $creative
    );
    
  4. (İsteğe bağlı) Reklam öğesini bir kampanyayla ilişkilendirin. Bu işlem, campaignCreativeAssociations.insert() çağırıp kampanya ve reklam öğesi kimliklerini ileterek yapılabilir.
    $association =
        new Google_Service_Dfareporting_CampaignCreativeAssociation();
    $association->setCreativeId($values['creative_id']);
    
    $result = $this->service->campaignCreativeAssociations->insert(
        $values['user_profile_id'],
        $values['campaign_id'],
        $association
    );
    

Python

  1. Öğeleri yükleyin. Farklı reklam öğeleri, farklı tür ve miktarlarda öğe gerektirir. ayrıntılar için Öğe yükleme konusuna bakın. Başarılı bir şekilde her öğe yüklediğinizde yanıtta assetIdenfitier alırsınız; reklam öğenizde bu öğelere referans vermek için geleneksel bir kimlik yerine depolanan dosya adını ve türünü kullanacaksınız.
  2. Bir reklam öğesi oluşturun ve uygun değerleri atayın. Bir Creative örneği gösterin ve doğru type değerini ayarlayın; Creative nesnesinin türünü kaydettikten sonra değiştiremezsiniz. Öğeleri AssetIdentifier ve role değerleriyle belirtin.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
                                                       advertiser_id)
    
    # Upload the HTML5 asset
    html5_asset_id = upload_creative_asset(service, profile_id, advertiser_id,
                                           html5_asset_name,
                                           path_to_html5_asset_file, 'HTML')
    
    # Upload the backup image asset
    backup_image_asset_id = upload_creative_asset(
        service, profile_id, advertiser_id, backup_image_name,
        path_to_backup_image_file, 'HTML_IMAGE')
    
    # Construct the creative structure.
    creative = {
        'advertiserId': advertiser_id,
        'backupImageClickThroughUrl': {
            'landingPageId': default_landing_page['id']
        },
        'backupImageReportingLabel': 'backup_image_exit',
        'backupImageTargetWindow': {'targetWindowOption': 'NEW_WINDOW'},
        'clickTags': [{
            'eventName': 'exit',
            'name': 'click_tag',
            'clickThroughUrl': {'landingPageId': default_landing_page['id']}
        }],
        'creativeAssets': [
            {'assetIdentifier': html5_asset_id, 'role': 'PRIMARY'},
            {'assetIdentifier': backup_image_asset_id, 'role': 'BACKUP_IMAGE'}
        ],
        'name': 'Test HTML5 display creative',
        'size': {'id': size_id},
        'type': 'DISPLAY'
    }
    
  3. Reklam öğesini kaydedin. Bu işlemi, creatives.insert() numaralı telefonu arayarak gerçekleştirebilirsiniz. Bu reklam öğesinin ilişkilendirileceği reklamveren kimliğinin belirtilmesi gerekir.
    request = service.creatives().insert(profileId=profile_id, body=creative)
    
    # Execute request and print response.
    response = request.execute()
    
  4. (İsteğe bağlı) Reklam öğesini bir kampanyayla ilişkilendirin. Bu işlem, campaignCreativeAssociations.insert() çağırıp kampanya ve reklam öğesi kimliklerini ileterek yapılabilir.
    # Construct the request.
    association = {
        'creativeId': creative_id
    }
    
    request = service.campaignCreativeAssociations().insert(
        profileId=profile_id, campaignId=campaign_id, body=association)
    
    # Execute request and print response.
    response = request.execute()
    

Ruby

  1. Öğeleri yükleyin. Farklı reklam öğeleri, farklı tür ve miktarlarda öğe gerektirir. ayrıntılar için Öğe yükleme konusuna bakın. Başarılı bir şekilde her öğe yüklediğinizde yanıtta assetIdenfitier alırsınız; reklam öğenizde bu öğelere referans vermek için geleneksel bir kimlik yerine depolanan dosya adını ve türünü kullanacaksınız.
  2. Bir reklam öğesi oluşturun ve uygun değerleri atayın. Bir Creative örneği gösterin ve doğru type değerini ayarlayın; Creative nesnesinin türünü kaydettikten sonra değiştiremezsiniz. Öğeleri AssetIdentifier ve role değerleriyle belirtin.
    # Locate an advertiser landing page to use as a default.
    default_landing_page = get_advertiser_landing_page(service, profile_id,
      advertiser_id)
    
    # Upload the HTML5 asset.
    html5_asset_id = util.upload_asset(advertiser_id, path_to_html5_asset_file,
      'HTML').asset_identifier
    
    # Upload the backup image asset.
    backup_image_asset_id = util.upload_asset(advertiser_id,
      path_to_backup_image_file, 'HTML_IMAGE').asset_identifier
    
    # Construct the creative structure.
    creative = DfareportingUtils::API_NAMESPACE::Creative.new(
      advertiser_id: advertiser_id,
      backup_image_click_through_url:
        DfareportingUtils::API_NAMESPACE::CreativeClickThroughUrl.new(
          landing_page_id: default_landing_page.id
        ),
      backup_image_reporting_label: 'backup',
      backup_image_target_window:
        DfareportingUtils::API_NAMESPACE::TargetWindow.new(
          target_window_option: 'NEW_WINDOW'
        ),
      click_tags: [
        DfareportingUtils::API_NAMESPACE::ClickTag.new(
          event_name: 'exit',
          name: 'click_tag',
          click_through_url:
            DfareportingUtils::API_NAMESPACE::CreativeClickThroughUrl.new(
              landing_page_id: default_landing_page.id
            )
        )
      ],
      creative_assets: [
        DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
          asset_identifier: html5_asset_id,
          role: 'PRIMARY'
        ),
        DfareportingUtils::API_NAMESPACE::CreativeAsset.new(
          asset_identifier: backup_image_asset_id,
          role: 'BACKUP_IMAGE'
        )
      ],
      name: 'Example HTML5 display creative',
      size: DfareportingUtils::API_NAMESPACE::Size.new(id: size_id),
      type: 'DISPLAY'
    )
    
  3. Reklam öğesini kaydedin. Bu işlemi, creatives.insert() numaralı telefonu arayarak gerçekleştirebilirsiniz. Bu reklam öğesinin ilişkilendirileceği reklamveren kimliğinin belirtilmesi gerekir.
    # Insert the creative.
    result = service.insert_creative(profile_id, creative)
    
  4. (İsteğe bağlı) Reklam öğesini bir kampanyayla ilişkilendirin. Bu işlem, campaignCreativeAssociations.insert() çağırıp kampanya ve reklam öğesi kimliklerini ileterek yapılabilir.
    # Create a new creative-campaign association to insert
    association =
      DfareportingUtils::API_NAMESPACE::CampaignCreativeAssociation.new(
        creative_id: creative_id
      )
    
    # Insert the advertiser group.
    result = service.insert_campaign_creative_association(profile_id, campaign_id,
      association)
    

Bir reklam oluşturun

Ad, Creative ile Placement arasındaki bağlantıdır. Ad, bir veya daha fazla yerleşime bağlanabilir ve bir veya daha fazla reklam öğesini içerir.

Açık veya dolaylı olarak Ad oluşturabilirsiniz.

Açıkça

C#

  1. Bu reklamın ilişkilendirilmesi gereken her bir reklam öğesi için bir CreativeAssignment nesnesi oluşturun. CreativeAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    // Create a click-through URL.
    ClickThroughUrl clickThroughUrl = new ClickThroughUrl();
    clickThroughUrl.DefaultLandingPage = true;
    
    // Create a creative assignment.
    CreativeAssignment creativeAssignment = new CreativeAssignment();
    creativeAssignment.Active = true;
    creativeAssignment.CreativeId = creativeId;
    creativeAssignment.ClickThroughUrl = clickThroughUrl;
    
  2. CreativeAssignment öğelerini depolayacak bir CreativeRotation nesnesi oluşturun. Rotasyon grubu oluşturuyorsanız diğer gerekli reklam öğesi rotasyon alanlarını ayarladığınızdan emin olun.
    // Create a creative rotation.
    CreativeRotation creativeRotation = new CreativeRotation();
    creativeRotation.CreativeAssignments = new List<CreativeAssignment>() {
        creativeAssignment
    };
    
  3. Bu reklamın ilişkilendirilmesi gereken her bir yerleşim için bir PlacementAssignment nesnesi oluşturun. PlacementAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    // Create a placement assignment.
    PlacementAssignment placementAssignment = new PlacementAssignment();
    placementAssignment.Active = true;
    placementAssignment.PlacementId = placementId;
    
  4. Ad nesnesi oluşturun. CreativeRotation'ı Ad nesnesinin creativeRotation alanına, placementAssignments'ı ise Ad nesnesinin placementAssignments dizisine ayarlayın.
    // Create a delivery schedule.
    DeliverySchedule deliverySchedule = new DeliverySchedule();
    deliverySchedule.ImpressionRatio = 1;
    deliverySchedule.Priority = "AD_PRIORITY_01";
    
    DateTime startDate = DateTime.Now;
    DateTime endDate = Convert.ToDateTime(campaign.EndDate);
    
    // Create a rotation group.
    Ad rotationGroup = new Ad();
    rotationGroup.Active = true;
    rotationGroup.CampaignId = campaignId;
    rotationGroup.CreativeRotation = creativeRotation;
    rotationGroup.DeliverySchedule = deliverySchedule;
    rotationGroup.StartTime = startDate;
    rotationGroup.EndTime = endDate;
    rotationGroup.Name = adName;
    rotationGroup.PlacementAssignments = new List<PlacementAssignment>() {
        placementAssignment
    };
    rotationGroup.Type = "AD_SERVING_STANDARD_AD";
    
  5. ads.insert() numaralı telefonu arayarak reklamı kaydedin.
    // Insert the rotation group.
    Ad result = service.Ads.Insert(rotationGroup, profileId).Execute();
    

Java

  1. Bu reklamın ilişkilendirilmesi gereken her bir reklam öğesi için bir CreativeAssignment nesnesi oluşturun. CreativeAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    // Create a click-through URL.
    ClickThroughUrl clickThroughUrl = new ClickThroughUrl();
    clickThroughUrl.setDefaultLandingPage(true);
    
    // Create a creative assignment.
    CreativeAssignment creativeAssignment = new CreativeAssignment();
    creativeAssignment.setActive(true);
    creativeAssignment.setCreativeId(creativeId);
    creativeAssignment.setClickThroughUrl(clickThroughUrl);
    
  2. CreativeAssignment öğelerini depolayacak bir CreativeRotation nesnesi oluşturun. Rotasyon grubu oluşturuyorsanız diğer gerekli reklam öğesi rotasyon alanlarını ayarladığınızdan emin olun.
    // Create a creative rotation.
    CreativeRotation creativeRotation = new CreativeRotation();
    creativeRotation.setCreativeAssignments(ImmutableList.of(creativeAssignment));
    
  3. Bu reklamın ilişkilendirilmesi gereken her bir yerleşim için bir PlacementAssignment nesnesi oluşturun. PlacementAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    // Create a placement assignment.
    PlacementAssignment placementAssignment = new PlacementAssignment();
    placementAssignment.setActive(true);
    placementAssignment.setPlacementId(placementId);
    
  4. Ad nesnesi oluşturun. CreativeRotation'ı Ad nesnesinin creativeRotation alanına, placementAssignments'ı ise Ad nesnesinin placementAssignments dizisine ayarlayın.
    // Create a delivery schedule.
    DeliverySchedule deliverySchedule = new DeliverySchedule();
    deliverySchedule.setImpressionRatio(1L);
    deliverySchedule.setPriority("AD_PRIORITY_01");
    
    DateTime startDate = new DateTime(new Date());
    DateTime endDate = new DateTime(campaign.getEndDate().getValue());
    
    // Create a rotation group.
    Ad rotationGroup = new Ad();
    rotationGroup.setActive(true);
    rotationGroup.setCampaignId(campaignId);
    rotationGroup.setCreativeRotation(creativeRotation);
    rotationGroup.setDeliverySchedule(deliverySchedule);
    rotationGroup.setStartTime(startDate);
    rotationGroup.setEndTime(endDate);
    rotationGroup.setName(adName);
    rotationGroup.setPlacementAssignments(ImmutableList.of(placementAssignment));
    rotationGroup.setType("AD_SERVING_STANDARD_AD");
    
  5. ads.insert() numaralı telefonu arayarak reklamı kaydedin.
    // Insert the rotation group.
    Ad result = reporting.ads().insert(profileId, rotationGroup).execute();
    

PHP

  1. Bu reklamın ilişkilendirilmesi gereken her bir reklam öğesi için bir CreativeAssignment nesnesi oluşturun. CreativeAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    // Create a click-through URL.
    $url = new Google_Service_Dfareporting_ClickThroughUrl();
    $url->setDefaultLandingPage(true);
    
    // Create a creative assignment.
    $creativeAssignment =
        new Google_Service_Dfareporting_CreativeAssignment();
    $creativeAssignment->setActive(true);
    $creativeAssignment->setCreativeId($values['creative_id']);
    $creativeAssignment->setClickThroughUrl($url);
    
  2. CreativeAssignment öğelerini depolayacak bir CreativeRotation nesnesi oluşturun. Rotasyon grubu oluşturuyorsanız diğer gerekli reklam öğesi rotasyon alanlarını ayarladığınızdan emin olun.
    // Create a creative rotation.
    $creativeRotation = new Google_Service_Dfareporting_CreativeRotation();
    $creativeRotation->setCreativeAssignments([$creativeAssignment]);
    
  3. Bu reklamın ilişkilendirilmesi gereken her bir yerleşim için bir PlacementAssignment nesnesi oluşturun. PlacementAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    // Create a placement assignment.
    $placementAssignment =
        new Google_Service_Dfareporting_PlacementAssignment();
    $placementAssignment->setActive(true);
    $placementAssignment->setPlacementId($values['placement_id']);
    
  4. Ad nesnesi oluşturun. CreativeRotation'ı Ad nesnesinin creativeRotation alanına, placementAssignments'ı ise Ad nesnesinin placementAssignments dizisine ayarlayın.
    // Create a delivery schedule.
    $deliverySchedule = new Google_Service_Dfareporting_DeliverySchedule();
    $deliverySchedule->setImpressionRatio(1);
    $deliverySchedule->SetPriority('AD_PRIORITY_01');
    
    $startDate = new DateTime('today');
    $endDate = new DateTime($campaign->getEndDate());
    
    // Create a rotation group.
    $ad = new Google_Service_Dfareporting_Ad();
    $ad->setActive(true);
    $ad->setCampaignId($values['campaign_id']);
    $ad->setCreativeRotation($creativeRotation);
    $ad->setDeliverySchedule($deliverySchedule);
    $ad->setStartTime($startDate->format('Y-m-d') . 'T23:59:59Z');
    $ad->setEndTime($endDate->format('Y-m-d') . 'T00:00:00Z');
    $ad->setName($values['ad_name']);
    $ad->setPlacementAssignments([$placementAssignment]);
    $ad->setType('AD_SERVING_STANDARD_AD');
    
  5. ads.insert() numaralı telefonu arayarak reklamı kaydedin.
    $result = $this->service->ads->insert($values['user_profile_id'], $ad);
    

Python

  1. Bu reklamın ilişkilendirilmesi gereken her bir reklam öğesi için bir CreativeAssignment nesnesi oluşturun. CreativeAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    # Construct creative assignment.
    creative_assignment = {
        'active': 'true',
        'creativeId': creative_id,
        'clickThroughUrl': {
            'defaultLandingPage': 'true'
        }
    }
    
  2. CreativeAssignment öğelerini depolayacak bir CreativeRotation nesnesi oluşturun. Rotasyon grubu oluşturuyorsanız diğer gerekli reklam öğesi rotasyon alanlarını ayarladığınızdan emin olun.
    # Construct creative rotation.
    creative_rotation = {
        'creativeAssignments': [creative_assignment],
        'type': 'CREATIVE_ROTATION_TYPE_RANDOM',
        'weightCalculationStrategy': 'WEIGHT_STRATEGY_OPTIMIZED'
    }
    
  3. Bu reklamın ilişkilendirilmesi gereken her bir yerleşim için bir PlacementAssignment nesnesi oluşturun. PlacementAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    # Construct placement assignment.
    placement_assignment = {
        'active': 'true',
        'placementId': placement_id,
    }
    
  4. Ad nesnesi oluşturun. CreativeRotation'ı Ad nesnesinin creativeRotation alanına, placementAssignments'ı ise Ad nesnesinin placementAssignments dizisine ayarlayın.
    # Construct delivery schedule.
    delivery_schedule = {
        'impressionRatio': '1',
        'priority': 'AD_PRIORITY_01'
    }
    
    # Construct and save ad.
    ad = {
        'active': 'true',
        'campaignId': campaign_id,
        'creativeRotation': creative_rotation,
        'deliverySchedule': delivery_schedule,
        'endTime': '%sT00:00:00Z' % campaign['endDate'],
        'name': 'Test Rotation Group',
        'placementAssignments': [placement_assignment],
        'startTime': '%sT23:59:59Z' % time.strftime('%Y-%m-%d'),
        'type': 'AD_SERVING_STANDARD_AD'
    }
    
  5. ads.insert() numaralı telefonu arayarak reklamı kaydedin.
    request = service.ads().insert(profileId=profile_id, body=ad)
    
    # Execute request and print response.
    response = request.execute()
    

Ruby

  1. Bu reklamın ilişkilendirilmesi gereken her bir reklam öğesi için bir CreativeAssignment nesnesi oluşturun. CreativeAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    # Construct creative assignment.
    creative_assignment =
      DfareportingUtils::API_NAMESPACE::CreativeAssignment.new(
        active: true,
        creative_id: creative_id,
        click_through_url: DfareportingUtils::API_NAMESPACE::ClickThroughUrl.new(
          default_landing_page: true
        )
      )
    
  2. CreativeAssignment öğelerini depolayacak bir CreativeRotation nesnesi oluşturun. Rotasyon grubu oluşturuyorsanız diğer gerekli reklam öğesi rotasyon alanlarını ayarladığınızdan emin olun.
    # Construct creative rotation.
    creative_rotation = DfareportingUtils::API_NAMESPACE::CreativeRotation.new(
      creative_assignments: [creative_assignment],
      type: 'CREATIVE_ROTATION_TYPE_RANDOM',
      weight_calculation_strategy: 'WEIGHT_STRATEGY_OPTIMIZED'
    )
    
  3. Bu reklamın ilişkilendirilmesi gereken her bir yerleşim için bir PlacementAssignment nesnesi oluşturun. PlacementAssignment.active alanını doğru değerine ayarladığınızdan emin olun.
    # Construct placement assignment.
    placement_assignment =
      DfareportingUtils::API_NAMESPACE::PlacementAssignment.new(
        active: true,
        placement_id: placement_id
      )
    
  4. Ad nesnesi oluşturun. CreativeRotation'ı Ad nesnesinin creativeRotation alanına, placementAssignments'ı ise Ad nesnesinin placementAssignments dizisine ayarlayın.
    # Construct delivery schedule.
    delivery_schedule = DfareportingUtils::API_NAMESPACE::DeliverySchedule.new(
      impression_ratio: 1,
      priority: 'AD_PRIORITY_01'
    )
    
    # Construct and save ad.
    ad = DfareportingUtils::API_NAMESPACE::Ad.new(
      active: true,
      campaign_id: campaign_id,
      creative_rotation: creative_rotation,
      delivery_schedule: delivery_schedule,
      end_time: format('%sT00:00:00Z', campaign.end_date),
      name: 'Example Rotation Group',
      placement_assignments: [placement_assignment],
      start_time: format('%sT23:59:59Z', Time.now.strftime('%Y-%m-%d')),
      type: 'AD_SERVING_STANDARD_AD'
    )
    
  5. ads.insert() numaralı telefonu arayarak reklamı kaydedin.
    result = service.insert_ad(profile_id, ad)
    

Dolaylı olarak

C#

  1. Placement oluşturup kaydedin.
  2. Creative oluşturup kaydedin.
  3. campaignCreativeAssociations.insert() öğesini çağırarak Creative öğesini Placement için kullanılan Campaign ile ilişkilendirin (Reklam öğesi oluşturma bölümündeki 4. adıma bakın). Bu işlem, hem reklam öğesi hem de yerleşimle ilişkilendirilen bir varsayılan reklam oluşturur.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.CreativeId = creativeId;
    
    // Insert the association.
    CampaignCreativeAssociation result =
        service.CampaignCreativeAssociations.Insert(association, profileId, campaignId).Execute();
    

Java

  1. Placement oluşturup kaydedin.
  2. Creative oluşturup kaydedin.
  3. campaignCreativeAssociations.insert() öğesini çağırarak Creative öğesini Placement için kullanılan Campaign ile ilişkilendirin (Reklam öğesi oluşturma bölümündeki 4. adıma bakın). Bu işlem, hem reklam öğesi hem de yerleşimle ilişkilendirilen bir varsayılan reklam oluşturur.
    // Create the campaign creative association structure.
    CampaignCreativeAssociation association = new CampaignCreativeAssociation();
    association.setCreativeId(creativeId);
    
    // Insert the association.
    CampaignCreativeAssociation result = reporting
        .campaignCreativeAssociations().insert(profileId, campaignId, association)
        .execute();
    

PHP

  1. Placement oluşturup kaydedin.
  2. Creative oluşturup kaydedin.
  3. campaignCreativeAssociations.insert() öğesini çağırarak Creative öğesini Placement için kullanılan Campaign ile ilişkilendirin (Reklam öğesi oluşturma bölümündeki 4. adıma bakın). Bu işlem, hem reklam öğesi hem de yerleşimle ilişkilendirilen bir varsayılan reklam oluşturur.
    $association =
        new Google_Service_Dfareporting_CampaignCreativeAssociation();
    $association->setCreativeId($values['creative_id']);
    
    $result = $this->service->campaignCreativeAssociations->insert(
        $values['user_profile_id'],
        $values['campaign_id'],
        $association
    );
    

Python

  1. Placement oluşturup kaydedin.
  2. Creative oluşturup kaydedin.
  3. campaignCreativeAssociations.insert() öğesini çağırarak Creative öğesini Placement için kullanılan Campaign ile ilişkilendirin (Reklam öğesi oluşturma bölümündeki 4. adıma bakın). Bu işlem, hem reklam öğesi hem de yerleşimle ilişkilendirilen bir varsayılan reklam oluşturur.
    # Construct the request.
    association = {
        'creativeId': creative_id
    }
    
    request = service.campaignCreativeAssociations().insert(
        profileId=profile_id, campaignId=campaign_id, body=association)
    
    # Execute request and print response.
    response = request.execute()
    

Ruby

  1. Placement oluşturup kaydedin.
  2. Creative oluşturup kaydedin.
  3. campaignCreativeAssociations.insert() öğesini çağırarak Creative öğesini Placement için kullanılan Campaign ile ilişkilendirin (Reklam öğesi oluşturma bölümündeki 4. adıma bakın). Bu işlem, hem reklam öğesi hem de yerleşimle ilişkilendirilen bir varsayılan reklam oluşturur.
    # Create a new creative-campaign association to insert
    association =
      DfareportingUtils::API_NAMESPACE::CampaignCreativeAssociation.new(
        creative_id: creative_id
      )
    
    # Insert the advertiser group.
    result = service.insert_campaign_creative_association(profile_id, campaign_id,
      association)
    

Dolaylı olarak reklam oluşturmak, Ad oluşturma işlemindeki fazladan adımı kaydeder. Bu işlemin, yalnızca belirtilen boyutta varsayılan reklam kampanyanızda halihazırda mevcut olmaması durumunda yapılabileceğini unutmayın.

Nesne arama

Bulunacak nesneyi tanımlayan hizmet tarafından sunulan list() işlemini çağırıp söz konusu nesne türüne uygun isteğe bağlı ölçütler belirterek nesneleri arayabilirsiniz. Bu nedenle, örneğin reklam nesnelerini aramak için ads.list() yöntemini çağırırsınız. İsteğe bağlı ölçütler, söz konusu nesne için uygun bir özellik grubunu ortaya çıkarır; arama yapmak istediğiniz kadar çok özellik girebilirsiniz. Arama yalnızca ölçütlerinizin tümünü karşılayan nesneleri döndürür; herhangi bir ölçütle eşleşen bir arama yapamazsınız. Dizeler * joker karakterini destekler, büyük/küçük harfe duyarlı değildir ve daha büyük dizelerle eşleşir.

Performansı artırmak için fields parametresi kullanılarak kısmi yanıtlar istenebilir. Bu, sunucuya tam kaynak gösterimi yerine yalnızca belirttiğiniz alanları döndürme talimatı verir. Bu konu hakkında daha fazla bilgiyi Performans İpuçları kılavuzunda bulabilirsiniz.

Sayfalama

Bazen bir list() isteği için tüm sonuçların alınması istenmeyebilir. Örneğin, binlerce kullanıcıdan oluşan bir havuzdaki en yeni 10 Reklam ilginizi çekebilir. Bu konuda yardımcı olmak için birçok list() yöntemi, sayfalara ayırma olarak bilinen bir işlem aracılığıyla daha az sonuç istemenize olanak tanır.

Sayfalara ayırmayı destekleyen yöntemler, sayfalar adı verilen gruplardaki sonuç alt kümelerini döndürür. Sayfa başına maksimum sonuç sayısı 1.000'dir (varsayılan). maxResults ayarını yaparak sayfa başına sonuç sayısını değiştirebilir ve yanıtta döndürülen nextPageToken öğesini kullanarak sayfalar arasında yineleme yapabilirsiniz:

C#

// Limit the fields returned.
String fields = "nextPageToken,ads(advertiserId,id,name)";

AdsListResponse result;
String nextPageToken = null;

do {
  // Create and execute the ad list request.
  AdsResource.ListRequest request = service.Ads.List(profileId);
  request.Active = true;
  request.Fields = fields;
  request.PageToken = nextPageToken;
  result = request.Execute();

  foreach (Ad ad in result.Ads) {
    Console.WriteLine(
        "Ad with ID {0} and name \"{1}\" is associated with advertiser" +
        " ID {2}.", ad.Id, ad.Name, ad.AdvertiserId);
  }

  // Update the next page token.
  nextPageToken = result.NextPageToken;
} while (result.Ads.Any() && !String.IsNullOrEmpty(nextPageToken));

Java

// Limit the fields returned.
String fields = "nextPageToken,ads(advertiserId,id,name)";

AdsListResponse result;
String nextPageToken = null;

do {
  // Create and execute the ad list request.
  result = reporting.ads().list(profileId).setActive(true).setFields(fields)
      .setPageToken(nextPageToken).execute();

  for (Ad ad : result.getAds()) {
    System.out.printf(
        "Ad with ID %d and name \"%s\" is associated with advertiser ID %d.%n", ad.getId(),
        ad.getName(), ad.getAdvertiserId());
  }

  // Update the next page token.
  nextPageToken = result.getNextPageToken();
} while (!result.getAds().isEmpty() && !Strings.isNullOrEmpty(nextPageToken));

PHP

$response = null;
$pageToken = null;

do {
    // Create and execute the ads list request.
    $response = $this->service->ads->listAds(
        $values['user_profile_id'],
        ['active' => true, 'pageToken' => $pageToken]
    );

    foreach ($response->getAds() as $ads) {
        $this->printResultsTableRow($ads);
    }

    // Update the next page token.
    $pageToken = $response->getNextPageToken();
} while (!empty($response->getAds()) && !empty($pageToken));

Python

# Construct the request.
request = service.ads().list(profileId=profile_id, active=True)

while True:
  # Execute request and print response.
  response = request.execute()

  for ad in response['ads']:
    print 'Found ad with ID %s and name "%s".' % (ad['id'], ad['name'])

  if response['ads'] and response['nextPageToken']:
    request = service.ads().list_next(request, response)
  else:
    break

Ruby

token = nil
loop do
  result = service.list_ads(profile_id,
    page_token: token,
    fields: 'nextPageToken,ads(id,name)')

  # Display results.
  if result.ads.any?
    result.ads.each do |ad|
      puts format('Found ad with ID %d and name "%s".', ad.id, ad.name)
    end

    token = result.next_page_token
  else
    # Stop paging if there are no more results.
    token = nil
  end

  break if token.to_s.empty?
end

Floodlight etiketleri oluşturma

Floodlight etiketleri, bir sayfaya yerleştirilen HTML etiketleridir ve bir sitedeki kullanıcı işlemlerini (ör. satın alma işlemleri) izlemek için kullanılır. Floodlight etiketleri oluşturmak için bir FloodlightActivity öğesine ihtiyacınız vardır şuna ait: FloodlightActivityGroup

C#

  1. name, type ve floodlightConfigurationId değerlerini ileten yeni bir Floodlight etkinlik grubu oluşturun.
    // Create the floodlight activity group.
    FloodlightActivityGroup floodlightActivityGroup = new FloodlightActivityGroup();
    floodlightActivityGroup.Name = groupName;
    floodlightActivityGroup.FloodlightConfigurationId = floodlightConfigurationId;
    floodlightActivityGroup.Type = "COUNTER";
    
  2. floodlightActivityGroups.insert() öğesini çağırarak Floodlight etkinlik grubunu kaydedin. Bu çağrı, yeni grubun kimliğini döndürür.
    // Insert the activity group.
    FloodlightActivityGroup result =
        service.FloodlightActivityGroups.Insert(floodlightActivityGroup, profileId).Execute();
    
  3. Yeni Floodlight etkinliği oluşturun ve bu etkinliğe, az önce oluşturduğunuz Floodlight etkinlik grubunun kimliğini ve diğer tüm zorunlu alanları atayın.
    // Set floodlight activity structure.
    FloodlightActivity activity = new FloodlightActivity();
    activity.CountingMethod = "STANDARD_COUNTING";
    activity.Name = activityName;
    activity.FloodlightActivityGroupId = activityGroupId;
    activity.FloodlightTagType = "GLOBAL_SITE_TAG";
    activity.ExpectedUrl = url;
    
  4. floodlightActivities.insert() numaralı telefonu arayarak yeni etkinliği kaydedin. Bu çağrı, yeni etkinliğin kimliğini döndürür.
    // Create the floodlight tag activity.
    FloodlightActivity result =
        service.FloodlightActivities.Insert(activity, profileId).Execute();
    
  5. Yeni etkinliğinizin floodlightActivityId ile floodlightActivities.generatetag() öğesini çağırarak etiketleri oluşturun. Etiketleri, reklamverenin web sitesindeki web yöneticisine gönderin.
    // Generate the floodlight activity tag.
    FloodlightActivitiesResource.GeneratetagRequest request =
        service.FloodlightActivities.Generatetag(profileId);
    request.FloodlightActivityId = activityId;
    
    FloodlightActivitiesGenerateTagResponse response = request.Execute();
    

Java

  1. name, type ve floodlightConfigurationId değerlerini ileten yeni bir Floodlight etkinlik grubu oluşturun.
    // Create the floodlight activity group.
    FloodlightActivityGroup floodlightActivityGroup = new FloodlightActivityGroup();
    floodlightActivityGroup.setName(groupName);
    floodlightActivityGroup.setFloodlightConfigurationId(floodlightConfigurationId);
    floodlightActivityGroup.setType("COUNTER");
    
  2. floodlightActivityGroups.insert() öğesini çağırarak Floodlight etkinlik grubunu kaydedin. Bu çağrı, yeni grubun kimliğini döndürür.
    // Insert the activity group.
    FloodlightActivityGroup result =
        reporting.floodlightActivityGroups().insert(profileId, floodlightActivityGroup).execute();
    
  3. Yeni Floodlight etkinliği oluşturun ve bu etkinliğe, az önce oluşturduğunuz Floodlight etkinlik grubunun kimliğini ve diğer tüm zorunlu alanları atayın.
    // Set floodlight activity structure.
    FloodlightActivity activity = new FloodlightActivity();
    activity.setName(activityName);
    activity.setCountingMethod("STANDARD_COUNTING");
    activity.setExpectedUrl(url);
    activity.setFloodlightActivityGroupId(activityGroupId);
    activity.setFloodlightTagType("GLOBAL_SITE_TAG");
    
  4. floodlightActivities.insert() numaralı telefonu arayarak yeni etkinliği kaydedin. Bu çağrı, yeni etkinliğin kimliğini döndürür.
    // Create the floodlight tag activity.
    FloodlightActivity result =
        reporting.floodlightActivities().insert(profileId, activity).execute();
    
  5. Yeni etkinliğinizin floodlightActivityId ile floodlightActivities.generatetag() öğesini çağırarak etiketleri oluşturun. Etiketleri, reklamverenin web sitesindeki web yöneticisine gönderin.
    // Generate the floodlight activity tag.
    Generatetag request = reporting.floodlightActivities().generatetag(profileId);
    request.setFloodlightActivityId(activityId);
    
    FloodlightActivitiesGenerateTagResponse response = request.execute();
    

PHP

  1. name, type ve floodlightConfigurationId değerlerini ileten yeni bir Floodlight etkinlik grubu oluşturun.
    $group = new Google_Service_Dfareporting_FloodlightActivityGroup();
    $group->setFloodlightConfigurationId($values['configuration_id']);
    $group->setName($values['group_name']);
    $group->setType('COUNTER');
    
  2. floodlightActivityGroups.insert() öğesini çağırarak Floodlight etkinlik grubunu kaydedin. Bu çağrı, yeni grubun kimliğini döndürür.
    $result = $this->service->floodlightActivityGroups->insert(
        $values['user_profile_id'],
        $group
    );
    
  3. Yeni Floodlight etkinliği oluşturun ve bu etkinliğe, az önce oluşturduğunuz Floodlight etkinlik grubunun kimliğini ve diğer tüm zorunlu alanları atayın.
    $activity = new Google_Service_Dfareporting_FloodlightActivity();
    $activity->setCountingMethod('STANDARD_COUNTING');
    $activity->setExpectedUrl($values['url']);
    $activity->setFloodlightActivityGroupId($values['activity_group_id']);
    $activity->setFloodlightTagType('GLOBAL_SITE_TAG');
    $activity->setName($values['activity_name']);
    
  4. floodlightActivities.insert() numaralı telefonu arayarak yeni etkinliği kaydedin. Bu çağrı, yeni etkinliğin kimliğini döndürür.
    $result = $this->service->floodlightActivities->insert(
        $values['user_profile_id'],
        $activity
    );
    
  5. Yeni etkinliğinizin floodlightActivityId ile floodlightActivities.generatetag() öğesini çağırarak etiketleri oluşturun. Etiketleri, reklamverenin web sitesindeki web yöneticisine gönderin.
    $result = $this->service->floodlightActivities->generatetag(
        $values['user_profile_id'],
        ['floodlightActivityId' => $values['activity_id']]
    );
    

Python

  1. name, type ve floodlightConfigurationId değerlerini ileten yeni bir Floodlight etkinlik grubu oluşturun.
    # Construct and save floodlight activity group.
    activity_group = {
        'name': 'Test Floodlight Activity Group',
        'floodlightConfigurationId': floodlight_config_id,
        'type': 'COUNTER'
    }
    
  2. floodlightActivityGroups.insert() öğesini çağırarak Floodlight etkinlik grubunu kaydedin. Bu çağrı, yeni grubun kimliğini döndürür.
    request = service.floodlightActivityGroups().insert(
        profileId=profile_id, body=activity_group)
    
  3. Yeni Floodlight etkinliği oluşturun ve bu etkinliğe, az önce oluşturduğunuz Floodlight etkinlik grubunun kimliğini ve diğer tüm zorunlu alanları atayın.
    # Construct and save floodlight activity.
    floodlight_activity = {
        'countingMethod': 'STANDARD_COUNTING',
        'expectedUrl': 'http://www.google.com',
        'floodlightActivityGroupId': activity_group_id,
        'floodlightTagType': 'GLOBAL_SITE_TAG',
        'name': 'Test Floodlight Activity'
    }
    
  4. floodlightActivities.insert() numaralı telefonu arayarak yeni etkinliği kaydedin. Bu çağrı, yeni etkinliğin kimliğini döndürür.
    request = service.floodlightActivities().insert(
        profileId=profile_id, body=floodlight_activity)
    
  5. Yeni etkinliğinizin floodlightActivityId ile floodlightActivities.generatetag() öğesini çağırarak etiketleri oluşturun. Etiketleri, reklamverenin web sitesindeki web yöneticisine gönderin.
    # Construct the request.
    request = service.floodlightActivities().generatetag(
        profileId=profile_id, floodlightActivityId=activity_id)
    
    # Execute request and print response.
    response = request.execute()
    

Ruby

  1. name, type ve floodlightConfigurationId değerlerini ileten yeni bir Floodlight etkinlik grubu oluşturun.
    # Create a new floodlight activity group resource to insert.
    activity_group =
      DfareportingUtils::API_NAMESPACE::FloodlightActivityGroup.new(
        floodlight_configuration_id: floodlight_config_id,
        name:
          format('Example Floodlight Activity Group #%s', SecureRandom.hex(3)),
        type: 'COUNTER'
      )
    
  2. floodlightActivityGroups.insert() öğesini çağırarak Floodlight etkinlik grubunu kaydedin. Bu çağrı, yeni grubun kimliğini döndürür.
    # Insert the floodlight activity group.
    result = service.insert_floodlight_activity_group(profile_id, activity_group)
    
  3. Yeni Floodlight etkinliği oluşturun ve bu etkinliğe, az önce oluşturduğunuz Floodlight etkinlik grubunun kimliğini ve diğer tüm zorunlu alanları atayın.
    # Create a new floodlight activity resource to insert.
    activity = DfareportingUtils::API_NAMESPACE::FloodlightActivity.new(
      counting_method: 'STANDARD_COUNTING',
      expected_url: 'http://www.google.com',
      floodlight_activity_group_id: activity_group_id,
      floodlight_tag_type: 'GLOBAL_SITE_TAG',
      name: format('Example Floodlight Activity #%s', SecureRandom.hex(3))
    )
    
  4. floodlightActivities.insert() numaralı telefonu arayarak yeni etkinliği kaydedin. Bu çağrı, yeni etkinliğin kimliğini döndürür.
    # Insert the floodlight activity.
    result = service.insert_floodlight_activity(profile_id, activity)
    
  5. Yeni etkinliğinizin floodlightActivityId ile floodlightActivities.generatetag() öğesini çağırarak etiketleri oluşturun. Etiketleri, reklamverenin web sitesindeki web yöneticisine gönderin.
    # Construct the request.
    result = service.generatetag_floodlight_activity(profile_id,
      floodlight_activity_id: activity_id)
    

Yerleşim etiketleri oluşturma

Son adım, reklamlarınızı görüntülemek üzere yayıncıya gönderilecek HTML etiketlerini oluşturmaktır. Etiketleri API aracılığıyla oluşturmak için bir placementIds ve tagFormats grubu belirterek placements.generatetags() öğesine bir istek gönderin.

C#

// Generate the placement activity tags.
PlacementsResource.GeneratetagsRequest request =
    service.Placements.Generatetags(profileId);
request.CampaignId = campaignId;
request.TagFormats =
    PlacementsResource.GeneratetagsRequest.TagFormatsEnum.PLACEMENTTAGIFRAMEJAVASCRIPT;
request.PlacementIds = placementId.ToString();

PlacementsGenerateTagsResponse response = request.Execute();

Java

// Generate the placement activity tags.
Generatetags request = reporting.placements().generatetags(profileId);
request.setCampaignId(campaignId);
request.setTagFormats(tagFormats);
request.setPlacementIds(ImmutableList.of(placementId));

PlacementsGenerateTagsResponse response = request.execute();

PHP

$placementTags = $this->service->placements->generatetags(
    $values['user_profile_id'],
    ['campaignId' => $values['campaign_id'],
     'placementIds' => [$values['placement_id']],
     'tagFormats' => ['PLACEMENT_TAG_STANDARD',
                      'PLACEMENT_TAG_IFRAME_JAVASCRIPT',
                      'PLACEMENT_TAG_INTERNAL_REDIRECT']
    ]
);

Python

# Construct the request.
request = service.placements().generatetags(
    profileId=profile_id, campaignId=campaign_id,
    placementIds=[placement_id])

# Execute request and print response.
response = request.execute()

Ruby

# Construct the request.
result = service.generate_placement_tags(profile_id,
  campaign_id: campaign_id,
  placement_ids: [placement_id])