Display & Video 360 API kullanılarak oluşturulan tüm satır öğeleri başlangıçta taslak durumunda oluşturulur. Bu taslak durumunda, satır öğeleri reklam yayınlamaz. Bu nedenle, mevcut reklam yayınını etkileyen değişiklikler olmadan ayarları ve hedeflemeyi düzenleyebilirsiniz. Bu sayfada, satır öğenizin reklam yayınlamaya hazır olduğunu onaylamak için izlemeniz gereken adımlar ve durumunu etkin olarak nasıl güncelleyeceğiniz açıklanmaktadır.
Etkinleştirmeden önce yapılması gerekenler
Satır öğelerinin reklam gelirinizin reklam satın alma ve sunma yoluyla harcanma şekli olduğu düşünüldüğünde, satır öğesinin etkinleştirildiğinde reklamları amaçlandığı şekilde sunduğundan emin olmak önemlidir. Aşağıda, satır öğenizi etkinleştirmeden önce göz önünde bulundurmanız gereken birkaç nokta verilmiştir:
- Yayın ayarlarının doğru olduğundan emin olun: Satır öğesi için yayın aralığının doğru ayarlandığından emin olmak için satır öğesinin
flight
alanını kontrol edin. Bir satır öğesinin yayın aralığı, satır öğesine özel olabilir veya üst kampanya siparişi tarafından devralınabilir. - Satır öğesinin yayınlanmasını engelleyen herhangi bir uyarı olmadığını doğrulayın:
Bir satır öğesi kaynağı almak için
advertisers.lineItems.get
öğesini kullanın ve satır öğesinde, satır öğesinin yayınlanmasını engelleyebilecek herhangi bir uyarı olmadığını doğrulamak içinwarningMessages
alanını kontrol edin.LineItemWarningMessage
sıralamasında her bir uyarının etkisi belirtilir. - Tüm üst kaynakların da etkin olduğunu onaylayın: Etkin bir satır öğesi, üst reklamvereni, kampanyası veya kampanya siparişi etkin değilse reklam yayınlamaya başlamaz. Reklamverenler, Kampanyalar ve Kampanya Siparişleri hizmetlerindeki
GET
yöntemlerini kullanarak bu kaynakları alın.
Satır öğesini etkinleştirme
Bir satır öğesinin entityStatus
alanını ENTITY_STATUS_ACTIVE
olarak güncelleyerek satır öğesini etkinleştirin. Bu alanı, advertisers.lineItems.patch
yöntemini kullanarak tek bir satır öğesi için, advertisers.lineItems.bulkUpdate
yöntemini kullanarak ise belirli bir reklamverendeki birden fazla satır öğesi için güncelleyebilirsiniz.
Aşağıda, birden fazla satır öğesini etkinleştirmek için bulkUpdate
'in nasıl kullanılacağına dair bir örnek verilmiştir:
Java
// Create the line item structure. LineItem targetLineItem = new LineItem(); targetLineItem.setEntityStatus("ENTITY_STATUS_ACTIVE"); // Create the bulk update request body. BulkUpdateLineItemsRequest requestBody = new BulkUpdateLineItemsRequest(); requestBody.setLineItemIds(line-item-ids); requestBody.setTargetLineItem(targetLineItem); requestBody.setUpdateMask("entityStatus"); // Configure the bulk update request. LineItems.BulkUpdate request = service.advertisers().lineItems() .bulkUpdate(advertiser-id, requestBody); // Update the line items. BulkUpdateLineItemsResponse response = request.execute(); // Display the line items that were updated, failed, and skipped. if (response.getUpdatedLineItemIds() != null) { System.out.printf( "The following line item IDs were successfully updated: %s.\n", Arrays.toString(response.getUpdatedLineItemIds().toArray())); } if (response.getFailedLineItemIds() != null) { System.out.printf("The following line item IDs failed to update: %s.\n", Arrays.toString(response.getFailedLineItemIds().toArray())); if (response.getErrors() != null) { System.out.printf( "The failed updates were caused by the following errors: %s.\n", Arrays.toString(response.getErrors().toArray())); } } if (response.getSkippedLineItemIds() != null) { System.out.printf( "The following line items IDs were skipped in the update: %s.\n", Arrays.toString(response.getSkippedLineItemIds().toArray())); }
Python
# Create a line item object with only updated entity status. line_item_obj = { 'entityStatus': 'ENTITY_STATUS_ACTIVE' } # Build the bulk update request. bulk_update_request = { 'lineItemIds': line-item-ids, 'targetLineItem': line_item_obj, 'updateMask': "entityStatus" } # Update the line items. response = service.advertisers().lineItems().bulkUpdate( advertiserId=advertiser-id, body=bulk_update_request ).execute() # Display the line items that were updated, failed, and skipped. if 'updatedLineItemIds' in response: print("The following line item IDs were updated: %s" % response['updatedLineItemIds']) if 'failedLineItemIds' in response: print("The following line item IDs failed to update: %s" % response['failedLineItemIds']) if 'errors' in response: print("The failed updates were caused by the following errors:") for error in response["errors"]: print("Error code: %s, Message: %s" % (error["code"], error["message"])) if 'skippedLineItemIds' in response: print("The following line items IDs were skipped in the update:: %s" % response['skippedLineItemIds'])
PHP
// Create request body. $body = new Google_Service_DisplayVideo_BulkUpdateLineItemsRequest(); $body->setLineItemIds(line-item-ids); // Create target line item with updated fields. $lineItem = new Google_Service_DisplayVideo_LineItem(); $lineItem->setEntityStatus('ENTITY_STATUS_ACTIVE'); $body->setTargetLineItem($lineItem); // Set update mask in request body. $body->setUpdateMask("entityStatus"); // Call the API, updating the entity status for the identified line item. $response = $service->advertisers_lineItems->bulkUpdate( advertiser-id, $body ); // Display the line items that were updated, failed, and skipped. if (!empty($response->getUpdatedLineItemIds())) { printf('The following line item IDs were updated:\n'); foreach ($response->getUpdatedLineItemIds() as $id) { printf('%s\n', $id); } } if (!empty($response->getFailedLineItemIds())) { print('The following line item IDs failed to update:\n'); foreach ($response->getFailedLineItemIds() as $id) { printf('%s\n', $id); } if (!empty($response->getErrors())) { print('The failed updates were caused by the following errors:\n'); foreach ($response->getErrors() as $error) { printf( 'Error Code: %s, Message: %s\n', $error->getCode(), $error->getMessage() ); } } } if (!empty($response->getSkippedLineItemIds())) { print('The following line item IDs were skipped in the update:\n'); foreach ($response->getSkippedLineItemIds() as $id) { printf('%s\n', $id); } }