Imagine for a moment that you're a mobile line item. You've just been initialized locally, and all of a sudden you’re having an existential crisis -- what makes you, you? How are you different from all the other line items? Sure your associated creative might be a bit different from other line items and you might have a few extra impressions allotted to your goal, but what truly makes you... unique? In this series of posts, we'll take you on an incredible journey through a day in the life of a mobile line item -- from how to target mobile to the actual delivery on a device.
It all starts similarly enough: you need a name, an order ID, start and end dates, a goal, and all the usual suspects -- but wait, there's more! Instead of just having custom criteria, ad units, and geo-targeting, you find that you also have TechnologyTargeting fields specified, like:
Now, say you're being created as a line item to advertise Android tablet cases. It doesn't make much sense for you to be delivered to an iPad or an iPhone, so we need to add technology specific targeting.
To do so using Java, we would first set the DeviceCategory object with the targeting ID of the 'Tablet' category and the OperatingSystem object with the targeting ID of 'Android', both of which we'd pull from the PublisherQueryLanguage service:
DeviceCategory deviceCategory = new DeviceCategory(); OperatingSystem operatingSystem = new OperatingSystem(); deviceCategory.setId(30002L); operatingSystem.setId(501013L);
These would then be set on the DeviceCategoryTargeting and OperatingSystemTargeting objects:
DeviceCategoryTargeting deviceCategoryTargeting = new DeviceCategoryTargeting(); OperatingSystemTargeting operatingSystemTargeting = new OperatingSystemTargeting(); deviceCategoryTargeting.setTargetedDeviceCategories(new DeviceCategory[] {deviceCategory}); operatingSystemTargeting.setOperatingSystems(new OperatingSystem[] {operatingSystem});
Finally, the Targeting object will have a TechnologyTargeting object set for DeviceCategoryTargeting and also OperatingSystemTargeting:
TechnologyTargeting techTargeting = new TechnologyTargeting(); technologyTargeting.setDeviceCategoryTargeting(deviceCategoryTargeting); technologyTargeting.setOperatingSystemTargeting(operatingSystemTargeting); Targeting targeting = new Targeting(); targeting.setTechnologyTargeting(techTargeting);
Now what happens? You're a line item that has a bit of technology targeting specified, but where are you off to next? Stay tuned for what happens next in - 'A day in the life of a mobile line item, part 2.'
- Nicholas Chen, DFP API Team
ParentIds
// Get the LineItemService. $lineItemService = $user->GetService('LineItemService', 'v201201'); // Calculate time from thirty days ago. $thirtyDaysAgo = date(DateTimeUtils::$DFP_DATE_TIME_STRING_FORMAT, strtotime('-30 day')); // Create bind variables. $vars = MapUtils::GetMapEntries(array( 'thirtyDaysAgo' => new TextValue($thirtyDaysAgo))); // Create statement object to only select line items that // have been modified in the last 30 days. $filterStatement = new Statement( "WHERE lastModifiedDateTime >= :thirtyDaysAgo " . "LIMIT 500", $vars); // Get line items by statement. $page = $lineItemService->getLineItemsByStatement($filterStatement);
Long orderId = Long.parseLong("INSERT_ORDER_ID_HERE"); // Create statement to filter for an order. Statement filterStatement = new StatementBuilder( "WHERE ORDER_ID = :id").putValue("id", orderId).toStatement(); // Create report job. ReportJob reportJob = new ReportJob(); // Create report query. ReportQuery reportQuery = new ReportQuery(); reportQuery.setStatement(filterStatement); reportQuery.setDateRangeType(DateRangeType.LAST_MONTH); reportQuery.setDimensions(new Dimension[] {Dimension.LINE_ITEM}); reportQuery.setDimensionAttributes(new DimensionAttribute[] { DimensionAttribute.ORDER_TRAFFICKER}); reportQuery.setColumns( new Column[] {Column.AD_SERVER_IMPRESSIONS, Column.AD_SERVER_REVENUE}); reportJob.setReportQuery(reportQuery);
