디스플레이 및 Video 360 API v2에 대한 지원이 종료됩니다. Display & Video 360 API v3를 대신 사용하세요. v2에서 v3으로 이전하는 방법은 이전 가이드를 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

맞춤 입찰 구현

디스플레이 및 Video 360 API를 사용하면 맞춤 입찰을 완벽하게 관리할 수 있습니다. 있습니다. 맞춤 입찰 알고리즘을 만들고, 이를 업로드하고 개별 스크립트를 사용하고 특정 알고리즘을 리소스에 입찰로 할당 전략입니다.

이 페이지에서는 맞춤 입찰 알고리즘을 생성, 업데이트, 할당하는 방법을 설명합니다. 디스플레이 및 Video 360 API 각 섹션에서는 코드 샘플을 제공합니다.

맞춤 입찰 알고리즘 만들기

CustomBiddingAlgorithm 객체는 개별 사용자를 나타냅니다. 입찰 전략에 사용하기 위해 광고 항목에 할당할 수 있는 알고리즘입니다. 이 객체에는 알고리즘에 대한 세부정보(예: customBiddingAlgorithmType 및 entityStatus 및 readinessState 및 suspensionState: 각 관련 광고주가 생성한 모델을 따릅니다. 다음을 만들 수 있습니다. CustomBiddingScript 및 CustomBiddingAlgorithmRules 객체를 알고리즘이 사용됩니다.

다음은 스크립트 기반 맞춤 입찰 알고리즘을 만드는 방법의 예입니다.

자바

// Create the custom bidding algorithm structure.
CustomBiddingAlgorithm customBiddingAlgorithm =
    new CustomBiddingAlgorithm()
        .setAdvertiserId(advertiser-id)
        .setDisplayName(display-name)
        .setEntityStatus("ENTITY_STATUS_ACTIVE")
        .setCustomBiddingAlgorithmType("SCRIPT_BASED");

// Configure the create request.
CustomBiddingAlgorithms.Create request =
    service.customBiddingAlgorithms().create(customBiddingAlgorithm);

// Create the custom bidding algorithm.
CustomBiddingAlgorithm response = request.execute();

// Display the new custom bidding algorithm name.
System.out.printf(
    "Custom bidding algorithm %s was created.%n",
    response.getName()
);

Python

# Create a custom bidding algorithm object.
custom_bidding_algorithm_obj = {
    'advertiserId': advertiser-id,
    'displayName': display-name,
    'entityStatus': 'ENTITY_STATUS_ACTIVE',
    'customBiddingAlgorithmType': 'SCRIPT_BASED'
}

# Create the custom bidding algorithm.
response = service.customBiddingAlgorithms().create(
    body=custom_bidding_algorithm_obj
).execute()

# Display the new custom bidding algorithm.
print(f'The following Custom Bidding Algorithm was created: {response}')

PHP

// Create a custom bidding algorithm object.
$customBiddingAlgorithm =
    new Google_Service_DisplayVideo_CustomBiddingAlgorithm();
$customBiddingAlgorithm->setAdvertiserId(advertiser-id);
$customBiddingAlgorithm->setDisplayName(display-name);
$customBiddingAlgorithm->setEntityStatus('ENTITY_STATUS_ACTIVE');
$customBiddingAlgorithm->setCustomBiddingAlgorithmType('SCRIPT_BASED');

// Create the custom bidding algorithm.
$result =
    $this->service->customBiddingAlgorithms->create($customBiddingAlgorithm);

// Display the new custom bidding algorithm name.
printf('Custom Bidding Algorithm %s was created.\n', $result['name']);

알고리즘 액세스 관리

맞춤 입찰 알고리즘은 파트너 또는 광고주가 소유할 수 있습니다. 알고리즘 파트너 및 모든 하위 파트너가 액세스하고 수정할 수 있습니다. sharedAdvertiserIds 필드에 광고주 목록을 표시합니다. 광고주가 소유한 알고리즘은 해당 광고주가 액세스하고 수정할 수 있습니다. 광고주와 해당 광고주 상위 파트너만 다른 광고주와 공유할 수 없습니다.

하나의 광고주에 대해서만 알고리즘을 사용하는 경우 advertiserId 필드를 사용하여 광고주를 소유자로 설정할 수 있습니다. 그렇지 않으면 광고주의 상위 파트너를 partnerId 필드로 대체되고, 광고주에게 sharedAdvertiserIds 필드

알고리즘 로직 업로드

다음으로 맞춤 입찰 알고리즘의 유형에 따라 script 또는 rules 객체를 하나씩 생성하며 여기에서 알고리즘에 사용할 로직을 제공합니다.

스크립트 업로드

사용자 제공을 사용하는 스크립트 기반 맞춤 입찰 알고리즘 스크립트: 노출의 가치를 평가합니다. 간단한 스크립트 샘플 및 고급 입력란은 디스플레이 및 Video 360 고객센터를 참고하세요.

다음 섹션에서는 신규 또는 업데이트된 스크립트를 맞춤 입찰 알고리즘

스크립트 리소스 위치 검색

먼저 맞춤 입찰에서 사용 가능한 리소스 위치를 가져옵니다. 알고리즘 리소스를 customBiddingAlgorithms.uploadScript 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 요청은 다음과 함께 CustomBiddingScriptRef 객체를 반환합니다. 리소스 이름. 다음과 같은 작업을 할 수 있습니다. 스크립트 파일을 업로드합니다. 리소스 이름입니다 그런 다음 맞춤 입찰 스크립트 참조 객체를 사용하여 스크립트 리소스를 만듭니다.

다음은 사용 가능한 리소스 위치를 가져오는 방법을 보여주는 예입니다.

자바

// Retrieve a usable custom bidding script
// reference.
CustomBiddingScriptRef scriptRef =
    service
        .customBiddingAlgorithms()
        .uploadScript(custom-bidding-algorithm-id)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display the custom bidding script reference resource path.
System.out.printf(
    "The script can be uploaded to the following resource path: %s%n",
    scriptRef.getResourceName()
);

Python

# Retrieve a usable custom bidding script reference
# object.
custom_bidding_script_ref = service.customBiddingAlgorithms().uploadScript(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id
).execute()

# Display the new custom bidding script reference object.
print('The following custom bidding script reference object was retrieved:'
      f'{custom_bidding_script_ref}')

PHP

// Set parent advertiser ID of custom bidding
// algorithm in optional parameters array for request.
$optParams = array('advertiserId' => advertiser-id);

// Retrieve a usable custom bidding script reference.
$scriptRefResponse = $this->service->customBiddingAlgorithms->uploadScript(
    custom-bidding-algorithm-id,
    $optParams
);

// Display the new custom bidding script reference object.
printf(
    'The script can be uploaded to the following resource path: %s\n',
    $scriptRefResponse->getResourceName()
);

스크립트 파일 업로드

사용 가능한 리소스 위치를 가져온 후 스크립트 파일을 해당 위치에 업로드합니다. 디스플레이 내 위치 및 동영상 360 시스템 media.upload 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 메서드는 쿼리 매개변수가 필요한 단순 업로드 uploadType=media입니다.

다음은 가져온 커스텀 입찰 스크립트 참조 객체:

자바

// Create media object.
GoogleBytestreamMedia media = new GoogleBytestreamMedia();
media.setResourceName(resource-name);

// Create input stream for the script file.
InputStreamContent scriptFileStream =
    new InputStreamContent(
        null, new FileInputStream(script-path));

// Create media.upload request.
Media.Upload uploadRequest =
        service
            .media()
            .upload(
                resource-name,
                media,
                scriptFileStream);

// 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/"
                + resource-name));

Python

# Create a media upload object.
media = MediaFileUpload(script-path)

# Create upload request.
upload_request = service.media().upload(
    resourceName=resource-name, media_body=media)

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

# Upload script to resource location given in retrieved custom bidding
# script reference object.
upload_request.execute()

PHP

// Create a media object.
$mediaBody = new Google_Service_DisplayVideo_GoogleBytestreamMedia();
$mediaBody->setResourceName(resource-name);

// Set parameters for upload request.
$optParams = array(
    'data' => file_get_contents(script-path),
    'uploadType' => 'media',
    'resourceName' => resource-name
);

// Upload script file to given resource location.
$this->service->media->upload(
    resource-name,
    $mediaBody,
    $optParams
);

cURL

curl --request POST 'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' 
  -H 'authorization: Bearer access-token'
  -H 'Content-Type: text/plain'
  --data-binary @script-path

스크립트 객체 만들기

스크립트 파일이 업로드되면 customBiddingAlgorithms.scripts.create 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 요청에서 전달된 CustomBiddingScript 객체는 CustomBiddingScriptRef 객체를 할당된 script 필드의 값입니다. 이렇게 하면 업로드된 스크립트 파일을 새 스크립트 리소스로 대체합니다.

다음은 스크립트 리소스를 만드는 방법의 예입니다.

자바

// Create the custom bidding script structure.
CustomBiddingScript customBiddingScript =
    new CustomBiddingScript()
        .setScript(custom-bidding-script-ref);

// Create the custom bidding script.
CustomBiddingScript response =
    service
        .customBiddingAlgorithms()
        .scripts()
        .create(custom-bidding-algorithm-id, customBiddingScript)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display the new script resource name
System.out.printf(
    "The following script was created: %s%n",
    response.getName());

Python

# Create a custom bidding script object.
script_obj = {
    'script': custom-bidding-script-ref
}

# Create the custom bidding script.
response = service.customBiddingAlgorithms().scripts().create(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id,
    body=script_obj).execute()

# Display the new custom bidding script object.
print(f'The following custom bidding script was created: {response}')

PHP

// Create the custom bidding script object.
$customBiddingScript =
    new Google_Service_DisplayVideo_CustomBiddingScript();
$customBiddingScript->setScript(custom-bidding-script-ref);

// Set parameters for create script request.
$optParams = array(
    'advertiserId' => advertiser-id
);

// Create the custom bidding script.
$result = $this->service->customBiddingAlgorithms_scripts->create(
    custom-bidding-algorithm-id,
    $customBiddingScript,
    $optParams
);

// Display the new script resource name.
printf('The following script was created: %s.\n', $result->getName());

맞춤 입찰 스크립트 리소스를 만들면 Display & Video 360은 확인하려고 합니다. 스크립트 객체의 state 필드 새 스크립트가 승인되면 맞춤 입찰 알고리즘이 스크립트를 사용하여 노출 가치를 산정하기 시작합니다. 이 즉시 발생하므로 업데이트를 실행하기 전에 새 스크립트 리소스를 생성합니다.

업로드 규칙

규칙 기반 맞춤 입찰 알고리즘은 AlgorithmRules 객체: 노출의 가치를 평가합니다.

AlgorithmRules 객체는 JSON 파일로 업로드된 후 맞춤 입찰 알고리즘과 연결되는 CustomBiddingAlgorithmRules 객체.

규칙 리소스 위치를 가져옵니다.

먼저 맞춤 입찰에서 사용 가능한 리소스 위치를 가져옵니다. 알고리즘 리소스를 customBiddingAlgorithms.uploadRules 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 요청은 CustomBiddingAlgorithmsRulesRef 객체를 반환합니다. 리소스 이름으로 바꿉니다. 규칙을 업로드하여 file을 리소스 이름으로 지정된 위치로 복사합니다. 그런 다음 맞춤 입찰 알고리즘 규칙 참조 객체를 사용하여 규칙 생성 리소스를 참고하세요.

다음은 사용 가능한 리소스 위치를 가져오는 방법을 보여주는 예입니다.

자바

// Create the custom bidding algorithm structure.
CustomBiddingAlgorithmRulesRef rulesRef =
    service
        .customBiddingAlgorithms()
        .uploadRules(custom-bidding-algorithm-id)
        .setAdvertiserId(advertiser-id)
        .execute();

System.out.printf(
    "The rules can be uploaded to the following resource path: %s%n",
    rulesRef.getResourceName()
);

Python

# Retrieve a usable custom bidding algorithm rules reference
# object.
custom_bidding_algorithm_rules_ref = service.customBiddingAlgorithms().uploadRules(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id
).execute()

# Display the new custom bidding algorithm rules reference object.
print('The following custom bidding algorithm rules reference object was retrieved:'
      f' {custom_bidding_algorithm_rules_ref}')

PHP

// Set parent advertiser ID of custom bidding algorithm
// in optional parameters array for request.
$optParams = array('advertiserId' => advertiser-id);

// Retrieve a usable custom bidding algorithm rules reference.
$rulesRefResponse = $this->service->customBiddingAlgorithms->uploadRules(
    custom-bidding-algorithm-id,
    $optParams
);

// Display the new custom bidding algorithm rules reference object resource path.
printf(
    'The rules can be uploaded to the following resource path: %s\n',
    $rulesRefResponse->getResourceName()
);

`AlgorithmRules` 파일 업로드

사용 가능한 리소스 위치를 가져온 후 해당 위치에 규칙 파일을 업로드합니다. 디스플레이 내 위치 및 동영상 360 시스템 media.upload 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 메서드는 쿼리 매개변수가 필요한 단순 업로드 uploadType=media입니다.

다음은 가져온 후 AlgorithmRules 파일을 업로드하는 방법의 예입니다. 맞춤 입찰 알고리즘 규칙 참조 객체:

자바

// Create media object.
GoogleBytestreamMedia media = new GoogleBytestreamMedia();
media.setResourceName(resource-name);

// Create input stream for the rules file.
InputStreamContent rulesFileStream =
    new InputStreamContent(
        null, new FileInputStream(rules-file-path));

// Create media.upload request.
 Media.Upload uploadRequest =
    service
        .media()
        .upload(
            resource-name,
            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/"
                + resource-name));

Python

# Create a media upload object.
media = MediaFileUpload(rules-file-path)

# Create upload request.
upload_request = service.media().upload(
    resourceName=resource-name, media_body=media)

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

# Upload rules file to resource location given in retrieved custom bidding
# algorithm rules reference object.
upload_request.execute()

PHP

// Create a media object.
$mediaBody = new Google_Service_DisplayVideo_GoogleBytestreamMedia();
$mediaBody->setResourceName(resource-name);

// Set parameters for upload request.
$optParams = array(
    'data' => file_get_contents(rules-file-path),
    'uploadType' => 'media',
    'resourceName' => resource-name
);

// Upload rules file to given resource location.
$this->service->media->upload(
    resource-name,
    $mediaBody,
    $optParams
);

cURL

curl --request POST 'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' 
  -H 'authorization: Bearer access-token'
  -H 'Content-Type: text/plain'
  --data-binary @rules-file-path

규칙 객체 만들기

AlgorithmRules JSON 파일이 업로드되면 맞춤 입찰을 만듭니다. 알고리즘 규칙 리소스에 customBiddingAlgorithms.rules.create 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 요청에서 전달된 CustomBiddingAlgorithmRules 객체는 다음과 같이 CustomBiddingAlgorithmRulesRef 객체만 포함합니다. rules 필드의 할당된 값입니다. 이를 통해 새 규칙 리소스가 포함된 JSON 파일 AlgorithmRules개를 업로드했습니다.

다음은 규칙 리소스를 만드는 방법의 예시입니다.

자바

// Create the custom bidding algorithm rules structure.
CustomBiddingAlgorithmRules customBiddingAlgorithmRules =
    new CustomBiddingAlgorithmRules()
        .setRules(custom-bidding-algorithm-rules-ref);

// Create the rules resource.
CustomBiddingAlgorithmRules response =
    service
        .customBiddingAlgorithms()
        .rules()
        .create(custom-bidding-algorithm-id, customBiddingAlgorithmRules)
        .setAdvertiserId(advertiser-id)
        .execute();

// Display the new rules resource name.
System.out.printf(
    "The following custom bidding algorithm rules object was created: %s%n",
    response.getName());

Python

# Create the custom bidding algorithm rules object.
rules_obj = {
    'rules': custom-bidding-algorithm-rules-ref
}

# Create the rules resource.
response = service.customBiddingAlgorithms().rules().create(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id,
    body=rules_obj).execute()

# Display the new custom bidding algorithm rules object.
print(f'The following custom bidding algorithm rules resource was created: {response}')

PHP

// Create the custom bidding algorithm rules object.
$customBiddingAlgorithmRules =
    new Google_Service_DisplayVideo_CustomBiddingAlgorithmRules();
$customBiddingAlgorithmRules->setRules(custom-bidding-algorithm-rules-ref);

// Set parameters for create rules request.
$optParams = array(
    'advertiserId' => advertiser-id
);

// Create the custom bidding algorithm rules resource.
$result = $this->service->customBiddingAlgorithms_rules->create(
    custom-bidding-algorithm-id,
    $customBiddingAlgorithmRules,
    $optParams
);

// Display the new custom bidding algorithm rules resource name.
printf('The following rules resource was created: %s.\n', $result->getName());

규칙 리소스를 만들면 Display & Video 360은 규칙 집합을 처리하여 노출 점수에 성공적으로 사용될 수 있는지 확인해야 합니다. 상태 검색 규칙 객체의 state 필드를 통해 이 처리의 우선순위를 지정합니다. 새 규칙이 수락되면 맞춤 입찰 알고리즘이 즉시 노출 값을 스코어링할 수 있습니다.

규칙이 거부되면 규칙에서 거부 사유를 검색합니다. 객체의 error 거부된 경우 AlgorithmRules 객체를 사용하여 오류를 수정하고 규칙 참조 객체를 검색하지 못하도록 할 수 있습니다.

맞춤 입찰 알고리즘 할당

맞춤 입찰 알고리즘을 만든 후 허용되는 로직을 업로드하고 필요한 요구사항이 있으면 입찰 알고리즘을 광고 항목이나 게재 신청서의 입찰 전략에 추가합니다.

맞춤 입찰 알고리즘을 사용하려면 지출 극대화 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO을(를) 할당하여 실적 목표 입찰 전략 및 맞춤 입찰 알고리즘 ID를 performanceGoalType 및 customBiddingAlgorithmId 필드에 각각 표시됩니다. 입찰 전략에 따라 다른 입찰 매개변수를 사용할 수 있습니다. 필요합니다.

다음은 지출 극대화 입찰가를 사용하도록 광고 항목을 업데이트하는 방법의 예입니다. 입찰 전략을 사용할 수도 있습니다.

자바

// Create the line item structure.
LineItem lineItem = new LineItem();

// Create and set the bidding strategy structure.
BiddingStrategy biddingStrategy = new BiddingStrategy();
MaximizeSpendBidStrategy maxSpendBidStrategy =
    new MaximizeSpendBidStrategy()
        .setPerformanceGoalType(
            "BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO")
        .setCustomBiddingAlgorithmId(custom-bidding-algorithm-id);
biddingStrategy.setMaximizeSpendAutoBid(maxSpendBidStrategy);
lineItem.setBidStrategy(biddingStrategy);

// Configure the patch request and set update mask to only update
// the bid strategy.
LineItems.Patch request =
    service
        .advertisers()
        .lineItems()
        .patch(advertiser-id, line-item-id, lineItem)
        .setUpdateMask("bidStrategy");

// Update the line item.
LineItem response = request.execute();

// Display the custom bidding algorithm ID used in the new
// bid strategy.
System.out.printf(
    "LineItem %s now has a bid strategy utilizing custom "
        + "bidding algorithm %s%n",
    response.getName(),
    response
        .getBidStrategy()
        .getMaximizeSpendAutoBid()
        .getCustomBiddingAlgorithmId());

Python

# Create the new bid strategy object.
bidding_strategy = {
    'maximizeSpendAutoBid': {
        'performanceGoalType':
            'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO',
        'customBiddingAlgorithmId': custom-bidding-algorithm-id
    }
}

# Create a line item object assigning the new bid strategy.
line_item_obj = {'bidStrategy': bidding_strategy}

# Update the line item with a new bid strategy.
response = service.advertisers().lineItems().patch(
    advertiserId=advertiser-id,
    lineItemId=line-item-id,
    updateMask='bidStrategy',
    body=line_item_obj).execute()

# Display the line item's new bid strategy
print(f'Line Item {response["name"]} is now using the following bid'
     f' strategy: {response["bidStrategy"]}.')

PHP

// Create the line item structure.
$lineItem = new Google_Service_DisplayVideo_LineItem();

// Create and set the bidding strategy structure.
$biddingStrategy =  new Google_Service_DisplayVideo_BiddingStrategy();
$maximizeSpendBidStrategy =
    new Google_Service_DisplayVideo_MaximizeSpendBidStrategy();
$maximizeSpendBidStrategy->setPerformanceGoalType(
    'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO'
);
$maximizeSpendBidStrategy->setCustomBiddingAlgorithmId(
    custom-bidding-algorithm-id
);
$biddingStrategy->setMaximizeSpendAutoBid($maximizeSpendBidStrategy);
$lineItem->setBidStrategy($biddingStrategy);

// Set update mask.
$optParams = array('updateMask' => 'bidStrategy');

// Update the line item.
$result = $this->service->advertisers_lineItems->patch(
    advertiser-id,
    line-item-id,
    $lineItem,
    $optParams
);

// Display the custom bidding algorithm ID used in the new bid strategy.
printf(
    'Line Item %s now has a bid strategy utilizing custom bidding algorithm %s.\n',
    $result['name'],
    $result['bidStrategy']['maximizeSpendBidStrategy']['customBiddingAlgorithmId']
);

YouTube + 파트너 광고 항목 검색

광고 항목 활성화

맞춤 입찰 구현

맞춤 입찰 알고리즘 만들기

자바

Python

PHP

알고리즘 액세스 관리

알고리즘 로직 업로드

스크립트 업로드

스크립트 리소스 위치 검색

자바

Python

PHP

스크립트 파일 업로드

자바

Python

PHP

cURL

스크립트 객체 만들기

자바

Python

PHP

업로드 규칙

규칙 리소스 위치를 가져옵니다.

자바

Python

PHP

AlgorithmRules 파일 업로드

자바

Python

PHP

cURL

규칙 객체 만들기

자바

Python

PHP

맞춤 입찰 알고리즘 할당

자바

Python

PHP

`AlgorithmRules` 파일 업로드