Automatyczna

Ten przewodnik zawiera ogólne informacje o tym, jak korzystać z funkcji automatyzacji bezpośredniej za pomocą interfejsu API. Opisuje, jak utworzyć ofertę pakietową i jak prowadzić negocjacje.

Primer

Zautomatyzowana oferta pakietowa jest podobna do zamówienia w usłudze Google Ad Manager. Oferty pakietowe automatyzacji zawierają ogólne informacje o proponowanej transakcji między Tobą a kupującym. Oferta pakietowa wraz z elementami zamówienia stanowi ofertę zasobów reklamowych dla kupującego.

Więcej informacji znajdziesz w Centrum pomocy.

Tworzenie oferty za pomocą interfejsu API

Do utworzenia obiektu Proposal wymagane są tylko nazwa i kupujący korzystający z automatyzacji kupowania. Identyfikator kupującego korzystającego z automatyzacji kupowania można uzyskać w interfejsie lub tabeli PQL Programmatic_Buyer.

Java

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

Wyświetl w GitHubie

Python

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

Wyświetl w GitHubie

PHP

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

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

Wyświetl w GitHubie

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

Wyświetl w GitHubie

Ruby

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

Wyświetl w GitHubie

Zanim wyślesz umowę do kupującego w celu negocjacji, musisz ustawić dodatkowe pola. Oferta pakietowa musi zawierać reklamodawcę, pracownika działu sprzedaży, trafikera i kontakty sprzedawcy.

Java

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

Wyświetl w GitHubie

Python

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

Wyświetl w GitHubie

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

Wyświetl w GitHubie

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

Wyświetl w GitHubie

Ruby

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

Wyświetl w GitHubie

Ponieważ oferty pakietowe składają się zwykle z obiektów ProposalLineItem, następnym krokiem jest dodanie elementów zamówienia w ofercie pakietowej do nowo utworzonej oferty pakietowej.

Stany zautomatyzowanej oferty pakietowej

Poniższy rysunek przedstawia ofertę automatyczną w różnych momentach procesu negocjacji z perspektywy interfejsu API. Każdy stan jest reprezentowany przez różne kombinacje tych pól:

• ProposalMarketplaceInfo.hasLocalVersionEdits
• ProposalMarketplaceInfo.negotiationStatus
• Proposal.status

Więcej informacji znajdziesz w Centrum pomocy Ad Managera.

Rysunek 1. Stany oferty automatycznej

Przewodnik po negocjacjach

Tutaj dowiesz się, jak za pomocą interfejsu API przeprowadzić negocjacje z kupującym dotyczące oferty automatycznej. Będziemy odwoływać się do stanów na powyższym diagramie.

Przygotowanie do sprawdzenia lub zaakceptowania przez kupującego

Najpierw musisz utworzyć wersję roboczą zautomatyzowanej oferty pakietowej z elementami zamówienia w ofercie pakietowej, które chcesz wysłać do kupującego. Na rysunku powyżej jest to state C.

Prośba o sprawdzenie lub zaakceptowanie oferty przez kupującego

Gdy będziesz gotowy(-a) do przesłania oferty automatycznej do sprawdzenia przez kupującego, możesz RequestBuyerReview lub RequestBuyerAcceptance, używając metody ProposalService.performProposalAction. Spowoduje to przejście do fazy negocjacji.

Negocjacje

Na tym etapie może się wydarzyć kilka rzeczy.

• Kupujący może zaakceptować Twoją ofertę automatyczną bez zmian.
• Kupujący może zaproponować zmiany. W takim przypadku oferta pakietowa zostanie przywrócona do stanu wersji roboczej (state B na rysunku 1). Następnie musisz otworzyć ofertę pakietową do edycji, wprowadzić proponowane zmiany i odesłać ją do sprawdzenia przez kupującego.
• Możesz też wprowadzić zmiany, zanim kupujący odpowie. Możesz to zrobić, otwierając ofertę pakietową do edycji z poziomu state D na rysunku 1.

Uwaga: gdy oferta pakietowa automatyzacji jest otwarta do edycji (state A na rysunku 1), nie będzie automatycznie otrzymywać aktualizacji z Marketplace. Oznacza to, że jeśli kupujący wprowadzi zmianę, zanim poprosisz go o akceptację, podczas próby wysłania prośby o akceptację zobaczysz komunikat o błędzie NEW_VERSION_FROM_BUYER. Aby rozwiązać ten problem, wykonaj działanie DiscardProposalDrafts, które zastąpi zmiany lokalne najnowszymi zmianami wprowadzonymi przez kupującego na Marketplace. Następnie musisz ponownie zastosować zmiany lokalne.

Negocjacje trwają do momentu osiągnięcia porozumienia z kupującym. Komentarze między Tobą a kupującym można pobrać za pomocą metody getMarketplaceCommentsByStatement. Możesz wysłać komentarz do kupującego, gdy jesteś w trybie state A. Aby to zrobić, musisz zaktualizować pole marketplaceComment w ofercie pakietowej, używając metody updateProposals. Komentarz zostanie wysłany, gdy poprosisz kupującego o zaakceptowanie oferty.

Sfinalizowano

Gdy zarówno Ty, jak i kupujący zaakceptujecie ofertę pakietową, zostanie ona sfinalizowana (state F na rysunku 1). Ad Manager automatycznie utworzy elementy zamówienia na podstawie tej oferty automatyzacji.

W większości przypadków oferta automatyczna jest już gotowa, ale możesz jeszcze wykonać 2 działania:

• Możesz ponownie otworzyć ofertę pakietową automatyzacji, aby przeprowadzić ponowne negocjacje, edytując w niej pola związane z wyświetlaniem. Aby to zrobić, otwórz ofertę pakietową do edycji (state E to A na rysunku 1), wprowadź zmiany, a następnie poproś kupującego o jej zaakceptowanie.
• Możesz wprowadzać zmiany niezwiązane z wyświetlaniem, np. aktualizować nazwę oferty pakietowej i odzwierciedlać te zmiany w zamówieniu i elementach zamówienia Ad Managera utworzonych na podstawie tej umowy. Aby to zrobić, zmień state E na rysunku 1, a następnie wykonaj działanie UpdateOrderWithSellerData.