Ödeme ayarlarını yönetme

Doğrudan ödeme sayfasına yönlendirme özelliği, satın almaya hazır müşterilerin Google ürün listelemelerinden doğrudan web sitenizin alışveriş sepeti veya ödeme sayfasına gitmesine olanak tanıyarak satın alma sürecini hızlandırır. Bu sayede dönüşüm oranları artabilir ve alışveriş deneyimi sorunsuz hale gelebilir.

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

Bu kılavuzda, ödeme özelliği programına kaydınızı 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ış olmanız ve bu özelliklerden yararlanıyor 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. İstek gövdesine checkout_uri_template veya cart_uri_template ile uri_settings ve seçilen eligible_destinations öğesini 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} kısmını Merchant Center hesabınızın benzersiz tanımlayıcısıyla değiştirin.

Başarılı bir çağrıdan 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çilen 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 çağrıdan 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. İstek gövdesine değiştirmek istediğiniz alanları ekleyin ve bu alanları update_mask sorgu parametresinde belirtin.

update_mask aşağıdaki alanları destekler:

  • eligible_destinations
  • uri_settings

URL'yi güncelleyen ve reklam hedefinin kaldırıldığı örnek bir istek aşağıda 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 çağrıdan 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, sizi ödeme programından çıkarır ve ödeme bağlantılarının ücretsiz listelemelerdeki ve Alışveriş reklamlarındaki ürünlerinizde görünmesini 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'leri sağlamanın iki yolu vardır:

  • Hesap düzeyi (alt API veya Merchant Center): Tek bir URL şablonu (checkout_uri_template veya cart_uri_template) 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üzeyi (feed): Tek tek ü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 kullanabilir veya envanterinizin yalnızca bir alt kümesi için ödeme 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ğiyle ilgili değer 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 eligible_destinations seçmek için alt API'yi kullanmaya devam edebilirsiniz. Bu durumda uri_settings sağlamanız gerekmez.

Ödeme URL'si şablonu

Ödeme URL'si şablonu, ürün verilerinize bir ödeme URL'si eklemenize olanak tanır. Bu URL'yi kullanarak internetten alışveriş yapan müşterileri listelemelerinizden doğrudan ö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ı, satın alınmaya hazır belirli bir öğeyle birlikte ödeme sayfanıza yönlendiren bir URL şablonu.
  • cart_uri_template: Kullanıcıyı, alışveriş sepetinize 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şıladığınızdan emin olun:

  • URL şablonunuz, sitenizde kayıtlı alan adınızla eşleşen, HTTP GET yöntemiyle çalışan 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