REST API를 찾고 계신가요? 이제 Ad Manager API (베타)를 사용할 수 있습니다.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

프로그래매틱

이 가이드는 API를 통해 프로그래매틱 다이렉트 기능을 사용하는 방법을 개략적으로 설명합니다. 제안서를 만드는 방법과 협상을 실행하는 방법을 설명합니다.

Primer

프로그래매틱 제안서는 Google Ad Manager의 주문과 유사합니다. 프로그래매틱 제안서에는 게시자와 구매자 간에 제안된 거래에 관한 광범위한 정보가 포함됩니다. 제안서는 광고 항목과 함께 구매자에게 인벤토리를 제안하는 것을 나타냅니다.

자세한 내용은 고객센터를 참고하세요.

API를 통해 제안서 만들기

Proposal 객체를 만들려면 이름과 프로그래매틱 구매자만 필요합니다. 프로그래매틱 구매자 ID는 UI 또는 Programmatic_Buyer PQL 테이블을 통해 확인할 수 있습니다.

자바

Proposal proposal = new Proposal();

// Setting required Marketplace information.
ProposalMarketplaceInfo proposalMarketplaceInfo = new ProposalMarketplaceInfo();
proposalMarketplaceInfo.setBuyerAccountId(programmaticBuyerId);

// Set common required fields for a proposal.
proposal.setName("Proposal #" + new Random().nextInt(Integer.MAX_VALUE));
proposal.setPrimaryTraffickerId(primaryTraffickerId);
proposal.setMarketplaceInfo(proposalMarketplaceInfo);

GitHub에서 보기

Python

proposal = {
    # Setting required Marketplace information.
    'isProgrammatic': 'true',
    'marketplaceInfo': {
        'buyerAccountId': programmatic_buyer_id,
    },
    # Set common required fields for proposals.
    'name': 'Proposal #%s' % uuid.uuid4(),
    # ...
}

GitHub에서 보기

PHP

$proposal = new Proposal();
$proposal->setName('Proposal #' . uniqid());

// Set the required Marketplace information.
$proposalMarketplaceInfo = new ProposalMarketplaceInfo();
$proposalMarketplaceInfo->setBuyerAccountId($buyerId);
$proposal->setMarketplaceInfo($proposalMarketplaceInfo);

GitHub에서 보기

C#

// Create a proposal with the minimum required fields.
Proposal proposal = new Proposal()
{
    name = "Programmatic proposal #" + new Random().Next(int.MaxValue),
    // Set required Marketplace information
    marketplaceInfo = new ProposalMarketplaceInfo()
    {
        buyerAccountId = programmaticBuyerId
    }
};

GitHub에서 보기

Ruby

# Create proposal configuration object.
proposal = {
  :marketplace_info => {
    :buyer_account_id => buyer_id
  },
  :name => 'Proposal %s' % SecureRandom.uuid(),
  # ...
}

GitHub에서 보기

협상을 위해 구매자에게 보내기 전에 추가 필드를 설정해야 합니다. 제안서에 광고주, 영업 담당자, 애드 마스터, 판매자 연락처가 있어야 합니다.

자바

SalespersonSplit primarySalesperson = new SalespersonSplit();
primarySalesperson.setUserId(primarySalespersonId);
proposal.setPrimarySalesperson(primarySalesperson);

GitHub에서 보기

Python

'primarySalesperson': {
    'userId': primary_salesperson_id,
},
'primaryTraffickerId': primary_trafficker_id,
'probabilityOfClose': '100000',

GitHub에서 보기

PHP

// Create salesperson splits for the primary salesperson.
$primarySalesperson = new SalespersonSplit();
$primarySalesperson->setUserId($primarySalespersonId);
$proposal->setPrimarySalesperson($primarySalesperson);

// Set the primary trafficker on the proposal for when it becomes an
// order.
$proposal->setPrimaryTraffickerId($primaryTraffickerId);

$advertiser = new ProposalCompanyAssociation();
$advertiser->setType(
    ProposalCompanyAssociationType::ADVERTISER
);
$advertiser->setCompanyId($advertiserId);
$proposal->setAdvertiser($advertiser);

GitHub에서 보기

C#

// Set fields that are required before sending the proposal to the buyer.
proposal.primaryTraffickerId = primaryTraffickerId;
proposal.sellerContactIds = new long[] { primarySalespersonId };
proposal.primarySalesperson = new SalespersonSplit()
{
    userId = primarySalespersonId,
};
proposal.advertiser = new ProposalCompanyAssociation()
{
    type = ProposalCompanyAssociationType.ADVERTISER,
    companyId = advertiserId
};

GitHub에서 보기

Ruby

:primary_salesperson => {
  :user_id => primary_salesperson_id
},
:primary_trafficker_id => primary_trafficker_id

GitHub에서 보기

제안서는 일반적으로 ProposalLineItem 객체로 구성되므로 다음 단계는 새로 만든 제안서 아래에 제안서 광고 항목을 추가하는 것입니다.