अपलोड के नियम

नियमों पर आधारित एल्गोरिदम को AlgorithmRules JSON ऑब्जेक्ट से तय किया जाता है. JSON फ़ाइल की मदद से, नियमों को Display & Video 360 में अपलोड करें.

अगर स्क्रिप्ट पर आधारित एल्गोरिदम का इस्तेमाल किया जा रहा है, तो स्क्रिप्ट अपलोड करें पेज पर जाएं.

नियमों का ऑब्जेक्ट बनाना

नियमों पर आधारित कस्टम बिडिंग एल्गोरिदम, जवाब के सिग्नल की अहमियत का आकलन करने के लिए नियमों का इस्तेमाल करते हैं.

AlgorithmRules ऑब्जेक्ट में एक या उससे ज़्यादा rulesets होते हैं. हर नियमों का सेट, अलग-अलग तरह के रिस्पॉन्स सिग्नल का आकलन करता है. जैसे, इंप्रेशन. हर नियमों के सेट में, नियमों की सूची होती है. हर नियम, सेट की गई शर्तों के हिसाब से सिग्नल का आकलन करता है और वैल्यू दिखाता है. किसी सिग्नल का आकलन, सेट में मौजूद सभी नियमों के हिसाब से किया जाता है. इसके बाद, हर नियम से मिली वैल्यू को एक साथ जोड़ दिया जाता है. इससे सिग्नल के लिए, आकलन की वैल्यू मिलती है.

अहम जानकारी: उपलब्ध नियम की शर्तों और लॉजिक के बारे में ज़्यादा जानने के लिए, रेफ़रंस दस्तावेज़ पढ़ें.

अपने AlgorithmRules ऑब्जेक्ट को स्थानीय तौर पर JSON फ़ाइल के तौर पर सेव करें.

नियमों का रेफ़रंस ऑब्जेक्ट जनरेट करना

रेफ़रंस ऑब्जेक्ट का इस्तेमाल, अपलोड की गई फ़ाइल को rules संसाधन से जोड़ने के लिए किया जाता है. uploadRules अनुरोध का इस्तेमाल करके, अपने एल्गोरिदम में रेफ़रंस ऑब्जेक्ट जनरेट करें.

rules रेफ़रंस ऑब्जेक्ट जनरेट करने का तरीका यहां बताया गया है:

Java

// Provide the ID of the advertiser that owns the algorithm.
long advertiserId = advertiser-id;

// Provide the ID of the algorithm.
long customBiddingAlgorithmId = algorithm-id;

// Generate an AlgorithmRules reference object under the algorithm.
CustomBiddingAlgorithmRulesRef response =
    service
        .customBiddingAlgorithms()
        .uploadRules(customBiddingAlgorithmId)
        .setAdvertiserId(advertiserId)
        .execute();

// Display the generated resource path.
System.out.printf(
    "The generated AlgorithmRules reference object provided the following resource path: %s.",
    response.getResourceName());

Python

# Provide the ID of the advertiser that owns the algorithm.
advertiser_id = advertiser-id

# Provide the ID of the algorithm.
algorithm_id = algorithm-id

# Generate an AlgorithmRules reference object under the algorithm.
custom_bidding_algorithm_rules_ref = (
    service.customBiddingAlgorithms()
    .uploadRules(
        customBiddingAlgorithmId=algorithm_id,
        advertiserId=advertiser_id
    )
    .execute()
)

# Print the resource path provided in the generated rules reference object.
print(
    "The generated rules reference object provided the following resource"
    f' path: {custom_bidding_algorithm_rules_ref["resourceName"]}.'
)

PHP

// Provide the ID of the advertiser that owns the algorithm.
$advertiserId = advertiser-id;

// Provide the ID of the algorithm.
$algorithmId = algorithm-id;

$uploadRulesOptParams = array(
    'advertiserId' => $advertiserId
);

try {
  // Generate an AlgorithmRules reference object under the algorithm.
    $rulesRefResponse =
        $this->service->customBiddingAlgorithms->uploadRules(
            $customBiddingAlgorithmId,
            $uploadRulesOptParams
        );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Print the retrieved resource path.
printf(
    '<p>The generated AlgorithmRules reference object provided the '
        . 'following resource path: %s</p>',
    $rulesRefResponse->getResourceName()
);

AlgorithmRules फ़ाइल अपलोड करना

रेफ़रंस ऑब्जेक्ट में मौजूद संसाधन पाथ पर नियमों वाली फ़ाइल अपलोड करने के लिए, मीडिया upload अनुरोध का इस्तेमाल करें. क्वेरी पैरामीटर uploadType=media के साथ सामान्य अपलोड का इस्तेमाल करें.

चेतावनी: नियमों वाली फ़ाइल का साइज़ 7 एमबी से ज़्यादा नहीं होना चाहिए.

नियमों वाली फ़ाइल अपलोड करने का तरीका यहां बताया गया है:

Java

// Provide the local path to the AlgorithmRules file to upload.
String rulesPath = rules-path;

// Provide the resource path to upload the AlgorithmRules file to.
String resourcePath = resource-path;

// Create media object.
GoogleBytestreamMedia media = new GoogleBytestreamMedia();
media.setResourceName(resourcePath);

// Create input stream for the Algorithm file.
InputStreamContent rulesFileStream =
    new InputStreamContent(null, new FileInputStream(rulesPath));

// Create media.upload request.
Media.Upload uploadRequest = service.media().upload(resourcePath, media, rulesFileStream);

// Retrieve uploader from the request and set it to us a simple upload
// request.
MediaHttpUploader uploader = uploadRequest.getMediaHttpUploader();
uploader.setDirectUploadEnabled(true);

// Execute the upload using an Upload URL with the destination resource
// name.
uploader.upload(
    new GenericUrl("https://displayvideo.googleapis.com/upload/media/" + resourcePath));

Python

# Import HTTP objects used for file upload.
from apiclient.http import HttpRequest
from apiclient.http import MediaFileUpload

# Provide the local path to the AlgorithmRules file to upload.
rules_path = rules-path

# Provide the resource path to upload the AlgorithmRules file to.
resource_path = resource-path

# Create a media upload object.
media = MediaFileUpload(rules_path)

# Create upload request.
upload_request = service.media().upload(
    resourceName=resource_path, media_body=media
)

# Override response handler to expect null response.
upload_request.postproc = HttpRequest.null_postproc

# Upload AlgorithmRules to given resource path.
upload_request.execute()

PHP

// Provide the local path to the AlgorithmRules file to upload.
$rulesPath = rules-path;

// Provide the resource path to upload the AlgorithmRules file to.
$resourcePath = resource-path;

// Create the media body.
$mediaBody = new Google_Service_DisplayVideo_GoogleBytestreamMedia();
$mediaBody->setResourceName($resourceName);

// Build params array for the upload request.
$mediaUploadOptParams = array(
    'data' => file_get_contents($rulesPath),
    'uploadType' => 'media',
    'resourceName' => $resourceName
);

try {
    // Call the API, uploading the rules file to Display & Video 360.
    $this->service->media->upload(
        $resourceName,
        $mediaBody,
        $mediaUploadOptParams
    );
} catch (\Exception $e) {
    $this->renderError($e);
}

नियमों का ऑब्जेक्ट बनाना

अपने एल्गोरिदम के तहत rules ऑब्जेक्ट बनाने के लिए, create अनुरोध का इस्तेमाल करें.

ध्यान दें: उपलब्ध डेटा के आधार पर ट्रेनिंग पूरी होने के बाद, एल्गोरिदम सबसे नए मान्य नियमों वाले ऑब्जेक्ट का इस्तेमाल करेगा. ट्रेनिंग में एक से तीन दिन लग सकते हैं. जब तक आपको मौजूदा नियमों को ओवरराइट नहीं करना है, तब तक नियमों का ऑब्जेक्ट न बनाएं.

यहां नियमों का ऑब्जेक्ट बनाने का तरीका बताया गया है:

Java

// Provide the ID of the advertiser that owns the parent algorithm.
long advertiserId = advertiser-id;

// Provide the ID of the parent algorithm.
long algorithmId = algorithm-id;

// Provide the resource path the AlgorithmRules file was uploaded to.
String resourcePath = resource-path;

// Create the custom bidding algorithm rules structure.
CustomBiddingAlgorithmRules customBiddingAlgorithmRules =
    new CustomBiddingAlgorithmRules()
        .setRules(new CustomBiddingAlgorithmRulesRef().setResourceName(resourcePath));

// Create the custom bidding algorithm rules.
CustomBiddingAlgorithmRules response =
    service
        .customBiddingAlgorithms()
        .rules()
        .create(algorithmId, customBiddingAlgorithmRules)
        .setAdvertiserId(advertiserId)
        .execute();

// Print ID of new custom bidding algorithm rules.
System.out.printf("Rules were created with ID %s.", response.getCustomBiddingAlgorithmRulesId());

Python

# Provide the ID of the advertiser that owns the parent algorithm.
advertiser_id = advertiser-id

# Provide the ID of the parent algorithm.
algorithm_id = algorithm-id

# Provide the resource path the AlgorithmRules file was uploaded to.
resource_path = resource-path

# Build algorithm rules object.
rules_obj = {"rules": {"resourceName": resource_path}}

# Build and execute request.
rules_response = (
    service.customBiddingAlgorithms()
    .rules()
    .create(
        customBiddingAlgorithmId=algorithm_id,
        advertiserId=advertiser_id,
        body=rules_obj,
    )
    .execute()
)

# Print ID of new custom bidding algorithm rules.
print(
    f'Rules were created with ID {rules_response["customBiddingAlgorithmRulesId"]}.'
)

PHP

// Provide the ID of the advertiser that owns the parent algorithm.
$advertiserId = advertiser-id;

// Provide the ID of the parent algorithm.
$algorithmId = algorithm-id;

// Provide the resource path the AlgorithmRules file was uploaded to.
$resourcePath = resource-path;

// Build algorithm rules object.
$customBiddingRules = new Google_Service_DisplayVideo_CustomBiddingAlgorithmRules();
$rulesRef = new Google_Service_DisplayVideo_CustomBiddingAlgorithmRulesRef();
$rulesRef->setResourceName($resourcePath);
$customBiddingRules->setRules($rulesRef);

$createRulesOptParams = array(
    'advertiserId' => $advertiserId
);

// Call the API, creating the custom bidding algorithm rules using the
// rules file and under the custom bidding algorithm given.
try {
    $result = $this->service->customBiddingAlgorithms_rules->create(
        $customBiddingAlgorithmId,
        $algorithmId,
        $createRulesOptParams
    );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Print ID of new custom bidding algorithm rules.
printf('<p>Rules was created with ID %s.</p>', $result['customBiddingAlgorithmRulesId']);