Özel Teklif Verme özelliğini uygulayın

Bu sorunu çözmek için Ekran ve Video 360 API ile özel teklifi yönetin hakkında bilgi edindiniz. Özel teklif verme algoritmaları oluşturabilir, yükleyebilir ve mevcut olanları doğrulayabilirsiniz bağımsız komut dosyalarını açabilir ve bir kaynağa teklifli sistem olarak belirli bir algoritma atayabilir üzerine konuşacağız.

Bu sayfada, özel teklif verme algoritmalarının nasıl oluşturulacağı, güncelleneceği ve atanacağı açıklanmaktadır. Ekran ve Video 360 API. Her bölümde bir kod örneği verilmiştir.

Özel Teklif Algoritması Oluşturma

CustomBiddingAlgorithm nesnesi bir kişiyi temsil eder teklif stratejisinde kullanmak üzere satır öğesine atayabileceğiniz bir algoritmadır. Bu nesne, algoritma hakkında customBiddingAlgorithmType entityStatus ve customBiddingAlgorithmState. Proje bilgilerini Algoritma için alt kaynaklar olarak CustomBiddingScript nesneleri tıklayın.

Aşağıda, komut dosyası tabanlı özel teklif vermenin nasıl oluşturulacağıyla ilgili bir örnek verilmiştir algoritma:

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=algorithm_obj
).execute()

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

Algoritma erişimini yönetme

Özel teklif verme algoritmaları bir iş ortağına veya reklamverene ait olabilir. Algoritmalar İş ortağına ait olan kullanıcılar, söz konusu iş ortağı ve alt yayıncılar tarafından erişilebilir ve bunlar üzerinde değişiklik yapabilir. sharedAdvertiserIds alanında listelenen reklamverenler. Bir reklamverenin sahip olduğu algoritmalara reklamveren ve üst iş ortağıyla birlikte çalışır ancak diğer reklamverenlerle paylaşılamaz.

Algoritmayı yalnızca tek bir reklamveren için kullanıyorsanız reklamvereni advertiserId alanında sahip olarak seçin. Aksi takdirde, reklamverenlerin üst iş ortağını partnerId alanını kullanabilir ve reklamverenlere sharedAdvertiserIds alanına giriş yapın.

Komut dosyası yükleyin

Özel teklif verme algoritması oluşturduktan sonra bunun için komut dosyası oluşturun algoritmayı kullanın. Komut dosyası tabanlı özel teklif verme algoritmaları, kullanıcı tarafından sağlanan verileri kullanır komut dosyalarını kullanarak bir gösterimin değerini değerlendirebilirsiniz. Basit komut dosyası örnekleri ve gelişmiş alanlar Görüntülü Reklam ve Video 360 Yardım Merkezi.

Aşağıdaki bölümlerde, yeni veya güncellenmiş bir komut dosyasının özel bir teklif verme algoritması.

Komut dosyası kaynak konumunu alma

Öncelikle, özel teklif verme altında kullanılabilir bir kaynak konumu alın diğeri de dahil olmak üzere customBiddingAlgorithms.uploadScript yöntemini kullanabilirsiniz. Bu isteği, değerine sahip bir CustomBiddingScriptRef nesnesi döndürüyor kaynak adı. Şunları yapabilirsiniz: komut dosyası dosyanızı kaynak adı. Ardından, özel teklif verme komut dosyası referans nesnesini komut dosyası kaynağınızı oluşturun.

Aşağıda, kullanılabilir bir kaynağı nasıl alabileceğinize dair bir örnek verilmiştir konum:

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}')

Komut dosyası yükleyin

Kullanılabilir bir kaynak konumunu aldıktan sonra komut dosyası dosyanızı bu konuma yükleyin Konumu Display & media.upload yöntemini kullanabilirsiniz. Bu yöntem sorgu parametresini gerektiren basit yükleme uploadType=media.

Aşağıda, özel teklif verme komut dosyası referans nesnesi alındı:

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

Komut dosyası nesnesi oluşturma

Komut dosyası yüklendikten sonra customBiddingAlgorithms.scripts.create yöntemini kullanır. İlgili içeriği oluşturmak için kullanılan İstekte iletilen CustomBiddingScript nesne yalnızca CustomBiddingScriptRef nesnesini atanan olarak dahil et script alanının değerini değiştirin. Bu, yüklenen dosyayı yeni komut dosyası kaynağına sahip komut dosyası dosyasıdır.

Aşağıda, komut dosyası oluşturmayla ilgili bir örnek verilmiştir:

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}')

Özel teklif verme komut dosyası kaynağı oluşturduktan sonra, Video 360, komut dosyasını kullanarak, bu komut dosyasının gösterimleri puanlamak üzere başarılı bir şekilde kullanılabildiğinden emin olun. Bu işlemin durumunu komut dosyası nesnesinin state alanına giriş yapın. Yeni komut dosyası kabul edildikten sonra, Teklifli sistem algoritması, gösterim değerlerini puanlamak için komut dosyasını kullanmaya başlar. Bu işlemi hemen gerçekleştirilir, bu nedenle işlem yapmadan önce algoritmayı yeni bir komut dosyası kaynağı oluşturun.

Özel Teklif Algoritması Atama

Özel teklif verme algoritması oluşturduktan sonra, kabul edilen bir komut dosyası yükleyin ve gerekli gereksinimleri yerine getiriyorsa, özel kullanıcılarınızı teklif verme algoritmasını bir satır öğesinin veya kampanya siparişinin teklif verme stratejisine ekler.

Özel teklif verme algoritmalarını harcamaları artırma ve BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO atayarak performans hedefi teklif stratejileri ve özel teklif verme algoritması kimliğini performanceGoalType ve customBiddingAlgorithmId alanlarını tıklayın. Teklif stratejisine bağlı olarak, başka teklif parametreleri kullanılabilir veya gereklidir.

Aşağıda, en üst düzeye çıkarma teklif stratejisi kullanmak için satır öğesinin nasıl güncelleneceğine teklif stratejisini belirli bir özel teklif verme algoritmasıyla harcayın:

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"]}.')