Satır Öğesini Etkinleştir

Display & Video 360 API kullanılarak oluşturulan tüm satır öğeleri başlangıçta taslak durumda oluşturulur. Bu taslak durumunda satır öğeleri reklam yayınlamaz. Bu nedenle, mevcut reklam yayınını etkilemeden ayarları ve hedeflemeyi düzenleyebilirsiniz. Bu sayfada, satır öğenizin reklam yayınlamaya hazır olduğunu onaylamak için uygulamanız gereken adımlar ve durumunu etkin olarak nasıl güncelleyeceğiniz açıklanmaktadır.

Etkinleştirmeden önce yapılması gerekenler

Satır öğeleri, reklam gelirinizin reklam satın alma ve yayınlama yoluyla harcanma şekli olduğundan, satır öğesinin etkinleştirildiğinde reklamları amaçlandığı şekilde yayınladığından emin olmak önemlidir. Satır öğenizi etkinleştirmeden önce göz önünde bulundurmanız gereken birkaç nokta aşağıda belirtilmiştir:

• Yayın ayarlarının doğru olduğundan emin olun: Satır öğesinin 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 uyarı olmadığından emin olun: Bir satır öğesi kaynağı almak için advertisers.lineItems.get'ı kullanın ve satır öğesinin yayınlanmasını engelleyebilecek uyarı olmadığından emin olmak için warningMessages alanını kontrol edin. LineItemWarningMessage enum, her bir uyarının etkisini belirtir.
• Tüm üst öğe kaynaklarını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 Giriş Siparişleri hizmetlerindeki GET yöntemleri kullanarak bu kaynakları alın.

Satır öğesini etkinleştirme

entityStatus alanını ENTITY_STATUS_ACTIVE olarak güncelleyerek bir satır öğesini etkinleştirin. Bu alanı advertisers.lineItems.patch yöntemini kullanarak tek bir satır öğesi için ve advertisers.lineItems.bulkUpdate yöntemini kullanarak belirli bir reklamverenin 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 istekleri göndermeyin.

Birden fazla satır öğesini etkinleştirmek için bulkUpdate işlevinin nasıl kullanılacağına dair bir örnek aşağıda 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);
    }
}