Bağlılık programlarına genel bakış

Bağlılık programlarını kullanarak mağazanızın avantajlarını Google'da sergileyin. Ücretsiz kargo, puanlar ve üyelere özel fiyatlandırma gibi çeşitli avantajlar sunabilirsiniz. Bağlılık programınızın avantajları; Google Arama, Alışveriş sekmesi ve Google Cüzdan gibi Google platformlarındaki ücretsiz listelemelerde, Alışveriş reklamlarında ve yerel envanter reklamlarında gösterilebilir.

Merchant API sayesinde satıcılar ve satıcılar adına hareket eden üçüncü taraf bağlılık sağlayıcılar, LoyaltyProgramService kullanarak bağlılık programlarını programatik olarak yapılandırabilir ve yönetebilir. Bu hizmet, bağlılık programları oluşturmanıza, almanıza, listelemenize, güncellemenize ve silmenize olanak tanır.

Önemli: Bu hizmet yalnızca belirli satıcılar tarafından kullanılabilir. Katılım için ilgi beyan etmek üzere Alışveriş API'si Destek Formu'nda Sorun/soru nedir? altında bir izin verilenler listesi talebi göndererek destek ekibiyle iletişime geçin. > İzin verilenler listesi isteği > Diğer'i seçin.

İşletme şartları ve politika yönergeleri hakkında daha fazla bilgi için Merchant Center Yardım Merkezi'ndeki Satıcı bağlılık programı hakkında başlıklı makaleyi inceleyin.

Temel kavramlar

Bağlılık programlarıyla çalışırken aşağıdaki kavramları ve sınırlamaları göz önünde bulundurun:

• Hesap düzeyinde tanımlayıcı: Merchant API, bağlılık programlarını, sahibi olan Merchant Center hesap kimliğine göre tanımlar.
• Tek program sınırı: Merchant API, satıcı hesabı başına yalnızca bir bağlılık programını destekler.
• Doğrudan hesap sahipliği: Bağlılık programları doğrudan hedef satıcı hesabında (accounts/{ACCOUNT_ID}) yapılandırılmalıdır. Hizmet, alt hesaplar için gelişmiş hesap düzeyinde bağlılık programlarının yönetilmesini desteklemez. Bir satıcının hesabına yetkili erişimi olan üçüncü taraf bağlılık sağlayıcıları, programı satıcı adına yönetebilir.
• İçerik incelemesi: Bağlılık programı oluşturulduktan veya güncellendikten sonra program incelenir. review_result.review_status alanı, programın UNDER_REVIEW, APPROVED veya REJECTED olup olmadığını gösterir.
• Desteklenen bölgeler: Satıcı bağlılık programları; ABD, Almanya, Avustralya, Birleşik Krallık, Brezilya, Fransa, Güney Kore, Hindistan, Hollanda, İspanya, İtalya, Kanada ve Meksika gibi desteklenen ülkelerde kullanılabilir.
• Katman koşulları: Katmanlara katılım ücretsiz olabilir, üyelik ücreti, harcama eşiği veya satıcı markalı kredi kartı gerektirebilir. Mesleğe dayalı katmanlar (ör. öğrenci veya asker katmanları) desteklenmez.
• Avantajlar: Programlar ücretsiz kargo, kullanılabilir puanlar ve üyelere özel fiyatlandırmayı destekler. Reklamlarda üyelik fiyatı, normal veya indirimli fiyat üzerinden en az% 5 ya da 5 para birimi tutarında indirim gerektirir.

Ön koşullar

Bağlılık programlarını Merchant API ile yönetmeden önce aşağıdaki koşulları karşıladığınızdan emin olun:

• Etkin bir Merchant Center hesabınız (veya üçüncü taraf bağlılık programı sağlayıcısıysanız satıcının hesabına yetkili erişiminiz) olmalıdır.
• Hesabınız için Bağlılık programı eklentisini etkinleştirin. Eklentiyi aşağıdaki seçeneklerden birini kullanarak etkinleştirebilirsiniz:
  • Merchant Center kullanıcı arayüzü: Merchant Center Yardımı'ndaki Bağlılık programı oluşturma bölümünde yer alan talimatları uygulayın.
  • Programs alt API'si: Programı, Programs alt API'sinde programları etkinleştirme bölümünde açıklandığı şekilde programatik olarak etkinleştirin.

Programs alt API'sini kullanarak bağlılık programı eklentisini etkinleştirmek için örnek bir istek aşağıda verilmiştir:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable

cURL

curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

Yöntemler

Bağlılık programlarını aşağıdaki yöntemleri kullanarak yönetebilirsiniz:

• loyaltyPrograms.create
• loyaltyPrograms.get
• loyaltyPrograms.list
• loyaltyPrograms.update
• loyaltyPrograms.delete

Bağlılık programı oluşturma

Bir hesap için yeni bağlılık programı oluşturmak istiyorsanız loyaltyPrograms.create yöntemini kullanın. Program açıklamaları, kayıt URL'si ve program katmanları gibi ayrıntıları, benzersiz avantajları ve şartlarıyla birlikte belirtin.

Zorunlu program_label, bağlılık programının benzersiz tanımlayıcısını ayarlar. Örneğin, my-rewards etiketini sağlamak, accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards değerinde bir name kaynağıyla sonuçlanır.

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

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

{
  "programLabel": "my-rewards",
  "loyaltyProgram": {
    "programName": "my rewards",
    "tiers": [
      {
        "tierName": "gold",
        "tierLabel": "gold",
        "tierBenefits": [
          {
            "otherBenefit": "free gift on your birthday"
          },
          {
            "structuredBenefit": {
              "pointsEarningBenefit": {
                "minimumMoneySpent": {
                  "currencyCode": "USD",
                  "units": "25"
                },
                "pointsEarningBenefitAnnotation": {
                  "pointsEarned": 1.0,
                  "amountSpent": {
                    "currencyCode": "USD",
                    "units": "1"
                  }
                }
              }
            }
          }
        ],
        "requirements": {
          "freeToJoin": true
        }
      }
    ],
    "programDescriptions": [
      "earn rewards buying products you love"
    ],
    "signupUrl": "https://www.example.com/my_rewards_signup",
    "regionCodes": [
      "US"
    ]
  }
}

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

Başarılı bir isteğin örnek yanıtını aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Bağlılık programını alma

Sahibi olduğunuz belirli bir bağlılık programının ayrıntılarını almak için loyaltyPrograms.get yöntemini kullanın.

Not: Bağlılık programı eklentisi etkinleştirilmemiş olsa bile bu uç nokta, hata döndürmeden eşleşen bir bağlılık programıyla yanıt verir.

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

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{ACCOUNT_ID} yerine hesap kimliğinizi, {PROGRAM_LABEL} yerine ise bağlılık programının benzersiz etiketini (ör. my-rewards) girin.

Başarılı bir isteğin örnek yanıtını aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Bağlılık programlarını listeleme

Hesabınızla ilişkili tüm bağlılık programlarını listelemek için loyaltyPrograms.list yöntemini kullanın.

Not: Bu yöntem, alt hesaplarla ilişkili programları değil, yalnızca belirtilen hesabın doğrudan sahibi olduğu bağlılık programlarını listeler. Bağlılık programı eklentisi devre dışı bırakılsa bile bu uç nokta, hata döndürmeden mevcut programlarla yanıt verir.

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

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

Başarılı bir isteğin örnek yanıtını aşağıda bulabilirsiniz:

{
  "loyaltyPrograms": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
      "programName": "my rewards",
      "tiers": [
        {
          "tierName": "gold",
          "tierLabel": "gold",
          "tierBenefits": [
            {
              "otherBenefit": "free gift on your birthday"
            },
            {
              "structuredBenefit": {
                "pointsEarningBenefit": {
                  "minimumMoneySpent": {
                    "currencyCode": "USD",
                    "units": "25"
                  },
                  "pointsEarningBenefitAnnotation": {
                    "pointsEarned": 1.0,
                    "amountSpent": {
                      "currencyCode": "USD",
                      "units": "1"
                    }
                  }
                }
              }
            }
          ],
          "requirements": {
            "freeToJoin": true
          },
          "signupUrl": "https://www.example.com/my-rewards/gold"
        }
      ],
      "programDescriptions": [
        "earn rewards buying products you love"
      ],
      "signupUrl": "https://www.example.com/my_rewards_signup",
      "reviewResult": {
        "reviewStatus": "UNDER_REVIEW"
      },
      "regionCodes": [
        "US"
      ]
    }
  ]
}

Bağlılık programını güncelleme

Mevcut bir bağlılık programını güncellemek için loyaltyPrograms.update yöntemini kullanın. update_mask kullanarak kısmi güncelleme yapın veya maskeyi atlayarak tam değiştirme yapın.

Önemli: Bağlılık programı güncellenirken yinelenen alanlar (ör. programDescriptions ve tiers) yerinde güncellenemez. Güncellemeye dahil edilen tüm yinelenen alanlar, mevcut listenin tamamını değiştirir. İstenmeyen veri kaybını önlemek için yinelenen alanları güncellemeden önce mevcut değerleri almak üzere bir get isteği gönderin.

Güncelleme maskesiyle kısmi güncelleme

update_mask, güncellenecek alanları tam olarak belirtmenize olanak tanır. Yalnızca maskede listelenen alanlar değiştirilir, listelenmeyen alanlar ise değişmeden kalır. Güncelleme maskesinde belirtilmeyen alanlar, istek gövdesinde belirtilmiş olsa bile yoksayılır.

Aşağıdaki örnek istek yalnızca programDescriptions ve advancedSettings değerlerini günceller:

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}?update_mask=program_descriptions,advanced_settings

{
  "programDescriptions": [
    "a new description of the program"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  },
  "signupUrl": "https://www.example.com"
}

Bu örnekte hizmet, update_mask içinde yer almadığı için signupUrl değerini yoksayar. programDescriptions alanı, daha önce yapılandırılmış tüm açıklamaların yerini tamamen alır.

Başarılı bir isteğe verilen örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "a new description of the program"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  }
}

Güncelleme maskesi olmadan tam değiştirme

update_mask parametresini atladığınızda istek, bağlılık programı yapılandırmasını tamamen değiştirir.

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

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{
  "programName": "Updated Program",
  "signupUrl": "https://example.com/updated",
  "programDescriptions": [
    "Updated description"
  ],
  "regionCodes": [
    "US"
  ],
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ]
}

Başarılı bir isteğe verilen örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "Updated Program",
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ],
  "programDescriptions": [
    "Updated description"
  ],
  "signupUrl": "https://example.com/updated",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Bağlılık programını silme

Hesabınızdan bir bağlılık programını silmek için loyaltyPrograms.delete yöntemini kullanın.

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

HTTP

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

Başarılı olursa yanıt gövdesi boş olur.

Sonraki adımlar

• Google Arama'da organik kişiselleştirme için bireysel alışveriş yapan kullanıcıları bağlılık programı katmanlarınızla ilişkilendirmek istiyorsanız Bağlılık Müşteri Eşleştirme Hizmeti kılavuzuna bakın.
• Hesabınızda alışveriş programlarını etkinleştirmek veya devre dışı bırakmak için Programlar alt API'si kılavuzuna bakın.
• İşletme kurulumu ayrıntıları, yazım politikaları ve raporlama için Merchant Center Yardım'daki Satıcı bağlılık programı hakkında başlıklı makaleyi inceleyin.
• API yöntemlerini ve kaynak tanımlarını incelemek için Merchant API referansına bakın.