Satır Öğesini Etkinleştir

Görüntülü Reklam Ağı ve Video 360 API başlangıçta bir taslak halinde oluşturulur durumu. Bu taslak durumunda, satır öğeleri reklam sunmaz. Bu nedenle ayarları ve hedeflemeyi, mevcut reklamları etkilemeyecek şekilde düzenleme yardımcı olur. Bu sayfada, hattınızı doğrulamak için uygulamanız gereken adımlar açıklanmaktadır. öğesinin durumu reklam yayınlamaya hazır ve etkin olarak nasıl güncelleneceği.

Etkinleştirmeden önce yapılması gerekenler

Satır öğeleri, reklam gelirinizin reklam gelirinizin harcanma şekli olduğu düşünülürse reklam satın alma ve sunma sürecinde, satır öğesinin etkinleştirildiğinde reklamları amaçlandığı şekilde sunar. Aşağıda daha önce göz önünde bulundurmanız gereken bazı noktalar belirtilmiştir: satır öğenizi etkinleştirin:

• Yayın ayarlarının doğru olduğundan emin olun: Satır öğesinin flight alanını kullanarak uçuş aralığının satır öğesi doğru şekilde ayarlandı. Bir satır öğesinin aralıklarla reklam yayını penceresi satır öğesi olabilir veya üst kampanya siparişi tarafından devralınır.
• Satır öğesinin yayınlanmasını engelleyen bir uyarı olmadığını doğrulayın: Satır öğesi kaynağı almak için advertisers.lineItems.get simgesini kullanın ve warningMessages alanını kontrol ederek satır öğesinde, satır öğesinin yayınlanmasını engelleyebilecek uyarı yok. İlgili içeriği oluşturmak için kullanılan LineItemWarningMessage sıralaması her birinin etkisini uyarı.
• Tüm üst kaynakların da etkin olduğunu onayla: Etkin bir satır öğesi üst reklamvereni, kampanyası veya eklemesi varsa reklam yayınlamaya başlamaz etkin değil. Şu sayfadaki GET yöntemlerini kullanarak bu kaynakları alın: Reklamverenler, Kampanyalar ve Kampanya Siparişleri hizmetleri için geçerlidir.

Satır öğesini etkinleştirme

Bir satır öğesini etkinleştirmek için entityStatus alanını ENTITY_STATUS_ACTIVE. Bu alanı tek bir satır öğesi için güncelleyebilirsiniz advertisers.lineItems.patch yöntemini kullanarak ve birden çok satır için belirli bir reklamverendeki öğeleri kullanarak advertisers.lineItems.bulkUpdate.

Uyarı: patch veya bulkUpdate yapmayın istekleriyle eşzamanlı olarak aynı satır öğelerini veya etkinleştirin.

Aşağıda, etkinleştirmek için bulkUpdate özelliğinin nasıl kullanılacağına dair bir örnek verilmiştir: birden çok satır öğesi:

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