コード例 #1
0
        /// <summary>
        /// Run the code example.
        /// </summary>
        /// <param name="user">The DFP user object running the code example.</param>
        public override void Run(DfpUser user)
        {
            // Get the LineItemService.
              LineItemService lineItemService = (LineItemService) user.GetService(
              DfpService.v201306.LineItemService);

              // Get the CustomTargetingService.
              CustomTargetingService customTargetingService = (CustomTargetingService) user.GetService(
              DfpService.v201306.CustomTargetingService);

              long lineItemId = long.Parse(_T("INSERT_LINE_ITEM_ID_HERE"));
              long[] customCriteriaIds1 =
              new long[] {long.Parse(_T("INSERT_CUSTOM_TARGETING_KEY_ID_HERE")),
              long.Parse(_T("INSERT_CUSTOM_TARGETING_VALUE_ID_HERE"))};
              long[] customCriteriaIds2 =
            new long[] {long.Parse(_T("INSERT_CUSTOM_TARGETING_KEY_ID_HERE")),
            long.Parse(_T("INSERT_CUSTOM_TARGETING_VALUE_ID_HERE"))};
              long[] customCriteriaIds3 =
            new long[] {long.Parse(_T("INSERT_CUSTOM_TARGETING_KEY_ID_HERE")),
            long.Parse(_T("INSERT_CUSTOM_TARGETING_VALUE_ID_HERE"))};

              // Create custom criteria.
              CustomCriteria customCriteria1 = new CustomCriteria();
              customCriteria1.keyId = customCriteriaIds1[0];
              customCriteria1.valueIds = new long[] {customCriteriaIds1[1]};
              customCriteria1.@operator = CustomCriteriaComparisonOperator.IS;

              CustomCriteria customCriteria2 = new CustomCriteria();
              customCriteria2.keyId = customCriteriaIds2[0];
              customCriteria2.valueIds = new long[] {customCriteriaIds2[1]};
              customCriteria2.@operator = CustomCriteriaComparisonOperator.IS_NOT;

              CustomCriteria customCriteria3 = new CustomCriteria();
              customCriteria3.keyId = customCriteriaIds3[0];
              customCriteria3.valueIds = new long[] {customCriteriaIds3[1]};
              customCriteria3.@operator = CustomCriteriaComparisonOperator.IS;

              // Create the custom criteria set that will resemble:
              //
              // (customCriteria1.key == customCriteria1.value OR
              //     (customCriteria2.key != customCriteria2.value AND
              //         customCriteria3.key == customCriteria3.value))
              CustomCriteriaSet topCustomCriteriaSet = new CustomCriteriaSet();
              topCustomCriteriaSet.logicalOperator = CustomCriteriaSetLogicalOperator.OR;

              CustomCriteriaSet subCustomCriteriaSet = new CustomCriteriaSet();
              subCustomCriteriaSet.logicalOperator = CustomCriteriaSetLogicalOperator.AND;
              subCustomCriteriaSet.children =
             new CustomCriteriaNode[] {customCriteria2, customCriteria3};
              topCustomCriteriaSet.children =
             new CustomCriteriaNode[] {customCriteria1, subCustomCriteriaSet};

              try {
            // Set the custom criteria targeting on the line item.
            LineItem lineItem = lineItemService.getLineItem(lineItemId);
            lineItem.targeting.customTargeting = topCustomCriteriaSet;

            // Update the line items on the server.
            lineItem = lineItemService.updateLineItem(lineItem);

            // Display the updated line item.
            Console.WriteLine("Line item with ID {0} updated with custom criteria targeting \n{1}\n",
            lineItem.id, getCustomCriteriaSetString(lineItem.targeting.customTargeting, 0));
              } catch (Exception ex) {
            Console.WriteLine("Failed to add custom target criteria. Exception says \"{0}\"",
            ex.Message);
              }
        }
コード例 #2
0
    /// <summary>
    /// Run the code example.
    /// </summary>
    /// <param name="user">The DFP user object running the code example.</param>
    public override void Run(DfpUser user) {
      // Get the LineItemService.
      LineItemService lineItemService =
          (LineItemService) user.GetService(DfpService.v201306.LineItemService);

      // Set the order that all created line items will belong to and the
      // video ad unit ID to target.
      long orderId = long.Parse(_T("INSERT_ORDER_ID_HERE"));
      string targetedVideoAdUnitId = _T("INSERT_TARGETED_VIDEO_AD_UNIT_ID_HERE");

      // Set the custom targeting key ID and value ID representing the metadata
      // on the content to target. This would typically be a key representing
      // a "genre" and a value representing something like "comedy".
      long contentCustomTargetingKeyId =
          long.Parse(_T("INSERT_CONTENT_CUSTOM_TARGETING_KEY_ID_HERE"));
      long contentCustomTargetingValueId =
          long.Parse(_T("INSERT_CONTENT_CUSTOM_TARGETING_VALUE_ID_HERE"));

      // Create custom criteria for the content metadata targeting.
      CustomCriteria contentCustomCriteria = new CustomCriteria();
      contentCustomCriteria.keyId = contentCustomTargetingKeyId;
      contentCustomCriteria.valueIds = new long[] {contentCustomTargetingValueId};
      contentCustomCriteria.@operator = CustomCriteriaComparisonOperator.IS;

      // Create custom criteria set.
      CustomCriteriaSet customCriteriaSet = new CustomCriteriaSet();
      customCriteriaSet.children = new CustomCriteriaNode[] {contentCustomCriteria};

      // Create inventory targeting.
      InventoryTargeting inventoryTargeting = new InventoryTargeting();
      AdUnitTargeting adUnitTargeting = new AdUnitTargeting();
      adUnitTargeting.adUnitId = targetedVideoAdUnitId;
      adUnitTargeting.includeDescendants = true;
      inventoryTargeting.targetedAdUnits = new AdUnitTargeting[] {adUnitTargeting};

      // Create video position targeting.
      VideoPosition videoPosition = new VideoPosition();
      videoPosition.positionType = VideoPositionType.PREROLL;
      VideoPositionTarget videoPositionTarget = new VideoPositionTarget();
      videoPositionTarget.videoPosition = videoPosition;
      VideoPositionTargeting videoPositionTargeting = new VideoPositionTargeting();
      videoPositionTargeting.targetedPositions = new VideoPositionTarget[] {videoPositionTarget};

      // Create targeting.
      Targeting targeting = new Targeting();
      targeting.customTargeting = customCriteriaSet;
      targeting.inventoryTargeting = inventoryTargeting;
      targeting.videoPositionTargeting = videoPositionTargeting;

      // Create local line item object.
      LineItem lineItem = new LineItem();
      lineItem.name = "Video line item - " + this.GetTimeStamp();
      lineItem.orderId = orderId;
      lineItem.targeting = targeting;
      lineItem.lineItemType = LineItemType.SPONSORSHIP;
      lineItem.allowOverbook = true;

      // Set the environment type to video.
      lineItem.environmentType = EnvironmentType.VIDEO_PLAYER;

      // Set the creative rotation type to optimized.
      lineItem.creativeRotationType = CreativeRotationType.OPTIMIZED;

      // Create the master creative placeholder.
      CreativePlaceholder creativeMasterPlaceholder = new CreativePlaceholder();
      Size size1 = new Size();
      size1.width = 400;
      size1.height = 300;
      size1.isAspectRatio = false;
      creativeMasterPlaceholder.size = size1;

      // Create companion creative placeholders.
      CreativePlaceholder companionCreativePlaceholder1 = new CreativePlaceholder();
      Size size2 = new Size();
      size2.width = 300;
      size2.height = 250;
      size2.isAspectRatio = false;
      companionCreativePlaceholder1.size = size2;

      CreativePlaceholder companionCreativePlaceholder2 = new CreativePlaceholder();
      Size size3 = new Size();
      size3.width = 728;
      size3.height = 90;
      size3.isAspectRatio = false;
      companionCreativePlaceholder2.size = size3;

      // Set companion creative placeholders.
      creativeMasterPlaceholder.companions = new CreativePlaceholder[] {
          companionCreativePlaceholder1, companionCreativePlaceholder2};

      // Set the size of creatives that can be associated with this line item.
      lineItem.creativePlaceholders = new CreativePlaceholder[] {creativeMasterPlaceholder};

      // Set delivery of video companions to optional.
      lineItem.companionDeliveryOption = CompanionDeliveryOption.OPTIONAL;

      // Set the length of the line item to run.
      lineItem.startDateTimeType = StartDateTimeType.IMMEDIATELY;
      lineItem.endDateTime = DateTimeUtilities.FromString("20120901 00:00:00");

      // Set the cost per day to $1.
      lineItem.costType = CostType.CPD;
      Money money = new Money();
      money.currencyCode = "USD";
      money.microAmount = 1000000L;
      lineItem.costPerUnit = money;

      // Set the percentage to be 100%.
      lineItem.unitsBought = 100;

      try {
        // Create the line item on the server.
        lineItem = lineItemService.createLineItem(lineItem);

        if (lineItem != null) {
          Console.WriteLine("A line item with ID \"{0}\", belonging to order ID \"{1}\", and " +
              "named \"{2}\" was created.", lineItem.id, lineItem.orderId, lineItem.name);
        } else {
          Console.WriteLine("No line item created.");
        }
      } catch (Exception ex) {
        Console.WriteLine("Failed to create line items. Exception says \"{0}\"",
            ex.Message);
      }
    }