লাইন আইটেম সক্রিয় করুন

Display & Video 360 API ব্যবহার করে তৈরি করা সমস্ত লাইন আইটেম প্রাথমিকভাবে একটি খসড়া অবস্থায় তৈরি করা হয়। এই খসড়া অবস্থায়, লাইন আইটেমগুলি বিজ্ঞাপন পরিবেশন করে না, তাই আপনি বর্তমান বিজ্ঞাপন পরিবেশনকে প্রভাবিত না করে সেই পরিবর্তনগুলি ছাড়াই সেটিংস এবং টার্গেটিং সামঞ্জস্য করতে পারবেন৷ এই পৃষ্ঠাটি আপনার লাইন আইটেমটি বিজ্ঞাপন পরিবেশনের জন্য প্রস্তুত কিনা তা নিশ্চিত করার জন্য আপনাকে কী পদক্ষেপ নিতে হবে এবং কীভাবে এটির স্থিতি সক্রিয় করতে আপডেট করতে হবে তা বর্ণনা করে৷

সক্রিয় করার আগে কি করতে হবে

প্রদত্ত যে লাইন আইটেমগুলি হল যে পদ্ধতিতে আপনার বিজ্ঞাপনের আয় বিজ্ঞাপন কেনা এবং পরিবেশনের মাধ্যমে ব্যয় করা হয়, এটি নিশ্চিত করা গুরুত্বপূর্ণ যে লাইন আইটেমটি সক্রিয় করার সময় উদ্দেশ্য অনুসারে বিজ্ঞাপন পরিবেশন করবে। আপনার লাইন আইটেম সক্রিয় করার আগে বিবেচনা করার জন্য নীচে কয়েকটি বিষয় রয়েছে:

• ফ্লাইট সেটিংস সঠিক কিনা তা নিশ্চিত করুন: লাইন আইটেমের ফ্লাইট উইন্ডোটি সঠিকভাবে সেট করা আছে কিনা তা নিশ্চিত করতে লাইন আইটেমের flight ক্ষেত্রটি পরীক্ষা করুন। একটি লাইন আইটেমের ফ্লাইট উইন্ডো লাইন আইটেমের সাথে কাস্টম হতে পারে বা প্যারেন্ট ইনসার্টেশন অর্ডার দ্বারা উত্তরাধিকারসূত্রে প্রাপ্ত হতে পারে।
• যাচাই করুন যে লাইন আইটেমের পরিবেশনকে ব্লক করে এমন কোনো সতর্কতা নেই: একটি লাইন আইটেম সম্পদ পুনরুদ্ধার করতে advertisers.lineItems.get ব্যবহার করুন এবং লাইন আইটেমটিতে এমন কোনো সতর্কতা নেই যা লাইন আইটেম পরিবেশনকে বাধাগ্রস্ত করতে পারে তা যাচাই করার জন্য ক্ষেত্র warningMessages চেক করুন। LineItemWarningMessage enum প্রতিটি সতর্কতার প্রভাব নোট করে।
• নিশ্চিত করুন যে সমস্ত অভিভাবক সংস্থানগুলিও সক্রিয় রয়েছে: একটি সক্রিয় লাইন আইটেম বিজ্ঞাপন পরিবেশন করা শুরু করবে না যদি তার মূল বিজ্ঞাপনদাতা, প্রচারাভিযান বা সন্নিবেশের আদেশ সক্রিয় না হয়৷ বিজ্ঞাপনদাতা , প্রচারাভিযান , এবং সন্নিবেশ আদেশ পরিষেবাগুলিতে GET পদ্ধতি ব্যবহার করে এই সংস্থানগুলি পুনরুদ্ধার করুন৷

একটি লাইন আইটেম সক্রিয় করুন

ENTITY_STATUS_ACTIVE তে একটি লাইন আইটেম এর entityStatus ফিল্ড আপডেট করে সক্রিয় করুন। আপনি advertisers.lineItems.patch পদ্ধতি ব্যবহার করে একটি পৃথক লাইন আইটেমের জন্য এবং advertisers.lineItems.bulkUpdate ব্যবহার করে একটি প্রদত্ত বিজ্ঞাপনদাতার মধ্যে একাধিক লাইন আইটেমের জন্য এই ক্ষেত্রটি আপডেট করতে পারেন।

সতর্কতা: একই লাইন আইটেম বা তাদের টার্গেটিং আপডেট করার অন্যান্য অনুরোধের সাথে একযোগে patch বা bulkUpdate অনুরোধ করবেন না।

একাধিক লাইন আইটেম সক্রিয় করতে bulkUpdate কীভাবে ব্যবহার করবেন তার একটি উদাহরণ এখানে দেওয়া হল:

জাভা

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

পাইথন

# 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'])

পিএইচপি

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