Satır Öğesini Etkinleştir

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çin warningMessages 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.

Uyarı: Aynı satır öğelerini veya hedeflemelerini güncelleyen diğer isteklerle eş zamanlı olarak patch veya bulkUpdate isteğinde bulunmayın.

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