Ödeme ayarlarını yönetme

Doğrudan ödeme sayfasına yönlendirme özelliği, satın almaya hazır müşterileri doğrudan Google ürün listelemelerinden web sitenizin alışveriş sepeti veya ödeme sayfasına yönlendirerek satın alma işlemini hızlandırır. Bu da dönüşüm oranlarını artırabilir ve alışveriş deneyimini kolaylaştırabilir.

Merchant API ile CheckoutSettings kaynağını kullanarak bu özelliğin ayarlarını yönetebilirsiniz.

Bu kılavuzda, ödeme özelliğine kaydınızı programatik olarak oluşturmak ve yönetmek için Merchant API'yi nasıl kullanacağınız açıklanmaktadır.

Daha fazla bilgi için Ürünleriniz için ödeme bağlantısı ekleme başlıklı makaleyi inceleyin.

Ön koşullar

CheckoutSettings kaynağını ve ilişkili yöntemleri kullanmak için aşağıdakileri yaptığınızdan emin olun:

  • Alışveriş reklamları, ücretsiz listelemeler veya her ikisi için de onaylanmış ve bu programlara katılmış olmanız gerekir.
  • Satış yaptığınız ülke ABD olmalıdır.

Yöntemler

Ödeme ayarlarını oluşturmak, almak, güncellemek ve silmek için aşağıdaki yöntemleri kullanabilirsiniz:

Ödeme ayarları oluşturma

Ödeme ayarı oluşturmak için checkoutSettings.create yöntemini kullanın. uri_settings'ü checkout_uri_template veya cart_uri_template ile birlikte ve seçili eligible_destinations'ı istek gövdesine ekleyin.

Aşağıda örnek bir istek verilmiştir:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

{ACCOUNT_ID} değerini Merchant Center hesabınızın benzersiz tanımlayıcıyla değiştirin.

Başarılı bir aramadan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Ödeme ayarlarını alma

URL şablonu, seçili hedefler, kayıt durumu ve URL inceleme durumu dahil olmak üzere ödeme ayarlarınızı almak için checkoutSettings.get yöntemini kullanın.

Aşağıda örnek bir istek verilmiştir:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Başarılı bir aramadan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

Ödeme ayarlarını güncelleme

Ödeme ayarlarınızı güncellemek için checkoutSettings.update yöntemini kullanın. Değiştirmek istediğiniz alanları istek gövdesine ekleyin ve bu alanları update_mask sorgu parametresinde belirtin.

update_mask aşağıdaki alanları destekler:

  • eligible_destinations
  • uri_settings

Aşağıda, URL'yi güncelleyen ve reklam hedefini kaldıran örnek bir istek verilmiştir:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

Başarılı bir aramadan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Sil

Ödeme ayarlarını silmek için checkoutSettings.delete yöntemini kullanın.

Bu işlem, hesap düzeyindeki yapılandırmanızı kaldırır, ödeme programından kaydınızı iptal eder ve ödeme bağlantılarının ücretsiz listelemelerdeki ve Alışveriş reklamlarındaki ürünlerinizde gösterilmesini durdurur.

Aşağıda örnek bir istek verilmiştir:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Başarılı bir çağrı, boş bir yanıt gövdesi döndürür.

Ürünleriniz için ödeme URL'lerini iki şekilde sağlayabilirsiniz:

  • Hesap düzeyinde (alt API veya Merchant Center): checkout_uri_template veya cart_uri_template olmak üzere tek bir URL şablonu tanımlamak için alt API'yi ya da Merchant Center ayarlarını kullanabilirsiniz. Bu şablon, uygun tüm ürünlerinize uygulanır. Ürünlerinizde tutarlı bir URL kullanmanızı öneririz. Örneğin, yourstore.com/checkout?id={id}.

  • Ürün düzeyinde (Feed): Belirli ürünler için belirli bir ödeme URL'si sağlamak istiyorsanız ürün feed'inizde checkout_link_template özelliğini kullanın. Bu sayede ürün başına özelleştirilmiş URL'ler oluşturabilir veya ödeme özelliğini yalnızca envanterinizin bir alt kümesi için sunabilirsiniz.

  • Bu alt API'yi kullanarak hesap düzeyinde bir URL şablonu ayarlarsanız söz konusu ürünler için feed'inizde checkout_link_template özelliğine ait değerler göndermediğinizden emin olun.

  • checkout_link_template feed özelliğini kullanıyorsanız alt API'yi veya Merchant Center ayarlarını kullanarak hesap düzeyinde bir URL şablonu ayarlamadığınızdan emin olun. URL'leri yalnızca feed üzerinden yönetiyorsanız uri_settings sağlamadan eligible_destinations seçmek için alt API'yi kullanmaya devam edebilirsiniz.

Ödeme URL'si şablonu

Ödeme URL'si şablonu, ürün verilerinize ödeme URL'si eklemenize olanak tanır. Bu URL'leri kullanarak internetten alışveriş yapan müşterileri listelemelerinizden ödeme sayfanıza yönlendirebilirsiniz. {ID} parametre yer tutucusunu içermeli ve eşleşen bir alana sahip olmalıdır.

Alt API'yi kullanarak ödeme bağlantılarını ayarlarken uri_settings alanını kullanın. Bu alan iki şablondan birini kabul eder:

  • checkout_uri_template: Yer tutucu doldurulduğunda kullanıcıyı, belirli bir öğenin satın alınmaya hazır olduğu ödeme sayfanıza yönlendiren bir URL şablonu.
  • cart_uri_template: Kullanıcıyı, alışveriş sepetine eklenen belirli bir öğeyle birlikte alışveriş sepeti sayfanıza yönlendiren bir URL şablonu.

Örnek şablonlar

  • Ödeme: https://www.your-store.com/checkout?item_id={id}
  • Alışveriş sepeti: https://shop.your-store.com/add_to_cart?product_sku={id}

Aşağıdaki koşulları karşılamanız gerekir:

  • URL şablonunuz, sitenizdeki kayıtlı alanınızla eşleşen, HTTP GET yöntemini kullanan ve müşterinin oturum açmasını gerektirmeyen geçerli bir sayfaya yönlendirmelidir.
  • Sağlanan ödeme şablonundaki alan, ürün alanıyla eşleşmelidir.

Daha fazla bilgi